PowerPoint.Interfaces.ShapeData interface

shape.toJSON() の呼び出しによって返されるデータを記述するインターフェイス。

注釈

使用元

プロパティ

altTextDescription

図形の代替テキストの説明。

代替テキストは、図形に含まれる情報の代替テキスト ベースの表現を提供します。 この情報は、形を見たり理解したりできない視覚または認知障害のあるユーザーに役立ちます。

altTextTitle

図形の代替テキスト タイトル。

代替テキストは、図形に含まれる情報の代替テキスト ベースの表現を提供します。 この情報は、形を見たり理解したりできない視覚または認知障害のあるユーザーに役立ちます。 タイトルは障碍のある人に読み上げることができ、コンテンツの説明を聞くかどうかを判断するために使用されます。

creationId

図形の作成 ID を取得します。 図形に作成 ID がない場合は null を返します。

height

図形の高さをポイント単位で指定します。 負の値に設定されている場合は、 InvalidArgument 例外をスローします。

id

図形の一意の ID を取得します。

isDecorative

図形が装飾的かどうかを表します。

装飾的なオブジェクトは視覚的な興味をそそりますが、情報的ではありません (様式的な罫線など)。 スクリーン リーダーを使用している People は、これらが装飾用であると読み上げられるため、重要な情報を聞き逃しているわけではないことがわかります。

left

図形の左側からスライドの左側までの距離 (ポイント単位)。

level

指定された図形のレベルを返します。

  • レベル 0 は、図形がグループの一部ではないことを意味します。

  • レベル 1 は、図形が最上位グループの一部であることを意味します。

  • レベルが 1 より大きい場合、図形が入れ子になったグループであることを示します。

name

この図形の名前を指定します。

rotation

z 軸を中心とした図形の回転を度数で指定します。 正の値は時計回りの回転を示し、負の値は反時計回りの回転を示します。

top

図形の上端からスライドの上端までの距離 (ポイント単位)。

type

この図形の種類を返します。 詳細については 、PowerPoint.ShapeType を参照してください。

visible

図形を表示するかどうかを指定します。

width

図形の幅をポイント単位で指定します。 負の値に設定されている場合は、 InvalidArgument 例外をスローします。

zOrderPosition

図形の z オーダー位置を返します。0 はスタックの下部を表します。 スライド上のすべての図形に一意の Z オーダーが設定されていますが、スライドごとに一意の Z オーダーのスタックもあるため、別々のスライド上の 2 つの図形に同じ Z オーダー番号を付けることができます。

プロパティの詳細

altTextDescription

図形の代替テキストの説明。

代替テキストは、図形に含まれる情報の代替テキスト ベースの表現を提供します。 この情報は、形を見たり理解したりできない視覚または認知障害のあるユーザーに役立ちます。

altTextDescription?: string;

プロパティ値

string

注釈

API セット: PowerPointApi 1.10

altTextTitle

図形の代替テキスト タイトル。

代替テキストは、図形に含まれる情報の代替テキスト ベースの表現を提供します。 この情報は、形を見たり理解したりできない視覚または認知障害のあるユーザーに役立ちます。 タイトルは障碍のある人に読み上げることができ、コンテンツの説明を聞くかどうかを判断するために使用されます。

altTextTitle?: string;

プロパティ値

string

注釈

API セット: PowerPointApi 1.10

creationId

図形の作成 ID を取得します。 図形に作成 ID がない場合は null を返します。

creationId?: string | null;

プロパティ値

string | null

注釈

API セット: PowerPointApi 1.10

height

図形の高さをポイント単位で指定します。 負の値に設定されている場合は、 InvalidArgument 例外をスローします。

height?: number;

プロパティ値

number

注釈

API セット: PowerPointApi 1.4

id

図形の一意の ID を取得します。

id?: string;

プロパティ値

string

注釈

API セット: PowerPointApi 1.3

isDecorative

図形が装飾的かどうかを表します。

装飾的なオブジェクトは視覚的な興味をそそりますが、情報的ではありません (様式的な罫線など)。 スクリーン リーダーを使用している People は、これらが装飾用であると読み上げられるため、重要な情報を聞き逃しているわけではないことがわかります。

isDecorative?: boolean;

プロパティ値

boolean

注釈

API セット: PowerPointApi 1.10

left

図形の左側からスライドの左側までの距離 (ポイント単位)。

left?: number;

プロパティ値

number

注釈

API セット: PowerPointApi 1.4

level

指定された図形のレベルを返します。

  • レベル 0 は、図形がグループの一部ではないことを意味します。

  • レベル 1 は、図形が最上位グループの一部であることを意味します。

  • レベルが 1 より大きい場合、図形が入れ子になったグループであることを示します。

level?: number;

プロパティ値

number

注釈

API セット: PowerPointApi 1.8

name

この図形の名前を指定します。

name?: string;

プロパティ値

string

注釈

API セット: PowerPointApi 1.4

rotation

z 軸を中心とした図形の回転を度数で指定します。 正の値は時計回りの回転を示し、負の値は反時計回りの回転を示します。

rotation?: number;

プロパティ値

number

注釈

API セット: PowerPointApi 1.10

top

図形の上端からスライドの上端までの距離 (ポイント単位)。

top?: number;

プロパティ値

number

注釈

API セット: PowerPointApi 1.4

type

この図形の種類を返します。 詳細については 、PowerPoint.ShapeType を参照してください。

type?: PowerPoint.ShapeType | "Unsupported" | "Image" | "GeometricShape" | "Group" | "Line" | "Table" | "Callout" | "Chart" | "ContentApp" | "Diagram" | "Freeform" | "Graphic" | "Ink" | "Media" | "Model3D" | "Ole" | "Placeholder" | "SmartArt" | "TextBox";

プロパティ値

PowerPoint.ShapeType | "Unsupported" | "Image" | "GeometricShape" | "Group" | "Line" | "Table" | "Callout" | "Chart" | "ContentApp" | "Diagram" | "Freeform" | "Graphic" | "Ink" | "Media" | "Model3D" | "Ole" | "Placeholder" | "SmartArt" | "TextBox"

注釈

API セット: PowerPointApi 1.4

visible

図形を表示するかどうかを指定します。

visible?: boolean;

プロパティ値

boolean

注釈

API セット: PowerPointApi 1.10

width

図形の幅をポイント単位で指定します。 負の値に設定されている場合は、 InvalidArgument 例外をスローします。

width?: number;

プロパティ値

number

注釈

API セット: PowerPointApi 1.4

zOrderPosition

図形の z オーダー位置を返します。0 はスタックの下部を表します。 スライド上のすべての図形に一意の Z オーダーが設定されていますが、スライドごとに一意の Z オーダーのスタックもあるため、別々のスライド上の 2 つの図形に同じ Z オーダー番号を付けることができます。

zOrderPosition?: number;

プロパティ値

number

注釈

API セット: PowerPointApi 1.8