Class PositionedImage

PositionedImage

Paragraph に固定された画像の位置を修正しました。InlineImage とは異なり、PositionedImage は Element ではありません。親または兄弟の Element がありません。代わりに、Paragraph または ListItem にアンカーされ、そのアンカーからのオフセットで配置されます。PositionedImage には、参照に使用できる ID があります。

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Append a new paragraph.
const paragraph = body.appendParagraph('New paragraph to anchor the image to.');

// Get an image in Drive from its ID.
const image = DriveApp.getFileById('ENTER_IMAGE_FILE_ID_HERE').getBlob();

// Add the PositionedImage with offsets (in points).
const posImage =
    paragraph.addPositionedImage(image).setTopOffset(60).setLeftOffset(40);

メソッド

メソッド戻り値の型概要
getAs(contentType)Blobこのオブジェクト内のデータを指定したコンテンツ タイプに変換された BLOB として返します。
getBlob()Blobこのオブジェクト内のデータを blob として返します。
getHeight()Integer画像の高さ（ピクセル単位）を取得します。
getId()Stringイメージの ID を取得します。
getLayout()PositionedLayout画像のレイアウト方法を表す列挙型値を取得します。
getLeftOffset()Number段落の左端からの画像のオフセット（ポイント単位）を取得します。
getParagraph()Paragraph画像がアンカーされている Paragraph を取得します。
getTopOffset()Number段落の上端からの画像のオフセット（ポイント単位）を取得します。
getWidth()Integer画像の幅（ピクセル単位）を取得します。
setHeight(height)PositionedImage画像の高さ（ピクセル単位）を設定します。
setLayout(layout)PositionedImage画像のレイアウト方法を定義します。
setLeftOffset(offset)PositionedImage段落の左端からの画像のオフセット（ポイント単位）を設定します。
setTopOffset(offset)PositionedImage段落の上端からの画像のオフセット（ポイント単位）を設定します。
setWidth(width)PositionedImage画像の幅（ピクセル単位）を設定します。

詳細なドキュメント

getAs(contentType)

このオブジェクト内のデータを指定したコンテンツ タイプに変換された BLOB として返します。この方法では、適切な拡張子がファイル名に追加されます（例: myfile.pdf）。ただし、最後のピリオド（存在する場合）の後のファイル名の部分は、置き換えが必要な既存の拡張子であると想定しています。そのため、「ShoppingList.12.25.2014」は「ShoppingList.12.25.pdf」になります。

コンバージョンの日別割り当てを表示するには、Google サービスの割り当てをご覧ください。新しく作成された Google Workspace ドメインには、一時的に厳しい割り当てが適用される場合があります。

パラメータ

名前型説明
contentTypeString変換する MIME タイプ。ほとんどの blob では、'application/pdf' のみが有効なオプションです。BMP、GIF、JPEG、PNG 形式の画像の場合は、'image/bmp'、'image/gif'、'image/jpeg'、'image/png' のいずれも有効です。Google ドキュメント ドキュメントの場合は、'text/markdown' も有効です。

戻る

Blob - BLOB としてのデータ。

getBlob()

このオブジェクト内のデータを blob として返します。

戻る

Blob - BLOB としてのデータ。

getHeight()

画像の高さ（ピクセル単位）を取得します。

戻る

Integer - 画像の高さ（ピクセル単位）

承認

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

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

getId()

イメージの ID を取得します。

戻る

String - 画像 ID

承認

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

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

getLayout()

画像のレイアウト方法を表す列挙型値を取得します。

戻る

PositionedLayout - 画像レイアウト

承認

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

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

getLeftOffset()

段落の左端からの画像のオフセット（ポイント単位）を取得します。

戻る

Number - 左側の段落の左端からの画像のオフセット

承認

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

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

getParagraph()

画像がアンカーされている Paragraph を取得します。

戻る

Paragraph - 親の段落

承認

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

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

getTopOffset()

段落の上端からの画像のオフセット（ポイント単位）を取得します。

戻る

Number - 左側の段落の上端からの画像のオフセット

承認

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

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

getWidth()

画像の幅（ピクセル単位）を取得します。

戻る

Integer - 画像の幅（ピクセル単位）

承認

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

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

setHeight(height)

画像の高さ（ピクセル単位）を設定します。

パラメータ

名前型説明
heightInteger画像の高さ（ピクセル単位）

戻る

PositionedImage - 現在のオブジェクト

承認

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

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

setLayout(layout)

画像のレイアウト方法を定義します。

パラメータ

名前型説明
layoutPositionedLayoutレイアウト モードを表す列挙型

戻る

PositionedImage - チェーン用の this オブジェクト

承認

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

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

setLeftOffset(offset)

段落の左端からの画像のオフセット（ポイント単位）を設定します。

パラメータ

名前型説明
offsetNumber段落の左からのオフセット

戻る

PositionedImage - チェーン用の this オブジェクト

承認

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

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

setTopOffset(offset)

段落の上端からの画像のオフセット（ポイント単位）を設定します。

パラメータ

名前型説明
offsetNumber段落の上端からのオフセット

戻る

PositionedImage - チェーン用の this オブジェクト

承認

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

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

setWidth(width)

画像の幅（ピクセル単位）を設定します。

パラメータ

名前型説明
widthInteger画像の幅（ピクセル単位）

戻る

PositionedImage - 現在のオブジェクト

承認

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

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