Bu sayfa, Cloud Translation API ile çevrilmiştir.

Class Shape

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öntem	Dönüş türü	Kısa açıklama
`alignOnPage(alignmentPosition)`	`Shape`	Öğeyi sayfadaki belirtilen hizalama konumuna getirir.
`bringForward()`	`Shape`	Sayfa öğesini bir öğe ileri getirir.
`bringToFront()`	`Shape`	Sayfa öğesini sayfanın önüne 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` öğ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()`	`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 yüksekliğini noktalar cinsinden alır. Bu değer, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun yüksekliğidir.
`getInherentHeight()`	`Number`	Öğenin doğal yüksekliğini noktalar cinsinden döndürür.
`getInherentWidth()`	`Number`	Öğenin doğal genişliğini noktalar cinsinden döndürür.
`getLeft()`	`Number`	Öğenin yatay konumunu, öğe döndürülmemişken sayfanın sol üst köşesinden ölçülen noktalar cinsinden döndürür.
`getLink()`	`Link`	Bağlantı yoksa `Link` veya `null` değerini döndürür.
`getObjectId()`	`String`	Bu nesnenin benzersiz kimliğini döndürür.
`getPageElementType()`	`PageElementType`	Sayfa öğesinin türünü `PageElementType` enum olarak döndürür.
`getParentGroup()`	`Group`	Bu sayfa öğesinin ait olduğu grubu veya öğe bir grupta değilse `null` değerini döndürür.
`getParentPage()`	`Page`	Bu sayfa öğesinin bulunduğu sayfayı döndürür.
`getParentPlaceholder()`	`PageElement`	Yer tutucunun üst sayfa öğesini döndürür.
`getPlaceholderIndex()`	`Integer`	Ş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()`	`String`	Sayfa öğesinin alternatif metin başlığını döndürür.
`getTop()`	`Number`	Öğenin dikey konumunu, öğede rotasyon olmadığında sayfanın sol üst köşesinden ölçülen noktalar cinsinden alır.
`getTransform()`	`AffineTransform`	Sayfa öğesinin dönüştürme işlemini döndürür.
`getWidth()`	`Number`	Öğenin genişliğini nokta cinsinden döndürür. Bu değer, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun genişliğidir.
`preconcatenateTransform(transform)`	`Shape`	Sağlanan dönüştürme işlemini, sayfa öğesinin mevcut dönüştürme işlemiyle önceden birleştirir.
`remove()`	`void`	Sayfa öğesini kaldırır.
`removeLink()`	`void`	Bir `Link` kaldırılır.
`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 Google E-Tablolar grafiğiyle değiştirir.
`replaceWithSheetsChartAsImage(sourceChart)`	`Image`	Bu ş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()`	`void`	Etkin sunudaki yalnızca `PageElement` seçeneğini belirler ve önceki tüm seçimleri kaldırır.
`select(replace)`	`void`	Etkin sunudaki `PageElement`'ü seçer.
`sendBackward()`	`Shape`	Sayfa öğesini bir öğe geriye gönderir.
`sendToBack()`	`Shape`	Sayfa öğesini sayfanın arkasına gönderir.
`setContentAlignment(contentAlignment)`	`Shape`	Şekildeki metnin `ContentAlignment` değerini ayarlar.
`setDescription(description)`	`Shape`	Sayfa öğ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)`	`Link`	Slaytın sıfır tabanlı dizini kullanılarak belirli bir `Slide` için `Link` ayarlanır.
`setLinkSlide(slide)`	`Link`	Belirtilen `Link` için bir `Slide` ayarlar. Bağlantı, belirtilen slayt kimliğine göre ayarlanır.
`setLinkSlide(slidePosition)`	`Link`	Slaytın göreli konumunu kullanarak `Link` öğesini belirli bir `Slide` öğesine ayarlar.
`setLinkUrl(url)`	`Link`	Belirtilen boş olmayan URL dizesine bir `Link` ayarlar.
`setRotation(angle)`	`Shape`	Öğenin merkezi etrafında saat yönünde dönme açısını derece cinsinden belirler.
`setTitle(title)`	`Shape`	Sayfa öğ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)`	`Shape`	Sayfa öğ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

