Excel.Interfaces.ShapeLoadOptions interface
ワークシート内の汎用図形オブジェクトを表します。 図形は、幾何学的形状、線、図形のグループなどです。図形オブジェクト モデルの詳細については、「Excel JavaScript API を使用して図形を操作する」を参照してください。
プロパティ
| $all | 読み込みオプションに |
| alt |
|
| alt |
|
| connection |
この図形の結合点の数を返します。 |
| display |
図形の表示名を取得します。 新しく作成された図形は、ローカライズされた生成された名前を持ち、その |
| fill | この図形の塗りつぶしの書式設定を返します。 |
| geometric |
図形に関連付けられた幾何学的図形を返します。 図形の種類が "GeometricShape" ではない場合は、エラーがスローされます。 |
| geometric |
この幾何学的形状の幾何学的形状の種類を指定します。 詳細は「 |
| group | 図形に関連付けられた図形グループを返します。 図形の種類が "GroupShape" ではない場合は、エラーがスローされます。 |
| height | 図形の高さをポイント単位で指定します。 入力として負の値またはゼロに設定された場合、 |
| id | 図形の識別子を指定します。 |
| image | 図形に関連付けられた画像を返します。 図形の種類が "Image" ではない場合は、エラーがスローされます。 |
| left | 図形の左側からワークシートの左側までの距離 (ポイント数) です。 入力として負の値を指定して設定すると、 |
| level | 指定する図形のレベルを指定します。 たとえば、レベル 0 は図形がどのグループの一部でもないことを意味し、レベル 1 は図形が最上位グループの一部であることを意味し、レベル 2 は図形が最上位レベルのサブグループの一部であることを意味します。 |
| line | 図形に関連付けられた線を返します。 図形の種類が "Line" ではない場合は、エラーがスローされます。 |
| line |
この図形の線の書式設定を返します。 |
| lock |
この図形の縦横比をロックするかどうかを指定します。 |
| name | 図形の名前を指定します。 |
| parent |
この図形の親グループを指定します。 |
| placement | オブジェクトがその下のセルに接続されている方法を表します。 |
| rotation | 図形の回転を度単位で指定します。 |
| text |
この図形のテキスト フレーム オブジェクトを返します。 |
| top | 図形の上端からワークシートの上までのポイント単位の距離です。 入力として負の値を指定して設定すると、 |
| type | この図形の種類を返します。 詳細は「 |
| visible | 図形を表示するかどうかを指定します。 |
| width | 図形の幅をポイント単位で指定します。 入力として負の値またはゼロに設定された場合、 |
| z |
指定された図形の z オーダーでの位置を返します。0 はオーダー スタックの一番下を表します。 |
プロパティの詳細
$all
読み込みオプションに $all を指定すると、すべてのスカラー プロパティ ( Range.address など) が読み込まれますが、ナビゲーション プロパティ ( Range.format.fill.color など) は読み込まれません。
$all?: boolean;プロパティ値
boolean
altTextDescription
altTextTitle
connectionSiteCount
displayName
図形の表示名を取得します。 新しく作成された図形は、ローカライズされた生成された名前を持ち、その nameと一致しない可能性があります。 このシナリオでは、この API を使用して、UI に表示される名前を取得できます。
displayName?: boolean;プロパティ値
boolean
注釈
fill
この図形の塗りつぶしの書式設定を返します。
fill?: Excel.Interfaces.ShapeFillLoadOptions;プロパティ値
注釈
geometricShape
図形に関連付けられた幾何学的図形を返します。 図形の種類が "GeometricShape" ではない場合は、エラーがスローされます。
geometricShape?: Excel.Interfaces.GeometricShapeLoadOptions;プロパティ値
注釈
geometricShapeType
この幾何学的形状の幾何学的形状の種類を指定します。 詳細は「Excel.GeometricShapeType」をご覧ください。 形状の種類が "GeometricShape" ではない場合に null を返します。
geometricShapeType?: boolean;プロパティ値
boolean
注釈
group
図形に関連付けられた図形グループを返します。 図形の種類が "GroupShape" ではない場合は、エラーがスローされます。
group?: Excel.Interfaces.ShapeGroupLoadOptions;プロパティ値
注釈
height
図形の高さをポイント単位で指定します。 入力として負の値またはゼロに設定された場合、 InvalidArgument 例外をスローします。
height?: boolean;プロパティ値
boolean
注釈
id
image
図形に関連付けられた画像を返します。 図形の種類が "Image" ではない場合は、エラーがスローされます。
image?: Excel.Interfaces.ImageLoadOptions;プロパティ値
注釈
left
図形の左側からワークシートの左側までの距離 (ポイント数) です。 入力として負の値を指定して設定すると、 InvalidArgument 例外をスローします。
left?: boolean;プロパティ値
boolean
注釈
level
指定する図形のレベルを指定します。 たとえば、レベル 0 は図形がどのグループの一部でもないことを意味し、レベル 1 は図形が最上位グループの一部であることを意味し、レベル 2 は図形が最上位レベルのサブグループの一部であることを意味します。
level?: boolean;プロパティ値
boolean
注釈
line
図形に関連付けられた線を返します。 図形の種類が "Line" ではない場合は、エラーがスローされます。
line?: Excel.Interfaces.LineLoadOptions;プロパティ値
注釈
lineFormat
この図形の線の書式設定を返します。
lineFormat?: Excel.Interfaces.ShapeLineFormatLoadOptions;プロパティ値
注釈
lockAspectRatio
name
parentGroup
この図形の親グループを指定します。
parentGroup?: Excel.Interfaces.ShapeLoadOptions;プロパティ値
注釈
placement
rotation
textFrame
この図形のテキスト フレーム オブジェクトを返します。
textFrame?: Excel.Interfaces.TextFrameLoadOptions;プロパティ値
注釈
top
図形の上端からワークシートの上までのポイント単位の距離です。 入力として負の値を指定して設定すると、 InvalidArgument 例外をスローします。
top?: boolean;プロパティ値
boolean
注釈
type
visible
width
図形の幅をポイント単位で指定します。 入力として負の値またはゼロに設定された場合、 InvalidArgument 例外をスローします。
width?: boolean;プロパティ値
boolean
注釈
zOrderPosition
指定された図形の z オーダーでの位置を返します。0 はオーダー スタックの一番下を表します。
zOrderPosition?: boolean;プロパティ値
boolean