Bir resmi temsil eden PageElement
.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
alignOnPage(alignmentPosition) | Image | Öğeyi sayfadaki belirtilen hizalama konumuna getirir. |
bringForward() | Image | Sayfa öğesini bir öğe ileri getirir. |
bringToFront() | Image | Sayfa öğesini sayfanın önüne getirir. |
duplicate() | PageElement | Sayfa öğesini kopyalar. |
getAs(contentType) | Blob | Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürme. |
getBlob() | Blob | Bu resmin içindeki verileri bir blob olarak döndürür. |
getBorder() | Border | Resmin Border değerini döndürür. |
getConnectionSites() | ConnectionSite[] | Sayfa öğesindeki ConnectionSite öğelerinin listesini veya sayfa öğesinde bağlantı sitesi yoksa boş bir listeyi 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 cinsinden alır. Bu değer, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun yüksekliğidir. |
getInherentHeight() | Number | Öğenin doğal yüksekliğini noktalar cinsinden döndürür. |
getInherentWidth() | Number | Öğenin doğal genişliğini noktalar cinsinden döndürür. |
getLeft() | Number | Öğenin yatay konumunu, öğe döndürülmemişken sayfanın sol üst köşesinden ölçülen 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 türünü PageElementType enum olarak döndürür. |
getParentGroup() | Group | Bu sayfa öğesinin ait olduğu grubu veya öğe bir grupta değilse 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 dizin numarasını döndürür. |
getPlaceholderType() | PlaceholderType | Resmin yer tutucu türünü döndürür veya şekil bir yer tutucu değilse PlaceholderType.NONE değerini döndürür. |
getRotation() | Number | Öğenin merkezi etrafında saat yönünde dönme açısını derece cinsinden döndürür. Sıfır derece, dönme 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 | Öğenin dikey konumunu, öğede rotasyon olmadığında sayfanın sol üst köşesinden ölçülen noktalar cinsinden alır. |
getTransform() | AffineTransform | Sayfa öğesinin dönüştürme işlemini döndürür. |
getWidth() | Number | Öğenin genişliğini nokta cinsinden döndürür. Bu değer, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun genişliğidir. |
preconcatenateTransform(transform) | Image | Sağlanan dönüştürme işlemini, sayfa öğesinin mevcut dönüştürme işlemiyle önceden birleştirir. |
remove() | void | Sayfa öğesini kaldırır. |
removeLink() | void | Bir Link kaldırılır. |
replace(blobSource) | Image | Bu resmi, BlobSource nesnesi tarafından tanımlanan bir resimle değiştirir. |
replace(blobSource, crop) | Image | Bu resmi, isteğe bağlı olarak sığacak şekilde kırparak Image nesnesi tarafından tanımlanan bir resimle değiştirir. |
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ığdıracak şekilde kırpar. |
scaleHeight(ratio) | Image | Öğenin yüksekliğini belirtilen orana göre ölçekler. |
scaleWidth(ratio) | Image | Öğenin genişliğini belirtilen orana göre ölçekler. |
select() | void | Etkin sunudaki yalnızca PageElement seçeneğini belirler ve önceki tüm seçimleri kaldırır. |
select(replace) | void | Etkin sunudaki PageElement 'ü seçer. |
sendBackward() | Image | Sayfa öğesini bir öğe geriye 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 nokta cinsinden ayarlar. Bu değer, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun yüksekliğidir. |
setLeft(left) | Image | Öğenin yatay konumunu, öğe döndürülmemişken sayfanın sol üst köşesinden ölçülen noktalar cinsinden ayarlar. |
setLinkSlide(slideIndex) | Link | Slaytın sıfır tabanlı dizini kullanılarak belirli bir Slide için Link ayarlanır. |
setLinkSlide(slide) | Link | Belirtilen Link için bir Slide ayarlar. Bağlantı, belirtilen slayt kimliğine göre ayarlanır. |
setLinkSlide(slidePosition) | Link | Slaytın göreli konumunu kullanarak Link öğesini belirli bir Slide öğesine ayarlar. |
setLinkUrl(url) | Link | Belirtilen boş olmayan URL dizesine bir Link ayarlar. |
setRotation(angle) | Image | Öğenin merkezi etrafında saat yönünde dönme açısını derece cinsinden belirler. |
setTitle(title) | Image | Sayfa öğesinin alternatif metin başlığını ayarlar. |
setTop(top) | Image | Öğenin dikey konumunu, öğe döndürülmemişken sayfanın sol üst köşesinden ölçülen noktalar cinsinden ayarlar. |
setTransform(transform) | Image | Sayfa öğesinin dönüştürme işlemini, sağlanan dönüştürme işlemiyle ayarlar. |
setWidth(width) | Image | Öğenin genişliğini nokta cinsinden ayarlar. Bu değer, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun genişliğidir. |
Ayrıntılı dokümanlar
alignOnPage(alignmentPosition)
Öğeyi sayfadaki belirtilen hizalama konumuna getirir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
alignmentPosition | AlignmentPosition | Bu sayfa öğesinin sayfa üzerinde hizalanacağı konum. |
Return
Image
: Zincirleme için bu sayfa öğesi.
bringForward()
Sayfa öğesini bir öğe ileri getirir.
Sayfa öğesi bir grupta olmamalıdır.
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
duplicate()
Sayfa öğesini kopyalar.
Kopya sayfa öğesi, orijinaliyle aynı sayfaya ve aynı konuma yerleştirilir.
Return
PageElement
: Bu sayfa öğesinin yeni kopyası.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ürme. Bu yöntem, dosya adına uygun uzantıyı ekler (ör. "dosyam.pdf"). Ancak, dosya adının son noktayı (varsa) izleyen kısmının, değiştirilmesi gereken mevcut bir uzantı olduğu varsayılır. Sonuç olarak, "AlışverişListesi.25.12.2014", "AlışverişListesi.25.12.pdf" olur.
Dönüşümler için günlük kotaları görüntülemek istiyorsanız Google Hizmetleri için kotalar başlıklı makaleyi inceleyin. Yeni oluşturulan Google Workspace alanları geçici olarak daha katı kotalara tabi olabilir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
contentType | String | Dönüştürülecek MIME türü. Çoğu blob için 'application/pdf' tek geçerli seçenektir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp' , 'image/gif' , 'image/jpeg' veya 'image/png' değerlerinden herhangi biri de geçerlidir. Google Dokümanlar dokümanları için 'text/markdown' de geçerlidir. |
Return
Blob
: Veriler bir blob olarak.
getBlob()
getBorder()
Resmin Border
değerini döndürür.
Return
Border
: Resmin kenarı.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getConnectionSites()
Sayfa öğesindeki ConnectionSite
öğelerinin listesini veya sayfa öğesinde bağlantı sitesi yoksa boş bir listeyi döndürür.
Return
ConnectionSite[]
: Bağlantı siteleri listesi. Bu öğenin bağlantı sitesi yoksa liste boş olabilir.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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 etiketlendiğinden, URL'ye sahip olan herkes resme orijinal istek sahibi olarak erişebilir. 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ı.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getHeight()
Öğenin yüksekliğini noktalar cinsinden alır. Bu değer, öğe döndürülmediğinde öğ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ı bölümüne bakın.
Return
Number
: Sayfa öğesinin nokta cinsinden doğal yüksekliği veya sayfa öğesinin yüksekliği yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentHeight()
Öğenin doğal yüksekliğini noktalar cinsinden döndürür.
Sayfa öğesinin dönüşümü, kendi boyutuna göredir. Öğenin nihai görsel görünümünü belirlemek için öğenin dönüştürme özelliğiyle birlikte doğal boyutu kullanın.
Return
Number
: Sayfa öğesinin nokta cinsinden doğal yüksekliği veya sayfa öğesinin yüksekliği yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentWidth()
Öğenin doğal genişliğini noktalar cinsinden döndürür.
Sayfa öğesinin dönüşümü, kendi boyutuna göredir. Öğenin nihai görsel görünümünü belirlemek için öğenin dönüştürme özelliğiyle birlikte doğal boyutu kullanın.
Return
Number
: Sayfa öğesinin nokta cinsinden doğal genişliği veya sayfa öğesinin genişliği yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLeft()
Öğenin yatay konumunu, öğe döndürülmemişken sayfanın sol üst köşesinden ölçülen noktalar cinsinden döndürür.
Return
Number
: Bu öğenin, sayfanın sol üst köşesine göre yatay konumu (noktalar cinsinden).
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; const link = shape.getLink(); if (link != null) { Logger.log(`Shape has a link of type: ${link.getLinkType()}`); }
Return
Link
: Bağlantı yoksa Link
veya null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementType()
Sayfa öğesinin türünü PageElementType
enum olarak döndürür.
Return
PageElementType
: Sayfa öğesinin türü.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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 değilse 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentPlaceholder()
Yer tutucunun üst sayfa öğesini döndürür. Resim yer tutucu değilse veya üst öğesi yoksa null
döndürür.
Return
PageElement
: Bu resim yer tutucusunun üst sayfa öğesi veya bu resim yer tutucu değilse ya da üst öğesi yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderIndex()
Yer tutucu resmin dizin numarasını döndürür. Aynı sayfada iki veya daha fazla yer tutucu resim aynı türdeyse her birinin benzersiz bir dizin değeri vardır. Resim bir yer tutucu değilse null
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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderType()
Resmin yer tutucu türünü döndürür 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRotation()
Öğenin merkezi etrafında saat yönünde dönme açısını derece cinsinden döndürür. Sıfır derece, dönme olmadığı anlamına gelir.
Return
Number
: Derece cinsinden dönüş açısı. 0 (dahil) ile 360 (hariç) arasındadır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSourceUrl()
Varsa resmin kaynak URL'sini alır.
Bir resim URL ile 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTop()
Öğenin dikey konumunu, öğede rotasyon olmadığında sayfanın sol üst köşesinden ölçülen noktalar cinsinden alır.
Return
Number
: Bu öğenin, sayfanın sol üst köşesine göre nokta cinsinden dikey konumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTransform()
Sayfa öğesinin dönüştürme işlemini döndürür.
Sayfa öğesinin görsel görünümü, mutlak dönüşümüne göre belirlenir. Mutlak dönüşümü hesaplamak için bir sayfa öğesinin dönüşümünü, tüm üst gruplarının dönüşümleriyle önceden birleştirin. Sayfa öğesi bir grupta değilse 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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 değer, öğe döndürülmediğinde öğ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ı bölümüne bakın.
Return
Number
: Sayfa öğesinin nokta cinsinden doğal genişliği veya sayfa öğesinin genişliği yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenateTransform(transform)
Sağlanan dönüştürme işlemini, sayfa öğesinin mevcut dönüştürme işlemiyle önceden birleştirir.
newTransform = argument * existingTransform;
Örneğin, bir sayfa öğesini 36 nokta sola taşımak için:
const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; element.preconcatenateTransform( SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(), );
Sayfa öğesinin dönüştürme özelliğini setTransform(transform)
ile de değiştirebilirsiniz.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
transform | AffineTransform | Bu sayfa öğesinin dönüştürme işlemine önceden birleştirilecek dönüştürme işlemi. |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
Sayfa öğesini kaldırır.
Bir kaldırma işleminin ardından Group
yalnızca bir sayfa öğesi veya hiç sayfa öğesi içermiyorsa grubun kendisi de kaldırılır.
Bir ana öğede veya düzende yer tutucu PageElement
kaldırılırsa devralan boş yer tutucular da kaldırılır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeLink()
Bir Link
kaldırılır.
const slides = SlidesApp.getActivePresentation().getSlides(); slides[1].getShapes()[0].removeLink();
replace(blobSource)
Bu resmi, BlobSource
nesnesi tarafından tanımlanan bir resimle değiştirir.
Resim eklendiğinde
BlobSource
kaynağından bir kez alınır ve sunu içinde gösterilmek üzere bir kopyası saklanır.
Resimler 50 MB'tan küçük, 25 megapikselden büyük olmamalı 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 ortalanmalıdır.
const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. const driveImage = DriveApp.getFileById("123abc"); image.replace(driveImage);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
blobSource | BlobSource | Resim verileri. |
Return
Image
: Değişimden sonraki Image
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(blobSource, crop)
Bu resmi, isteğe bağlı olarak sığacak şekilde kırparak Image
nesnesi tarafından tanımlanan bir resimle değiştirir.
Resim eklendiğinde
BlobSource
kaynağından bir kez alınır ve sunu içinde gösterilmek üzere bir kopyası saklanır.
Resimler 50 MB'tan küçük, 25 megapikselden büyük olmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.
const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. const driveImage = DriveApp.getFileById('123abc'); // 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
: Değişimden sonra bu Image
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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.
Resim eklendiğinde URL'den bir kez alınır ve sunumda gösterilmek üzere bir kopyası depolanır. Resimler 50 MB'tan küçük, 25 megapikselden büyük olmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.
Sağlanan URL herkese açık olmalı ve 2 KB'tan büyük olmamalıdır. URL, resimle birlikte kaydedilir ve getSourceUrl()
üzerinden gösterilir.
Resmin en boy oranını korumak için resim, mevcut resmin boyutuna göre ölçeklendirilir ve ortalanırsa.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
imageUrl | String | Resmin indirileceği URL. |
Return
Image
: Değişimden sonra bu Image
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ığdıracak şekilde kırpar.
Resim eklendiğinde URL'den bir kez alınır ve sunumda gösterilmek üzere bir kopyası depolanır. Resimler 50 MB'tan küçük, 25 megapikselden büyük olmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.
Sağlanan URL en fazla 2 KB olmalıdır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
imageUrl | String | Resmin 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
: Değişimden sonraki Image
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleHeight(ratio)
Öğenin yüksekliğini belirtilen orana göre ölçekler. Öğenin yüksekliği, öğe döndürülmemişken 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ı bölümüne bakın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
ratio | Number | Bu sayfa öğesinin yüksekliğinin ölçeklendirileceği oran. |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
Öğenin genişliğini belirtilen orana göre ölçekler. Öğenin genişliği, öğe döndürülmediğinde 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ı bölümüne bakın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
ratio | Number | Bu sayfa öğesinin genişliğinin ölçekleneceği oran. |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
Etkin sunudaki yalnızca PageElement
seçeneğini belirler ve önceki tüm seçimleri kaldırır. Bu, select(replace)
işlevini true
ile çağırmaya eşdeğerdir.
Bir komut dosyası, yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve bu da komut dosyası sunucuya bağlıysa geçerlidir.
Bu işlem, PageElement
öğesinin üst öğesi Page
'yi current page selection
olarak ayarlar.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = slide.getPageElements()[0]; // Only select this page element and replace any previous selection. pageElement.select();
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select(replace)
Etkin sunudaki PageElement
'ü seçer.
Bir komut dosyası, yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve bu da komut dosyası sunucuya bağlıysa geçerlidir.
Yalnızca PageElement
'yi seçmek ve önceki seçimleri kaldırmak için bu yönteme true
'yi iletin. Bu işlem, PageElement
öğesinin üst öğesi Page
'ü de current page selection
olarak ayarlar.
Birden fazla PageElement
nesnesi seçmek için false
değerini iletin. PageElement
nesneleri aynı Page
içinde olmalıdır.
false
parametresi kullanılarak bir sayfa öğesi seçilirken aşağıdaki koşullar karşılanmalıdır:
PageElement
nesnesinin üst öğesiPage
,current page selection
olmalıdır.- Birden fazla
Page
nesnesi seçili olmamalıdır.
Bu durumdan emin olmak için tercih edilen yaklaşım, önce Page.selectAsCurrentPage()
kullanarak üst öğeyi Page
seçip ardından bu sayfadaki sayfa öğelerini seçmektir.
const 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. const pageElements = slide.getPageElements(); for (let i = 0; i < pageElements.length; i++) { pageElements[i].select(false); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
replace | Boolean | true ise seçim önceki seçimin yerini alır. Aksi takdirde seçim önceki seçime eklenir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
Sayfa öğesini bir öğe geriye gönderir.
Sayfa öğesi bir grupta olmamalıdır.
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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 desteklenmez.
// Set the first page element's alt text description to "new alt text // description". const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
Öğenin yüksekliğini nokta cinsinden ayarlar. Bu değer, öğe döndürülmediğinde öğ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ı bölümüne bakın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
height | Number | Ayarlanacak bu sayfa öğesinin yeni yüksekliği (noktada). |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
Öğenin yatay konumunu, öğe döndürülmemişken sayfanın sol üst köşesinden ölçülen noktalar cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
left | Number | Ayarlanacak yeni yatay konum (noktalar cinsinden). |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slideIndex)
Slaytın sıfır tabanlı dizini kullanılarak belirli bir Slide
için Link
ayarlanır.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slide)
Belirtilen Link
için bir Slide
ayarlar. Bağlantı, belirtilen slayt kimliğine göre ayarlanır.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(slides[0]);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
slide | Slide | Bağlanacak Slide . |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slidePosition)
Slaytın göreli konumunu kullanarak Link
öğesini belirli bir Slide
öğesine ayarlar.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
slidePosition | SlidePosition | Göreli SlidePosition . |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkUrl(url)
Belirtilen boş olmayan URL dizesine bir Link
ayarlar.
// Set a link to the URL. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkUrl('https://slides.google.com');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
url | String | URL dizesi. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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 belirler.
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ı bölümüne bakın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
angle | Number | Ayarlanacak yeni saat yönünde dönüş açısı (derece cinsinden). |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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 desteklenmez.
// Set the first page element's alt text title to "new alt text title". const 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ı ayarlamak için kullanılacak dize. |
Return
Image
: Bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
Öğenin dikey konumunu, öğe döndürülmemişken sayfanın sol üst köşesinden ölçülen noktalar cinsinden ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
top | Number | Ayarlanacak yeni dikey konum (noktalar cinsinden). |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
Sayfa öğesinin dönüştürme işlemini, sağlanan dönüştürme işlemiyle ayarlar.
Bir grubun dönüştürme işleminin güncellenmesi, söz konusu gruptaki sayfa öğelerinin mutlak dönüştürme işlemini değiştirir. Bu da öğelerin görsel görünümünü değiştirebilir.
Bir gruptaki sayfa öğesinin dönüştürme işlemini güncellemek yalnızca ilgili sayfa öğesinin dönüştürme işlemini değiştirir. Grubun veya gruptaki diğer sayfa öğelerinin dönüştürme işlemlerini etkilemez.
Dönüşümlerin sayfa öğelerinin görsel görünümünü nasıl etkilediği hakkında ayrıntılı bilgi 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üştürme. |
Return
Image
: Zincirleme için bu öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
Öğenin genişliğini nokta cinsinden ayarlar. Bu değer, öğe döndürülmediğinde öğ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ı bölümüne bakın.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
width | Number | Ayarlanacak bu sayfa öğesinin yeni genişliği (punto cinsinden). |
Return
Image
: Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations