Class Shape

Şekil

Daha spesifik bir sınıflandırması olmayan genel bir şekli temsil eden PageElement. Metin kutuları, dikdörtgenler ve diğer önceden tanımlanmış şekilleri içerir.

Yöntemler

YöntemDönüş türüKısa açıklama
alignOnPage(alignmentPosition)ShapeÖğeyi sayfada belirtilen hizalama konumuna hizalar.
bringForward()ShapeSayfa öğesini sayfada bir öğe ileri taşır.
bringToFront()ShapeSayfa öğesini sayfanın önüne getirir.
duplicate()PageElementSayfa öğesini kopyalar.
getAutofit()Autofit|nullBu şeklin 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 öğesinde bağlantı sitesi yoksa boş bir liste döndürür.
getContentAlignment()ContentAlignmentŞekildeki metnin ContentAlignment değerini döndürür.
getDescription()StringSayfa öğesinin alternatif metin açıklamasını döndürür.
getFill()FillŞeklin Fill değerini döndürür.
getHeight()Number|nullÖğenin yüksekliğini puan cinsinden alır. Bu değer, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun yüksekliğidir.
getInherentHeight()Number|nullÖğenin doğal yüksekliğini puan cinsinden döndürür.
getInherentWidth()Number|nullÖğenin doğal genişliğini puan cinsinden döndürür.
getLeft()NumberÖğe döndürülmediğinde sayfanın sol üst köşesinden ölçülen, öğenin yatay konumunu puan cinsinden döndürür.
getLink()Link|nullBağlantı yoksa Link veya null değerini döndürür.
getObjectId()StringBu nesnenin benzersiz kimliğini döndürür.
getPageElementType()PageElementTypeSayfa öğesinin türünü PageElementType enum olarak döndürür.
getParentGroup()Group|nullBu sayfa öğesinin ait olduğu grubu veya öğe bir grupta değilse null değerini döndürür.
getParentPage()PageBu sayfa öğesinin bulunduğu sayfayı döndürür.
getParentPlaceholder()PageElement|nullYer tutucunun üst sayfa öğesini döndürür.
getPlaceholderIndex()Integer|nullŞeklin yer tutucu dizinini döndürür.
getPlaceholderType()PlaceholderTypeŞeklin yer tutucu türünü veya şekil yer tutucu değilse PlaceholderType.NONE değerini döndürür.
getRotation()NumberÖğenin merkezi etrafındaki saat yönünde dönüş açısını derece cinsinden döndürür. Sıfır derece, dönüş 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()StringSayfa öğesinin alternatif metin başlığını döndürür.
getTop()NumberÖğe döndürülmediğinde, sayfanın sol üst köşesinden itibaren ölçülen, öğenin dikey konumunu puan cinsinden alır.
getTransform()AffineTransformSayfa öğesinin dönüşümünü döndürür.
getWidth()Number|nullÖğenin genişliğini puan cinsinden döndürür. Bu, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun genişliğidir.
preconcatenateTransform(transform)ShapeSağlanan dönüşümü, sayfa öğesinin mevcut dönüşümüyle önceden birleştirir.
remove()voidSayfa öğesini kaldırır.
removeLink()voidLink öğesini kaldırır.
replaceWithImage(blobSource)ImageBu şekli, BlobSource tarafından sağlanan bir resimle değiştirir.
replaceWithImage(blobSource, crop)ImageBu şekli, BlobSource tarafından sağlanan bir resimle değiştirir.
replaceWithImage(imageUrl)ImageBu şekli bir resimle değiştirir.
replaceWithImage(imageUrl, crop)ImageBu şekli bir resimle değiştirir.
replaceWithSheetsChart(sourceChart)SheetsChartBu şekli Google E-Tablolar grafiğiyle değiştirir.
replaceWithSheetsChartAsImage(sourceChart)ImageBu şekli Google E-Tablolar grafiğiyle değiştirir.
scaleHeight(ratio)ShapeÖğenin yüksekliğini belirtilen oranda ölçeklendirir.
scaleWidth(ratio)ShapeÖğenin genişliğini belirtilen oranda ölçeklendirir.
select()voidYalnızca etkin sunudaki PageElement öğesini seçer ve önceki seçimleri kaldırır.
select(replace)voidEtkin sunudaki PageElement öğesini seçer.
sendBackward()ShapeSayfa öğesini sayfada bir öğe geriye gönderir.
sendToBack()ShapeSayfa öğesini sayfanın arkasına gönderir.
setContentAlignment(contentAlignment)ShapeŞekildeki metnin ContentAlignment ayarlar.
setDescription(description)ShapeSayfa öğesinin alternatif metin açıklamasını ayarlar.
setHeight(height)ShapeÖğenin yüksekliğini puan cinsinden ayarlar. Bu, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun yüksekliğidir.
setLeft(left)ShapeÖğenin yatay konumunu, öğe döndürülmediğinde sayfanın sol üst köşesinden itibaren ölçülen puanlar cinsinden ayarlar.
setLinkSlide(slideIndex)LinkSlaytın sıfır tabanlı dizinini kullanarak belirtilen Slide değerine Link ayarlar.
setLinkSlide(slide)LinkBelirtilen Link değerini, verilen Slide olarak ayarlar. Bağlantı, verilen slayt kimliğine göre ayarlanır.
setLinkSlide(slidePosition)LinkSlaydın göreli konumunu kullanarak belirtilen Slide için Link ayarlar.
setLinkUrl(url)LinkLink özelliğini, verilen boş olmayan URL dizesine ayarlar.
setRotation(angle)ShapeÖğenin merkezi etrafındaki saat yönünde dönüş açısını derece cinsinden ayarlar.
setTitle(title)ShapeSayfa öğesinin alternatif metin başlığını ayarlar.
setTop(top)ShapeÖğe döndürülmediğinde, öğenin dikey konumunu sayfanın sol üst köşesinden itibaren ölçülen puanlar cinsinden ayarlar.
setTransform(transform)ShapeSayfa öğesinin dönüşümünü, sağlanan dönüşümle ayarlar.
setWidth(width)ShapeÖğenin genişliğini puan cinsinden ayarlar. Bu, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun genişliğidir.

