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 des Dokuments werden durch die Shape-Klasse dargestellt.

Einfügen von Formen mit Document Builder

Mit der insert_shape-Methode können Sie Inline-Formen mit angegebenem Typ und Größe sowie frei schwebende Formen mit angegebener Position, Größe und Textumbruchart in ein Dokument einfügen. Die insert_shape-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 aspect_ratio_locked-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 is_layout_in_cell-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 SINGLE_CORNER_SNIPPED, TOP_CORNERS_SNIPPED, DIAGONAL_CORNERS_SNIPPED, TOP_CORNERS_ONE_ROUNDED_ONE_SNIPPED, SINGLE_CORNER_ROUNDED, TOP_CORNERS_ROUNDED und DIAGONAL_CORNERS_ROUNDED.

Die DML-Form wird mithilfe der insert_shape-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 Shape-Klasse 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 bounds_in_points-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 vertical_anchor-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 has_smart_art-Eigenschaft-Eigenschaft.

Das folgende Codebeispiel zeigt, wie mit der HasSmartArt-Eigenschaft gearbeitet wird:

Fügen Sie eine horizontale Linie in das Dokument ein

Mit der insert_horizontal_rule-Methode können Sie eine horizontale Linienform in ein Dokument einfügen.

Das folgende Codebeispiel zeigt, wie das geht:

Aspose.Words API stellt die horizontal_rule_format-Eigenschaft bereit, um auf die Eigenschaften der horizontalen Regelform zuzugreifen. Die HorizontalRuleFormat-Klasse stellt grundlegende Eigenschaften wie height, color, no_shade usw. für die Formatierung einer horizontalen Linie bereit.

Das folgende Codebeispiel zeigt, wie HorizontalRuleFormat festgelegt wird:

OLE-Objekt als Symbol einfügen

Aspose.Words API bietet eine Shape.insert_ole_object_as_icon-Funktion zum Einfügen eines eingebetteten oder verknüpften OLE-Objekts als Symbol in das Dokument. Mit dieser Funktion können Sie die Symboldatei und die Beschriftung angeben. Der OLE-Objekttyp wird anhand der Dateierweiterung erkannt.

Das folgende Codebeispiel zeigt, wie man ein OLE-Objekt als Symbol in das Dokument einfügt:

Für die korrekte Anzeige muss die maximale Größe des Symbols 32 x 32 betragen.

Importieren Sie Formen mit Mathe-XML als Formen in DOM

Sie können die convert_shape_to_office_math-Eigenschaft verwenden, um die Formen mit EquationXML in Office Math-Objekte zu konvertieren. Der Standardwert dieser Eigenschaft entspricht dem Verhalten von MS Word, dh Formen mit Gleichungs-XML werden nicht in Office-Matheobjekte konvertiert.

Das folgende Codebeispiel zeigt, wie Formen in Office Math-Objekte konvertiert werden: