Class Line

LINE

線を表す PageElement。

Methods

メソッド戻り値の型概要
alignOnPage(alignmentPosition)Lineページ上の指定された配置位置に要素を揃えます。
bringForward()Lineページ上のページ要素を 1 つ前の要素に移動します。
bringToFront()Lineページ要素をページの前面に移動します。
duplicate()PageElementページ要素を複製します。
getConnectionSites()ConnectionSite[]ページ要素に含まれる ConnectionSite のリストを返します。ページ要素に接続サイトがない場合は空のリストを返します。
getDashStyle()DashStyle行の DashStyle を取得します。
getDescription()Stringページ要素の代替テキストの説明を返します。
getEnd()Pointページの左上隅から計測した線の終点を返します。
getEndArrow()ArrowStyle行の末尾にある矢印の ArrowStyle を取得します。
getEndConnection()ConnectionSite行の最後に接続を返します。接続がない場合は null を返します。
getHeight()Number要素の高さ（ポイント単位）を取得します。これは、要素が回転していない場合の要素の境界ボックスの高さです。
getInherentHeight()Number要素固有の高さをポイント単位で返します。
getInherentWidth()Number要素固有の幅をポイント数で返します。
getLeft()Number要素の水平方向の位置をポイント数で返します。要素が回転していない場合に、ページの左上隅から測定されます。
getLineCategory()LineCategory行の LineCategory を取得します。
getLineFill()LineFill行の LineFill を取得します。
getLineType()LineType行の LineType を取得します。
getLink()Linkリンクがない場合は Link または null を返します。
getObjectId()Stringこのオブジェクトの一意の ID を返します。
getPageElementType()PageElementTypeページ要素のタイプを PageElementType 列挙型で返します。
getParentGroup()Groupこのページ要素が属するグループを返します。要素がグループ内にない場合は null を返します。
getParentPage()Pageこのページ要素が配置されているページを返します。
getRotation()Number要素の中心を中心とする時計回りの回転角度を度数で返します。0 度は回転していないことを意味します。
getStart()Pointページの左上隅から計測した線の始点を返します。
getStartArrow()ArrowStyle行の先頭にある矢印の ArrowStyle を取得します。
getStartConnection()ConnectionSite行の先頭の接続を返します。接続がない場合は null を返します。
getTitle()Stringページ要素の代替テキストのタイトルを返します。
getTop()Number要素が回転していないときに、ページの左上隅から測定したポイント単位で要素の垂直位置を取得します。
getTransform()AffineTransformページ要素の変換を返します。
getWeight()Number線の太さをポイント単位で返します。
getWidth()Number要素の幅をポイント単位で返します。これは、要素が回転していない場合の要素の境界ボックスの幅です。
isConnector()Boolean線がコネクタの場合は true、そうでない場合は false を返します。
preconcatenateTransform(transform)Line指定された変換をページ要素の既存の変換に事前連結します。
remove()voidページ要素を削除します。
removeLink()voidLink を削除します。
reroute()Line線の始点と終点を、接続されたページ要素で最も近い 2 つの接続サイトに再ルーティングします。
scaleHeight(ratio)Line指定された比率で要素の高さをスケーリングします。
scaleWidth(ratio)Line指定された比率で要素の幅を拡大縮小します。
select()voidアクティブなプレゼンテーション内の PageElement のみを選択し、以前の選択を削除します。
select(replace)voidアクティブなプレゼンテーションの PageElement を選択します。
sendBackward()Lineページ要素を 1 つ分、ページの後方に移動します。
sendToBack()Lineページ要素をページの裏側に移動します。
setDashStyle(style)Line行の DashStyle を設定します。
setDescription(description)Lineページ要素の代替テキストの説明を設定します。
setEnd(left, top)Line線の終点の位置を設定します。
setEnd(point)Line線の終点の位置を設定します。
setEndArrow(style)Line行の最後に矢印の ArrowStyle を設定します。
setEndConnection(connectionSite)Line行の最後に接続を設定します。
setHeight(height)Line要素の高さをポイント単位で設定します。これは、要素が回転していない場合の要素の境界ボックスの高さです。
setLeft(left)Line要素が回転していない場合に、ページの左上隅から測定して、要素の水平方向の位置をポイント単位で設定します。
setLineCategory(lineCategory)Line行の LineCategory を設定します。
setLinkSlide(slideIndex)Linkスライドのゼロから始まるインデックスを使用して、Link を指定された Slide に設定します。
setLinkSlide(slide)LinkLink を指定された Slide に設定します。リンクは指定されたスライド ID によって設定されます。
setLinkSlide(slidePosition)Linkスライドの相対位置を使用して、Link を指定された Slide に設定します。
setLinkUrl(url)LinkLink を指定された空でない URL 文字列に設定します。
setRotation(angle)Line要素の中心を中心とする時計回りの回転角度を度単位で設定します。
setStart(left, top)Line線の始点の位置を設定します。
setStart(point)Line線の始点の位置を設定します。
setStartArrow(style)Line行の先頭に矢印の ArrowStyle を設定します。
setStartConnection(connectionSite)Line行の先頭に接続を設定します。
setTitle(title)Lineページ要素の代替テキストのタイトルを設定します。
setTop(top)Line要素が回転していないときに、ページの左上隅から測定したポイント単位で要素の垂直位置を設定します。
setTransform(transform)Line指定された変換でページ要素の変換を設定します。
setWeight(points)Line線の太さをポイント単位で設定します。
setWidth(width)Line要素の幅をポイント単位で設定します。これは、要素が回転していない場合の要素の境界ボックスの幅です。

