Shape オブジェクト (PowerPoint)Shape Object (PowerPoint)

オートシェイプ、フリーフォーム、OLE オブジェクト、図などの描画オブジェクトを表します。Represents an object in the drawing layer, such as an AutoShape, freeform, OLE object, or picture.

注釈Remarks

メモ 図形を表す 3 つのオブジェクト: ドキュメントのすべての図形を表すShapesコレクションは、ShapeRange コレクションには、指定した文書の図形のサブセットを表します ( ShapeRangeオブジェクトは、ドキュメント上にある図形 1 と 4 を表すことがなど、ドキュメントで選択したすべての図形を表すことがあります)。ドキュメントの 1 つの図形を表すShapeオブジェクトです。Note 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); the Shape object, which represents a single shape on a document. 複数の図形を同時に操作する場合や選択範囲内にある図形を操作する場合は、ShapeRange コレクションを使用します。If you want to work with several shape at the same time or with shapes within the selection, use a ShapeRange collection. 単一の図形または同時に複数の図形を処理する方法については、「使い方: 図形 (描画オブジェクト) を使用する」を参照してください。For an overview of how to work with either a single shape or with more than one shape at a time, see How to: Work with Shapes (Drawing Objects).

次の使用例は、次の方法を示しています。The following examples describe how to:

  • 名前または番号でインデックスが付けられたスライドの既存の図形を取得するReturn an existing shape on a slide, indexed by name or number.

  • スライドに新しく作成した図形を取得するReturn a newly created shape on a slide.

  • 選択範囲内の図形を取得するReturn a shape within the selection.

  • スライドのスライド タイトルおよび他のプレースホルダーを取得するReturn the slide title and other placeholders on a slide.

  • コネクタの端に接続された図形を取得するReturn the shapes attached to the ends of a connector.

  • プレゼンテーションのオートシェイプの既定値を取得するReturn the default shape for a presentation.

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

  • グループ化した図形の中から単一の図形を取得するReturn a single shape from within a group.

  • 新しくグループ化した図形を取得するReturn a newly formed group of shapes.

Example

を使用して図形(インデックス)、インデックスは、図形の名前またはインデックス番号は、スライド上の図形を表すShapeオブジェクトを取得します。Use Shapes (index), where index is the shape name or the index number, to return a Shape object that represents a shape on a slide. 次の使用例は、myDocument の Rectangle 1 という名前の図形 1 を水平に反転します。The following example horizontally flips shape one and the shape named Rectangle 1 on myDocument.

Set myDocument = ActivePresentation.Slides(1)

myDocument.Shapes(1).Flip msoFlipHorizontal

myDocument.Shapes("Rectangle 1").Flip msoFlipHorizontal

各図形は、 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. 次の例は、四角形を myDocument に追加、名前の赤色の正方形が与えられ、前景の色と線のスタイルを設定し、します。The following example adds a rectangle to myDocument, gives it the name Red Square, and then sets its foreground color and line style.

Set myDocument = ActivePresentation.Slides(1)

With myDocument.Shapes.AddShape(Type:=msoShapeRectangle, _

        Top:=144, Left:=144, Width:=72, Height:=72)

    .Name = "Red Square"

    .Fill.ForeColor.RGB = RGB(255, 0, 0)

    .Line.DashStyle = msoLineDashDot

End With

スライドに図形を追加し、新しく作成された図形を表すShapeオブジェクトを取得、次のShapesコレクションのメソッドのいずれかの操作を使用して:AddCalloutAddComment取得しするAddLabel AddMediaObjectAddOLEObjectAddPictureAddPlaceholderAddPolylineAddShapeAddTableAddTextboxメソッドを使用AddTitleTo add a shape to a slide and return a Shape object that represents the newly created shape, use one of the following methods of the Shapes collection:AddCallout, AddComment, AddConnector, AddCurve, AddLabel, AddLine, AddMediaObject, AddOLEObject, AddPicture, AddPlaceholder, AddPolyline, AddShape, AddTable, AddTextbox, AddTextEffect, AddTitle.

Selection.ShapeRange (インデックス) をインデックスは、図形の名前またはインデックス番号を使用して、選択範囲内の図形を表す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. 次の使用例は、選択範囲内に少なくとも 1 つの図形があると仮定して、アクティブ ウィンドウの選択範囲内にある最初の図形に塗りつぶしを設定します。The following example sets the fill for the first shape in the selection in the active window, assuming that there's at least one shape in the selection.

ActiveWindow.Selection.ShapeRange(1).Fill _

    .ForeColor.RGB = RGB(255, 0, 0)