Ayrıntılı belgeler

alignOnPage(alignmentPosition)

Öğeyi sayfada belirtilen hizalama konumuna hizalar.

Parametreler

AdTürAçıklama
alignmentPositionAlignmentPositionBu sayfa öğesinin sayfada hizalanacağı konum.

Return

Shape: Zincirleme için kullanılan bu sayfa öğesi.

bringForward()

Sayfa öğesini sayfada bir öğe ileri taşır.

Sayfa öğesi bir grupta olmamalıdır.

Return

Shape: Zincirleme için kullanılan bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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

Shape: Zincirleme için kullanılan bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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, orijinaliyle aynı sayfaya aynı konumda yerleştirilir.

Return

PageElement: Bu sayfa öğesinin yeni kopyası.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getAutofit()

Bu şeklin içindeki metnin Autofit değerini döndürür. Şekilde metne izin verilmiyorsa bu null olur.

Return

Autofit|null: Metnin bu şekil içinde otomatik olarak sığdırılması.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 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 öğesinde bağlantı sitesi yoksa boş bir liste döndürür.

Return

ConnectionSite[]: Bu öğenin bağlantı siteleri yoksa boş olabilecek bağlantı siteleri listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 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östermek ve okumak için başlıkla birlikte kullanılır.

Return

String: Sayfa öğesinin alternatif metin açıklaması.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 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 puan 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|null: Sayfa öğesinin puan cinsinden doğal yüksekliği veya sayfa öğesinin yüksekliği yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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ü, kendi boyutuna göre belirlenir. Öğenin nihai görsel görünümünü belirlemek için öğenin dönüşümüyle birlikte doğal boyutu kullanın.

