Shape インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
描画レイヤー上にあるオートシェイプ、フリーフォーム、OLE オブジェクト、ActiveX コントロール、図などのオブジェクトを表します。
public interface class Shape
[System.Runtime.InteropServices.Guid("000209A0-0000-0000-C000-000000000046")]
public interface Shape
type Shape = interface
Public Interface Shape
- 属性
注釈
オブジェクトはShapeコレクションのメンバーであり、ドキュメントのShapesメインストーリー内のすべての図形、またはドキュメントのすべてのヘッダーとフッターに含まれます。
図形は、常にアンカー設定範囲に配置されます。 アンカーを含むページ上の任意の場所に図形を配置できます。
図形を表す 3 つのオブジェクトがあります。 Shapes コレクションは、ドキュメント ShapeRange 上のすべての図形を表します。コレクションは、ドキュメント上の図形の指定されたサブセットを表します (たとえば、 ShapeRange オブジェクトはドキュメント上の図形の 1 と 4 を表したり、ドキュメント Shape 上で選択したすべての図形を表したりできます)。オブジェクト、 ドキュメント上の 1 つの図形を表します。 複数の図形を同時に操作する場合、または選択範囲内の図形を使用する場合は、コレクションを ShapeRange 使用します。
1 つのShapeオブジェクトを返すには、Shapes(index
) を使用します。ここでindex
、名前またはインデックス番号を指定します。
各図形には、作成したときに、既定の名前が付けられます。 たとえば、文書に 3 つの異なる図形を追加すると、"四角形 2"、"テキスト ボックス 3"、"楕円 4" ("Rectangle 2"、"TextBox 3"、"Oval 4") のように名前が付けられます。 図形にわかりやすい名前を付けるには、 プロパティを Name 設定します。
Selection.ShapeRange(index
) index
を使用して、名前またはインデックス番号を指定して、選択範囲内の図形をShape表すオブジェクトを返します。
指定したドキュメントの図形のコレクションにオブジェクトを追加Shapeし、新しく作成された図形を表すオブジェクトを返Shapeすには、コレクションのShapes次のいずれかのメソッドを使用します。 AddCallout(MsoCalloutType, Single, Single, Single, Single, Object)AddCurve(Object, Object)AddLabel(MsoTextOrientation, Single, Single, Single, Single, Object)AddLine(Single, Single, Single, Single, Object)AddOLEControl(Object, Object, Object, Object, Object, Object)AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)AddPolyline(Object, Object)AddShape(Int32, Single, Single, Single, Single, Object)AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object)AddTextEffect(MsoPresetTextEffect, String, String, Single, MsoTriState, MsoTriState, Single, Single, Object)BuildFreeform(MsoEditingType, Single, Single)
GroupItems(index
) index
を使用して、グループ内の図形名またはインデックス番号を指定して、グループ化された図形の 1 つの図形を表す Shape オブジェクトを取得します。
Group()または Regroup() メソッドを使用して図形の範囲をグループ化し、新しく形成されたグループを表す 1 つのShapeオブジェクトを返します。 グループを形成すると、他の図形を処理するのと同じようにグループを処理できます。
すべての Shape オブジェクトは、テキストの範囲に固定されます。 図形は、アンカーが配置された範囲の含まれる最初の段落に対応付けられます。 その図形は、必ずアンカーのあるページと同じページに配置されます。
アンカー自体を表示するには、 プロパティを ShowObjectAnchorsTrue に設定します。 図形 Top とプロパティによって、垂直方向と Left 水平方向の位置が決まります。 図形 RelativeHorizontalPosition と RelativeVerticalPosition プロパティは、位置がアンカー段落、アンカー段落を含む列、余白、またはページの端から測定されるかどうかを決定します。
図形の LockAnchor プロパティが True に設定されている場合、ページ上の位置からアンカーをドラッグすることはできません。
閉じた図形の Fill 塗りつぶしを FillFormat 書式設定するためのすべてのプロパティとメソッドを含む オブジェクトを取得するには、 プロパティを使用します。 プロパティは Shadow 、シャドウの書式設定に ShadowFormat 使用する オブジェクトを返します。 行と矢印を Line 書式設定するためのプロパティとメソッドを LineFormat 含む オブジェクトを取得するには、 プロパティを使用します。 プロパティは TextEffect 、ワードアートの TextEffectFormat 書式設定に使用する オブジェクトを返します。 プロパティは Callout 、線吹き出しの CalloutFormat 書式設定に使用する オブジェクトを返します。 プロパティは WrapFormat オブジェクトを WrapFormat 返します。このオブジェクトを使用して、テキストが図形を囲む方法を定義します。 プロパティは ThreeD 、3-D 図形の作成に使用する オブジェクトを返 ThreeDFormat します。 メソッドと Apply() メソッドをPickUp()使用して、ある図形から別の図形に書式設定を転送できます。
オブジェクトの SetShapesDefaultProperties() メソッドを Shape 使用して、ドキュメントの既定の図形の書式を設定します。 新しく図形を作成すると、その図形は既定の図形から大部分の属性を継承します。
プロパティを Type 使用して、フリーフォーム、オートシェイプ、OLE オブジェクト、吹き出し、リンクされた図などの図形の種類を指定します。 プロパティを AutoShapeType 使用して、オートシェイプの種類 (楕円、四角形、吹き出しなど) を指定します。
プロパティと Height プロパティをWidth使用して、図形のサイズを指定します。
プロパティは TextFrame 、 オブジェクトを TextFrame 返します。このオブジェクトには、テキストを図形にアタッチし、テキスト フレーム間でテキストをリンクするためのすべてのプロパティとメソッドが含まれています。
Shape オブジェクトはテキスト範囲に固定されますが、自由浮動であり、ページ上の任意の場所に配置できます。 InlineShape オブジェクトは文字のように扱われ、テキスト行内の文字として配置されます。 メソッドと メソッドをConvertToInlineShape()ConvertToShape()使用して、図形を 1 つの型から他方の型に変換できます。 位置を固定した図形に変換できるのは、図、OLE オブジェクト、および ActiveX コントロールだけです。
プロパティ
Adjustments |
オートシェイプまたはワードアートを Adjustments 表す指定した Shape オブジェクト内のすべての調整の調整値を含むオブジェクトを返します。 |
AlternativeText |
Web ページ内の図形に関連付けられている代替テキストを設定または返します。 |
Anchor |
指定した図形の Range アンカー範囲を表す オブジェクトを返します。 |
AnchorID |
描画レイヤー上にあるオートシェイプ、フリーフォーム、OLE オブジェクト、ActiveX コントロール、図などのオブジェクトを表します。 |
Application |
Application Microsoft Word アプリケーションを表す オブジェクトを返します。 |
AutoShapeType |
線またはフリーフォーム図面以外のオートシェイプを表す必要がある、指定した Shape オブジェクトの図形の種類を設定または返します。 |
BackgroundStyle |
指定した図形の背景スタイルを取得または設定します。 |
Callout |
指定した図形の CalloutFormat 吹き出しの書式設定プロパティを含むオブジェクトを返します。 |
CanvasItems |
描画キャンバス内の CanvasShapes 図形のコレクションを表す オブジェクトを返します。 |
Chart |
ドキュメント内の Chart 図形のコレクション内のグラフを表す オブジェクトを返します。 読み取り専用です。 |
Child |
図形が子図形であるかどうかを判断します。 |
ConnectionSiteCount |
内部使用のため予約済みです。 |
Connector |
内部使用のため予約済みです。 |
ConnectorFormat |
内部使用のため予約済みです。 |
Creator |
指定されたオブジェクトを作成したアプリケーションを示す 32 ビットの整数を取得します。 |
Diagram |
ダイアグラム ノードが Diagram 属するオブジェクトを返します。 |
DiagramNode |
ダイアグラム内の DiagramNode ノードを表す オブジェクトを返します。 |
EditID |
描画レイヤー上にあるオートシェイプ、フリーフォーム、OLE オブジェクト、ActiveX コントロール、図などのオブジェクトを表します。 |
Fill |
指定した図形の FillFormat 塗りつぶしの書式設定プロパティを含むオブジェクトを返します。 |
Glow |
図形の GlowFormat 光彩の書式設定を表すオブジェクトを返します。 読み取り専用です。 |
GroupItems |
指定したグループ内の GroupShapes 個々の図形を表す オブジェクトを返します。 |
HasChart |
True 指定した図形にグラフがある場合。 読み取り専用です。 |
HasDiagram |
図形が図であるかどうかを判断します。 |
HasDiagramNode |
図形がダイアグラム ノードであるかどうかを判断します。 |
HasSmartArt |
図形に SmartArt ダイアグラムが存在する場合は True を 取得します。 |
Height |
指定した図形の高さをポイント単位で設定または返します。 |
HeightRelative |
取得または設定、 1 つ の図形の相対的な高さの割合を表す。 値の取得と設定が可能です。 |
HorizontalFlip |
図形を水平方向に反転されていることを示します。 |
Hyperlink |
指定した図形に Hyperlink 関連付けられているハイパーリンクを表す オブジェクトを返します。 |
ID |
指定したオブジェクトの型を返します。 |
LayoutInCell |
テーブル内の図形がテーブル内に表示されるか、テーブルの外部に表示されるかを表す 整数型 (Integer) の値を返します。 |
Left |
1 つ を表す単位で指定した図形または図形範囲の水平方向の位置を設定または返します。 |
LeftRelative |
取得または設定、 1 つ の図形の相対的な左端位置を表す。 値の取得と設定が可能です。 |
Line |
指定した図形の LineFormat 線の書式設定プロパティを含むオブジェクトを返します。 |
LinkFormat |
ファイルに LinkFormat リンクされている指定した図形のリンク オプションを表す オブジェクトを返します。 |
LockAnchor |
指定した Shape オブジェクトのアンカーがアンカー範囲にロックされているかどうかを判断します。 |
LockAspectRatio |
図形のサイズを変更するときに、図形の高さと幅を互いに独立して変更できるか、元の比率を保持するかを決定します。 |
Name |
指定したオブジェクトの名前を設定または返します。 |
Nodes |
指定した図形の ShapeNodes 幾何学的な説明を表すコレクションを返します。 |
OLEFormat |
指定した OLEFormat 図形の OLE 特性 (リンク以外) を表すオブジェクトを返します。 |
Parent |
指定されたオブジェクトの親オブジェクトを表すオブジェクトを取得します。 |
ParentGroup |
子図形の Shape 一般的な親図形を表す オブジェクトを返します。 |
PictureFormat |
指定したオブジェクトの PictureFormat 図の書式設定プロパティを含むオブジェクトを返します。 |
Reflection |
図形の ReflectionFormat リフレクションの書式設定を表す オブジェクトを返します。 読み取り専用です。 |
RelativeHorizontalPosition |
図形の水平方向の位置が相対的な位置を指定します。 |
RelativeHorizontalSize |
図形の範囲が WdRelativeHorizontalSize 相対的なオブジェクトを表す定数を設定または返します。 値の取得と設定が可能です。 |
RelativeVerticalPosition |
図形の垂直方向の位置を相対的に指定します。 |
RelativeVerticalSize |
図形の相対的な垂直サイズを WdRelativeVerticalSize 表す定数を設定または返します。 値の取得と設定が可能です。 |
Rotation |
取得または指定した図形は、z 軸回りの回転数を設定します。 |
RTF |
内部使用のため予約済みです。 |
Script |
指定した Script Web ページ上のスクリプトまたはコードのブロックを表す オブジェクトを返します。 |
Shadow |
指定した図形の ShadowFormat 影の書式設定を表す オブジェクトを返します。 |
ShapeStyle |
指定した図形の図形スタイルを取得または設定します。 |
SmartArt |
指定した SmartArt 図形に関連付けられている SmartArt を操作する方法を提供するオブジェクトを取得します。 |
SoftEdge |
図形の SoftEdgeFormat ソフト エッジの書式設定を表す オブジェクトを返します。 読み取り専用です。 |
TextEffect |
指定した図形の TextEffectFormat テキスト効果の書式設定プロパティを含むオブジェクトを返します。 |
TextFrame |
指定した図形の TextFrame テキストを含むオブジェクトを返します。 |
TextFrame2 |
指定した図形の TextFrame2 テキストを含むオブジェクトを返します。 読み取り専用です。 |
ThreeD |
指定した図形の ThreeDFormat 3 次元効果の書式設定プロパティを含むオブジェクトを返します。 |
Title |
指定した図形のタイトルを含む文字列を取得または設定します。 |
Top |
指定した図形の垂直方向の位置をポイント単位で設定または返します。 |
TopRelative |
1 つ を表す図形の相対的な先頭位置を設定または返します。 値の取得と設定が可能です。 |
Type |
図形の種類を返します。 |
VerticalFlip |
指定した図形が縦軸を中心に反転するかどうかを決定します。 |
Vertices |
指定したフリーフォームの頂点 (およびベジェ曲線のコントロール ポイント) の座標を、一連の 2 次元の座標として取得します。 |
Visible |
指定したオブジェクトまたはそのオブジェクトに適用された書式設定が表示されるかどうかを判断します。 |
Width |
指定したオブジェクトの幅をポイント単位で設定します。 |
WidthRelative |
図形の相対的な幅を表す Single を取得または設定します。 値の取得と設定が可能です。 |
WrapFormat |
指定した図形の WrapFormat 周囲にテキストを折り返すプロパティを含むオブジェクトを返します。 |
ZOrderPosition |
指定した図形の z 方向の位置を取得します。 |
メソッド
Activate() |
指定されたオブジェクトをアクティブにします。 |
Apply() |
メソッドを使用してコピーされた指定した図形の書式設定に PickUp() 適用されます。 |
CanvasCropBottom(Single) |
描画キャンバスの高さに対するパーセンテージで、キャンバスを下側からトリミングします。 |
CanvasCropLeft(Single) |
.描画キャンバスの幅をパーセンテージで、キャンバスの左側からトリミングします。 |
CanvasCropRight(Single) |
描画キャンバスの幅をパーセンテージで、キャンバスの右側からトリミングします。 |
CanvasCropTop(Single) |
描画キャンバスの高さをパーセンテージで、キャンバスの上側からトリミングします。 |
ConvertToFrame() |
指定された図形をレイアウト枠に変換します。 |
ConvertToInlineShape() |
文書の描画レイヤーで指定された図形を、文字列レイヤーの位置を固定した図形に変換します。 |
Delete() |
指定されたオブジェクトを削除します。 |
Duplicate() |
指定した Shape オブジェクトの複製を作成し、元の図形からの標準オフセットで新しい図形 Shapes の範囲をコレクションに追加し、新しい Shape オブジェクトを返します。 |
Flip(MsoFlipCmd) |
図形を水平方向または垂直方向に反転します。 |
IncrementLeft(Single) |
指定した図形を、指定したポイント数だけ水平方向に移動します。 |
IncrementRotation(Single) |
指定した図形の z 軸回りの回転を、指定した角度だけ変更します。 |
IncrementTop(Single) |
指定した図形を、指定したポイント数だけ垂直方向に移動します。 |
PickUp() |
指定された図形の書式をコピーします。 |
RerouteConnections() |
内部使用のため予約済みです。 |
ScaleHeight(Single, MsoTriState, MsoScaleFrom) |
指定した係数分だけ図形の高さを変更します。 |
ScaleWidth(Single, MsoTriState, MsoScaleFrom) |
指定した係数分だけ図形の幅を変更します。 |
Select(Object) |
指定されたオブジェクトを選択します。 |
SetShapesDefaultProperties() |
指定した図形の書式設定を、そのドキュメントの既定の図形に適用します。 新しく図形を作成すると、その図形は既定の図形から大部分の属性を継承します。 |
Ungroup() |
指定した図形に含まれるグループ化された任意の図形のグループを解除します。 |
ZOrder(MsoZOrderCmd) |
コレクションの他の図形の前面または背後に指定の図形を移動させます (つまり、図形の位置を z オーダーで変更します)。 |