詳細なドキュメント

alignOnPage(alignmentPosition)

ページ上の指定された配置位置に要素を揃えます。

パラメータ

名前型説明
alignmentPositionAlignmentPositionページ上のこのページ要素を配置する位置。

リターン

Line - このページ要素（チェーン用）。

bringForward()

ページ上のページ要素を 1 つ前の要素に移動します。

ページ要素をグループに含めることはできません。

リターン

Line - このページ要素（チェーン用）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

bringToFront()

ページ要素をページの前面に移動します。

ページ要素をグループに含めることはできません。

リターン

Line - このページ要素（チェーン用）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

duplicate()

ページ要素を複製します。

複製したページ要素は、同じページのオリジナルと同じ位置に配置されます。

リターン

PageElement - このページ要素の新しい重複。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getConnectionSites()

ページ要素に含まれる ConnectionSite のリストを返します。ページ要素に接続サイトがない場合は空のリストを返します。

リターン

ConnectionSite[] - 接続サイトのリスト。この要素に接続サイトがない場合は空になることがあります。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getDashStyle()

行の DashStyle を取得します。

リターン

DashStyle - この線で使用される破線のスタイル。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getDescription()

ページ要素の代替テキストの説明を返します。description はタイトルと組み合わされ、代替テキストの表示と読み上げを行います。

リターン

String - ページ要素の代替テキストの説明。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getEnd()

ページの左上隅から計測した線の終点を返します。

リターン

Point - 線の終点。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getEndArrow()

行の末尾にある矢印の ArrowStyle を取得します。

リターン

ArrowStyle - この線の終端にある矢印のスタイル。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getEndConnection()

行の最後に接続を返します。接続がない場合は null を返します。

リターン

ConnectionSite - 線の終点の接続。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getHeight()

要素の高さ（ポイント単位）を取得します。これは、要素が回転していない場合の要素の境界ボックスの高さです。

この方法は、すべてのページ要素に対応していません。このメソッドに対応していないページ要素については、 サイズと配置の制限をご覧ください。

リターン

Number - ページ要素に固有の高さ（ポイント単位）。ページ要素に高さがない場合は null。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getInherentHeight()

要素固有の高さをポイント数で返します。

ページ要素の変換は、その固有のサイズに対応して行われます。固有のサイズを要素の変換と組み合わせて、要素の最終的な外観を判断します。

リターン

Number - ページ要素に固有の高さ（ポイント単位）。ページ要素に高さがない場合は null。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getInherentWidth()

要素固有の幅（ポイント数）を返します。

ページ要素の変換は、その固有のサイズに対応して行われます。固有のサイズを要素の変換と組み合わせて、要素の最終的な外観を判断します。

リターン

Number - ページ要素固有の幅（ポイント単位）。ページ要素に幅がない場合は null。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getLeft()

要素の水平方向の位置をポイント数で返します。要素が回転していない場合に、ページの左上隅から測定されます。

リターン

Number - この要素の水平位置（ページの左上隅からのポイント数）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getLineCategory()

行の LineCategory を取得します。

リターン

LineCategory - 線のカテゴリ。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getLineFill()

行の LineFill を取得します。

リターン

LineFill - この線の塗りつぶし設定。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getLineType()

行の LineType を取得します。

リターン

LineType - この線の種類。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

リンクがない場合は Link または null を返します。 

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

リターン

Link

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getObjectId()

このオブジェクトの一意の ID を返します。ページとページ要素で使用されるオブジェクト ID は同じ名前空間を共有します。

リターン

String - このオブジェクトの一意の ID。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getPageElementType()

ページ要素のタイプを PageElementType 列挙型で返します。

リターン

PageElementType - ページ要素のタイプ。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getParentGroup()

このページ要素が属するグループを返します。要素がグループ内にない場合は null を返します。

リターン

Group - このページ要素が属するグループまたは null。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getParentPage()

このページ要素が配置されているページを返します。

リターン

Page - この要素が存在するページ。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getRotation()

要素の中心を中心とする時計回りの回転角度を度数で返します。0 度は回転していないことを意味します。

リターン

Number - 回転角度（0 度以上 360 度未満）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getStart()

ページの左上隅から計測した線の始点を返します。

リターン

Point - 線の始点。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getStartArrow()

行の先頭にある矢印の ArrowStyle を取得します。

リターン

ArrowStyle - この線の先頭にある矢印のスタイル。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getStartConnection()

行の先頭の接続を返します。接続がない場合は null を返します。

リターン

ConnectionSite - 行の先頭の接続。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getTitle()

ページ要素の代替テキストのタイトルを返します。タイトルは説明と組み合わされて、代替テキストが表示され、読み上げられます。

リターン

String - ページ要素の代替テキストのタイトル。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getTop()

要素が回転していないときに、ページの左上隅から測定したポイント単位で要素の垂直位置を取得します。

リターン

Number - この要素の垂直位置（ページの左上からのポイント数）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getTransform()

ページ要素の変換を返します。

ページ要素の外観は、その絶対的な変換によって決まります。絶対変換を計算するには、ページ要素の変換とそのすべての親グループの変換を事前連結します。ページ要素がグループにない場合、その絶対変換はこのフィールドの値と同じです。

リターン

AffineTransform - ページ要素の変換。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getWeight()

線の太さをポイント単位で返します。

リターン

Number - 線の太さ（ポイント単位）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

getWidth()

要素の幅をポイント単位で返します。これは、要素が回転していない場合の要素の境界ボックスの幅です。

この方法は、すべてのページ要素に対応していません。このメソッドに対応していないページ要素については、 サイズと配置の制限をご覧ください。

リターン

Number - ページ要素固有の幅（ポイント単位）。ページ要素に幅がない場合は null。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

isConnector()

線がコネクタの場合は true、そうでない場合は false を返します。

コネクタは、該当するページ要素で接続サイトを接続するために使用される線の一種です。コネクタの各端は、最大 1 つの接続サイトに接続できます。

リターン

Boolean - 線がコネクタの場合は True、そうでない場合は false。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

preconcatenateTransform(transform)

指定された変換をページ要素の既存の変換に事前連結します。

newTransform = argument * existingTransform

たとえば、ページ要素を 36 ポイント左に移動するには:

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

ページ要素の変換を setTransform(transform) に置き換えることもできます。

パラメータ

名前型説明
transformAffineTransformこのページ要素の変換に事前連結する変換。

リターン

Line - このページ要素（チェーン用）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

remove()

ページ要素を削除します。

削除操作の後、Group にページ要素が 1 つだけ含まれているか、まったく含まれていない場合、グループ自体も削除されます。

プレースホルダ PageElement がマスターまたはレイアウトから削除されると、空の継承プレースホルダも削除されます。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

Link を削除します。 

shape.removeLink();

reroute()

線の始点と終点を、接続されたページ要素で最も近い 2 つの接続サイトに再ルーティングします。線の始点と終点は、異なるページ要素に接続する必要があります。

リターン

Line - 線。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

scaleHeight(ratio)

指定された比率で要素の高さをスケーリングします。要素の高さは、要素が回転していない場合の境界ボックスの高さです。

この方法は、すべてのページ要素に対応していません。このメソッドに対応していないページ要素については、 サイズと配置の制限をご覧ください。

パラメータ

名前型説明
ratioNumberこのページ要素の高さをスケーリングする比率。

リターン

Line - このページ要素（チェーン用）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

scaleWidth(ratio)

指定された比率で要素の幅を拡大縮小します。要素の幅は、要素に回転がない場合の境界ボックスの幅です。