Ad	Tür	Açıklama
`alignmentPosition`	`AlignmentPosition`	Bu 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

`getLink()`

Bağlantı yoksa Link veya null değerini döndürür.

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

Return

Link: Bağlantı yoksa Link veya null.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getObjectId()`

Bu nesnenin benzersiz kimliğini döndürür. Sayfalar ve sayfa öğeleri tarafından kullanılan nesne kimlikleri aynı ad alanını paylaşır.

Return

String: Bu nesnenin benzersiz kimliği.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getPageElementType()`

Sayfa öğesinin türünü PageElementType enum olarak döndürür.

Return

PageElementType: Sayfa öğesinin türü.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getParentGroup()`

Bu sayfa öğesinin ait olduğu grubu veya öğe bir grupta değilse null değerini döndürür.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getParentPage()`

Bu sayfa öğesinin bulunduğu sayfayı döndürür.

Return

Page: Bu öğenin bulunduğu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getParentPlaceholder()`

Yer tutucunun üst sayfa öğesini döndürür. Ş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

Ad	Tür	Açıklama
`transform`	`AffineTransform`	Bu sayfa öğesinin dönüştürme işlemine önceden birleştirilecek dönüştürme işlemi.

Return

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

`removeLink()`

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

Ad	Tür	Açıklama
`blobSource`	`BlobSource`	Resim 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

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

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

Sağlanan URL en fazla 2 KB olmalıdır. URL, 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ı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

Ad	Tür	Açıklama
`sourceChart`	`EmbeddedChart`	E-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

Ad	Tür	Açıklama
`sourceChart`	`EmbeddedChart`	E-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

Ad	Tür	Açıklama
`ratio`	`Number`	Bu 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

Ad	Tür	Açıklama
`ratio`	`Number`	Bu 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:

PageElement nesnesinin üst öğesi Page, current page selection olmalıdır.
Birden fazla Page nesnesi seçili olmamalıdır.

Bu durumdan emin olmak için tercih edilen yaklaşım, önce Page.selectAsCurrentPage() kullanarak üst öğeyi Page seçip ardından bu sayfadaki sayfa öğelerini seçmektir.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

Parametreler

Ad	Tür	Açıklama
`replace`	`Boolean`	`true` ise seçim önceki seçimin yerini alır. Aksi takdirde seçim önceki seçime eklenir.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`sendBackward()`

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

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

Return

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

Ad	Tür	Açıklama
`contentAlignment`	`ContentAlignment`	Ayarlanacak 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

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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`setHeight(height)`

Öğenin yüksekliğini nokta cinsinden ayarlar. Bu değer, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun yüksekliğidir.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin bu yöntemle uyumlu olmadığını öğrenmek için boyutlandırma ve konumlandırma sınırlamaları bölümüne bakın.

Parametreler

Ad	Tür	Açıklama
`height`	`Number`	Ayarlanacak bu sayfa öğesinin yeni yüksekliği (noktada).

Return

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

Ad	Tür	Açıklama
`left`	`Number`	Ayarlanacak 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

Ad	Tür	Açıklama
`slideIndex`	`Integer`	Slaytı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

Ad	Tür	Açıklama
`slide`	`Slide`	Bağ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

Ad	Tür	Açıklama
`slidePosition`	`SlidePosition`	Gö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

Ad	Tür	Açıklama
`url`	`String`	URL 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

Ad	Tür	Açıklama
`angle`	`Number`	Ayarlanacak 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

Ad	Tür	Açıklama
`title`	`String`	Alternatif 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

Ad	Tür	Açıklama
`top`	`Number`	Ayarlanacak 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

Ad	Tür	Açıklama
`transform`	`AffineTransform`	Bu 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

Ad	Tür	Açıklama
`width`	`Number`	Ayarlanacak 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