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 sayfada belirtilen hizalama konumuna hizalar.
`bringForward()`	`Shape`	Sayfa öğesini sayfada bir öğe öne getirir.
`bringToFront()`	`Shape`	Sayfa öğesini sayfanın önüne getirir.
`duplicate()`	`PageElement`	Sayfa öğesini çoğaltır.
`getAutofit()`	`Autofit`	Bu şekil içindeki metnin `Autofit` değerini döndürür.
`getBorder()`	`Border`	Şeklin `Border` değerini döndürür.
`getConnectionSites()`	`ConnectionSite[]`	Sayfa öğesindeki `ConnectionSite` listesini veya sayfa öğesinin bağlantı sitesi yoksa boş bir liste 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 halinde alır. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun yüksekliğidir.
`getInherentHeight()`	`Number`	Öğenin doğal yüksekliğini puan cinsinden döndürür.
`getInherentWidth()`	`Number`	Öğenin doğal genişliğini nokta cinsinden döndürür.
`getLeft()`	`Number`	Öğe hiç dönmediğinde sayfanın sol üst köşesinden ölçülen, öğenin yatay konumunu 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 `PageElementType` sıralamasıyla belirtilen türünü döndürür.
`getParentGroup()`	`Group`	Bu sayfa öğesinin ait olduğu grubu veya öğe bir grupta yer almıyorsa `null` değerini döndürür.
`getParentPage()`	`Page`	Bu sayfa öğesinin bulunduğu sayfayı döndürür.
`getParentPlaceholder()`	`PageElement`	Yer tutucunun üst sayfa öğesini döndürür.
`getPlaceholderIndex()`	`Integer`	Şeklin yer tutucu dizinini döndürür.
`getPlaceholderType()`	`PlaceholderType`	Şeklin yer tutucu türünü veya şekil bir yer tutucu değilse `PlaceholderType.NONE` değerini döndürür.
`getRotation()`	`Number`	Öğenin merkezi çevresindeki saat yönünde dönme 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()`	`String`	Sayfa öğesinin alternatif metin başlığını döndürür.
`getTop()`	`Number`	Öğe döndürme olduğunda sayfanın sol üst köşesinden ölçülen, öğenin dikey konumunu noktalar cinsinden alır.
`getTransform()`	`AffineTransform`	Sayfa öğesinin dönüşümünü döndürür.
`getWidth()`	`Number`	Öğenin genişliğini, nokta cinsinden döndürür. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun genişliğidir.
`preconcatenateTransform(transform)`	`Shape`	Sağlanan dönüşümü, sayfa öğesinin mevcut dönüşümüyle önceden birleştirir.
`remove()`	`void`	Sayfa öğesini kaldırır.
`removeLink()`	`void`	Bir `Link` kaldırı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 Google E-Tablolar grafiğinin resmiyle değiştirir.
`scaleHeight(ratio)`	`Shape`	Öğenin yüksekliğini belirtilen orana göre ölçeklendirir.
`scaleWidth(ratio)`	`Shape`	Öğenin genişliğini belirtilen orana göre ölçeklendirir.
`select()`	`void`	Etkin sunuda yalnızca `PageElement` öğesini seçer ve önceki seçimleri kaldırır.
`select(replace)`	`void`	Etkin sunuda `PageElement` öğesini seçer.
`sendBackward()`	`Shape`	Sayfa öğesini bir öğe tarafından sayfada geriye doğru gönderir.
`sendToBack()`	`Shape`	Sayfa öğesini sayfanın arkasına gönderir.
`setContentAlignment(contentAlignment)`	`Shape`	Şekildeki metnin `ContentAlignment` özelliğini ayarlar.
`setDescription(description)`	`Shape`	Sayfa öğesinin alternatif metin açıklamasını ayarlar.
`setHeight(height)`	`Shape`	Öğenin yüksekliğini noktalar halinde ayarlar. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun yüksekliğidir.
`setLeft(left)`	`Shape`	Öğenin yatay konumunu, öğe döndürme olduğunda sayfanın sol üst köşesinden ölçülen noktalar cinsinden ayarlar.
`setLinkSlide(slideIndex)`	`Link`	Slaytın sıfır tabanlı dizinini kullanarak bir `Link` öğesini belirtilen `Slide` olarak ayarlar.
`setLinkSlide(slide)`	`Link`	`Link` öğesini belirtilen `Slide` değerine ayarlarsa bağlantı, belirtilen slayt kimliğine göre ayarlanır.
`setLinkSlide(slidePosition)`	`Link`	Slaytın göreli konumunu kullanarak belirli bir `Slide` için `Link` ayarlar.
`setLinkUrl(url)`	`Link`	Belirli boş olmayan URL dizesine `Link` ayarlar.
`setRotation(angle)`	`Shape`	Öğenin merkezi etrafında saat yönünde dönme açısını derece cinsinden ayarlar.
`setTitle(title)`	`Shape`	Sayfa öğesinin alternatif metin başlığını ayarlar.
`setTop(top)`	`Shape`	Öğe döndürme olduğunda, sayfanın sol üst köşesinden ölçülen, öğenin dikey konumunu noktalar cinsinden ayarlar.
`setTransform(transform)`	`Shape`	Sağlanan dönüşümle sayfa öğesinin dönüşümünü ayarlar.
`setWidth(width)`	`Shape`	Öğenin genişliğini, noktalar halinde ayarlar. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun genişliğidir.

Ayrıntılı belgeler

`alignOnPage(alignmentPosition)`

Öğeyi sayfada belirtilen hizalama konumuna hizalar.

Parametreler

Ad	Tür	Açıklama
`alignmentPosition`	`AlignmentPosition`	Bu sayfa öğesinin sayfada hizalanacağı konum.

Return

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

`bringForward()`

Sayfa öğesini sayfada bir öğe öne getirir.

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 bu sayfa öğesi.

Yetkilendirme

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

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

`duplicate()`

Sayfa öğesini çoğaltır.

Sayfa kopyası öğesi aynı sayfaya, orijinalle aynı konuma yerleştirilir.

Return

PageElement - Bu sayfa öğesinin yeni kopyası.

Yetkilendirme

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

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

`getAutofit()`

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

Return

Autofit: Metnin bu şekil içine otomatik sığdırılması.

Yetkilendirme

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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: Metnin bu şekil içindeki hizalaması.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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örüntülemek ve okumak için başlıkla birleştirilir.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 kapsamların 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 noktalar halinde alır. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun yüksekliğidir.

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

Return

Number: Sayfa öğesinin noktalar halinde doğal yüksekliği veya sayfa öğesinin yüksekliği yoksa null.

Yetkilendirme

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

Return

Number: Sayfa öğesinin noktalar halinde doğal yüksekliği veya sayfa öğesinin yüksekliği yoksa null.

Yetkilendirme

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

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

Return

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

Yetkilendirme

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

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

`getLeft()`

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

Return

Number: Bu öğenin, sayfanın sol üst köşesinden itibaren noktalar halinde yatay konumu.

Yetkilendirme

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

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

`getLink()`

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

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

Return

Link

Yetkilendirme

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

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

`getPageElementType()`

Sayfa öğesinin PageElementType sıralamasıyla belirtilen türünü döndürür.

Return

PageElementType: Sayfa öğesinin türü.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 yer almıyorsa null değerini döndürür.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 kapsamların 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 bir yer tutucu değilse veya üst öğesi yoksa null değerini 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ı, aşağıdaki kapsamların 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ı sayfada aynı yer tutucu türüne ait iki veya daha fazla örnek varsa her birinin kendi benzersiz dizin değeri olur. Şekil bir yer tutucu değilse null değerini döndürür.

Return

Integer — Bu şeklin yer tutucu dizini veya şekil bir yer tutucu değilse null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 bir yer tutucu değilse PlaceholderType.NONE değerini döndürür.

Return

PlaceholderType: Bu şeklin yer tutucu türü.

Yetkilendirme

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

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

`getRotation()`

Öğenin merkezi çevresindeki saat yönünde dönme 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 kapsamların 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 kapsamların 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 birleştirilir.

Return

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

Yetkilendirme

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

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

`getTop()`

Öğe döndürme olduğunda sayfanın sol üst köşesinden ölçülen, öğenin dikey konumunu noktalar cinsinden alır.

Return

Number: Bu öğenin, sayfanın sol üst köşesinden itibaren noktalar halinde dikey konumu.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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ındaki dönüşümlerle önceden bağlayın. Sayfa öğesi bir grupta yer almıyorsa 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 kapsamların 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, nokta cinsinden döndürür. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun genişliğidir.

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 işaret edecek şekilde sola taşımak için:

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

Ayrıca, sayfa öğesinin dönüşümünü setTransform(transform) ile değiştirebilirsiniz.

Parametreler

Ad	Tür	Açıklama
`transform`	`AffineTransform`	Bu sayfa öğesinin dönüşümüne önceden bağlanacak dönüşüm.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 sayfa öğesi içeriyorsa veya hiç sayfa öğesi içermiyorsa grubun kendisi de kaldırılır.

Bir ana slaytta veya düzende PageElement yer tutucusu kaldırılırsa devralınan boş yer tutucular da kaldırılır.

Yetkilendirme

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

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

`removeLink()`

Bir Link kaldırır.

shape.removeLink();

`replaceWithImage(blobSource)`

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

Resim, ekleme zamanında bir kez sağlanan BlobSource aracından getirilir ve bir kopyası sunu içinde gösterilmek üzere saklanır. Resimler 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.

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

Parametreler

Ad	Tür	Açıklama
`blobSource`	`BlobSource`	Resim verileri.

Return

Image: Şekli değiştiren Image.

Yetkilendirme

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

Eklenen resim bir kez BlobSource üzerinden getirilir ve bir kopyası sunu içinde gösterilmek üzere saklanır. Resimlerin boyutu 50 MB'tan küçük, 25 megapikseli aşmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.

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

Parametreler

Ad	Tür	Açıklama
`blobSource`	`BlobSource`	Resim verileri.
`crop`	`Boolean`	`true` ise resmi mevcut şeklin boyutuna sığacak şekilde kırpar. Aksi takdirde, resim ölçeklendirilir ve ortalanır.

Return

Image: Şekli değiştiren Image.

Yetkilendirme

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

Eklenen resim bir kez URL'den getirilir ve bir kopyası sunuda görüntülenmek üzere saklanır. Resimlerin boyutu 50 MB'tan küçük, 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() aracılığıyla gösterilir.

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

Parametreler

Ad	Tür	Açıklama
`imageUrl`	`String`	Görselin indirileceği görselin URL'si.

Return

Image: Şekli değiştiren Image.

Yetkilendirme

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

Sağlanan URL 2 kB'tan büyük olmamalıdır. URL'nin kendisi resimle birlikte kaydedilir ve Image.getSourceUrl() aracılığıyla gösterilir.

Parametreler

Ad	Tür	Açıklama
`imageUrl`	`String`	Görselin indirileceği görselin URL'si.
`crop`	`Boolean`	`true` ise resmi mevcut şeklin boyutuna sığacak şekilde kırpar. Aksi takdirde, resim ölçeklendirilir ve ortalanır.

Return

Image: Şekli değiştiren Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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, güncellenmesine olanak tanıyan kaynak Google E-Tablolar grafiğine bağlıdır. Diğer ortak çalışanlar kaynak e-tablonun bağlantısını görebilir.

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

Parametreler

Ad	Tür	Açıklama
`sourceChart`	`EmbeddedChart`	Şeklin yerini alan e-tablodaki grafik.

Return

SheetsChart: Şeklin yerini alan grafik.

Yetkilendirme

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

Grafik resmi, kaynak Google E-Tablolar grafiğine bağlı değil.

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

Parametreler

Ad	Tür	Açıklama
`sourceChart`	`EmbeddedChart`	Şeklin yerini alan e-tablodaki grafik.

Return

Image: Şeklin yerini alan grafiğin resmi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 orana göre ölçeklendirir. Öğenin yüksekliği, öğe döndürme olduğunda sınırlayıcı kutusunun yüksekliğidir.

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

Parametreler

Ad	Tür	Açıklama
`ratio`	`Number`	Bu sayfa öğesinin yüksekliğini ölçeklendirme oranı.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 orana göre ölçeklendirir. Öğenin genişliği, öğe döndürme olduğunda sınırlayıcı kutusunun genişliğidir.

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

Parametreler

Ad	Tür	Açıklama
`ratio`	`Number`	Bu sayfa öğesinin genişliğini ölçekleme oranı.

Return

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

Yetkilendirme

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

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

`select()`

Etkin sunuda yalnızca PageElement öğesini seçer ve önceki seçimleri kaldırır. Bu, true ile select(replace) numarasını aramak ile aynıdır.

Bir komut dosyası yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve komut dosyasının sunuya bağlı olması gerekir.

Bu işlem, PageElement öğesinin üst Page öğesini current page selection olarak ayarlar.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

Yetkilendirme

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

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

`select(replace)`

Etkin sunuda PageElement öğesini seçer.

Bir komut dosyası yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve komut dosyasının sunuya bağlı olması gerekir.

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

Birden çok PageElement nesnesi seçmek için false değerini geçirin. PageElement nesneleri aynı Page içinde olmalıdır.

false parametresi kullanılarak sayfa öğesi seçilirken aşağıdaki koşullar karşılanmalıdır:

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

Bu durumun söz konusu olduğundan emin olmak için tercih edilen yaklaşım, önce Page.selectAsCurrentPage() kullanarak üst Page öğesini, ardından bu sayfadaki sayfa öğelerini seçmektir.

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

Parametreler

Ad	Tür	Açıklama
`replace`	`Boolean`	`true` ise önceki seçimlerin yerini alır; aksi takdirde önceki seçimlere eklenir.

Yetkilendirme

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

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

`sendBackward()`

Sayfa öğesini bir öğe tarafından sayfada geriye doğru gönderir.

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 özelliğini ayarlar.

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

Parametreler

Ad	Tür	Açıklama
`contentAlignment`	`ContentAlignment`	Ayarlanacak hizalama.

Return

Shape — Bu şekil, zincirleme için kullanılır.

Yetkilendirme

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

Yöntem, Group öğeleri için desteklenmiyor.

// Set the first page element's alt text description to "new alt text description".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

Parametreler

Ad	Tür	Açıklama
`description`	`String`	Alternatif metin açıklamasının ayarlanacağı dize.

Return

Shape — Bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 noktalar halinde ayarlar. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun yüksekliğidir.

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

Parametreler

Ad	Tür	Açıklama
`height`	`Number`	Bu sayfa öğesinin nokta cinsinden ayarlanacak yeni yüksekliği.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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ürme olduğunda sayfanın sol üst köşesinden ölçülen noktalar cinsinden ayarlar.

Parametreler

Ad	Tür	Açıklama
`left`	`Number`	Nokta cinsinden ayarlanacak yeni yatay konum.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 bir Link öğesini belirtilen Slide olarak ayarlar.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

Parametreler

Ad	Tür	Açıklama
`slideIndex`	`Integer`	Slaytın sıfır tabanlı dizini.

Return

Link — ayarlanan Link

Yetkilendirme

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

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

`setLinkSlide(slide)`

Link öğesini belirtilen Slide değerine ayarlarsa bağlantı, belirtilen slayt kimliğine göre ayarlanır.

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

Parametreler

Ad	Tür	Açıklama
`slide`	`Slide`	Bağlanacak `Slide`.

Return

Link — ayarlanan Link

Yetkilendirme

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

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

`setLinkSlide(slidePosition)`

Slaytın göreli konumunu kullanarak belirli bir Slide için Link ayarlar.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

Parametreler

Ad	Tür	Açıklama
`slidePosition`	`SlidePosition`	Göreli `SlidePosition`.

Return

Link — ayarlanan Link

Yetkilendirme

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

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

`setLinkUrl(url)`

Belirli boş olmayan URL dizesine Link ayarlar.

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

Parametreler

Ad	Tür	Açıklama
`url`	`String`	URL dizesi.

Return

Link — ayarlanan Link

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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ında saat yönünde dönme açısını derece cinsinden ayarlar.

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

Parametreler

Ad	Tür	Açıklama
`angle`	`Number`	Derece cinsinden ayarlanacak yeni saat yönünde dönme açısı.

Return

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

Yetkilendirme

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

Yöntem, Group öğeleri için desteklenmiyor.

// Set the first page element's alt text title to "new alt text title".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

Parametreler

Ad	Tür	Açıklama
`title`	`String`	Alternatif metin başlığının ayarlanacağı dize.

Return

Shape — Bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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ürme olduğunda, sayfanın sol üst köşesinden ölçülen, öğenin dikey konumunu noktalar cinsinden ayarlar.

Parametreler

Ad	Tür	Açıklama
`top`	`Number`	Nokta cinsinden ayarlanacak yeni dikey konum.

Return

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

Yetkilendirme

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

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

`setTransform(transform)`

Sağlanan dönüşümle sayfa öğesinin dönüşümünü ayarlar.

Bir grubun dönüşümünün güncellenmesi, söz konusu gruptaki sayfa öğelerinin mutlak dönüşümünü değiştirir ve bu da görsel görünümlerini değiştirebilir.

Bir gruptaki 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() bölümüne bakın.

Parametreler

Ad	Tür	Açıklama
`transform`	`AffineTransform`	Bu sayfa öğesi için ayarlanan dönüşüm.

Return

Shape: Zincirleme için bu öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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, noktalar halinde ayarlar. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun genişliğidir.

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

Parametreler

Ad	Tür	Açıklama
`width`	`Number`	Bu sayfa öğesinin nokta cinsinden ayarlanacak yeni genişliği.

Return

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

Yetkilendirme

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

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