Arbeiten mit Formen
In diesem Thema wird erläutert, wie Sie mithilfe von Aspose.Words programmgesteuert mit Formen arbeiten.
Die Formen in Aspose.Words stellen ein Objekt in der Zeichenebene dar, beispielsweise eine AutoForm, ein Textfeld, eine Freiform, ein OLE-Objekt, ein ActiveX-Steuerelement oder ein Bild. Ein Word-Dokument kann eine oder mehrere verschiedene Formen enthalten. Formen in Aspose.Words werden durch die Shape-Klasse dargestellt.
Einfügen von Formen mit Document Builder
Mit der InsertShape-Methode können Sie Inline-Formen mit angegebenem Typ und Größe sowie frei schwebende Formen mit angegebener Position, Größe und Textumbruchtyp in ein Dokument einfügen. Die InsertShape-Methode ermöglicht das Einfügen einer DML-Form in das Dokumentmodell. Das Dokument muss in dem Format gespeichert werden, das DML-Formen unterstützt, andernfalls werden solche Knoten beim Speichern des Dokuments in VML-Formen konvertiert.
Das folgende Codebeispiel zeigt, wie diese Arten von Formen in das Dokument eingefügt werden:
Stellen Sie das Seitenverhältnis auf gesperrt ein
Mit Aspose.Words können Sie über die AspectRatioLocked-Eigenschaft angeben, ob das Seitenverhältnis der Form gesperrt ist.
Das folgende Codebeispiel zeigt, wie mit der AspectRatioLocked-Eigenschaft gearbeitet wird:
Legen Sie das Formlayout in der Zelle fest
Mithilfe der IsLayoutInCell-Eigenschaft können Sie außerdem festlegen, ob die Form innerhalb oder außerhalb einer Tabelle angezeigt wird.
Das folgende Codebeispiel zeigt, wie mit der IsLayoutInCell-Eigenschaft gearbeitet wird:
Erstellen Sie ein Snip Corner-Rechteck
Mit Aspose.Words können Sie ein ausgeschnittenes Eckrechteck erstellen. Die Formtypen sind SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped, TopCornersOneRoundedOneSnipped, SingleCornerRounded, TopCornersRounded und DiagonalCornersRounded.
Die DML-Form wird mithilfe der InsertShape-Methode mit diesen Formtypen erstellt. Diese Typen können nicht zum Erstellen von VML-Formen verwendet werden. Der Versuch, eine Form mithilfe des öffentlichen Konstruktors der Klasse “Shape” zu erstellen, löst die Ausnahme “NotSupportedException” aus.
Das folgende Codebeispiel zeigt, wie diese Art von Formen in das Dokument eingefügt wird:
Erhalten Sie tatsächliche Formbegrenzungspunkte
Mit Aspose.Words API können Sie die Position und Größe des die Form enthaltenden Blocks in Punkten relativ zum Anker der obersten Form ermitteln. Verwenden Sie dazu die BoundsInPoints-Eigenschaft.
Das folgende Codebeispiel zeigt, wie mit der BoundsInPoints-Eigenschaft gearbeitet wird:
Geben Sie den vertikalen Anker an
Sie können die vertikale Textausrichtung innerhalb einer Form mithilfe der VerticalAnchor-Eigenschaft angeben.
Das folgende Codebeispiel zeigt, wie mit der VerticalAnchor-Eigenschaft gearbeitet wird:
SmartArt-Form erkennen
Aspose.Words ermöglicht auch die Erkennung, ob die Form ein SmartArt-Objekt hat. Verwenden Sie dazu die HasSmartArt-Eigenschaft.
Das folgende Codebeispiel zeigt, wie mit der HasSmartArt-Eigenschaft gearbeitet wird:
Fügen Sie eine horizontale Linie in das Dokument ein
Mit der InsertHorizontalRule-Methode können Sie eine horizontale Linienform in ein Dokument einfügen.
Das folgende Codebeispiel zeigt, wie das geht:
Aspose.Words API stellt die HorizontalRuleFormat-Eigenschaft bereit, um auf die Eigenschaften der horizontalen Regelform zuzugreifen. Die HorizontalRuleFormat-Klasse stellt grundlegende Eigenschaften wie Höhe, Farbe, NoShade usw. für die Formatierung einer horizontalen Linie bereit.
Das folgende Codebeispiel zeigt, wie HorizontalRuleFormat festgelegt wird:
Importieren Sie Formen mit Mathe-XML als Formen in DOM
Sie können die ConvertShapeToOfficeMath-Eigenschaft verwenden, um die Formen mit EquationXML in Office Math-Objekte zu konvertieren. Der Standardwert dieser Eigenschaft entspricht dem Microsoft Word-Verhalten, dh Formen mit Gleichungs-XML werden nicht in Office-Matheobjekte konvertiert.
Das folgende Codebeispiel zeigt, wie Formen in Office Math-Objekte konvertiert werden: