Shape インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オートシェイプ、フリーフォーム、OLE オブジェクト、図などの描画オブジェクトを表します。 Shape オブジェクトは、Shapes コレクションのメンバーです。 図形コレクションには、スライド上のすべての図形が含まれます。
public interface class Shape[System.Runtime.InteropServices.Guid("00024439-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface ShapePublic Interface Shape- 属性
注釈
図形を表すオブジェクトには次の 3 つがあります。 図形 コレクションは、ドキュメント上のすべての図形を表します。ドキュメント上の図形の指定されたサブセットを表す ShapeRange コレクション (たとえば、 ShapeRange オブジェクトはドキュメント上の図形 1 と 4 や、ドキュメント上の選択されたすべての図形を表す場合があります)。および Shape オブジェクトは、ドキュメント上の単一の図形を表します。 複数の図形を同時に操作する場合や、選択範囲内の図形を操作する場合は、 ShapeRange コレクションを使用します。
このセクションで説明する方法。
- 既存の図形を取得する
- 選択範囲内の図形を取得する
- コネクタの両端が接続された図形を取得する
- 新しく作成したフリーフォームを取得する
- グループ化した図形の中から単一の図形を取得する
- 新しく形成した図形グループを取得する
既存の図形を取得する
図形を表す Shape オブジェクトを取得するには、Shapes(index) を使用します。ここで、index は図形名またはインデックス番号です。
Shapes コレクションに図形を追加すると、各図形には既定の名前が割り当てられます。 図形にわかりやすい名前を付けるには、 Name プロパティを使います。
選択範囲内の図形を取得する
Selection.ShapeRange(index) を使用して、index は図形名またはインデックス番号で、選択範囲内の図形を表す Shape オブジェクトを返します。
コネクタの両端が接続された図形を取得する
コネクタによって接続された図形の 1 つを表す Shape オブジェクトを返すには、 BeginConnectedShape または EndConnectedShape プロパティを使用します。
新しく作成したフリーフォームを取得する
BuildFreeform(MsoEditingType, Single, Single) メソッドと AddNodes(MsoSegmentType, MsoEditingType, Single, Single, Object, Object, Object, Object) メソッドを使用して新しいフリーフォームのジオメトリを定義し、ConvertToShape() メソッドを使用してフリーフォームを作成し、それを表す Shape オブジェクトを返します。
グループ内から単一の図形を取得する
グループ化された図形内の 1 つの図形を表す Shape オブジェクトを取得するには、GroupItems(index) を使用します。index はグループ内の図形名またはインデックス番号です。
新しく形成した図形グループを取得する
Group() または Regroup() メソッドを使用して、図形の範囲をグループ化し、新しく形成されたグループを表す単一の Shape オブジェクトを返します。 グループを形成すると、他の図形を処理するのと同じようにグループを処理できます。
プロパティ
| 名前 | 説明 |
|---|---|
| Adjustments |
指定した図形のすべての調整の調整値を含む Adjustments オブジェクトを返します。 読み取り専用です。 |
| AlternativeText |
オブジェクトを Web ページに保存したときに、 Shape オブジェクトの説明 (代替) テキスト文字列を返すか設定します。 読み取り/書き込みが可能な String です。 |
| Application |
Microsoft Excel アプリケーションを表す Application オブジェクトを返します。 読み取り専用です。 |
| AutoShapeType |
指定した Shape オブジェクトの図形の種類を返すか設定します。このオブジェクトは、線、フリーフォーム描画、コネクタ以外のオートシェイプを表す必要があります。 読み取り/書き込み MsoAutoShapeType。 |
| BackgroundStyle |
背景のスタイルを返すか設定します。 値の取得と設定が可能です。 |
| BlackWhiteMode |
プレゼンテーションを白黒表示モードにした場合に、指定した図形の表示方法を示す値を設定します。 読み取り/書き込み MsoBlackWhiteMode。 |
| BottomRightCell |
オブジェクトの右下隅にあるセルを表す Range オブジェクトを返します。 読み取り専用です。 |
| Callout |
指定された図形の吹き出し書式設定プロパティが含まれる CalloutFormat オブジェクトを返します。 線の吹き出しを表す Shape オブジェクトに適用されます。 読み取り専用です。 |
| CanvasItems |
内部使用のため予約済みです。 |
| Chart | |
| Child |
指定された図形が子図形である場合、または図形範囲内のすべての図形が同じ親の子図形である場合は、 msoTrue を返します。 読み取り専用 MsoTriState。 |
| ConnectionSiteCount |
指定した図形の結合点の数を取得します。 読み取り専用の Integer です。 |
| Connector |
指定された図形がコネクタの場合は True。 読み取り専用 MsoTriState。 |
| ConnectorFormat |
コネクタの書式設定プロパティが含まれる ConnectorFormat オブジェクトを返します。 コネクタを表す Shape オブジェクトに適用されます。 読み取り専用です。 |
| ControlFormat |
Microsoft Excel のコントロール プロパティが含まれる ControlFormat オブジェクトを返します。 読み取り専用です。 |
| Creator |
このオブジェクトを作成したアプリケーションを示す、32 ビットの整数値を返します。 Excel で作成されたオブジェクトの場合は、文字列 XCEL を表す 16 進数の 5843454C を返します。 読み取り専用 XlCreator。 |
| Diagram |
ダイアグラムを表す Diagram オブジェクトを返します。 |
| DiagramNode |
ダイアグラム内のノードを表す DiagramNode オブジェクトを返します。 |
| DrawingObject |
内部使用のため予約済みです。 |
| Fill |
指定したグラフまたは図形の塗りつぶしの書式設定プロパティが格納されている FillFormat オブジェクトを返します。 読み取り専用です。 |
| FormControlType |
Microsoft Excel のコントロール型を返します。 読み取り専用 XlFormControl。 |
| Glow |
指定された図形の光彩の書式設定プロパティを含むオブジェクトを返します。 読み取り専用です。 |
| GroupItems |
指定したグループ内の個々の図形を表す GroupShapes オブジェクトを返します。 GroupShapes オブジェクトの Item(Object) メソッドを使用して、グループから単一の図形を返します。 グループ化された図形を表す Shape オブジェクトに適用します。 読み取り専用です。 |
| HasChart |
Shapeにグラフが含まれているかどうかに関する情報を返します。 読み取り専用です。 |
| HasDiagram |
図形または図形範囲にダイアグラムが含まれているかどうかを返します。 読み取り専用 MsoTriState。 |
| HasDiagramNode |
図ノードが特定の図形または図形範囲に存在するかどうかを示す値を返します。 読み取り専用 MsoTriState。 |
| HasSmartArt |
指定した図形に SmartArt ダイアグラムが存在するかどうかを取得します。 |
| Height |
オブジェクトの高さ。 読み取り/書き込み 1 つ です。 |
| HorizontalFlip |
指定された図形が横軸で反転されている場合は True を指定します。 読み取り専用 MsoTriState。 |
| Hyperlink |
図形のハイパーリンクを表す Hyperlink オブジェクトを返します。 |
| ID |
指定されたオブジェクトの型を返します。 読み取り専用の Integer です。 |
| Left |
オブジェクトの左端から列 A の左端 (ワークシート上)、またはグラフ領域の左端 (グラフ上) までの距離。 読み取り/書き込み 1 つ です。 |
| Line |
指定された図形の線の書式設定プロパティが含まれる LineFormat オブジェクトを返します。 読み取り専用です。 |
| LinkFormat |
リンクされた OLE オブジェクト プロパティが含まれる LinkFormat オブジェクトを返します。 読み取り専用です。 |
| LockAspectRatio |
指定された図形が、サイズを変更しても元の比率を保持している場合は True です。 サイズを変更するときに、図形の高さと幅を個別に変更できる場合は False です。 読み取り/書き込み MsoTriState。 |
| Locked |
オブジェクトがロックされている場合は true、シートが保護されているときにオブジェクトを変更できる場合は false。 値の取得と設定が可能なブール型 (Boolean) の値です。 |
| Name |
オブジェクトの名前を返すか設定します。 読み取り/書き込みが可能な String です。 |
| Nodes |
指定された図形の幾何学的記述を表す ShapeNodes コレクションを返します。 フリーフォーム図面を表す Shape オブジェクトに適用します。 |
| OLEFormat |
OLE オブジェクトのプロパティが含まれる OLEFormat オブジェクトを返します。 読み取り専用です。 |
| OnAction |
指定したオブジェクトがクリックされたときに実行されるマクロの名前を返すか設定します。 読み取り/書き込みが可能な String です。 |
| Parent |
指定されたオブジェクトの親オブジェクトを返します。 読み取り専用です。 |
| ParentGroup |
子図形または子図形の範囲の共通の親図形を表す Shape オブジェクトを返します。 |
| PictureFormat |
指定された図形の図の書式設定プロパティが含まれる PictureFormat オブジェクトを返します。 画像または OLE オブジェクトを表す Shape オブジェクトに適用されます。 読み取り専用です。 |
| Placement |
オブジェクトがその下のセルにアタッチされる方法を返す、または設定します。 読み取り/書き込み XlPlacement。 |
| Reflection |
図形のリフレクションの書式設定プロパティが含まれるオブジェクトを返します。 読み取り専用です。 |
| Rotation |
図形の回転を度単位で返す、または設定します。 読み取り/書き込み 1 つ です。 |
| Script |
指定された Web ページ上のスクリプト ブロックまたはコード ブロックを表す Script オブジェクトを返します。 ページにスクリプトが記述されていない場合は、何も返されません。 |
| Shadow |
オブジェクトに影がある場合は true。 値の取得と設定が可能なブール型 (Boolean) の値です。 |
| ShapeStyle |
図形の図形のスタイルを表す MsoShapeStyleIndex を返すか設定します。 値の取得と設定が可能です。 |
| SmartArt |
図形に関連付けられている SmartArt を表すオブジェクトを取得します。 |
| SoftEdge |
図形のソフト エッジ フォーマット プロパティが含まれる、指定した図形の SoftEdgeFormat オブジェクトを返します。 読み取り専用です。 |
| TextEffect |
指定された図形のテキスト効果書式設定プロパティが含まれる TextEffectFormat オブジェクトを返します。 ワードアートを表す T:Microsoft.Office.Interop.Excel.Shape オブジェクトに適用されます。 読み取り専用です。 |
| TextFrame |
指定された図形の配置プロパティと固定プロパティを含む TextFrame オブジェクトを返します。 読み取り専用です。 |
| TextFrame2 |
指定された図形のテキスト書式を含むオブジェクトを返します。 読み取り専用です。 |
| ThreeD |
指定された図形の 3-D 効果フォーマットのプロパティが含まれる ThreeDFormat オブジェクトを返します。 読み取り専用です。 |
| Title |
指定した図形に関連付けられている代替テキストのタイトルを取得または設定します。 |
| Top |
図形範囲内の最上位図形の上端からワークシートの上端までの距離。 読み取り/書き込み 1 つ です。 |
| TopLeftCell |
指定したオブジェクトの左上隅にあるセルを表す Range オブジェクトを返します。 読み取り専用です。 |
| Type |
図形の種類を返す、または設定します。 読み取り専用 MsoShapeType。 |
| VerticalFlip |
指定された図形が縦軸で反転されている場合は True を指定します。 読み取り専用 MsoTriState。 |
| Vertices |
指定したフリーフォームの頂点 (およびベジェ曲線のコントロール ポイント) の座標を、一連の 2 次元の座標として取得します。 読み取り専用 オブジェクト 。 |
| Visible |
オブジェクトが表示されているかどうかを決定します。 読み取り/書き込み MsoTriState。 |
| Width |
オブジェクトの幅。 読み取り/書き込み 1 つ です。 |
| ZOrderPosition |
指定した図形の z 方向の位置を取得します。 読み取り専用の Integer です。 |
メソッド
| 名前 | 説明 |
|---|---|
| Apply() |
PickUp() メソッドを使用してコピーされた、指定された図形の書式設定に適用します。 |
| CanvasCropBottom(Single) |
内部使用のため予約済みです。 |
| CanvasCropLeft(Single) |
内部使用のため予約済みです。 |
| CanvasCropRight(Single) |
内部使用のため予約済みです。 |
| CanvasCropTop(Single) |
内部使用のため予約済みです。 |
| Copy() |
オブジェクトをクリップボードにコピーします。 |
| CopyPicture(Object, Object) |
選択しているオブジェクトを図としてクリップボードにコピーします。 |
| Cut() |
オブジェクトを切り取り、クリップボードまたは指定された範囲に貼り付けます。 |
| Delete() |
オブジェクトを削除します。 |
| Duplicate() |
オブジェクトを複製し、複製されたオブジェクトへの参照を返します。 |
| Flip(MsoFlipCmd) |
指定した図形を、水平軸または垂直軸を中心として反転します。 |
| IncrementLeft(Single) |
指定した図形を、指定したポイント数だけ水平方向に移動します。 |
| IncrementRotation(Single) |
指定した図形の z 軸回りの回転を、指定した角度だけ変更します。 Rotation プロパティを使用して、図形の絶対回転を設定します。 |
| IncrementTop(Single) |
指定した図形を、指定したポイント数だけ垂直方向に移動します。 |
| PickUp() |
指定された図形の書式をコピーします。 コピーした書式を別の図形に適用するには、 Apply() メソッドを使用します。 |
| RerouteConnections() |
RerouteConnections メソッドは、図形間を結ぶ線 (コネクタ) の経路が最短になるように、そのコネクタを再接続します。 |
| ScaleHeight(Single, MsoTriState, Object) |
指定した係数分だけ図形の高さを変更します。 |
| ScaleWidth(Single, MsoTriState, Object) |
指定した係数分だけ図形の幅を変更します。 |
| Select(Object) |
オブジェクトを選択します。 |
| SetShapesDefaultProperties() |
指定された図形の書式を、その図形の既定の書式にします。 |
| Ungroup() |
指定した図形または図形範囲の図形のグループ化を解除します。 指定した図形内の図や OLE オブジェクトを逆アセンブルします。 グループ化されていない図形を 1 つの ShapeRange オブジェクトとして返します。 |
| ZOrder(MsoZOrderCmd) |
コレクションの他の図形の前面または背後に指定の図形を移動させます (つまり、図形の位置を z オーダーで変更します)。 |