Shape インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オートシェイプ、フリーフォーム、OLE オブジェクト、図などの描画オブジェクトを表します。 Shape オブジェクトは、コレクションのShapesメンバーです。 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 つのオブジェクトがあります。 Shapes コレクションは、ドキュメント上のすべての図形を表します。 ShapeRange ドキュメント上の図形の指定されたサブセットを表すコレクション (たとえば、 ShapeRange オブジェクトは、ドキュメント上の図形を 1 つ、4 つ、またはドキュメント上のすべての選択した図形を表す場合があります)、 および Shape オブジェクトは、ドキュメント上の 1 つの図形を表します。 複数の図形を同時に操作する場合、または選択範囲内の図形を操作する場合は、 ShapeRange コレクションを使用します。
このセクションで説明する方法。
- 既存の図形を取得する
- 選択範囲内の図形を取得する
- コネクタの両端が接続された図形を取得する
- 新しく作成したフリーフォームを取得する
- グループ化した図形の中から単一の図形を取得する
- 新しく形成した図形グループを取得する
既存の図形を取得する
Shapes(index) index は図形名またはインデックス番号を使用して、図形を表す Shape オブジェクトを取得します。
Shapes コレクションに図形を追加すると、各図形には既定の名前が割り当てられます。 図形にわかりやすい名前を付けるには、 プロパティを Name 使用します。
選択範囲内の図形を取得する
Selection.ShapeRange(index) index は図形名またはインデックス番号を使用して、選択範囲内の図形を表す Shape オブジェクトを取得します。
コネクタの両端が接続された図形を取得する
コネクタによってアタッチされた図形のいずれかを表す Shape オブジェクトを取得するには、 または EndConnectedShape プロパティをBeginConnectedShape使用します。
新しく作成したフリーフォームを取得する
BuildFreeform(MsoEditingType, Single, Single)メソッドと AddNodes(MsoSegmentType, MsoEditingType, Single, Single, Object, Object, Object, Object) メソッドを使用して新しいフリーフォームのジオメトリを定義し、 メソッドをConvertToShape()使用してフリーフォームを作成し、それを表す Shape オブジェクトを返します。
グループ内から単一の図形を取得する
GroupItems(index) index を使用して、グループ内の図形名またはインデックス番号を指定して、グループ化された図形の 1 つの図形を表す Shape オブジェクトを取得します。
新しく形成した図形グループを取得する
または メソッドを使用して図形の範囲をグループ化し、新しく形成されたグループを表す単一の Shape オブジェクトを返します。Regroup()Group() グループを形成すると、他の図形を処理するのと同じようにグループを処理できます。
プロパティ
| 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 個々の図形を表す オブジェクトを返します。 Item(Object)GroupShapes オブジェクトの メソッドを使用して、グループから 1 つの図形を返します。 グループ化された図形を Shape 表すオブジェクトに適用されます。 読み取り専用です。 |
| HasChart |
にグラフが含まれているかどうか Shape に関する情報を返します。 読み取り専用です。 |
| HasDiagram |
図形または図形範囲に図が含まれているかどうかを返します。 読み取り専用 MsoTriStateです。 |
| HasDiagramNode |
ダイアグラム ノードが特定の図形または図形範囲に存在するかどうかを示す値を返します。 読み取り専用 MsoTriStateです。 |
| HasSmartArt |
指定した図形に SmartArt ダイアグラムが存在するかどうかを取得します。 |
| Height |
オブジェクトの高さ。 読み取り/書き込み 1 つ です。 |
| HorizontalFlip |
指定された図形が横軸で反転されている場合は True を指定します。 読み取り専用 MsoTriStateです。 |
| Hyperlink |
図形の Hyperlink ハイパーリンクを表す オブジェクトを返します。 |
| ID |
指定したオブジェクトの型を返します。 読み取り専用の Integer です。 |
| Left |
オブジェクトの左端から列 A の左端 (ワークシート上) までの距離、またはグラフ領域 (グラフ上) の左端までの距離。 読み取り/書き込み 1 つ です。 |
| Line |
指定した図形の LineFormat 線の書式設定プロパティを含むオブジェクトを返します。 読み取り専用です。 |
| LinkFormat |
LinkFormatリンクされた OLE オブジェクト プロパティを含むオブジェクトを返します。 読み取り専用です。 |
| 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 |
指定した図形の ThreeDFormat 3-D – 効果の書式設定プロパティを含むオブジェクトを返します。 読み取り専用です。 |
| 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 オーダーで変更します)。 |
適用対象
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示