この方法は、すべてのページ要素に対応していません。このメソッドに対応していないページ要素については、 サイズと配置の制限をご覧ください。

パラメータ

名前型説明
ratioNumberこのページ要素の幅をスケーリングする比率。

リターン

Line - このページ要素（チェーン用）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

select()

アクティブなプレゼンテーション内の PageElement のみを選択し、以前の選択を削除します。これは、true を指定して select(replace) を呼び出す場合と同じです。

スクリプトがアクセスできるのは、スクリプトを実行しているユーザーの選択で、かつスクリプトがプレゼンテーションにバインドされている場合のみです。

これにより、PageElement の親 Page が current page selection に設定されます。 

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

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

select(replace)

アクティブなプレゼンテーションの PageElement を選択します。

スクリプトがアクセスできるのは、スクリプトを実行しているユーザーの選択で、かつスクリプトがプレゼンテーションにバインドされている場合のみです。

このメソッドに true を渡すと、PageElement のみが選択され、以前の選択は削除されます。これにより、PageElement の親 Page も current page selection に設定されます。

false を渡して、複数の PageElement オブジェクトを選択します。PageElement オブジェクトは同じ Page に存在する必要があります。

false パラメータを使用してページ要素を選択する際は、次の条件を満たす必要があります。

  1. PageElement オブジェクトの親 Page は、current page selection である必要があります。
  2. 複数の Page オブジェクトを選択しないでください。

これを確認するには、最初に Page.selectAsCurrentPage() を使用して親 Page を選択し、次にそのページのページ要素を選択することをおすすめします。 

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);
}

パラメータ

名前型説明
replaceBooleantrue の場合、選択内容は前の選択を置き換えます。それ以外の場合、選択は前の選択に追加されます。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

sendBackward()

ページ要素をページ上で 1 要素分、後方に移動します。

ページ要素をグループに含めることはできません。

リターン

Line - このページ要素（チェーン用）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

sendToBack()

ページ要素をページの背面に移動します。

ページ要素をグループに含めることはできません。

リターン

Line - このページ要素（チェーン用）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setDashStyle(style)

行の DashStyle を設定します。

パラメータ

名前型説明
styleDashStyleこの線に設定する破線のスタイル。

リターン

Line - チェーン用のこの行。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setDescription(description)

ページ要素の代替テキストの説明を設定します。

このメソッドは、Group 要素ではサポートされていません。 

// 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());

パラメータ

名前型説明
descriptionString代替テキストの説明を設定する文字列。

リターン

Line - このページの要素。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setEnd(left, top)

線の終点の位置を設定します。

行パスは、位置の変更後に調整される場合があります。

パラメータ

名前型説明
leftNumber線の終点の水平方向の位置。ページの左上隅からのポイント数で指定します。
topNumber線の終点の垂直位置。ページの左上隅からのポイント数で示されます。

リターン

Line - チェーン用のこの行。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setEnd(point)

線の終点の位置を設定します。

行パスは、位置の変更後に調整される場合があります。

パラメータ

名前型説明
pointPoint線の終点。この位置は、ページの左上隅から計測します。

リターン

Line - チェーン用のこの行。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setEndArrow(style)

行の最後に矢印の ArrowStyle を設定します。

パラメータ

名前型説明
styleArrowStyle設定するスタイル。

リターン

Line - チェーン用のこの行。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setEndConnection(connectionSite)

行の最後に接続を設定します。線の終端は指定された接続サイトに移動しますが、もう一方の端はそのままです。

パラメータ

名前型説明
connectionSiteConnectionSite終了接続が更新される接続サイト。終了接続を削除する場合は null。

リターン

Line - 線。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setHeight(height)

要素の高さをポイント単位で設定します。これは、要素が回転していない場合の要素の境界ボックスの高さです。

この方法は、すべてのページ要素に対応していません。このメソッドに対応していないページ要素については、 サイズと配置の制限をご覧ください。

パラメータ

名前型説明
heightNumber設定するこのページ要素の新しい高さ（ポイント単位）。

リターン

Line - このページ要素（チェーン用）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setLeft(left)

要素が回転していない場合に、ページの左上隅から測定して、要素の水平方向の位置をポイント単位で設定します。

パラメータ

名前型説明
leftNumber設定する新しい水平位置（ポイント単位）。

リターン

Line - このページ要素（チェーン用）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setLineCategory(lineCategory)

行の LineCategory を設定します。

