Class Line

Line

線を表す PageElement。

メソッド

メソッド戻り値の型概要
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行の末尾にある接続を返します。接続がない場合は null を返します。
getHeight()Number|null要素の高さ（ポイント単位）を取得します。これは、要素に回転がない場合の要素のバウンディング ボックスの高さです。
getInherentHeight()Number|null要素の固有の高さをポイント単位で返します。
getInherentWidth()Number|null要素の固有の幅をポイント単位で返します。
getLeft()Number要素が回転していない場合、ページの左上隅から測定された要素の水平位置をポイント単位で返します。
getLineCategory()LineCategory行の LineCategory を取得します。
getLineFill()LineFill行の LineFill を取得します。
getLineType()LineType行の LineType を取得します。
getLink()Link|nullリンクがない場合は Link または null を返します。
getObjectId()Stringこのオブジェクトの一意の ID を返します。
getPageElementType()PageElementTypeページ要素の型を PageElementType 列挙型で返します。
getParentGroup()Group|nullこのページ要素が属するグループを返します。要素がグループに属していない場合は null を返します。
getParentPage()Pageこのページ要素があるページを返します。
getRotation()Number要素の中心を軸とした時計回りの回転角度を度数で返します。0 度は回転がないことを意味します。
getStart()Pointページの左上隅から測定した、線の始点を返します。
getStartArrow()ArrowStyle線の先頭にある矢印の ArrowStyle を取得します。
getStartConnection()ConnectionSite|null行の先頭にある接続を返します。接続がない場合は null を返します。
getTitle()Stringページ要素の代替テキストのタイトルを返します。
getTop()Number要素が回転していない場合、ページの左上隅から測定した要素の垂直位置をポイント単位で取得します。
getTransform()AffineTransformページ要素の変換を返します。
getWeight()Number線の太さをポイント単位で返します。
getWidth()Number|null要素の幅をポイント単位で返します。要素が回転していない場合、これは要素のバウンディング ボックスの幅です。
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スライドのゼロベースのインデックスを使用して、指定された Slide に Link を設定します。
setLinkSlide(slide)Link指定された Slide に Link を設定します。リンクは指定されたスライド ID によって設定されます。
setLinkSlide(slidePosition)Linkスライドの相対位置を使用して、指定された Slide に Link を設定します。
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()

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

戻る

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|null - 行の末尾の接続。

承認

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

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

getHeight()

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

この方法は、すべてのページ要素に対応しているわけではありません。このメソッドと互換性のないページ要素については、 サイズと位置の制限事項をご覧ください。

戻る

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

承認

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

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

getInherentHeight()

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

ページ要素の変換は、その固有のサイズを基準としています。要素の最終的な外観を決定するには、要素の変換と組み合わせて固有のサイズを使用します。

戻る

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

承認

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

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

getInherentWidth()

要素の固有の幅をポイント単位で返します。

ページ要素の変換は、その固有のサイズを基準としています。要素の最終的な外観を決定するには、要素の変換と組み合わせて固有のサイズを使用します。

戻る

Number|null - ページ要素の固有の幅（ポイント単位）。ページ要素に幅がない場合は 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 を返します。

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

戻る

Link|null - リンクがない場合は Link または null。

承認

このメソッドを使用するスクリプトには、次の 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 - このページ要素が属するグループ、または 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|null - 行の先頭の接続。

承認

このメソッドを使用するスクリプトには、次の 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 - ページ要素の固有の幅（ポイント単位）。ページ要素に幅がない場合は 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 ポイント移動するには:

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
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 を削除します。

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].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 として設定されます。

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const 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 として設定します。

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

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

  1. PageElement オブジェクトの親 Page は current page selection である必要があります。
  2. 複数の Page オブジェクトが選択されていないようにする必要があります。

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

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

パラメータ

名前型説明
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".
const 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.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

パラメータ

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

戻る

Link - 設定された Link。

承認

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

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

setLinkSlide(slide)

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

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

パラメータ

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

戻る

Link - 設定された Link。

承認

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

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

setLinkSlide(slidePosition)

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

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

パラメータ

名前型説明
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.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = 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".
const 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