Return

Number|null: Sayfa öğesinin puan cinsinden doğal yüksekliği veya sayfa öğesinin yüksekliği yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 puan cinsinden döndürür.

Sayfa öğesinin dönüşümü, kendi boyutuna göre belirlenir. Öğenin nihai görsel görünümünü belirlemek için öğenin dönüşümüyle birlikte doğal boyutu kullanın.

Return

Number|null: Sayfa öğesinin puan cinsinden doğal genişliği veya sayfa öğesinin genişliği yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getLeft()

Öğe döndürülmediğinde sayfanın sol üst köşesinden ölçülen, öğenin yatay konumunu puan cinsinden döndürür.

Return

Number: Bu öğenin, sayfanın sol üst köşesinden itibaren yatay konumu (nokta cinsinden).

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

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|null: Bağlantı yoksa Link veya null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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ı, aşağıdaki kapsamlardan 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 değilse null değerini döndürür.

Return

Group|null: Bu sayfa öğesinin ait olduğu grup veya null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 kapsamlardan 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. Şekil yer tutucu değilse veya üst öğesi yoksa null değerini döndürür.

Return

PageElement|null: Bu şekil yer tutucusunun üst sayfa öğesi veya bu şekil yer tutucu değilse ya da üst öğesi yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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ı yer tutucu türlerinin aynı sayfada iki veya daha fazla örneği varsa her birinin kendine özgü bir dizin değeri vardır. Şekil yer tutucu değilse null değerini döndürür.

Return

Integer|null: Bu şeklin yer tutucu dizini veya şekil yer tutucu değilse null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 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 biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getRotation()

Öğenin merkezi etrafındaki saat yönünde dönüş 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 kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getShapeType()

Şeklin türünü döndürür.

Return

ShapeType: Bu şeklin türü.

getText()

Şeklin metin içeriğini döndürür.

Şekil içindeki metin her zaman yeni satır karakteriyle sonlanır.

Return

TextRange: Bu şeklin metin içeriği.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 birlikte kullanılır.

Return

String: Sayfa öğesinin alternatif metin başlığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTop()

Öğe döndürülmediğinde, sayfanın sol üst köşesinden itibaren ölçülen, öğenin dikey konumunu puan cinsinden alır.

Return

Number: Bu öğenin, sayfanın sol üst köşesinden itibaren dikey konumu (nokta cinsinden).

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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ı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ı, aşağıdaki kapsamlardan 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 puan cinsinden döndürür. Bu, öğ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|null: Sayfa öğesinin puan cinsinden doğal genişliği veya sayfa öğesinin genişliği yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 puan 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üşümünü setTransform(transform) ile de değiştirebilirsiniz.

Parametreler

AdTürAçıklama
transformAffineTransformBu sayfa öğesinin dönüştürmesine önceden birleştirilecek dönüştürme.

Return

Shape: Zincirleme için kullanılan bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 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 devralınan tüm boş yer tutucular da kaldırılır.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

Link öğesini kaldırır. 

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

replaceWithImage(blobSource)

Bu şekli, BlobSource tarafından sağlanan bir resimle değiştirir.

Resim, ekleme sırasında sağlanan BlobSource kaynağından bir kez alınır ve sunuda gösterilmek üzere bir kopyası saklanır. Görüntüler 50 MB'tan küçük olmalı, 25 megapikseli aşmamalı 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. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
shape.replaceWithImage(driveImage);

Parametreler

AdTürAçıklama
blobSourceBlobSourceResim verileri.

Return

Image: Şeklin yerini alan Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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.

Görüntü eklediğinizde BlobSource kaynağından bir kez alınır ve sunuda gösterilmek üzere bir kopyası saklanır. Resimler 50 MB'tan küçük olmalı, 25 megapikseli aşmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

Parametreler

AdTürAçıklama
blobSourceBlobSourceResim verileri.
cropBooleantrue ise resmi, mevcut şeklin boyutuna sığacak şekilde kırpar. Aksi takdirde, resim ölçeklendirilir ve ortalanır.

Return

Image: Şeklin yerini alan Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 eklediğinizde URL'den bir kez alınır ve sunuda gösterilmek üzere bir kopyası saklanır. Resimler 50 MB'tan küçük olmalı, 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 Image.getSourceUrl() üzerinden gösterilir.

Resmin en boy oranını korumak için resim, mevcut şeklin boyutuna göre ölçeklendirilir ve ortalanır.

Parametreler

AdTürAçıklama
imageUrlStringResmin indirileceği resim URL'si.

Return

Image: Şeklin yerini alan Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 eklediğinizde URL'den bir kez alınır ve sunuda gösterilmek üzere bir kopyası saklanır. Resimler 50 MB'tan küçük olmalı, 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. URL'nin kendisi resimle birlikte kaydedilir ve Image.getSourceUrl() aracılığıyla gösterilir.

Parametreler

AdTürAçıklama
imageUrlStringResmin indirileceği resim URL'si.
cropBooleantrue ise resmi, mevcut şeklin boyutuna sığacak şekilde kırpar. Aksi takdirde, resim ölçeklendirilir ve ortalanır.

Return

Image: Şeklin yerini alan Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceWithSheetsChart(sourceChart)

Bu şekli Google E-Tablolar grafiğiyle değiştirir.

Grafik, kaynak Google E-Tablolar grafiğine bağlanır ve bu sayede güncellenebilir. Diğer ortak çalışanlar kaynak e-tablonun bağlantısını görebilir. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

Parametreler

AdTürAçıklama
sourceChartEmbeddedChartE-tablodaki şeklin yerini alan grafik.

Return

SheetsChart: Şeklin yerini alan grafik.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceWithSheetsChartAsImage(sourceChart)

Bu şekli Google E-Tablolar grafiğiyle 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ğiyle bağlantılı değil. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

Parametreler

AdTürAçıklama
sourceChartEmbeddedChartE-tablodaki şeklin yerini alan grafik.

Return

Image: Şeklin yerini alan grafiğin resmi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 oranda ölçeklendirir. Öğenin yüksekliği, öğe döndürülmediğinde 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

AdTürAçıklama
ratioNumberBu sayfa öğesinin yüksekliğini ölçeklendirmek için kullanılan oran.

Return

Shape: Zincirleme için kullanılan bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 oranda ölçeklendirir. Öğ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

AdTürAçıklama
ratioNumberBu sayfa öğesinin genişliğinin ölçekleneceği oran.

Return

Shape: Zincirleme için kullanılan bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

select()

Yalnızca etkin sunudaki PageElement öğesini seçer ve önceki seçimleri kaldırır. Bu, select(replace) işlevini true ile çağırmakla aynıdır.

Bir komut dosyası yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve yalnızca komut dosyası sunuya bağlıysa bu işlemi yapabilir.

Bu işlem, PageElement öğesinin üst öğesi olan Page öğesini 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ı, aşağıdaki kapsamlardan biri 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 erişebilir ve yalnızca komut dosyası sunuya bağlıysa bu işlemi yapabilir.

Yalnızca PageElement öğesini seçmek ve önceki seçimleri kaldırmak için bu yönteme true öğesini iletin. Bu işlem, PageElement öğesinin üst öğesini Page de current page selection olarak ayarlar.

Birden fazla PageElement nesne seçmek için geçirin.false PageElement nesneleri aynı Page içinde olmalıdır.

false parametresi kullanılarak bir sayfa öğesi seçilirken aşağıdaki koşulların karşılanması gerekir:

  1. PageElement nesnesinin üst Page'sı current page selection olmalıdır.
  2. Birden fazla Page nesnesi seçilmemelidir.

Bunun böyle olduğundan emin olmak için tercih edilen yaklaşım, önce Page.selectAsCurrentPage() kullanarak üst öğeyi Page seçmek, 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

AdTürAçıklama
replaceBooleantrue ise seçim, önceki tüm seçimlerin yerini alır. Aksi takdirde seçim, önceki tüm seçimlere eklenir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

sendBackward()

Sayfa öğesini sayfada bir öğe geriye gönderir.

Sayfa öğesi bir grupta olmamalıdır.

Return

Shape: Zincirleme için kullanılan bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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

Shape: Zincirleme için kullanılan bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setContentAlignment(contentAlignment)

Şekildeki metnin ContentAlignment ayarlar.

Bu yöntem, güncellenen şekillerdeki metin otomatik sığdırma özelliklerini otomatik olarak devre dışı bırakır.

Parametreler

AdTürAçıklama
contentAlignmentContentAlignmentAyarlanacak hizalama.

Return

Shape: Zincirleme için kullanılan şekil.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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.

Bu 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

AdTürAçıklama
descriptionStringAlternatif metin açıklamasını ayarlamak için kullanılan dize.

Return

Shape: Bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 puan cinsinden ayarlar. Bu, öğ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

AdTürAçıklama
heightNumberBu sayfa öğesinin yeni yüksekliği (nokta cinsinden).

Return

Shape: Zincirleme için kullanılan bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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ürülmediğinde sayfanın sol üst köşesinden itibaren ölçülen puanlar cinsinden ayarlar.

Parametreler

AdTürAçıklama
leftNumberAyarlanacak yeni yatay konum (nokta cinsinden).

Return

Shape: Zincirleme için kullanılan bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 belirtilen Slide değerine Link 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(0);

Parametreler

AdTürAçıklama
slideIndexIntegerSlaytın sıfır tabanlı dizini.

Return

Link: Ayarlanan Link.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slide)

Belirtilen Link değerini, verilen Slide olarak ayarlar. Bağlantı, verilen 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

AdTürAçıklama
slideSlideBağlanacak Slide.

Return

Link: Ayarlanan Link.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkSlide(slidePosition)

Slaydın göreli konumunu kullanarak belirtilen Slide için Link 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

AdTürAçıklama
slidePositionSlidePositionGöreceli SlidePosition.

Return

Link: Ayarlanan Link.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setLinkUrl(url)

Link özelliğini, verilen boş olmayan URL dizesine 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

AdTürAçıklama
urlStringURL dizesi.

Return

Link: Ayarlanan Link.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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ındaki saat yönünde dönüş 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ı bölümüne bakın.

Parametreler

AdTürAçıklama
angleNumberAyarlanacak yeni saat yönünde dönüş açısı (derece cinsinden).

Return

Shape: Zincirleme için kullanılan bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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.

Bu 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

AdTürAçıklama
titleStringAlternatif metin başlığını ayarlamak için kullanılan dize.

Return

Shape: Bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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ürülmediğinde, öğenin dikey konumunu sayfanın sol üst köşesinden itibaren ölçülen puanlar cinsinden ayarlar.

Parametreler

AdTürAçıklama
topNumberAyarlanacak yeni dikey konum (puan cinsinden).

Return

Shape: Zincirleme için kullanılan bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

setTransform(transform)

Sayfa öğesinin dönüşümünü, sağlanan dönüşümle ayarlar.

Bir grubun dönüşümünü güncellemek, o gruptaki sayfa öğelerinin mutlak dönüşümünü değiştirir. Bu da öğelerin görsel görünümünü değiştirebilir.

Bir grupta bulunan bir 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() başlıklı makaleyi inceleyin.

Parametreler

AdTürAçıklama
transformAffineTransformBu sayfa öğesi için ayarlanan dönüşüm.

Return

Shape: Bu öğe, zincirleme için kullanılır.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 puan cinsinden ayarlar. Bu, öğ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

AdTürAçıklama
widthNumberBu sayfa öğesinin yeni genişliği (punto cinsinden).

Return

Shape: Zincirleme için kullanılan bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations