Shape Shape Shape Interface

定義

オートシェイプ、フリーフォーム、OLE オブジェクト、図などの描画オブジェクトを表します。 Represents an object in the drawing layer, such as an AutoShape, freeform, OLE object, or picture. Shapeオブジェクトのメンバーである、Shapesコレクションです。 The Shape object is a member of the Shapes collection. Shapesコレクションには、スライド上のすべての図形が含まれています。 The Shapes collection contains all the shapes on a slide.

public interface class Shape
[System.Runtime.InteropServices.Guid("00024439-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface Shape
Public Interface Shape
属性

注釈

図形を表す 3 つのオブジェクト: ドキュメントのすべての図形を表すShapesコレクションは、ShapeRangeコレクションを指定した文書の図形のサブセットを表します ( ShapeRangeオブジェクトは、ドキュメント上にある図形 1 と 4 を表すことがなど、ドキュメントで選択したすべての図形を表すことがあります)。文書の 1 つの図形を表すShapeオブジェクトです。 There are three objects that represent shapes: the Shapes collection, which represents all the shapes on a document; the ShapeRange collection, which represents a specified subset of the shapes on a document (for example, a ShapeRange object could represent shapes one and four on the document, or it could represent all the selected shapes on the document); and the Shape object, which represents a single shape on a document. 同時に、または選択範囲内の図形には、いくつかの図形を操作する場合は、 ShapeRangeコレクションを使用します。 If you want to work with several shapes at the same time or with shapes within the selection, use a ShapeRange collection.

このセクションで説明する方法。 This section describes how to:

  • 既存の図形を取得する Return an existing shape.
  • 選択範囲内の図形を取得する Return a shape within the selection.
  • コネクタの両端が接続された図形を取得する Return the shapes attached to the ends of a connector.
  • 新しく作成したフリーフォームを取得する Return a newly created freeform.
  • グループ化した図形の中から単一の図形を取得する Return a single shape from within a group.
  • 新しく形成した図形グループを取得する Return a newly formed group of shapes.

既存の図形を取得する Returning an Existing Shape

図形を使用する (index)、indexは、図形の名前またはインデックス番号の図形を表すShapeオブジェクトを取得するのには。 Use Shapes(index), where index is the shape name or the index number, to return a Shape object that represents a shape.

各図形は、 Shapesコレクションに追加すると、既定の名前を割り当てられますがします。 Each shape is assigned a default name when you add it to the Shapes collection. 図形にわかりやすい名前を付けるを使用して、Nameプロパティ。 To give the shape a more meaningful name, use the Name property.

選択範囲内の図形を取得する Returning a Shape Within the Selection

Selection.ShapeRangeを使用 (index)、indexは、図形の名前またはインデックス番号で、選択範囲内の図形を表すShapeオブジェクトを取得するのには。 Use Selection.ShapeRange(index), where index is the shape name or the index number, to return a Shape object that represents a shape within the selection.

コネクタの両端が接続された図形を取得する Returning the Shapes Attached to the Ends of a Connector

コネクタで接続された図形の 1 つを表すShapeオブジェクトを返すを使用して、BeginConnectedShapeまたはEndConnectedShapeプロパティ。 To return a Shape object that represents one of the shapes attached by a connector, use the BeginConnectedShape or EndConnectedShape property.

新しく作成したフリーフォームを取得する Returning a newly created freeform

使用して、BuildFreeform(MsoEditingType, Single, Single)AddNodes(MsoSegmentType, MsoEditingType, Single, Single, Object, Object, Object, Object)フリー フォーム、新しいジオメトリを定義して使用する方法、 ConvertToShape() 、フリー フォームを作成し、それを表すShapeオブジェクトを取得するメソッドです。 Use the BuildFreeform(MsoEditingType, Single, Single) and AddNodes(MsoSegmentType, MsoEditingType, Single, Single, Object, Object, Object, Object) methods to define the geometry of a new freeform, and use the ConvertToShape() method to create the freeform and return the Shape object that represents it.

グループ内から単一の図形を取得する Returning a Single Shape from Within a Group

GroupItemsを使用 (index)、indexは、図形の名前またはインデックス番号をグループ化された図形の 1 つの図形を表すShapeオブジェクトを取得するのには、グループ内で。 Use GroupItems(index), where index is the shape name or the index number within the group, to return a Shape object that represents a single shape in a grouped shape.

新しく形成した図形グループを取得する Returning a Newly Formed Group of Shapes

使用して、Group()またはRegroup()範囲の図形をグループ化し、新しく形成されたグループを表す 1 つのShapeオブジェクトを返すメソッドです。 Use the Group() or Regroup() method to group a range of shapes and return a single Shape object that represents the newly formed group. グループの作成後は、他の図形を操作する場合と同じようにグループを操作できます。 After a group has been formed, you can work with the group the same way you work with any other shape.

プロパティ

Adjustments Adjustments Adjustments

返します、 Adjustments 、指定した図形のすべての調整項目に対する調整値を格納しているオブジェクト。 Returns an Adjustments object that contains adjustment values for all the adjustments in the specified shape. 読み取り専用。 Read-only.

AlternativeText AlternativeText AlternativeText

説明 (代替) テキスト文字列を設定を取得または設定、Shapeオブジェクトは Web ページに保存されるとします。 Returns or sets the descriptive (alternative) text string for a Shape object when the object is saved to a Web page. 値の取得および設定が可能です。文字列型 ( String ) の値を使用します。 Read/write String.

Application Application Application

返します、 Application 、Microsoft Excel アプリケーションを表すオブジェクト。 Returns an Application object that represents the Microsoft Excel application. 読み取り専用。 Read-only.

AutoShapeType AutoShapeType AutoShapeType

指定された図形の種類を取得またはShapeオブジェクトで、線、フリー フォーム、またはコネクタ以外のオートシェイプを表す必要があります。 Returns or sets the shape type for the specified Shape object, which must represent an AutoShape other than a line, freeform drawing, or connector. 読み取り/書き込みMsoAutoShapeType Read/write MsoAutoShapeType.

BackgroundStyle BackgroundStyle BackgroundStyle

背景のスタイルを設定または返します。 Returns or sets the background style. 値の取得および設定が可能です。 Read/write.

BlackWhiteMode BlackWhiteMode BlackWhiteMode

プレゼンテーションを白黒表示モードにした場合に、指定した図形の表示方法を示す値を設定します。 Returns or sets a value that indicates how the specified shape appears when the presentation is viewed in black-and-white mode. 読み取り/書き込みMsoBlackWhiteMode Read/write MsoBlackWhiteMode.

BottomRightCell BottomRightCell BottomRightCell

返します、Rangeオブジェクトの右下隅にあるセルを表すオブジェクト。 Returns a Range object that represents the cell that lies under the lower-right corner of the object. 読み取り専用。 Read-only.

Callout Callout Callout

返します、CalloutFormat引き出し線の書式指定した図形のプロパティを格納しているオブジェクト。 Returns a CalloutFormat object that contains callout formatting properties for the specified shape. 適用されるShape線吹き出しを表すオブジェクト。 Applies to Shape objects that represent line callouts. 読み取り専用。 Read-only.

CanvasItems CanvasItems CanvasItems

内部使用のため予約済みです。 Reserved for internal use.

Chart Chart Chart

表すオブジェクトを取得、_Chartに含まれている、 Shape Returns an object that represents the _Chart contained in the Shape. 読み取り専用。 Read-only.

Child Child Child

指定した図形が子図形または図形範囲のすべての図形が同じ親の子図形である場合は、 msoTrueを返します。 Returns msoTrue if the specified shape is a child shape or if all shapes in a shape range are child shapes of the same parent. 読み取り専用MsoTriState Read-only MsoTriState.

ConnectionSiteCount ConnectionSiteCount ConnectionSiteCount

指定した図形の結合点の数を取得します。 Returns the number of connection sites on the specified shape. 整数型 ( Integer) の値を使用します。 Read-only Integer.

Connector Connector Connector

True指定した図形がコネクタの場合です。 True if the specified shape is a connector. 読み取り専用MsoTriState Read-only MsoTriState.

ConnectorFormat ConnectorFormat ConnectorFormat

返します、ConnectorFormatコネクタの書式設定プロパティを含むオブジェクトです。 Returns a ConnectorFormat object that contains connector formatting properties. 適用されるShapeコネクタを表すオブジェクト。 Applies to Shape objects that represent connectors. 読み取り専用。 Read-only.

ControlFormat ControlFormat ControlFormat

返します、 ControlFormat Excel コントロールのプロパティを格納しているオブジェクト。 Returns a ControlFormat object that contains Microsoft Excel control properties. 読み取り専用。 Read-only.

Creator Creator Creator

現在のオブジェクトが作成されたアプリケーションを示す 32 ビットの整数を返します。 Returns a 32-bit integer that indicates the application in which this object was created. オブジェクトは、Microsoft Excel で作成されている場合を返します文字列 XCEL を 16 進数の 5843454c に相当 If the object was created in Microsoft Excel, this property returns the string XCEL, which is equivalent to the hexadecimal number 5843454C. 読み取り専用XlCreator Read-only XlCreator.

Diagram Diagram Diagram

返します、 Diagram 、図を表すオブジェクト。 Returns a Diagram object representing a diagram.

DiagramNode DiagramNode DiagramNode

返します、 DiagramNode 、ダイアグラム内のノードを表すオブジェクト。 Returns a DiagramNode object that represents a node in a diagram.

DrawingObject DrawingObject DrawingObject

内部使用のため予約済みです。 Reserved for internal use.

Fill Fill Fill

返します、 FillFormat 、指定したグラフまたは図形のプロパティを格納しているオブジェクト。 Returns a FillFormat object that contains fill formatting properties for the specified chart or shape. 読み取り専用。 Read-only.

FormControlType FormControlType FormControlType

Microsoft Excel コントロールの種類を返します。 Returns the Microsoft Excel control type. 読み取り専用XlFormControl Read-only XlFormControl.

Glow Glow Glow

光彩の書式を図形のプロパティを含む指定された図形のオブジェクトを返します。 Returns an object for a specified shape that contains glow formatting properties for that shape. 読み取り専用。 Read-only.

GroupItems GroupItems GroupItems

返します、GroupShapes指定されたグループ内の個々 の図形を表すオブジェクト。 Returns a GroupShapes object that represents the individual shapes in the specified group. 使用して、 Item(Object)グループ形状にオブジェクトのメソッド グループから 1 つの図形を取得します。 Use the Item(Object) method of the GroupShapes object to return a single shape from the group. 適用されるShapeグループ化された図形を表すオブジェクト。 Applies to Shape objects that represent grouped shapes. 読み取り専用。 Read-only.

HasChart HasChart HasChart

情報を返す場合に、Shapeグラフが含まれています。 Returns information on if a Shape contains a chart. 読み取り専用。 Read-only.

HasDiagram HasDiagram HasDiagram

図形または図形範囲に図表が含まれているかどうかを返します。 Returns whether a shape or shape range contains a diagram. 読み取り専用MsoTriState Read-only MsoTriState.

HasDiagramNode HasDiagramNode HasDiagramNode

指定した図形または図形範囲に図表ノードが存在するかどうかを示す値を返します。 Returns a value indicating whether a diagram node exists in a given shape or shape range. 読み取り専用MsoTriState Read-only MsoTriState.

HasSmartArt HasSmartArt HasSmartArt

SmartArt 図の指定した図形に存在するかどうかを取得します。 Gets whether there is a SmartArt diagram present on the specified shape.

Height Height Height

オブジェクトの高さ。 The height of the object. 読み取り/書き込み 1 つ です。 Read/write Single.

HorizontalFlip HorizontalFlip HorizontalFlip

True の場合は、指定した図形が水平軸を中心として反転します。 True if the specified shape is flipped around the horizontal axis. 読み取り専用MsoTriState Read-only MsoTriState.

Hyperlink Hyperlink Hyperlink

返します、Hyperlinkの図形のハイパーリンクを表すオブジェクト。 Returns a Hyperlink object that represents the hyperlink for the shape.

ID ID ID

指定したオブジェクトの型を返します。 Returns the type for the specified object. 整数型 ( Integer) の値を使用します。 Read-only Integer.

Left Left Left

(ワークシートの列 A の左端をグラフ エリア (グラフの場合) の左端から、オブジェクトの左端からの距離。 The distance from the left edge of the object to the left edge of column A (on a worksheet) or the left edge of the chart area (on a chart). 読み取り/書き込み 1 つ です。 Read/write Single.

Line Line Line

返します、LineFormatオブジェクトを指定した図形のプロパティを書式設定の行が含まれています。 Returns a LineFormat object that contains line formatting properties for the specified shape. 読み取り専用。 Read-only.

LinkFormat LinkFormat LinkFormat

返します、LinkFormatリンクされた OLE オブジェクトのプロパティを格納しているオブジェクト。 Returns a LinkFormat object that contains linked OLE object properties. 読み取り専用。 Read-only.

LockAspectRatio LockAspectRatio LockAspectRatio

True の場合、指定した図形では、サイズを変更するときの元の縦横比が保持されます。 True if the specified shape retains its original proportions when you resize it. False場合は、サイズを変更するときに個別に図形の幅と高さを変更することができます。 False if you can change the height and width of the shape independently of one another when you resize it. 読み取り/書き込みMsoTriState Read/write MsoTriState.

Locked Locked Locked

Trueオブジェクトがロックされている場合はFalse場合は、シートが保護されている場合、オブジェクトを変更できます。 True if the object is locked, False if the object can be modified when the sheet is protected. ブール型 ( Boolean) の値を使用します。 Read/write Boolean.

Name Name Name

指定されたオブジェクトの名前を設定します。値の取得および設定が可能です。文字列型 ( String ) の値を使用します。 Returns or sets the name of the object. Read/write String.

Nodes Nodes Nodes

返します、 ShapeNodes 、指定した図形の幾何学的な説明を表すコレクション。 Returns a ShapeNodes collection that represents the geometric description of the specified shape. 適用されるShapeフリー フォームの描画を表すオブジェクト。 Applies to Shape objects that represent freeform drawings.

OLEFormat OLEFormat OLEFormat

返します、 OLEFormat OLE オブジェクトのプロパティを格納しているオブジェクト。 Returns an OLEFormat object that contains OLE object properties. 読み取り専用。 Read-only.

OnAction OnAction OnAction

指定したオブジェクトがクリックされたときに実行されるマクロの名前を設定または返します。 Returns or sets the name of a macro that’s run when the specified object is clicked. 値の取得および設定が可能です。文字列型 ( String ) の値を使用します。 Read/write String.

Parent Parent Parent

指定されたオブジェクトの親オブジェクトを返します。値の取得のみ可能です。 Returns the parent object for the specified object. Read-only.

ParentGroup ParentGroup ParentGroup

返します、Shapeを共通の親図形の子図形または子図形の範囲を表すオブジェクト。 Returns a Shape object that represents the common parent shape of a child shape or a range of child shapes.

PictureFormat PictureFormat PictureFormat

返します、PictureFormat図の指定した図形のプロパティを書式設定を格納しているオブジェクト。 Returns a PictureFormat object that contains picture formatting properties for the specified shape. 適用されるShape図または OLE オブジェクトを表すオブジェクト。 Applies to Shape objects that represent pictures or OLE objects. 読み取り専用。 Read-only.

Placement Placement Placement

オブジェクトがその下のセルに関連付けられている方法を設定または返します。 Returns or sets the way the object is attached to the cells below it. 読み取り/書き込みXlPlacement Read/write XlPlacement.

Reflection Reflection Reflection

リフレクションの書式設定、図形のプロパティを格納しているオブジェクトを返します。 Returns an object that contains reflection formatting properties for the shape. 読み取り専用。 Read-only.

Rotation Rotation Rotation

度単位で図形の回転角度を設定または返します。 Returns or sets the rotation of the shape in degrees. 読み取り/書き込み 1 つ です。 Read/write Single.

Script Script Script

指定された Web ページ上のスクリプト ブロックまたはコード ブロックを表す Script オブジェクトを返します。指定のページにスクリプトが含まれない場合、何も取得されません。 Returns the Script object, which represents a block of script or code on the specified Web page. If the page contains no script, nothing is returned.

Shadow Shadow Shadow

True を指定のオブジェクトに影がある場合。 True if the object has a shadow. ブール型 ( Boolean) の値を使用します。 Read/write Boolean.

ShapeStyle ShapeStyle ShapeStyle

値を取得または設定、 MsoShapeStyleIndex 、図形の図形のスタイルを表します。 Returns or sets a MsoShapeStyleIndex that represents the shape style of the shape. 値の取得および設定が可能です。 Read/write.

SmartArt SmartArt SmartArt

図形に関連付けられている SmartArt を表すオブジェクトを取得します。 Gets an object that represents the SmartArt associated with the shape.

SoftEdge SoftEdge SoftEdge

返します、SoftEdgeFormatのぼかしの書式設定、図形のプロパティを含む指定された図形のオブジェクトです。 Returns a SoftEdgeFormat object for a specified shape that contains soft edge formatting properties for the shape. 読み取り専用。 Read-only.

TextEffect TextEffect TextEffect

返します、 TextEffectFormat 、指定した図形のテキスト効果の書式プロパティを含むオブジェクトです。 Returns a TextEffectFormat object that contains text-effect formatting properties for the specified shape. ワードアートを表すT:Microsoft.Office.Interop.Excel.Shapeオブジェクトに適用されます。 Applies to T:Microsoft.Office.Interop.Excel.Shape objects that represent WordArt. 読み取り専用。 Read-only.

TextFrame TextFrame TextFrame

返します、TextFrameの配置およびアンカーの指定した図形のプロパティを格納しているオブジェクト。 Returns a TextFrame object that contains the alignment and anchoring properties for the specified shape. 読み取り専用。 Read-only.

TextFrame2 TextFrame2 TextFrame2

テキストの指定した図形の書式設定を格納しているオブジェクトを返します。 Returns an object that contains text formatting for the specified shape. 読み取り専用。 Read-only.

ThreeD ThreeD ThreeD

返します、 ThreeDFormat 3-d スタイル: 書式設定プロパティを指定した図形の効果を含むオブジェクトです。 Returns a ThreeDFormat object that contains 3-D – effect formatting properties for the specified shape. 読み取り専用。 Read-only.

Title Title Title

取得または指定した図形に関連付けられている代替テキストのタイトルを設定します。 Gets or sets the title of the alternative text associated with the specified shape.

Top Top Top

図形範囲の最上位の図形の上端からワークシートの上端までの距離。 The distance from the top edge of the topmost shape in the shape range to the top edge of the worksheet. 読み取り/書き込み 1 つ です。 Read/write Single.

TopLeftCell TopLeftCell TopLeftCell

返します、Rangeを指定したオブジェクトの左上隅にあるセルを表すオブジェクト。 Returns a Range object that represents the cell that lies under the upper-left corner of the specified object. 読み取り専用。 Read-only.

Type Type Type

図形の種類を設定または返します。 Returns or sets the shape type. 読み取り専用MsoShapeType Read-only MsoShapeType.

VerticalFlip VerticalFlip VerticalFlip

True の場合指定した図形が垂直軸を中心に反転します。 True if the specified shape is flipped around the vertical axis. 読み取り専用MsoTriState Read-only MsoTriState.

Vertices Vertices Vertices

一連の座標のペアとして指定されたフリー フォームの頂点 (およびベジェ曲線のコントロール ポイント) の座標を返します。 Returns the coordinates of the specified freeform drawing's vertices (and control points for Bézier curves) as a series of coordinate pairs. 読み取り専用 オブジェクト Read-only Object.

Visible Visible Visible

オブジェクトを表示するかどうかを決定します。 Determines whether the object is visible. 読み取り/書き込みMsoTriState Read/write MsoTriState.

Width Width Width

オブジェクトの幅。 The width of the object. 読み取り/書き込み 1 つ です。 Read/write Single.

ZOrderPosition ZOrderPosition ZOrderPosition

指定した図形の z 方向の位置を取得します。 Returns the position of the specified shape in the z-order. 整数型 ( Integer) の値を使用します。 Read-only Integer.

方法

Apply() Apply() Apply()

使用してコピーされている指定した図形の書式設定に適用されます、PickUp()メソッドです。 Applies to the specified shape formatting that’s been copied by using the PickUp() method.

CanvasCropBottom(Single) CanvasCropBottom(Single) CanvasCropBottom(Single)

内部使用のため予約済みです。 Reserved for internal use.

CanvasCropLeft(Single) CanvasCropLeft(Single) CanvasCropLeft(Single)

内部使用のため予約済みです。 Reserved for internal use.

CanvasCropRight(Single) CanvasCropRight(Single) CanvasCropRight(Single)

内部使用のため予約済みです。 Reserved for internal use.

CanvasCropTop(Single) CanvasCropTop(Single) CanvasCropTop(Single)

内部使用のため予約済みです。 Reserved for internal use.

Copy() Copy() Copy()

オブジェクトをクリップボードにコピーします。 Copies the object to the Clipboard.

CopyPicture(Object, Object) CopyPicture(Object, Object) CopyPicture(Object, Object)

選択しているオブジェクトを図としてクリップボードにコピーします。 Copies the selected object to the Clipboard as a picture.

Cut() Cut() Cut()

オブジェクトを切り取り、クリップボードまたは指定された範囲に貼り付けます。 Cuts the object to the Clipboard or pastes it into a specified destination.

Delete() Delete() Delete()

オブジェクトを削除します。 Deletes the object.

Duplicate() Duplicate() Duplicate()

オブジェクトを複製し、その複製への参照を返します。 Duplicates the object and returns a reference to the new copy.

Flip(MsoFlipCmd) Flip(MsoFlipCmd) Flip(MsoFlipCmd)

指定した図形を、水平軸または垂直軸を中心として反転します。 Flips the specified shape around its horizontal or vertical axis.

IncrementLeft(Single) IncrementLeft(Single) IncrementLeft(Single)

指定された図形を、指定したポイント数だけ水平方向に移動します。 Moves the specified shape horizontally by the specified number of points.

IncrementRotation(Single) IncrementRotation(Single) IncrementRotation(Single)

図形の z 軸を中心とした回転角度を、指定した度数だけ変更します。 Changes the rotation of the specified shape around the z-axis by the specified number of degrees. 使用して、Rotationの図形の絶対回転角度を設定するプロパティです。 Use the Rotation property to set the absolute rotation of the shape.

IncrementTop(Single) IncrementTop(Single) IncrementTop(Single)

指定した図形を、指定したポイント数だけ垂直に移動します。 Moves the specified shape vertically by the specified number of points.

PickUp() PickUp() PickUp()

図形の書式をコピーします。 Copies the formatting of the specified shape. 使用して、Apply()を別の図形にコピーした書式を適用する方法です。 Use the Apply() method to apply the copied formatting to another shape.

RerouteConnections() RerouteConnections() RerouteConnections()

RerouteConnections メソッドは、図形間を結ぶ線 (コネクタ) の経路が最短になるように、そのコネクタを再接続します。 Reroutes connectors so that they take the shortest possible path between the shapes they connect.

ScaleHeight(Single, MsoTriState, Object) ScaleHeight(Single, MsoTriState, Object) ScaleHeight(Single, MsoTriState, Object)

図形の高さを指定した係数で拡大または縮小します。 Scales the height of the shape by a specified factor.

ScaleWidth(Single, MsoTriState, Object) ScaleWidth(Single, MsoTriState, Object) ScaleWidth(Single, MsoTriState, Object)

図形の幅を、指定した係数で拡大または縮小します。 Scales the width of the shape by a specified factor.

Select(Object) Select(Object) Select(Object)

オブジェクトを選択します。 Selects the object.

SetShapesDefaultProperties() SetShapesDefaultProperties() SetShapesDefaultProperties()

指定された図形の書式を、その図形の既定の書式にします。 Makes the formatting of the specified shape the default formatting for the shape.

Ungroup() Ungroup() Ungroup()

指定した図形または図形範囲の図形のグループ化を解除します。 Ungroups any grouped shapes in the specified shape or range of shapes. 図および OLE オブジェクトを指定した図形内を逆アセンブルします。 Disassembles pictures and OLE objects within the specified shape. 1 つとしてグループ化されていない図形を返しますShapeRangeオブジェクトです。 Returns the ungrouped shapes as a single ShapeRange object.

ZOrder(MsoZOrderCmd) ZOrder(MsoZOrderCmd) ZOrder(MsoZOrderCmd)

指定された図形をコレクションの他の図形の前面または背面に移動します。つまり、図形の z 方向における順序を変更します。 Moves the specified shape in front of or behind other shapes in the collection (that is, changes the shape's position in the z-order).

適用対象