番号を使用して、既存のスライド タイトルを表すShapeオブジェクトを取得します。Use Shapes.Title to return a Shape object that represents an existing slide title. 既に 1 つがあり、新しく作成したタイトルを表すShapeオブジェクトを取得するためのスライドにタイトルを追加するのにには、 Shapes.AddTitleを使用します。Use Shapes.AddTitle to add a title to a slide that doesn't already have one and return a Shape object that represents the newly created title. Shapes.Placeholders (インデックス)、インデックスがプレース ホルダーのインデックス番号を使用して、プレース ホルダーを表すShapeオブジェクトを取得します。Use Shapes.Placeholders (index), where index is the placeholder's index number, to return a Shape object that represents a placeholder. スライド上の図形の重ね合わせの順序を変更していない場合は次の 3 つのステートメントは同等ですが、タイトル スライド 1 がある場合します。If you have not changed the layering order of the shapes on a slide, the following three statements are equivalent, assuming that slide one has a title.

ActivePresentation.Slides(1).Shapes.Title _

    .TextFrame.TextRange.Font.Italic = True

ActivePresentation.Slides(1).Shapes.Placeholders(1) _

    .TextFrame.TextRange.Font.Italic = True

ActivePresentation.Slides(1).Shapes(1).TextFrame _

    .TextRange.Font.Italic = True

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

プレゼンテーションの既定の図形を表す Shape オブジェクトを取得するには、 DefaultShape プロパティを使用します。To return a Shape object that represents the default shape for a presentation, use the DefaultShapeproperty.

BuildFreeformAddNodesメソッドを使用して、フリー フォーム、新しいジオメトリを定義して、 ConvertToShapeメソッドを使用して、フリー フォームを作成し、それを表すShapeオブジェクトを取得します。Use the BuildFreeformand AddNodesmethods to define the geometry of a new freeform, and use the ConvertToShapemethod to create the freeform and return the Shape object that represents it.

グループ化した図形内の単一の図形を表す Shape オブジェクトを取得するには、 GroupItems (index) プロパティを使用します。引数 index には、グループ内の図形名またはインデックス番号を指定します。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.

図形範囲をグループ化し、新しく形成されたグループを表す単一のShapeオブジェクトを取得するには、グループまたは再グループ化の方法を使用します。Use the Group or Regroupmethod 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.

メソッドMethods

名前Name
ApplyApply
ApplyAnimationApplyAnimation
ConvertTextToSmartArtConvertTextToSmartArt
CopyCopy
CutCut
DeleteDelete
DuplicateDuplicate
FlipFlip
IncrementLeftIncrementLeft
IncrementRotationIncrementRotation
IncrementTopIncrementTop
PickUpPickUp
PickupAnimationPickupAnimation
RerouteConnectionsRerouteConnections
ScaleHeightScaleHeight
ScaleWidthScaleWidth
SelectSelect
SetShapesDefaultPropertiesSetShapesDefaultProperties
UngroupUngroup
UpgradeMediaUpgradeMedia
ZOrderZOrder

プロパティProperties

NameName
ActionSettingsActionSettings
AdjustmentsAdjustments
AlternativeTextAlternativeText
AnimationSettingsAnimationSettings
ApplicationApplication
AutoShapeTypeAutoShapeType
BackgroundStyleBackgroundStyle
BlackWhiteModeBlackWhiteMode
CalloutCallout
ChartChart
ChildChild
ConnectionSiteCountConnectionSiteCount
ConnectorConnector
ConnectorFormatConnectorFormat
CreatorCreator
CustomerDataCustomerData
FillFill
GlowGlow
GroupItemsGroupItems
HasChartHasChart
HasInkXMLHasInkXML
HasSmartArtHasSmartArt
HasTableHasTable
HasTextFrameHasTextFrame
HeightHeight
HorizontalFlipHorizontalFlip
IdId
InkXMLInkXML
IsNarrationIsNarration
LeftLeft
LineLine
LinkFormatLinkFormat
LockAspectRatioLockAspectRatio
MediaFormatMediaFormat
MediaTypeMediaType
NameName
NodesNodes
OLEFormatOLEFormat
ParentParent
ParentGroupParentGroup
PictureFormatPictureFormat
PlaceholderFormatPlaceholderFormat
ReflectionReflection
RotationRotation
ShadowShadow
ShapeStyleShapeStyle
SmartArtSmartArt
SoftEdgeSoftEdge
TableTable
TagsTags
TextEffectTextEffect
TextFrameTextFrame
TextFrame2TextFrame2
ThreeDThreeD
TitleTitle
TopTop
Type
VerticalFlipVerticalFlip
VerticesVertices
VisibleVisible
WidthWidth
ZOrderPositionZOrderPosition

関連項目See also

PowerPoint オブジェクト モデル リファレンスPowerPoint Object Model Reference