Shapes.BuildFreeform-Methode (Publisher)

Artikel
04/07/2023

Erstellt ein Freihandform-Objekt. Gibt ein FreeformBuilder -Objekt zurück, das die Freihandform so darstellt, wie sie erstellt wird.

Syntax

Ausdruck. BuildFreeform (EditingType, X1, Y1)

expression Eine Variable, die ein Shapes-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
EditingType	Erforderlich	MsoEditingType	Gibt die Bearbeitungsart des ersten Knotens an. Dies kann eine der msoEditingType-Konstanten sein, die in der Microsoft Office-Typbibliothek deklariert sind.
X1	Erforderlich	Variant	Die horizontale Position des ersten Knotens in der Freihandform-Zeichnung relativ zu der linken oberen Ecke der Seite.
Y1	Erforderlich	Variant	Die vertikale Position des ersten Knotens in der Freihandform-Zeichnung relativ zu der linken oberen Ecke der Seite.

Rückgabewert

FreeformBuilder

Beispiel

Für die Argumente X1 und Y1 werden numerische Werte in Punkten ausgewertet. Zeichenfolgen können in beliebigen Einheiten enthalten sein, die von Microsoft Publisher unterstützt werden (z. B. "2,5 zoll").

Verwenden Sie die AddNodes -Methode, um das Freihandobjekt Segmente hinzuzufügen. Nachdem Sie der Freihandform mindestens ein Segment hinzugefügt haben, können Sie die ConvertToShape-Methode verwenden, um das FreeformBuilder-Objekt in ein Shape-Objekt mit der geometrischen Beschreibung zu konvertieren, die Sie im FreeformBuilder-Objekt definiert haben .

' Add a new freeform object. 
With ActiveDocument.Shapes _ 
 .BuildFreeform(EditingType:=msoEditingCorner, _ 
 X1:=100, Y1:=100) 
 
 ' Add three more nodes and close the polygon. 
 .AddNodes SegmentType:=msoSegmentCurve, _ 
 EditingType:=msoEditingCorner, _ 
 X1:=200, Y1:=200, X2:=225, Y2:=250, X3:=250, Y3:=200 
 .AddNodes SegmentType:=msoSegmentCurve, _ 
 EditingType:=msoEditingAuto, X1:=200, Y1:=100 
 .AddNodes SegmentType:=msoSegmentLine, _ 
 EditingType:=msoEditingAuto, X1:=150, Y1:=50 
 .AddNodes SegmentType:=msoSegmentLine, _ 
 EditingType:=msoEditingAuto, X1:=100, Y1:=100 
 
 ' Convert the polygon to a Shape object. 
 .ConvertToShape 
End With

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.

Freigeben über