カテゴリは connectors でのみ設定できます。カテゴリの変更後にコネクタが再ルーティングされる場合があります。

パラメータ

名前型説明
lineCategoryLineCategory設定する回線のカテゴリ。

リターン

Line - 線。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setLinkSlide(slideIndex)

スライドのゼロから始まるインデックスを使用して、指定された Slide に Link を設定します。 

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

パラメータ

名前型説明
slideIndexIntegerスライドのゼロから始まるインデックス。

リターン

Link - 設定された Link

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setLinkSlide(slide)

Link を指定された Slide に設定します。リンクは指定されたスライド ID で設定されます。 

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

パラメータ

名前型説明
slideSlideリンクする Slide。

リターン

Link - 設定された Link

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setLinkSlide(slidePosition)

スライドの相対位置を使用して、Link を指定された Slide に設定します。 

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

パラメータ

名前型説明
slidePositionSlidePosition相対 SlidePosition。

リターン

Link - 設定された Link

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setLinkUrl(url)

Link を指定された空でない URL 文字列に設定します。 

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

パラメータ

名前型説明
urlStringURL 文字列。

リターン

Link - 設定された Link

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setRotation(angle)

要素の中心を中心とする時計回りの回転角度を度単位で設定します。

この方法は、すべてのページ要素に対応していません。このメソッドに対応していないページ要素については、 サイズと配置の制限をご覧ください。

パラメータ

名前型説明
angleNumber新たに設定する時計回りの回転角度（度数）。

リターン

Line - このページ要素（チェーン用）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setStart(left, top)

線の始点の位置を設定します。

行パスは、位置の変更後に調整される場合があります。

パラメータ

名前型説明
leftNumber線の始点の水平方向の位置。ページの左上隅からのポイント数で表されます。
topNumber線の始点の垂直位置。ページの左上隅からのポイント数で示されます。

リターン

Line - チェーン用のこの行。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setStart(point)

線の始点の位置を設定します。

行パスは、位置の変更後に調整される場合があります。

パラメータ

名前型説明
pointPoint線の始点。位置は、ページの左上隅です。

リターン

Line - チェーン用のこの行。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setStartArrow(style)

行の先頭に矢印の ArrowStyle を設定します。

パラメータ

名前型説明
styleArrowStyle設定する新しい矢印スタイル。

リターン

Line - チェーン用のこの行。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setStartConnection(connectionSite)

行の先頭に接続を設定します。行の先頭を指定された接続サイトに移動しますが、もう一方の端はそのままです。

パラメータ

名前型説明
connectionSiteConnectionSite開始接続が更新される先の接続サイト。開始接続を削除する場合は null。

リターン

Line - 線。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setTitle(title)

ページ要素の代替テキストのタイトルを設定します。

このメソッドは、Group 要素ではサポートされていません。 

// 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());

パラメータ

名前型説明
titleString代替テキストのタイトルを設定する文字列。

リターン

Line - このページの要素。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setTop(top)

要素が回転していないときに、ページの左上隅から測定したポイント単位で要素の垂直位置を設定します。

パラメータ

名前型説明
topNumber設定する新しい垂直位置（ポイント単位）。

リターン

Line - このページ要素（チェーン用）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setTransform(transform)

指定された変換でページ要素の変換を設定します。

グループの変換を更新すると、そのグループ内のページ要素の絶対変換が変更され、視覚的外観が変わる可能性があります。

グループ内のページ要素の変換を更新しても、そのページ要素の変換のみが変更され、グループまたはグループ内の他のページ要素の変換には影響しません。

変換がページ要素の外観に与える影響について詳しくは、getTransform() をご覧ください。

パラメータ

名前型説明
transformAffineTransformこのページ要素に設定されている変換。

リターン

Line - チェーン用のこの要素。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setWeight(points)

線の太さをポイント単位で設定します。

パラメータ

名前型説明
pointsNumber線の新しい太さ（ポイント単位）。

リターン

Line - チェーン用のこの行。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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

setWidth(width)

要素の幅をポイント単位で設定します。これは、要素が回転していない場合の要素の境界ボックスの幅です。

この方法は、すべてのページ要素に対応していません。このメソッドに対応していないページ要素については、 サイズと配置の制限をご覧ください。

パラメータ

名前型説明
widthNumber設定するこのページ要素の新しい幅（ポイント単位）。

リターン

Line - このページ要素（チェーン用）。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

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