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

Class Shape

Daha spesifik olmayan genel bir şekli temsil eden PageElement en iyi uygulamaları görelim. Metin kutuları, dikdörtgenler ve diğer önceden tanımlanmış şekiller içerir.

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`alignOnPage(alignmentPosition)`	`Shape`	Öğeyi, sayfada belirtilen hizalama konumuna hizalar.
`bringForward()`	`Shape`	Sayfa öğesini bir öğe ilerletir.
`bringToFront()`	`Shape`	Sayfa öğesini sayfanın ön tarafına getirir.
`duplicate()`	`PageElement`	Sayfa öğesini kopyalar.
`getAutofit()`	`Autofit`	Bu şekil içindeki metnin `Autofit` değerini döndürür.
`getBorder()`	`Border`	Şeklin `Border` değerini döndürür.
`getConnectionSites()`	`ConnectionSite[]`	Sayfa öğesindeki `ConnectionSite` listesini veya sayfaysa boş bir listeyi döndürür öğesinin herhangi bir bağlantı sitesi yok.
`getContentAlignment()`	`ContentAlignment`	Şekildeki metnin `ContentAlignment` değerini döndürür.
`getDescription()`	`String`	Sayfa öğesinin alternatif metin açıklamasını döndürür.
`getFill()`	`Fill`	Şeklin `Fill` değerini döndürür.
`getHeight()`	`Number`	Öğenin, nokta cinsinden yüksekliğini alır. Bu, öğesinin rotasyonu yok.
`getInherentHeight()`	`Number`	Öğenin doğal yüksekliğini punto cinsinden döndürür.
`getInherentWidth()`	`Number`	Öğenin doğal genişliğini punto olarak döndürür.
`getLeft()`	`Number`	Öğenin, öğenin sol üst köşesinden ölçülen, noktalardaki yatay konumunu döndürür sayfa için bir değer girin.
`getLink()`	`Link`	Bağlantı yoksa `Link` veya `null` değerini döndürür.
`getObjectId()`	`String`	Bu nesnenin benzersiz kimliğini döndürür.
`getPageElementType()`	`PageElementType`	Sayfa öğesinin `PageElementType` sıralaması ile temsil edilen türünü döndürür.
`getParentGroup()`	`Group`	Bu sayfa öğesinin ait olduğu grubu veya öğe bir`null` grubu.
`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 değilse `PlaceholderType.NONE` değerini döndürür yer tutucudur.
`getRotation()`	`Number`	Öğenin, merkezi etrafında saat yönünde dönüş açısını derece cinsinden döndürür (sıfır derece) rotasyon 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, sayfanın sol üst köşesinden ölçülen noktalardaki dikey konumunu alır öğe döndürülmediğinde.
`getTransform()`	`AffineTransform`	Sayfa öğesinin dönüşümünü döndürür.
`getWidth()`	`Number`	Nokta cinsinden öğenin genişliğini döndürür. Bu, söz konusu olduğunda öğenin sınırlayıcı kutusunun genişliğidir öğede rotasyon yok.
`preconcatenateTransform(transform)`	`Shape`	Sağlanan dönüşümü, sayfa öğesinin mevcut dönüşümüyle önceden birleştirir.
`remove()`	`void`	Sayfa öğesini kaldırır.
`removeLink()`	`void`	`Link` kaldırılır.
`replaceWithImage(blobSource)`	`Image`	Bu şekli, `BlobSource` tarafından sağlanan bir resimle değiştirir.
`replaceWithImage(blobSource, crop)`	`Image`	Bu şekli, `BlobSource` tarafından sağlanan bir resimle değiştirir.
`replaceWithImage(imageUrl)`	`Image`	Bu şekli bir resimle değiştirir.
`replaceWithImage(imageUrl, crop)`	`Image`	Bu şekli bir resimle değiştirir.
`replaceWithSheetsChart(sourceChart)`	`SheetsChart`	Bu şekli bir Google E-Tablolar grafiğiyle değiştirir.
`replaceWithSheetsChartAsImage(sourceChart)`	`Image`	Bu şekli bir Google E-Tablolar grafiği resmiyle değiştirir.
`scaleHeight(ratio)`	`Shape`	Öğenin yüksekliğini belirtilen orana göre ölçeklendirir.
`scaleWidth(ratio)`	`Shape`	Öğenin genişliğini belirtilen orana göre ölçeklendirir.
`select()`	`void`	Etkin sunuda yalnızca `PageElement` öğesini seçer ve daha öncekileri kaldırır seçim.
`select(replace)`	`void`	Etkin sunudaki `PageElement` öğesini seçer.
`sendBackward()`	`Shape`	Sayfa öğesini bir öğe geri gönderir.
`sendToBack()`	`Shape`	Sayfa öğesini sayfanın arkasına gönderir.
`setContentAlignment(contentAlignment)`	`Shape`	Şekildeki metnin `ContentAlignment` özelliğini ayarlar.
`setDescription(description)`	`Shape`	Sayfa öğesinin alternatif metin açıklamasını ayarlar.
`setHeight(height)`	`Shape`	Nokta cinsinden öğenin yüksekliğini ayarlar. Bu, öğesinin rotasyonu yok.
`setLeft(left)`	`Shape`	Noktalarda öğenin yatay konumunu ayarlar. Konum, grafiğin sol üst köşesinden sayfa için bir değer girin.
`setLinkSlide(slideIndex)`	`Link`	Slaytın sıfır tabanlı dizinini kullanarak belirtilen `Slide` için bir `Link` ayarlar.
`setLinkSlide(slide)`	`Link`	Belirtilen `Slide` öğesine bir `Link` ayarlar. Bağlantı, belirtilen slayt kimliğine göre ayarlanır.
`setLinkSlide(slidePosition)`	`Link`	Slaytın göreli konumunu kullanarak, belirtilen `Slide` için bir `Link` ayarlar.
`setLinkUrl(url)`	`Link`	Belirtilen boş olmayan URL dizesine bir `Link` ayarlar.
`setRotation(angle)`	`Shape`	Öğenin saat yönünün çevresindeki dönme açısını derece cinsinden ayarlar.
`setTitle(title)`	`Shape`	Sayfa öğesinin alternatif metin başlığını ayarlar.
`setTop(top)`	`Shape`	Öğenin, sayfanın sol üst köşesinden ölçülen noktalardaki dikey konumunu ayarlar öğe döndürülmediğinde.
`setTransform(transform)`	`Shape`	Sağlanan dönüşümle sayfa öğesinin dönüşümünü ayarlar.
`setWidth(width)`	`Shape`	Noktalar cinsinden öğenin genişliğini ayarlar. Bu, öğesinin rotasyonu yok.

Ayrıntılı belgeler

`alignOnPage(alignmentPosition)`

Öğeyi, sayfada belirtilen hizalama konumuna hizalar.

Parametreler

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

Return

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

`bringForward()`

Sayfa öğesini bir öğe ilerletir.

Sayfa öğesi bir grupta yer almamalıdır.

Return

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

Yetkilendirme

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

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

`bringToFront()`

Sayfa öğesini sayfanın ön tarafına getirir.

Sayfa öğesi bir grupta yer almamalıdır.

Return

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

Yetkilendirme

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

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

`duplicate()`

Sayfa öğesini kopyalar.

Kopya sayfa öğesi, aynı sayfaya, orijinalle aynı konuma yerleştirilir.

Return

PageElement: Bu sayfa öğesinin yeni kopyası.

Yetkilendirme

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

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

`getAutofit()`

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

Return

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

Yetkilendirme

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

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

`getBorder()`

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

Return

Border — Bu şeklin kenarlık ayarı.

Yetkilendirme

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

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

`getConnectionSites()`

Sayfa öğesindeki ConnectionSite listesini veya sayfaysa boş bir listeyi döndürür öğesinin herhangi bir bağlantı sitesi yok.

Return

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

Yetkilendirme

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

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

`getContentAlignment()`

Şekildeki metnin ContentAlignment değerini döndürür.

Return

ContentAlignment — Bu şekil içindeki metnin hizalaması.

Yetkilendirme

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

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

`getDescription()`

Sayfa öğesinin alternatif metin açıklamasını döndürür. Açıklama, başlıkla birleştirilir. alternatif metin görüntüleyip okuyabilir.

Return

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

Yetkilendirme

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

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

`getFill()`

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

Return

Fill — Bu şeklin dolgu ayarı.

Yetkilendirme

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

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

`getHeight()`

Öğenin, nokta cinsinden yüksekliğini alır. Bu, öğesinin rotasyonu yok.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin daha fazla bilgi için Boyutlandırma ve konumlandırma sınırlamaları.

Return

Number: Sayfa öğesinin noktalardaki doğal yüksekliği veya sayfa öğesi varsa null bir yüksekliği yoktur.

Yetkilendirme

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

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

`getInherentHeight()`

Öğenin doğal yüksekliğini punto cinsinden döndürür.

Sayfa öğesinin dönüşümü doğal boyutuna göre değişir. Doğal boyutu şurada kullan: ile birlikte kullanılan dönüşümlerle birlikte gösterilir.

Return

Number: Sayfa öğesinin noktalardaki doğal yüksekliği veya sayfa öğesi varsa null bir yüksekliği yoktur.

Yetkilendirme

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

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

`getInherentWidth()`

Öğenin doğal genişliğini punto olarak döndürür.

Sayfa öğesinin dönüşümü doğal boyutuna göre değişir. Doğal boyutu şurada kullan: ile birlikte kullanılan dönüşümlerle birlikte gösterilir.

Return

Number: Sayfa öğesinin noktalardaki doğal genişliği veya sayfa öğesi varsa null bir genişliği yoktur.

Yetkilendirme

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

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

`getLeft()`

Öğenin, öğenin sol üst köşesinden ölçülen, noktalardaki yatay konumunu döndürür sayfa için bir değer girin.

Return

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

Yetkilendirme

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

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

`getLink()`

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

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

Return

Link

Yetkilendirme

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

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

`getObjectId()`

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

Return

String: Bu nesnenin benzersiz kimliği.

Yetkilendirme

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

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

`getPageElementType()`

Sayfa öğesinin PageElementType sıralaması ile temsil edilen türünü döndürür.

Return

PageElementType: Sayfa öğesinin türü.

Yetkilendirme

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

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

`getParentGroup()`

Bu sayfa öğesinin ait olduğu grubu veya öğe birnull grubu.

Return

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

Yetkilendirme

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

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

`getParentPage()`

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

Return

Page: Bu öğenin bulunduğu sayfa.

Yetkilendirme

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

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

`getParentPlaceholder()`

Yer tutucunun üst sayfa öğesini döndürür. Şekilnull yer tutucusu ya da üst öğesi yok.

Return

PageElement — Bu şekil yer tutucusunun üst sayfa öğesi veya bu şekil değilse null veya bir üst öğesi olmaması gerekir.

Yetkilendirme

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

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

`getPlaceholderIndex()`

Şeklin yer tutucu dizinini döndürür. Aynı yer tutucunun iki veya daha fazla örneği aynı sayfada bulunduğundan, bunların her birinin kendi benzersiz dizin değeri vardır. Şekil bir yer tutucu değilse null değerini döndürür.

Return

Integer — Bu şeklin yer tutucu dizinidir. (Şekil bir yer tutucu değilse null)

Yetkilendirme

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

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

`getPlaceholderType()`

Şeklin yer tutucu türünü veya şekil değilse PlaceholderType.NONE değerini döndürür yer tutucudur.

Return

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

Yetkilendirme

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

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

`getRotation()`

Öğenin, merkezi etrafında saat yönünde dönüş açısını derece cinsinden döndürür (sıfır derece) rotasyon olmadığı anlamına gelir.

Return

Number — 0 (dahil) ile 360 (hariç) arasındaki derece cinsinden dönüş açısı.

Yetkilendirme

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

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

`getShapeType()`

Ş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 şeklin içindeki metin her zaman yeni satır karakteriyle sona erer.

Return

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

Yetkilendirme

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

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

`getTitle()`

Sayfa öğesinin alternatif metin başlığını döndürür. Başlık, açıklama ile birleştirilerek alternatif metin görüntüleyip okuyabilir.

Return

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

Yetkilendirme

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

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

`getTop()`

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

Return

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

Yetkilendirme

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

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

`getTransform()`

Sayfa öğesinin dönüşümünü döndürür.

Sayfa öğesinin görsel görünümü, mutlak dönüşümüyle belirlenir. Alıcı: mutlak dönüşümü hesaplama, dönüşümlerle bir sayfa öğesinin dönüşümünü önceden bağlama tüm üst gruplarının içinde yer alır. Sayfa öğesi bir grupta bulunmuyorsa mutlak dönüşümü bu alandaki değerle aynıdır.

Return

AffineTransform: Sayfa öğesinin dönüşümü.

Yetkilendirme

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

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

`getWidth()`

Nokta cinsinden öğenin genişliğini döndürür. Bu, söz konusu olduğunda öğenin sınırlayıcı kutusunun genişliğidir öğede rotasyon yok.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin daha fazla bilgi için Boyutlandırma ve konumlandırma sınırlamaları.

Return

Number: Sayfa öğesinin noktalardaki doğal genişliği veya sayfa öğesi varsa null bir genişliği yoktur.

Yetkilendirme

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

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

`preconcatenateTransform(transform)`

Sağlanan dönüşümü, sayfa öğesinin mevcut dönüşümüyle önceden birleştirir.

newTransform = argument * existingTransform

Örneğin, bir sayfa öğesini 36 nokta sola taşımak için:

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

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

Parametreler

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

Return

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

Yetkilendirme

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

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

`remove()`

Sayfa öğesini kaldırır.

Bir kaldırma işleminden sonra Group yalnızca bir sayfa öğesi içerir veya hiç sayfa öğesi içermezse grubun kendisi de kaldırılır.

Bir ana slaytta veya düzende PageElement yer tutucusu kaldırılırsa boş öğelerin devralması yer tutucular da kaldırılır.

Yetkilendirme

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

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

`removeLink()`

Link kaldırılır.

shape.removeLink();

`replaceWithImage(blobSource)`

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

Resim, ekleme zamanında bir kez sağlanan BlobSource aracından getirilir ve bu kopya sunu içinde görüntülenmek üzere saklanır. Resimlerin boyutu 50 MB'tan küçük olmalıdır; 25 megapikseli aşmalı ve PNG, JPEG veya GIF biçiminde olmalıdır.

Resmin en boy oranını korumak için resim uygun şekilde ölçeklendirilir ve ortalanır boyutunu değiştirmektir.

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

Parametreler

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

Return

Image — Şekli değiştiren Image.

Yetkilendirme

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

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

`replaceWithImage(blobSource, crop)`

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

Resim eklendiğinde BlobSource kaynağından bir kez getirilir ve resmin bir kopyası şu şekilde saklanır: sunum içinde görüntüleyeceksiniz. Resimlerin boyutu 50 MB'tan küçük olmalıdır, 25'ten büyük olamaz. megapiksel boyutunda olmalı 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 halde, resim ölçeklendirilir ve ortalanır.

Return

Image — Şekli değiştiren Image.

Yetkilendirme

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

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

`replaceWithImage(imageUrl)`

Bu şekli bir resimle değiştirir.

Resim eklendiğinde URL'den bir kez getirilir ve resmin bir kopyası en iyi uygulamaları paylaşacağız. Resimler 50 MB'tan küçük olmalı, 25 megapikselden büyük olmamalıdır ve PNG, JPEG veya GIF biçiminde olur.

Sağlanan URL herkesin erişimine açık olmalı ve 2 kB'tan büyük olmamalıdır. URL kaydedilir ve Image.getSourceUrl() üzerinden gösterildiği için resimle birlikte gösterilir.

Resmin en boy oranını korumak için resim uygun şekilde ölçeklendirilir ve ortalanır boyutunu değiştirmektir.

Parametreler

Ad	Tür	Açıklama
`imageUrl`	`String`	Resmin indirileceği resim URL'si.

Return

Image — Şekli değiştiren Image.

Yetkilendirme

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

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

`replaceWithImage(imageUrl, crop)`

Bu şekli bir resimle değiştirir.

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österildi.

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 halde, resim ölçeklendirilir ve ortalanır.

Return

Image — Şekli değiştiren Image.

Yetkilendirme

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

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

`replaceWithSheetsChart(sourceChart)`

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

Bu grafik, güncellenmesine izin veren kaynak Google E-Tablolar grafiğine bağlıdır. Diğer ortak çalışanlar kaynak e-tablonun bağlantısını görebilir.

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

Parametreler

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

Return

SheetsChart — Şeklin yerini alan grafik.

Yetkilendirme

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

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

`replaceWithSheetsChartAsImage(sourceChart)`

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

Google E-Tablolar grafiğinin en boy oranını korumak için grafik resmi ölçeklendirilir ve ortalanacak şekilde oluşturulur.

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

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

Parametreler

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

Return

Image — Şeklin yerini alan grafiğin resmi.

Yetkilendirme

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

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

`scaleHeight(ratio)`

Öğenin yüksekliğini belirtilen orana göre ölçeklendirir. Öğenin yüksekliği, öğenin yüksekliğidir sınırlayıcı kutudur.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin daha fazla bilgi için Boyutlandırma ve konumlandırma sınırlamaları.

Parametreler

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

Return

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

Yetkilendirme

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

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

`scaleWidth(ratio)`

Öğenin genişliğini belirtilen orana göre ölçeklendirir. Öğenin genişliği, öğenin genişliğidir. sınırlayıcı kutudur.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin daha fazla bilgi için Boyutlandırma ve konumlandırma sınırlamaları.

Parametreler

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

Return

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

Yetkilendirme

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

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

`select()`

Etkin sunuda yalnızca PageElement öğesini seçer ve daha öncekileri kaldırır seçim. Bu, true üzerinden select(replace) adlı kişiyi aramakla aynıdır.

Bir komut dosyası, yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve bu işlemin komut dosyası sunuya bağlı olmalıdır.

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

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

Yetkilendirme

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

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

`select(replace)`

Etkin sunudaki PageElement öğesini seçer.

Bir komut dosyası, yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve bu işlemin komut dosyası sunuya bağlı olmalıdır.

Yalnızca PageElement öğesini seçmek ve diğerlerini kaldırmak için bu yönteme true aktarın önceki seçim. Bu işlem ayrıca PageElement öğesinin Page üst öğesini current page selection.

Birden fazla PageElement nesnesi seçmek için false öğesini iletin. PageElement nesneler aynı Page içinde olmalıdır.

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

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

Bu durumun geçerli olduğundan emin olmak için tercih edilen yaklaşım, üst Page olmalıdır. önce Page.selectAsCurrentPage() kullanarak, sonra da bu sayfadaki sayfa öğelerini seçin.

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 bu seçim, önceki seçimlerin yerini alır; Aksi takdirde seçim önceki herhangi bir seçime eklenir.

Yetkilendirme

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

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

`sendBackward()`

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

Sayfa öğesi bir grupta yer almamalıdır.

Return

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

Yetkilendirme

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

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

`sendToBack()`

Sayfa öğesini sayfanın arkasına gönderir.

Sayfa öğesi bir grupta yer almamalıdır.

Return

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

Yetkilendirme

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

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

`setContentAlignment(contentAlignment)`

Şekildeki metnin ContentAlignment özelliğini ayarlar.

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

Parametreler

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

Return

Shape — Zincirleme için bu şekil.

Yetkilendirme

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

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

`setDescription(description)`

Sayfa öğesinin alternatif metin açıklamasını ayarlar.

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

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

Parametreler

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

Return

Shape: Bu sayfa öğesi.

Yetkilendirme

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

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

`setHeight(height)`

Nokta cinsinden öğenin yüksekliğini ayarlar. Bu, öğesinin rotasyonu yok.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin daha fazla bilgi için Boyutlandırma ve konumlandırma sınırlamaları.

Parametreler

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

Return

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

Yetkilendirme

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

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

`setLeft(left)`

Noktalarda öğenin yatay konumunu ayarlar. Konum, grafiğin sol üst köşesinden sayfa için bir değer girin.

Parametreler

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

Return

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

Yetkilendirme

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

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

`setLinkSlide(slideIndex)`

Slaytın sıfır tabanlı dizinini kullanarak belirtilen Slide için bir Link ayarlar.

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

Parametreler

Ad	Tür	Açıklama
`slideIndex`	`Integer`	Slaytın sıfır tabanlı dizin değeri.

Return

Link — ayarlanan Link

Yetkilendirme

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

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

`setLinkSlide(slide)`

Belirtilen Slide öğesine bir Link ayarlar. Bağlantı, belirtilen slayt kimliğine göre ayarlanır.

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

Parametreler

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

Return

Link — ayarlanan Link

Yetkilendirme

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

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

`setLinkSlide(slidePosition)`

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

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

Parametreler

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

Return

Link — ayarlanan Link

Yetkilendirme

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

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

`setLinkUrl(url)`

Belirtilen boş olmayan URL dizesine bir Link ayarlar.

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

Parametreler

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

Return

Link — ayarlanan Link

Yetkilendirme

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

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

`setRotation(angle)`

Öğenin saat yönünün çevresindeki dönme açısını derece cinsinden ayarlar.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin daha fazla bilgi için Boyutlandırma ve konumlandırma sınırlamaları.

Parametreler

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

Return

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

Yetkilendirme

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

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

`setTitle(title)`

Sayfa öğesinin alternatif metin başlığını ayarlar.

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

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

Parametreler

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

Return

Shape: Bu sayfa öğesi.

Yetkilendirme

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

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

`setTop(top)`

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

Parametreler

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

Return

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

Yetkilendirme

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

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

`setTransform(transform)`

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

Bir grubun dönüşümünün güncellenmesi, bu da görsel görünümlerini değiştirebilir.

Bir grupta bulunan sayfa öğesinin dönüşümünün güncellenmesi, yalnızca bu sayfa öğesini kullanabilirsiniz. grubu veya diğer sayfa öğelerinin dönüşümlerini etkilemez: grubu.

Dönüşümlerin, sayfa öğelerinin görsel görünümünü nasıl etkilediğiyle ilgili ayrıntılar için getTransform() bölümüne bakın.

Parametreler

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

Return

Shape: Zincirleme için bu öğe.

Yetkilendirme

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

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

`setWidth(width)`

Noktalar cinsinden öğenin genişliğini ayarlar. Bu, öğesinin rotasyonu yok.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin daha fazla bilgi için Boyutlandırma ve konumlandırma sınırlamaları.

Parametreler

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

Return

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

Yetkilendirme

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

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