Shape-Objekt (PowerPoint)Shape Object (PowerPoint)

Stellt ein Objekt in der Zeichnungsebene dar, z. B. eine AutoForm, eine Freihandform, ein OLE-Objekt oder eine Grafik.Represents an object in the drawing layer, such as an AutoShape, freeform, OLE object, or picture.

BemerkungenRemarks

Hinweis Es gibt drei Objekte, die Formen darstellen: die Shapes -Auflistung, die alle Formen in einem Dokument; darstellt. ShapeRange -Auflistung, die eine angegebene Teilmenge der Formen in einem Dokument darstellt (beispielsweise ein ShapeRange -Objekt die Formen 1 und 4 im Dokument darstellen, oder alle markierten Formen im Dokument darstellen); das Shape -Objekt, das eine einzelne Form in einem Dokument darstellt.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. Wenn Sie gleichzeitig mit mehreren Formen oder mit Formen in der Auswahl arbeiten, verwenden Sie eine ShapeRange-Sammlung.If you want to work with several shape at the same time or with shapes within the selection, use a ShapeRange collection. Eine Übersicht über das Arbeiten mit einer einzelnen Form oder mit mehr als eine Form zu einem Zeitpunkt, finden Sie unter Vorgehensweise: Arbeiten mit Formen (Zeichnungsobjekte).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).

Im folgenden Beispiel werden folgende Aktionen beschrieben:The following examples describe how to:

  • Zurückgeben einer vorhandenen Form auf einer Folie, die durch den Namen oder eine Nummer indiziert ist.Return an existing shape on a slide, indexed by name or number.

  • Zurückgeben einer neu erstellten Form auf einer Folie.Return a newly created shape on a slide.

  • Zurückgeben einer Form innerhalb der Markierung.Return a shape within the selection.

  • Zurückgeben des Folientitels und anderer Platzhalter auf einer Folie.Return the slide title and other placeholders on a slide.

  • Zurückgeben der Formen, die mit den Enden einer Verbindung zusammengefügt sind.Return the shapes attached to the ends of a connector.

  • Zurückgeben der Standardform für eine Präsentation.Return the default shape for a presentation.

  • Zurückgeben einer neu erstellten Freihandform.Return a newly created freeform.

  • Zurückgeben einer einzelnen Form innerhalb einer Gruppe.Return a single shape from within a group.

  • Zurückgeben einer neu gebildeten Gruppe von Formen.Return a newly formed group of shapes.

BeispielExample

Verwenden von Formen (Index), wobei Index der Name des Shapes oder die Indexnummer ist, um ein Shape -Objekt zurückzugeben, das eine Form auf einer Folie darstellt.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. In dem folgenden Beispiel wird Form 1 und die Form "Rectangle 1" in myDocument horizontal gespiegelt.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

Jeder Form wird ein Standardname zugewiesen, wenn Sie es der Shapes -Auflistung hinzufügen.Each shape is assigned a default name when you add it to the Shapes collection. Wenn der Form einen aussagekräftigeren Namen übergeben möchten, verwenden Sie die Name -Eigenschaft.To give the shape a more meaningful name, use the Name property. Im folgenden Beispiel wird MyDocument ein Rechteck hinzugefügt, weist ihm das Namen rotes Quadrat und legt dann die Vordergrundfarbe und die Linienart fest.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

Um einer Folie eine Form hinzugefügt und ein Shape -Objekt, das die neu erstellte Form darstellt, zurückzugeben, verwenden Sie eine der folgenden Methoden der Shapes -Auflistung:AddCallout, AddComment, AddConnector, AddCurve, AddLabel, AddLine, AddMediaObject, AddOLEObject, AddPicture, AddPlaceholder, AddPolyline, AddShape, AddTable, AddTextbox, AddTextEffect, AddTitle.To 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.

Verwenden Sie Selection.ShapeRange (Index), wobei Index der Name des Shapes oder die Indexnummer ist, um ein Shape -Objekt zurückzugeben, das eine Form innerhalb der Markierung darstellt.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. Das folgende Beispiel legt die Füllung für die erste Form in der Auswahl im aktiven Fenster, davon ausgegangen, dass mindestens eine Form in der Auswahl ist.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)

Verwenden Sie Platzhalters , um ein Shape -Objekt zurückzugeben, das einen vorhandenen Folientitel darstellt.Use Shapes.Title to return a Shape object that represents an existing slide title. Verwenden Sie Shapes.AddTitle Hinzufügen eines Titels zu einer Folie, die nicht bereits und zurückgeben ein Shape -Objekt, das den neu erstellten Titel darstellt.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. Verwenden Sie Shapes.Placeholders (Index), wobei Index die Indexnummer der Platzhalter ist, um ein Shape -Objekt zurückzugeben, das einen Platzhalter darstellt.Use Shapes.Placeholders (index), where index is the placeholder's index number, to return a Shape object that represents a placeholder. Wenn Sie nicht die Reihenfolge der Ebenen der Formen auf einer Folie geändert haben, sind die folgenden drei Anweisungen gleichwertig, sofern dieser Folie einen Titel besitzt.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

Um ein Shape -Objekt zurückzugeben, das eine der durch eine Verbindung zugeordneten Formen darstellt, verwenden Sie die Eigenschaft BeginConnectedShape oder EndConnectedShape-Eigenschaft.To return a Shape object that represents one of the shapes attached by a connector, use the BeginConnectedShape or EndConnectedShapeproperty.

Wenn Sie ein Shape -Objekt zurückgeben möchten, mit dem die Standardform für eine Präsentation dargestellt wird, verwenden Sie die DefaultShape-Eigenschaft.To return a Shape object that represents the default shape for a presentation, use the DefaultShapeproperty.

Verwenden Sie die BuildFreeform-und AddNodes-Methode, um die Geometrie eines neuen Freihandobjekts zu definieren, und verwenden Sie die ConvertToShape-Methode, um die Freihandform erstellen und Zurückgeben des Shape -Objekts, das es darstellt.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.

Verwenden Sie GroupItems (Index), wobei es sich bei Index um den Namen oder die Indexnummer der Form innerhalb der Gruppe handelt, um ein Shape -Objekt zurückzugeben, das eine einzelne Form aus einer gruppierten Form repräsentiert.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.

Verwenden Sie die Gruppe oder Regroup-Methode einen Bereich von Formen gruppieren und zurückgeben ein einzelnes Shape -Objekt, das die neu gebildete Gruppe darstellt.Use the Group or Regroupmethod to group a range of shapes and return a single Shape object that represents the newly formed group. Nachdem eine Gruppe gebildet wurde, können Sie mit der Gruppe genauso arbeiten wie mit anderen Formen.After a group has been formed, you can work with the group the same way you work with any other shape.

MethodenMethods

NameName
ApplyApply
ApplyAnimationApplyAnimation
ConvertTextToSmartArtConvertTextToSmartArt
CopyCopy
AusschneidenCut
DeleteDelete
DoppelteDuplicate
FlipFlip
IncrementLeftIncrementLeft
IncrementRotationIncrementRotation
IncrementTopIncrementTop
PickUpPickUp
PickupAnimationPickupAnimation
RerouteConnectionsRerouteConnections
ScaleHeightScaleHeight
ScaleWidthScaleWidth
SelectSelect
SetShapesDefaultPropertiesSetShapesDefaultProperties
UngroupUngroup
UpgradeMediaUpgradeMedia
ZOrderZOrder

EigenschaftenProperties

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

Siehe auchSee also

PowerPoint-ObjektmodellreferenzPowerPoint Object Model Reference

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.