Daha ayrıntılı bir sınıflandırması olmayan genel bir şekli temsil eden PageElement
. Metin kutuları, dikdörtgenler ve diğer önceden tanımlanmış şekiller içerir.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
alignOnPage(alignmentPosition) | Shape | Öğeyi, sayfada belirtilen hizalama konumuna hizalar. |
bringForward() | Shape | Sayfa öğesini bir öğe ilerletir. |
bringToFront() | Shape | Sayfa öğesini sayfanın ön tarafına getirir. |
duplicate() | PageElement | Sayfa öğesini kopyalar. |
getAutofit() | Autofit | Bu şekil içindeki metnin Autofit değerini döndürür. |
getBorder() | Border | Şeklin Border değerini döndürür. |
getConnectionSites() | ConnectionSite[] | Sayfa öğesindeki ConnectionSite listesini veya sayfa öğesinin herhangi bir bağlantı sitesi yoksa boş listeyi döndürür. |
getContentAlignment() | ContentAlignment | Şekildeki metnin ContentAlignment değerini döndürür. |
getDescription() | String | Sayfa öğesinin alternatif metin açıklamasını döndürür. |
getFill() | Fill | Şeklin Fill değerini döndürür. |
getHeight() | Number | Öğenin, nokta cinsinden yüksekliğini alır. Bu değer, öğenin dönmesi olmadığında öğenin sınırlayıcı kutusunun yüksekliğidir. |
getInherentHeight() | Number | Öğenin doğal yüksekliğini punto cinsinden döndürür. |
getInherentWidth() | Number | Öğenin doğal genişliğini punto olarak döndürür. |
getLeft() | Number | Öğenin, öğe döndürülmediğinde sayfanın sol üst köşesinden ölçülen, noktalar cinsinden yatay konumunu 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ı ile temsil edilen türünü döndürür. |
getParentGroup() | Group | Bu sayfa öğesinin ait olduğu grubu veya öğe bir grupta bulunmuyorsa 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 | Şeklin yer tutucu dizinini döndürür. |
getPlaceholderType() | PlaceholderType | Şeklin yer tutucu türünü 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önüş açısını derece cinsinden döndürür. Burada sıfır derece, döndürme olmadığı anlamına gelir. |
getShapeType() | ShapeType | Şeklin türünü döndürür. |
getText() | TextRange | Şeklin metin içeriğini döndürür. |
getTitle() | String | Sayfa öğesinin alternatif metin başlığını döndürür. |
getTop() | Number | Öğenin, öğe döndürmediği durumlarda sayfanın sol üst köşesinden ölçülen, noktalardaki dikey konumunu alır. |
getTransform() | AffineTransform | Sayfa öğesinin dönüşümünü döndürür. |
getWidth() | Number | Nokta cinsinden öğenin genişliğini döndürür. Bu değer, öğede rotasyon olmadığında öğenin sınırlayıcı kutusunun genişliğidir. |
preconcatenateTransform(transform) | Shape | Sağlanan dönüşümü, sayfa öğesinin mevcut dönüşümüyle önceden birleştirir. |
remove() | void | Sayfa öğesini kaldırır. |
removeLink() | void | Link kaldırılır. |
replaceWithImage(blobSource) | Image | Bu şekli, BlobSource tarafından sağlanan bir resimle değiştirir. |
replaceWithImage(blobSource, crop) | Image | Bu şekli, BlobSource tarafından sağlanan bir resimle değiştirir. |
replaceWithImage(imageUrl) | Image | Bu şekli bir resimle değiştirir. |
replaceWithImage(imageUrl, crop) | Image | Bu şekli bir resimle değiştirir. |
replaceWithSheetsChart(sourceChart) | SheetsChart | Bu şekli bir Google E-Tablolar grafiğiyle değiştirir. |
replaceWithSheetsChartAsImage(sourceChart) | Image | Bu şekli bir Google E-Tablolar grafiği resmiyle değiştirir. |
scaleHeight(ratio) | Shape | Öğenin yüksekliğini belirtilen orana göre ölçeklendirir. |
scaleWidth(ratio) | Shape | Öğ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 sunudaki PageElement öğesini seçer. |
sendBackward() | Shape | Sayfa öğesini bir öğe geri gönderir. |
sendToBack() | Shape | Sayfa öğesini sayfanın arkasına gönderir. |
setContentAlignment(contentAlignment) | Shape | Şekildeki metnin ContentAlignment özelliğini ayarlar. |
setDescription(description) | Shape | Sayfa öğesinin alternatif metin açıklamasını ayarlar. |
setHeight(height) | Shape | Öğenin yüksekliğini noktalar olarak ayarlar. Bu değer, öğenin dönmesi olmadığı durumda öğeyi sınırlayıcı kutusunun yüksekliğidir. |
setLeft(left) | Shape | Öğenin, öğe döndürmediği durumlarda sayfanın sol üst köşesinden ölçülen noktalardaki yatay konumunu ayarlar. |
setLinkSlide(slideIndex) | Link | Slaytın sıfır tabanlı dizinini kullanarak belirtilen Slide için bir Link ayarlar. |
setLinkSlide(slide) | Link | Belirtilen Slide öğesine bir Link ayarlar. Bağlantı, belirtilen slayt kimliğine göre ayarlanır. |
setLinkSlide(slidePosition) | Link | Slaytın göreli konumunu kullanarak, belirtilen Slide için bir Link ayarlar. |
setLinkUrl(url) | Link | Belirtilen boş olmayan URL dizesine bir Link ayarlar. |
setRotation(angle) | Shape | Öğenin saat yönünün çevresindeki dönme açısını derece cinsinden ayarlar. |
setTitle(title) | Shape | Sayfa öğesinin alternatif metin başlığını ayarlar. |
setTop(top) | Shape | Öğenin, öğe döndürmediği durumlarda sayfanın sol üst köşesinden ölçülen noktalardaki dikey konumunu ayarlar. |
setTransform(transform) | Shape | Sağlanan dönüşümle sayfa öğesinin dönüşümünü ayarlar. |
setWidth(width) | Shape | Noktalar cinsinden öğenin genişliğini ayarlar. Bu, öğenin dönmesi olmadığı durumda öğ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
Shape
— Zincirleme için bu sayfa öğesi.
bringForward()
Sayfa öğesini bir öğe ilerletir.
Sayfa öğesi bir grupta yer almamalıdır.
Return
Shape
— Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 tarafına getirir.
Sayfa öğesi bir grupta yer almamalıdır.
Return
Shape
— Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
duplicate()
Sayfa öğesini kopyalar.
Kopya sayfa öğ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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getAutofit()
Bu şekil içindeki metnin Autofit
değerini döndürür. Şekil metne izin vermiyorsa
bu değer null
olur.
Return
Autofit
— Bu şekil içindeki metnin otomatik sığdırılması.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getBorder()
Şeklin Border
değerini döndürür.
Return
Border
— Bu şeklin kenarlık ayarı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 herhangi bir bağlantı sitesi yoksa boş listeyi 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getContentAlignment()
Şekildeki metnin ContentAlignment
değerini döndürür.
Return
ContentAlignment
— Bu şekil içindeki metnin hizalaması.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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östermek 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getFill()
Şeklin Fill
değerini döndürür.
Return
Fill
— Bu şeklin dolgu ayarı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getHeight()
Öğenin, nokta cinsinden yüksekliğini alır. Bu değer, öğenin dönmesi 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 noktalardaki doğal yüksekliği veya sayfa öğesinin yüksekliği yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 punto 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 noktalardaki doğal yüksekliği veya sayfa öğesinin yüksekliği yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 punto olarak 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 noktalardaki doğal genişliği veya sayfa öğesinin genişliği yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLeft()
Öğenin, öğe döndürülmediğinde sayfanın sol üst köşesinden ölçülen, noktalar cinsinden yatay konumunu döndürür.
Return
Number
: Bu öğenin, sayfanın sol üst köşesinden noktalar halinde yatay konumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 kapsamlardan bir 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 kapsamlardan bir 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ı ile temsil edilen türünü döndürür.
Return
PageElementType
: Sayfa öğesinin türü.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 bulunmuyorsa 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 kapsamlardan bir 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 kapsamlardan bir 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. Şekil bir yer tutucu değilse veya bir üst öğe yoksa null
değerini döndürür.
Return
PageElement
— Bu şekil yer tutucusunun üst sayfa öğesi veya bu şeklin bir yer tutucusu yoksa ya da bir üst öğesi yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderIndex()
Şeklin yer tutucu dizinini döndürür. Aynı sayfada aynı yer tutucu türüne ait iki veya daha fazla örnek varsa her birinin kendi benzersiz dizin değeri olur. Şekil bir yer tutucu değilse null
değerini döndürür.
Return
Integer
— Bu şeklin yer tutucu dizinidir. (Şekil bir yer tutucu değilse null
)
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderType()
Şeklin yer tutucu türünü veya şekil bir yer tutucu değilse PlaceholderType.NONE
değerini döndürür.
Return
PlaceholderType
— Bu şeklin yer tutucu türü.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRotation()
Öğenin, merkezi etrafında saat yönünde dönüş açısını derece cinsinden döndürür. Burada sıfır derece, döndürme olmadığı anlamına gelir.
Return
Number
— 0 (dahil) ile 360 (hariç) arasındaki derece cinsinden dönüş açısı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getShapeType()
getText()
Şeklin metin içeriğini döndürür.
Bir şeklin içindeki metin her zaman yeni satır karakteriyle sona erer.
Return
TextRange
— Bu şeklin metin içeriği.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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östermek 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTop()
Öğenin, öğe döndürmediği durumlarda sayfanın sol üst köşesinden ölçülen, noktalardaki dikey konumunu alır.
Return
Number
: Bu öğenin, sayfanın sol üst köşesinden noktalardaki dikey konumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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ının dönüşümleriyle önceden bağlayın. Sayfa öğesi bir grupta bulunmuyorsa mutlak dönüşümü bu alandaki değerle aynı olur.
Return
AffineTransform
: Sayfa öğesinin dönüşümü.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWidth()
Nokta cinsinden öğenin genişliğini döndürür. Bu değer, öğede rotasyon 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 noktalardaki doğal genişliği veya sayfa öğesinin genişliği yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 nokta 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 bitişik olacak dönüşüm. |
Return
Shape
— Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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.
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 bir PageElement
yer tutucusu kaldırılırsa boş devralma yer tutucuları da kaldırılır.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeLink()
Link
kaldırılır.
shape.removeLink();
replaceWithImage(blobSource)
Bu şekli, BlobSource
tarafından sağlanan bir resimle değiştirir.
Resim, ekleme zamanında bir kez sağlanan BlobSource
öğesinden alınır ve bir kopyası sununun içinde görüntülemek üzere saklanır. Resimler 50 MB'tan küçük olmalı, 25 megapikselden büyük olmamalıdır ve PNG, JPEG veya GIF biçiminde olmalıdır.
Resmin en boy oranını korumak için resim, mevcut şeklin boyutuna göre ölçeklendirilir ve ortalanır.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); shape.replaceWithImage(driveImage);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
blobSource | BlobSource | Resim verileri. |
Return
Image
— Şekli değiştiren Image
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithImage(blobSource, crop)
Bu şekli, BlobSource
tarafından sağlanan bir resimle değiştirir.
Resim eklendiğinde BlobSource
kaynağından bir kez getirilir ve bir kopyası sununun içinde görüntülenmek üzere saklanır. Resimlerin boyutu 50 MB'tan küçük olmalı, 25 megapikselden büyük olmamalıdır ve PNG, JPEG veya GIF biçiminde olmalıdır.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); // Replace and crop the replaced image. shape.replaceWithImage(driveImage, true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
blobSource | BlobSource | Resim verileri. |
crop | Boolean | true ise resmi mevcut şeklin boyutuna sığacak şekilde kırpar. Aksi takdirde, resim ölçeklendirilir ve ortalanır. |
Return
Image
— Şekli değiştiren Image
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithImage(imageUrl)
Bu şekli bir resimle değiştirir.
Resim eklendiğinde URL'den bir kez getirilir ve resmin bir kopyası sununun içinde görüntülemek üzere saklanır. Resimlerin boyutu 50 MB'tan küçük olmalı, 25 megapikselden büyük olmamalıdır 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 Image.getSourceUrl()
aracılığıyla gösterilir.
Resmin en boy oranını korumak için resim, mevcut şeklin boyutuna göre ölçeklendirilir ve ortalanır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
imageUrl | String | Resmin indirileceği resim URL'si. |
Return
Image
— Şekli değiştiren Image
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithImage(imageUrl, crop)
Bu şekli bir resimle değiştirir.
Resim eklendiğinde URL'den bir kez getirilir ve resmin bir kopyası sununun içinde görüntülemek üzere saklanır. Resimlerin boyutu 50 MB'tan küçük olmalı, 25 megapikselden büyük olmamalıdır ve PNG, JPEG veya GIF biçiminde olmalıdır.
Sağlanan URL 2 kB'tan büyük olmamalıdır. URL'nin kendisi resimle birlikte kaydedilir ve Image.getSourceUrl()
aracılığıyla gösterilir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
imageUrl | String | Resmin indirileceği resim URL'si. |
crop | Boolean | true ise resmi mevcut şeklin boyutuna sığacak şekilde kırpar. Aksi takdirde, resim ölçeklendirilir ve ortalanır. |
Return
Image
— Şekli değiştiren Image
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithSheetsChart(sourceChart)
Bu şekli bir Google E-Tablolar grafiğiyle değiştirir.
Bu grafik, güncellenmesine izin veren kaynak Google E-Tablolar grafiğine bağlıdır. Diğer ortak çalışanlar kaynak e-tablonun bağlantısını görebilir.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Replace the shape with the Sheets chart. var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; shape.replaceWithSheetsChart(chart);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sourceChart | EmbeddedChart | Şeklin yerini alan bir e-tablodaki grafik. |
Return
SheetsChart
— Şeklin yerini alan grafik.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithSheetsChartAsImage(sourceChart)
Bu şekli bir Google E-Tablolar grafiği resmiyle değiştirir.
Google E-Tablolar grafiğinin en boy oranını korumak için grafik resmi, mevcut şeklin boyutuna göre ölçeklendirilir ve ortalanır.
Grafiğin resmi, kaynak Google E-Tablolar grafiğine bağlı değil.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Replace the shape with the Sheets chart as an image. var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; shape.replaceWithSheetsChartAsImage(chart);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sourceChart | EmbeddedChart | Şeklin yerini alan bir e-tablodaki grafik. |
Return
Image
— Şeklin yerini alan grafiğin resmi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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önüşü olmadığında 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
Shape
— Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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önüşü olmadığında 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çeklendirme oranı. |
Return
Shape
— Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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
üzerinden select(replace)
adlı kişiyi aramakla aynıdır.
Bir komut dosyası, yalnızca komut dosyasını çalıştıran kullanıcının seçimine ve sadece komut dosyası sunuya bağlıysa erişebilir.
Bu işlem, PageElement
öğesinin Page
üst öğ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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select(replace)
Etkin sunudaki PageElement
öğesini seçer.
Bir komut dosyası, yalnızca komut dosyasını çalıştıran kullanıcının seçimine ve sadece komut dosyası sunuya bağlıysa erişebilir.
Yalnızca PageElement
öğesini seçmek ve önceki seçimleri kaldırmak için bu yönteme true
aktarın. Bu işlem, PageElement
öğesinin Page
üst öğesini de current page selection
olarak ayarlar.
Birden fazla PageElement
nesnesi seçmek için false
öğesini iletin. 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
öğesi,current page selection
olmalıdır.- Birden fazla
Page
nesnesi seçilmemelidir.
Bu durumun geçerli olması 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 değerine ayarlanırsa seçim, önceki herhangi bir seçimin yerini alır. Aksi takdirde seçim, önceki herhangi bir seçime eklenir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
Sayfa öğesini bir öğe geri gönderir.
Sayfa öğesi bir grupta yer almamalıdır.
Return
Shape
— Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 yer almamalıdır.
Return
Shape
— Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setContentAlignment(contentAlignment)
Şekildeki metnin ContentAlignment
özelliğini ayarlar.
Bu yöntem, güncellenen şekillerdeki metin otomatik sığdırma özelliklerini otomatik olarak devre dışı bırakır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
contentAlignment | ContentAlignment | Ayarlanacak hizalama. |
Return
Shape
— Zincirleme için bu şekil.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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
Shape
: Bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 olarak ayarlar. Bu değer, öğenin dönmesi olmadığı durumda öğeyi 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 puan cinsinden ayarlanacak yeni yüksekliği. |
Return
Shape
— Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
Öğenin, öğe döndürmediği durumlarda sayfanın sol üst köşesinden ölçülen noktalardaki yatay konumunu ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
left | Number | Nokta cinsinden ayarlanacak yeni yatay konum. |
Return
Shape
— Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 belirtilen Slide
için bir Link
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ı dizin değeri. |
Return
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slide)
Belirtilen Slide
öğesine bir Link
ayarlar. 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 kapsamlardan bir 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, belirtilen Slide
için bir 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
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. 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setRotation(angle)
Öğenin saat yönünün çevresindeki 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
Shape
— Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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
Shape
: Bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
Öğenin, öğe döndürmediği durumlarda sayfanın sol üst köşesinden ölçülen noktalardaki dikey konumunu ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
top | Number | Puan cinsinden ayarlanacak yeni dikey konum. |
Return
Shape
— Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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. Bu da görsel görünümlerini değiştirebilir.
Bir grupta yer alan bir sayfa öğesinin dönüşümünün güncellenmesi yalnızca o 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
Shape
: Zincirleme için bu öğe.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
Noktalar cinsinden öğenin genişliğini ayarlar. Bu, öğenin dönmesi olmadığı durumda öğ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 punto cinsinden ayarlanacak yeni genişliği. |
Return
Shape
— Zincirleme için bu sayfa öğesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations