Class Shape

Şekil

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

Yöntemler

YöntemDönüş türüKısa açıklama
alignOnPage(alignmentPosition)ShapeÖğeyi sayfadaki belirtilen hizalama konumuna getirir.
bringForward()ShapeSayfa öğesini bir öğe ileri getirir.
bringToFront()ShapeSayfa öğesini sayfanın önüne getirir.
duplicate()PageElementSayfa öğesini kopyalar.
getAutofit()AutofitBu ş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 öğelerinin listesini veya sayfa öğesinde bağlantı sitesi yoksa boş bir listeyi 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Öğ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()LinkBağ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()GroupBu 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()PageElementYer tutucunun üst sayfa öğesini döndürür.
getPlaceholderIndex()IntegerŞeklin yer tutucu dizini döndürülü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önme açısını derece cinsinden döndürür. Sıfır derece, dönme 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Öğenin dikey konumunu, öğede rotasyon olmadığında sayfanın sol üst köşesinden ölçülen noktalar cinsinden alır.
getTransform()AffineTransformSayfa öğ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)ShapeSağlanan dönüştürme işlemini, sayfa öğesinin mevcut dönüştürme işlemiyle önceden birleştirir.
remove()voidSayfa öğesini kaldırır.
removeLink()voidBir Link kaldırılı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 bir Google E-Tablolar grafiğinin resmiyle değiştirir.
scaleHeight(ratio)ShapeÖğenin yüksekliğini belirtilen orana göre ölçekler.
scaleWidth(ratio)ShapeÖğenin genişliğini belirtilen orana göre ölçekler.
select()voidEtkin sunudaki yalnızca PageElement seçeneğini belirler ve önceki tüm seçimleri kaldırır.
select(replace)voidEtkin sunudaki PageElement'ü seçer.
sendBackward()ShapeSayfa öğesini bir öğe geriye gönderir.
sendToBack()ShapeSayfa öğesini sayfanın arkasına gönderir.
setContentAlignment(contentAlignment)ShapeŞekildeki metnin ContentAlignment değerini ayarlar.
setDescription(description)ShapeSayfa öğesinin alternatif metin açıklamasını ayarlar.
setHeight(height)ShapeÖğ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)ShapeÖğenin yatay konumunu, öğe döndürülmemişken sayfanın sol üst köşesinden ölçülen noktalar cinsinden ayarlar.
setLinkSlide(slideIndex)LinkSlaytın sıfır tabanlı dizini kullanılarak belirli bir Slide için Link ayarlanır.
setLinkSlide(slide)LinkBelirtilen Link için bir Slide ayarlar. Bağlantı, belirtilen slayt kimliğine göre ayarlanır.
setLinkSlide(slidePosition)LinkSlaytın göreli konumunu kullanarak Link öğesini belirli bir Slide öğesine ayarlar.
setLinkUrl(url)LinkBelirtilen boş olmayan URL dizesine bir Link ayarlar.
setRotation(angle)ShapeÖğenin merkezi etrafında saat yönünde dönme açısını derece cinsinden belirler.
setTitle(title)ShapeSayfa öğesinin alternatif metin başlığını ayarlar.
setTop(top)ShapeÖğenin dikey konumunu, öğe döndürülmemişken sayfanın sol üst köşesinden ölçülen noktalar cinsinden ayarlar.
setTransform(transform)ShapeSayfa öğesinin dönüştürme işlemini, sağlanan dönüştürme işlemiyle ayarlar.
setWidth(width)ShapeÖğ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

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

Return

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

bringForward()

Sayfa öğesini bir öğe ileri getirir.

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

Return

Shape: 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

Shape: 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

getAutofit()

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

Return

Autofit: Bu şekil içindeki metnin otomatik sığdırılması.

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

getBorder()

Şeklin Border değerini döndürür.

Return

Border: Bu şeklin kenar ayarıdı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

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

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ı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

getFill()

Şeklin Fill değerini döndürür.

Return

Fill: Bu şeklin dolgu ayarı.

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

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. Şekil yer tutucu değilse veya üst öğesi yoksa null döndürür.

Return

PageElement: 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ı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()

Şeklin yer tutucu dizini döndürülür. Aynı yer tutucu türlerinin iki veya daha fazla örneği aynı sayfada varsa bunların her birinin kendi benzersiz dizine ekleme değeri vardır. Şekil bir yer tutucu değilse null döndürür.

Return

Integer: Bu şeklin yer tutucu dizini veya şekil 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()

Ş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ı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

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.

Bir şekil içindeki metin her zaman yeni satır karakteriyle sonlandırılır.

Return

TextRange: Bu şeklin metin içeriğ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

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

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

Return

Shape: 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

Bir Link kaldırılı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.

Görüntü, ekleme sırasında sağlanan 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 fazla olmamalı 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 ortalanacaktı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: Şekli değiştiren 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

replaceWithImage(blobSource, crop)

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

Resim eklendiğinde BlobSource'ten bir kez alınır ve sunuda gösterilmek üzere bir kopyası depolanır. Resimler 50 MB'tan küçük, 25 megapikselden fazla olmamalı 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: Şekli değiştiren 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

replaceWithImage(imageUrl)

Bu şekli 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 Image.getSourceUrl() üzerinden gösterilir.

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

Parametreler

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

Return

Image: Şekli değiştiren 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

replaceWithImage(imageUrl, crop)

Bu şekli 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 en fazla 2 KB olmalıdır. URL, 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: Şekli değiştiren 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

replaceWithSheetsChart(sourceChart)

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

Grafik, kaynak Google E-Tablolar grafiğine bağlıdı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-tabloda, şeklin yerini alan grafik.

Return

SheetsChart: Şekli değiştiren grafik.

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

replaceWithSheetsChartAsImage(sourceChart)

Bu şekli bir Google E-Tablolar grafiğinin 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 ortalanacaktır.

Grafiğin resmi, kaynak Google E-Tablolar grafiğine bağ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-tabloda, şeklin yerini alan grafik.

Return

Image: Şeklin yerini alan grafiğin resmi.

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

AdTürAçıklama
ratioNumberBu sayfa öğesinin yüksekliğinin ölçeklendirileceği oran.

Return

Shape: 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

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

Return

Shape: 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:

  1. PageElement nesnesinin üst öğesi Page, current page selection olmalıdır.
  2. 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

AdTürAçıklama
replaceBooleantrue 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

Shape: 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

Shape: 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

setContentAlignment(contentAlignment)

Şekildeki metnin ContentAlignment değerini 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 bu şekil.

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

AdTürAçıklama
descriptionStringAlternatif metin açıklamasının ayarlanacağı dize.

Return

Shape: 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

AdTürAçıklama
heightNumberAyarlanacak bu sayfa öğesinin yeni yüksekliği (noktada).

Return

Shape: 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

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

Return

Shape: 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

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

Return

Link: Ayarlanan Link.

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

AdTürAçıklama
slideSlideBağlanacak Slide.

Return

Link: Ayarlanan Link.

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

AdTürAçıklama
slidePositionSlidePositionGöreli SlidePosition.

Return

Link: Ayarlanan Link.

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

AdTürAçıklama
urlStringURL dizesi.

Return

Link: Ayarlanan Link.

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

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

Return

Shape: 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

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

Return

Shape: 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

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

Return

Shape: 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

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

Return

Shape: 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

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

Return

Shape: 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