Bir resmi temsil eden PageElement
.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
alignOnPage(alignmentPosition) | Image | Öğeyi sayfada belirtilen hizalama konumuna hizalar. |
bringForward() | Image | Sayfa öğesini sayfada bir öğe öne getirir. |
bringToFront() | Image | Sayfa öğesini sayfanın önüne getirir. |
duplicate() | PageElement | Sayfa öğesini çoğaltır. |
getAs(contentType) | Blob | Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün. |
getBlob() | Blob | Bu görüntüdeki verileri blob olarak döndürün. |
getBorder() | Border | Resmin Border değerini döndürür. |
getConnectionSites() | ConnectionSite[] | Sayfa öğesindeki ConnectionSite listesini veya sayfa öğesinin bağlantı sitesi yoksa boş bir liste döndürür. |
getContentUrl() | String | Resmin URL'sini alır. |
getDescription() | String | Sayfa öğesinin alternatif metin açıklamasını döndürür. |
getHeight() | Number | Öğenin yüksekliğini noktalar halinde alır. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun yüksekliğidir. |
getInherentHeight() | Number | Öğenin doğal yüksekliğini puan cinsinden döndürür. |
getInherentWidth() | Number | Öğenin doğal genişliğini nokta cinsinden döndürür. |
getLeft() | Number | Öğe hiç dönmediğinde sayfanın sol üst köşesinden ölçülen, öğenin yatay konumunu noktalar cinsinden döndürür. |
getLink() | Link | Bağlantı yoksa Link veya null değerini döndürür. |
getObjectId() | String | Bu nesnenin benzersiz kimliğini döndürür. |
getPageElementType() | PageElementType | Sayfa öğesinin PageElementType sıralamasıyla belirtilen türünü döndürür. |
getParentGroup() | Group | Bu sayfa öğesinin ait olduğu grubu veya öğe bir grupta yer almıyorsa null değerini döndürür. |
getParentPage() | Page | Bu sayfa öğesinin bulunduğu sayfayı döndürür. |
getParentPlaceholder() | PageElement | Yer tutucunun üst sayfa öğesini döndürür. |
getPlaceholderIndex() | Integer | Yer tutucu resmin dizinini döndürür. |
getPlaceholderType() | PlaceholderType | Resmin yer tutucu türünü veya şekil bir yer tutucu değilse PlaceholderType.NONE değerini döndürür. |
getRotation() | Number | Öğenin merkezi çevresindeki saat yönünde dönme açısını derece cinsinden döndürür. Sıfır derece, dönüş olmadığı anlamına gelir. |
getSourceUrl() | String | Varsa resmin kaynak URL'sini alır. |
getTitle() | String | Sayfa öğesinin alternatif metin başlığını döndürür. |
getTop() | Number | Öğe döndürme olduğunda sayfanın sol üst köşesinden ölçülen, öğenin dikey konumunu noktalar cinsinden alır. |
getTransform() | AffineTransform | Sayfa öğesinin dönüşümünü döndürür. |
getWidth() | Number | Öğenin genişliğini, nokta cinsinden döndürür. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun genişliğidir. |
preconcatenateTransform(transform) | Image | Sağlanan dönüşümü, sayfa öğesinin mevcut dönüşümüyle önceden birleştirir. |
remove() | void | Sayfa öğesini kaldırır. |
removeLink() | void | Bir Link kaldırır. |
replace(blobSource) | Image | Bu resmi, BlobSource nesnesi tarafından açıklanan bir resimle değiştirir. |
replace(blobSource, crop) | Image | Bu resmi, Image nesnesi tarafından açıklanan bir resimle değiştirir ve isteğe bağlı olarak resmi sığacak şekilde kırpar. |
replace(imageUrl) | Image | Bu resmi, sağlanan URL'den indirilen başka bir resimle değiştirir. |
replace(imageUrl, crop) | Image | Bu resmi, sağlanan URL'den indirilen başka bir resimle değiştirir ve isteğe bağlı olarak resmi sığacak şekilde kırpar. |
scaleHeight(ratio) | Image | Öğenin yüksekliğini belirtilen orana göre ölçeklendirir. |
scaleWidth(ratio) | Image | Öğenin genişliğini belirtilen orana göre ölçeklendirir. |
select() | void | Etkin sunuda yalnızca PageElement öğesini seçer ve önceki seçimleri kaldırır. |
select(replace) | void | Etkin sunuda PageElement öğesini seçer. |
sendBackward() | Image | Sayfa öğesini bir öğe tarafından sayfada geriye doğru gönderir. |
sendToBack() | Image | Sayfa öğesini sayfanın arkasına gönderir. |
setDescription(description) | Image | Sayfa öğesinin alternatif metin açıklamasını ayarlar. |
setHeight(height) | Image | Öğenin yüksekliğini noktalar halinde ayarlar. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun yüksekliğidir. |
setLeft(left) | Image | Öğenin yatay konumunu, öğe döndürme olduğunda sayfanın sol üst köşesinden ölçülen noktalar cinsinden ayarlar. |
setLinkSlide(slideIndex) | Link | Slaytın sıfır tabanlı dizinini kullanarak bir Link öğesini belirtilen Slide olarak ayarlar. |
setLinkSlide(slide) | Link | Link öğesini belirtilen Slide değerine ayarlarsa bağlantı, belirtilen slayt kimliğine göre ayarlanır. |
setLinkSlide(slidePosition) | Link | Slaytın göreli konumunu kullanarak belirli bir Slide için Link ayarlar. |
setLinkUrl(url) | Link | Belirli boş olmayan URL dizesine Link ayarlar. |
setRotation(angle) | Image | Öğenin merkezi etrafında saat yönünde dönme açısını derece cinsinden ayarlar. |
setTitle(title) | Image | Sayfa öğesinin alternatif metin başlığını ayarlar. |
setTop(top) | Image | Öğe döndürme olduğunda, sayfanın sol üst köşesinden ölçülen, öğenin dikey konumunu noktalar cinsinden ayarlar. |
setTransform(transform) | Image | Sağlanan dönüşümle sayfa öğesinin dönüşümünü ayarlar. |
setWidth(width) | Image | Öğenin genişliğini, noktalar halinde ayarlar. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun genişliğidir. |
Ayrıntılı belgeler
alignOnPage(alignmentPosition)
Öğeyi sayfada belirtilen hizalama konumuna hizalar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
alignmentPosition | AlignmentPosition | Bu sayfa öğesinin sayfada hizalanacağı konum. |
Return
Image
: Zincirleme için bu sayfa öğesi.
bringForward()
Sayfa öğesini sayfada bir öğe öne getirir.
Sayfa öğesi bir grupta olmamalıdır.
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
Sayfa öğesini sayfanın önüne getirir.
Sayfa öğesi bir grupta olmamalıdır.
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
duplicate()
Sayfa öğesini çoğaltır.
Sayfa kopyası öğesi aynı sayfaya, orijinalle aynı konuma yerleştirilir.
Return
PageElement
- Bu sayfa öğesinin yeni kopyası.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getAs(contentType)
Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün. Bu yöntem, dosya adına uygun uzantıyı ekler (örneğin, "dosyam.pdf"). Bununla birlikte, dosya adında son noktanın ardından gelen bölümün (varsa) değiştirilmesi gereken mevcut bir uzantı olduğu varsayılır. Sonuç olarak, "ShoppingList.12.25.2014", "ShoppingList.12.25.pdf" haline gelir.
Günlük dönüşüm kotalarını görüntülemek için Google Hizmetleri Kotalar bölümüne bakın. Yeni oluşturulan Google Workspace alanları geçici olarak daha sıkı kotalara tabi olabilir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
contentType | String | Dönüştürülecek MIME türü. Çoğu blob için geçerli tek seçenek 'application/pdf' 'tir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp' , 'image/gif' , 'image/jpeg' veya 'image/png' değerleri de geçerlidir. |
Return
Blob
: Blob halinde veriler.
getBlob()
getBorder()
Resmin Border
değerini döndürür.
Return
Border
: Resmin kenarlığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getConnectionSites()
Sayfa öğesindeki ConnectionSite
listesini veya sayfa öğesinin bağlantı sitesi yoksa boş bir liste döndürür.
Return
ConnectionSite[]
: Bağlantı siteleri listesi. Bu öğenin bağlantı sitesi yoksa boş olabilir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getContentUrl()
Resmin URL'sini alır.
Bu URL, istek sahibinin hesabıyla etiketlenir. Böylece URL'ye sahip herkes, resme orijinal istek sahibi olarak etkili bir şekilde erişir. Sununun paylaşım ayarları değişirse resme erişim kaybedilebilir. Döndürülen URL'nin süresi kısa bir süre sonra dolar.
Return
String
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDescription()
Sayfa öğesinin alternatif metin açıklamasını döndürür. Açıklama, alternatif metni görüntülemek ve okumak için başlıkla birleştirilir.
Return
String
: Sayfa öğesinin alternatif metin açıklamasıdır.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getHeight()
Öğenin yüksekliğini noktalar halinde alır. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun yüksekliğidir.
Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin bu yöntemle uyumlu olmadığını öğrenmek için boyutlandırma ve konumlandırma sınırlamalarına bakın.
Return
Number
: Sayfa öğesinin noktalar halinde doğal yüksekliği veya sayfa öğesinin yüksekliği yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentHeight()
Öğenin doğal yüksekliğini puan cinsinden döndürür.
Sayfa öğesinin dönüşümü, doğal boyutuna göre değişir. Öğenin nihai görsel görünümünü belirlemek için doğal boyutu öğenin dönüşümüyle birlikte kullanın.
Return
Number
: Sayfa öğesinin noktalar halinde doğal yüksekliği veya sayfa öğesinin yüksekliği yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentWidth()
Öğenin doğal genişliğini nokta cinsinden döndürür.
Sayfa öğesinin dönüşümü, doğal boyutuna göre değişir. Öğenin nihai görsel görünümünü belirlemek için doğal boyutu öğenin dönüşümüyle birlikte kullanın.
Return
Number
: Sayfa öğesinin noktalar cinsinden doğal genişliği veya sayfa öğesinin genişliği yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLeft()
Öğe hiç dönmediğinde sayfanın sol üst köşesinden ölçülen, öğenin yatay konumunu noktalar cinsinden döndürür.
Return
Number
: Bu öğenin, sayfanın sol üst köşesinden itibaren noktalar halinde yatay konumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLink()
Bağlantı yoksa Link
veya null
değerini döndürür.
var link = shape.getLink(); if (link != null) { Logger.log('Shape has a link of type: ' + link.getLinkType()); }
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getObjectId()
Bu nesnenin benzersiz kimliğini döndürür. Sayfalar ve sayfa öğeleri tarafından kullanılan nesne kimlikleri aynı ad alanını paylaşır.
Return
String
: Bu nesnenin benzersiz kimliği.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementType()
Sayfa öğesinin PageElementType
sıralamasıyla belirtilen türünü döndürür.
Return
PageElementType
: Sayfa öğesinin türü.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentGroup()
Bu sayfa öğesinin ait olduğu grubu veya öğe bir grupta yer almıyorsa null
değerini döndürür.
Return
Group
: Bu sayfa öğesinin ait olduğu grup veya null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentPage()
Bu sayfa öğesinin bulunduğu sayfayı döndürür.
Return
Page
: Bu öğenin bulunduğu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentPlaceholder()
Yer tutucunun üst sayfa öğesini döndürür. Resim bir yer tutucu değilse veya üst öğesi yoksa null
değerini döndürür.
Return
PageElement
: Bu resim yer tutucusunun üst sayfa öğesi; bu resim bir yer tutucu değilse veya üst öğesi yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderIndex()
Yer tutucu resmin dizinini döndürür. Aynı sayfadaki iki veya daha fazla yer tutucu resim aynı türdeyse her birinin benzersiz dizin değeri olur. Resim bir yer tutucu değilse null
değerini döndürür.
Return
Integer
— Bu resmin yer tutucu dizini veya resim bir yer tutucu değilse null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderType()
Resmin yer tutucu türünü veya şekil bir yer tutucu değilse PlaceholderType.NONE
değerini döndürür.
Return
PlaceholderType
: Bu resmin yer tutucu türü.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRotation()
Öğenin merkezi çevresindeki saat yönünde dönme açısını derece cinsinden döndürür. Sıfır derece, dönüş olmadığı anlamına gelir.
Return
Number
: 0 (dahil) ile 360 (hariç) arasında derece cinsinden dönüş açısı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSourceUrl()
Varsa resmin kaynak URL'sini alır.
URL ile bir resim eklendiğinde, resim ekleme sırasında sağlanan URL'yi döndürür.
Return
String
: Resmin URL'si veya resmin kaynak URL'si yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTitle()
Sayfa öğesinin alternatif metin başlığını döndürür. Başlık, alternatif metni görüntülemek ve okumak için açıklamayla birleştirilir.
Return
String
: Sayfa öğesinin alternatif metin başlığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTop()
Öğe döndürme olduğunda sayfanın sol üst köşesinden ölçülen, öğenin dikey konumunu noktalar cinsinden alır.
Return
Number
: Bu öğenin, sayfanın sol üst köşesinden itibaren noktalar halinde dikey konumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTransform()
Sayfa öğesinin dönüşümünü döndürür.
Sayfa öğesinin görsel görünümü, mutlak dönüşümüyle belirlenir. Mutlak dönüşümü hesaplamak için bir sayfa öğesinin dönüşümünü, tüm üst gruplarındaki dönüşümlerle önceden bağlayın. Sayfa öğesi bir grupta yer almıyorsa mutlak dönüşümü bu alandaki değerle aynıdır.
Return
AffineTransform
: Sayfa öğesinin dönüşümü.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWidth()
Öğenin genişliğini, nokta cinsinden döndürür. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun genişliğidir.
Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin bu yöntemle uyumlu olmadığını öğrenmek için boyutlandırma ve konumlandırma sınırlamalarına bakın.
Return
Number
: Sayfa öğesinin noktalar cinsinden doğal genişliği veya sayfa öğesinin genişliği yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenateTransform(transform)
Sağlanan dönüşümü, sayfa öğesinin mevcut dönüşümüyle önceden birleştirir.
newTransform = argument * existingTransform
Örneğin, bir sayfa öğesini 36 işaret edecek şekilde sola taşımak için:
element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder() .setTranslateX(-36.0) .build());
Ayrıca, sayfa öğesinin dönüşümünü setTransform(transform)
ile değiştirebilirsiniz.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
transform | AffineTransform | Bu sayfa öğesinin dönüşümüne önceden bağlanacak dönüşüm. |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Sayfa öğesini kaldırır.
Bir kaldırma işleminden sonra Group
yalnızca bir sayfa öğesi içeriyorsa veya hiç sayfa öğesi içermiyorsa grubun kendisi de kaldırılır.
Bir ana slaytta veya düzende PageElement
yer tutucusu kaldırılırsa devralınan boş yer tutucular da kaldırılır.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeLink()
Bir Link
kaldırır.
shape.removeLink();
replace(blobSource)
Bu resmi, BlobSource
nesnesi tarafından açıklanan bir resimle değiştirir.
Eklenen resim bir kez
BlobSource
üzerinden getirilir ve bir kopyası sunu içinde gösterilmek üzere saklanır.
Resimlerin boyutu 50 MB'tan küçük, 25 megapikseli aşmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.
Resmin en boy oranını korumak için resim mevcut resmin boyutuna göre ölçeklendirilir ve ortalanır.
var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); image.replace(driveImage);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
blobSource | BlobSource | Resim verileri. |
Return
Image
— Bu, değişimden sonra Image
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(blobSource, crop)
Bu resmi, Image
nesnesi tarafından açıklanan bir resimle değiştirir ve isteğe bağlı olarak resmi sığacak şekilde kırpar.
Eklenen resim bir kez
BlobSource
üzerinden getirilir ve bir kopyası sunu içinde gösterilmek üzere saklanır.
Resimlerin boyutu 50 MB'tan küçük, 25 megapikseli aşmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.
var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); // Replace and crop the drive image. image.replace(driveImage, true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
blobSource | BlobSource | Resim verileri. |
crop | Boolean | true ise resmi mevcut resmin boyutuna sığacak şekilde kırpar. Aksi takdirde, resim ölçeklendirilir ve ortalanır. |
Return
Image
— Bu, değişimden sonra Image
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl)
Bu resmi, sağlanan URL'den indirilen başka bir resimle değiştirir.
Eklenen resim bir kez URL'den getirilir ve bir kopyası sunuda görüntülenmek üzere saklanır. Resimlerin boyutu 50 MB'tan küçük, 25 megapikseli aşmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.
Sağlanan URL, herkesin erişimine açık olmalı ve 2 kB'tan büyük olmamalıdır. URL'nin kendisi resimle birlikte kaydedilir ve getSourceUrl()
aracılığıyla gösterilir.
Resmin en boy oranını korumak için resim mevcut resmin boyutuna göre ölçeklendirilir ve ortalanır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
imageUrl | String | Görselin indirileceği URL. |
Return
Image
— Bu, değişimden sonra Image
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl, crop)
Bu resmi, sağlanan URL'den indirilen başka bir resimle değiştirir ve isteğe bağlı olarak resmi sığacak şekilde kırpar.
Eklenen resim bir kez URL'den getirilir ve bir kopyası sunuda görüntülenmek üzere saklanır. Resimlerin boyutu 50 MB'tan küçük, 25 megapikseli aşmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.
Sağlanan URL 2 kB'tan büyük olmamalıdır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
imageUrl | String | Görselin indirileceği URL. |
crop | Boolean | true ise resmi mevcut resmin boyutuna sığacak şekilde kırpar. Aksi takdirde, resim ölçeklendirilir ve ortalanır. |
Return
Image
— Bu, değişimden sonra Image
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleHeight(ratio)
Öğenin yüksekliğini belirtilen orana göre ölçeklendirir. Öğenin yüksekliği, öğe döndürme olduğunda sınırlayıcı kutusunun yüksekliğidir.
Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin bu yöntemle uyumlu olmadığını öğrenmek için boyutlandırma ve konumlandırma sınırlamalarına bakın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
ratio | Number | Bu sayfa öğesinin yüksekliğini ölçeklendirme oranı. |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
Öğenin genişliğini belirtilen orana göre ölçeklendirir. Öğenin genişliği, öğe döndürme olduğunda sınırlayıcı kutusunun genişliğidir.
Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin bu yöntemle uyumlu olmadığını öğrenmek için boyutlandırma ve konumlandırma sınırlamalarına bakın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
ratio | Number | Bu sayfa öğesinin genişliğini ölçekleme oranı. |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
Etkin sunuda yalnızca PageElement
öğesini seçer ve önceki seçimleri kaldırır. Bu, true
ile select(replace)
numarasını aramak ile aynıdır.
Bir komut dosyası yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve komut dosyasının sunuya bağlı olması gerekir.
Bu işlem, PageElement
öğesinin üst Page
öğesini current page selection
olarak ayarlar.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var pageElement = slide.getPageElements()[0]; // Only select this page element and replace any previous selection. pageElement.select();
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select(replace)
Etkin sunuda PageElement
öğesini seçer.
Bir komut dosyası yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve komut dosyasının sunuya bağlı olması gerekir.
Yalnızca PageElement
öğesini seçmek ve önceki seçimleri kaldırmak için bu yönteme true
iletin. Bu işlem, PageElement
öğesinin üst Page
öğesini de current page selection
olarak ayarlar.
Birden çok PageElement
nesnesi seçmek için false
değerini geçirin. PageElement
nesneleri aynı Page
içinde olmalıdır.
false
parametresi kullanılarak sayfa öğesi seçilirken aşağıdaki koşullar karşılanmalıdır:
PageElement
nesnesinin üstPage
öğesicurrent page selection
olmalıdır.- Birden fazla
Page
nesnesi seçilmemelidir.
Bu durumun söz konusu olduğundan emin olmak için tercih edilen yaklaşım, önce Page.selectAsCurrentPage()
kullanarak üst Page
öğesini, ardından bu sayfadaki sayfa öğelerini seçmektir.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // First select the slide page, as the current page selection. slide.selectAsCurrentPage(); // Then select all the page elements in the selected slide page. var pageElements = slide.getPageElements(); for (var i = 0; i < pageElements.length; i++) { pageElements[i].select(false); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
replace | Boolean | true ise önceki seçimlerin yerini alır; aksi takdirde önceki seçimlere eklenir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
Sayfa öğesini bir öğe tarafından sayfada geriye doğru gönderir.
Sayfa öğesi bir grupta olmamalıdır.
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendToBack()
Sayfa öğesini sayfanın arkasına gönderir.
Sayfa öğesi bir grupta olmamalıdır.
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setDescription(description)
Sayfa öğesinin alternatif metin açıklamasını ayarlar.
Yöntem, Group
öğeleri için desteklenmiyor.
// Set the first page element's alt text description to "new alt text description". var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setDescription('new alt text description'); Logger.log(pageElement.getDescription());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
description | String | Alternatif metin açıklamasının ayarlanacağı dize. |
Return
Image
— Bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
Öğenin yüksekliğini noktalar halinde ayarlar. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun yüksekliğidir.
Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin bu yöntemle uyumlu olmadığını öğrenmek için boyutlandırma ve konumlandırma sınırlamalarına bakın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
height | Number | Bu sayfa öğesinin nokta cinsinden ayarlanacak yeni yüksekliği. |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
Öğenin yatay konumunu, öğe döndürme olduğunda sayfanın sol üst köşesinden ölçülen noktalar cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
left | Number | Nokta cinsinden ayarlanacak yeni yatay konum. |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slideIndex)
Slaytın sıfır tabanlı dizinini kullanarak bir Link
öğesini belirtilen Slide
olarak ayarlar.
// Set a link to the first slide of the presentation. shape.setLinkSlide(0);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
slideIndex | Integer | Slaytın sıfır tabanlı dizini. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slide)
Link
öğesini belirtilen Slide
değerine ayarlarsa bağlantı, belirtilen slayt kimliğine göre ayarlanır.
// Set a link to the first slide of the presentation. var slide = presentation.getSlides()[0]; shape.setLinkSlide(slide);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
slide | Slide | Bağlanacak Slide . |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slidePosition)
Slaytın göreli konumunu kullanarak belirli bir Slide
için Link
ayarlar.
// Set a link to the first slide of the presentation. shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
slidePosition | SlidePosition | Göreli SlidePosition . |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkUrl(url)
Belirli boş olmayan URL dizesine Link
ayarlar.
// Set a link to the URL. shape.setLinkUrl("https://slides.google.com");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
url | String | URL dizesi. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setRotation(angle)
Öğenin merkezi etrafında saat yönünde dönme açısını derece cinsinden ayarlar.
Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin bu yöntemle uyumlu olmadığını öğrenmek için boyutlandırma ve konumlandırma sınırlamalarına bakın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
angle | Number | Derece cinsinden ayarlanacak yeni saat yönünde dönme açısı. |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTitle(title)
Sayfa öğesinin alternatif metin başlığını ayarlar.
Yöntem, Group
öğeleri için desteklenmiyor.
// Set the first page element's alt text title to "new alt text title". var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setTitle('new alt text title'); Logger.log(pageElement.getTitle());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
title | String | Alternatif metin başlığının ayarlanacağı dize. |
Return
Image
— Bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
Öğe döndürme olduğunda, sayfanın sol üst köşesinden ölçülen, öğenin dikey konumunu noktalar cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
top | Number | Nokta cinsinden ayarlanacak yeni dikey konum. |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
Sağlanan dönüşümle sayfa öğesinin dönüşümünü ayarlar.
Bir grubun dönüşümünün güncellenmesi, söz konusu gruptaki sayfa öğelerinin mutlak dönüşümünü değiştirir ve bu da görsel görünümlerini değiştirebilir.
Bir gruptaki sayfa öğesinin dönüşümünü güncellemek yalnızca söz konusu sayfa öğesinin dönüşümünü değiştirir. Grubun veya gruptaki diğer sayfa öğelerinin dönüşümlerini etkilemez.
Dönüşümlerin, sayfa öğelerinin görsel görünümünü nasıl etkilediğiyle ilgili ayrıntılar için getTransform()
bölümüne bakın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
transform | AffineTransform | Bu sayfa öğesi için ayarlanan dönüşüm. |
Return
Image
: Zincirleme için bu öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
Öğenin genişliğini, noktalar halinde ayarlar. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun genişliğidir.
Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin bu yöntemle uyumlu olmadığını öğrenmek için boyutlandırma ve konumlandırma sınırlamalarına bakın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
width | Number | Bu sayfa öğesinin nokta cinsinden ayarlanacak yeni genişliği. |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations