InsertShape

InsertShape(ShapeType, double, double)

Fügt eine Inline-Form mit angegebenem Typ und angegebener Größe ein.

public Shape InsertShape(ShapeType shapeType, double width, double height)
ParameterTypBeschreibung
shapeTypeShapeTypeDer in das Dokument einzufügende Formtyp.
widthDoubleDie Breite der Form in Punkten.
heightDoubleDie Höhe der Form in Punkten.

Rückgabewert

Der eingefügte Formknoten.

Beispiele

Zeigt, wie DML-Formen in ein Dokument eingefügt werden.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Unten sind zwei Umbrucharten aufgeführt, die Formen haben können.
// 1 - Schwebend:
builder.InsertShape(ShapeType.TopCornersRounded, RelativeHorizontalPosition.Page, 100,
        RelativeVerticalPosition.Page, 100, 50, 50, WrapType.None);

// 2 - Inline:
builder.InsertShape(ShapeType.DiagonalCornersRounded, 50, 50);

// Wenn Sie „nicht-primitive“ Formen erstellen müssen, wie z. B. SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped,
// TopCornersOneRoundedOneSnipped, SingleCornerRounded, TopCornersRounded oder DiagonalCornersRounded,
// Speichern Sie das Dokument dann mit der Konformität „Strict“ oder „Transitional“, wodurch die Form als DML gespeichert werden kann.
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions(SaveFormat.Docx);
saveOptions.Compliance = OoxmlCompliance.Iso29500_2008_Transitional;

doc.Save(ArtifactsDir + "Shape.ShapeInsertion.docx", saveOptions);

Siehe auch


InsertShape(ShapeTypeRelativeHorizontalPosition, double, RelativeVerticalPosition, double, double, double, WrapType)

Fügt eine frei schwebende Form mit angegebener Position, Größe und Textumbruchart ein.

public Shape InsertShape(ShapeType shapeType, RelativeHorizontalPosition horzPos, double left, 
    RelativeVerticalPosition vertPos, double top, double width, double height, WrapType wrapType)
ParameterTypBeschreibung
shapeTypeShapeTypeDer in das Dokument einzufügende Formtyp
horzPosRelativeHorizontalPositionGibt an, von wo aus der horizontale Abstand zur Form gemessen wird.
leftDoubleAbstand in Punkten vom Ursprung zur linken Seite der Form.
vertPosRelativeVerticalPositionGibt an, von wo aus der vertikale Abstand zur Form gemessen wird.
topDoubleAbstand in Punkten vom Ursprung zur Oberseite der Form.
widthDoubleDie Breite der Form in Punkten.
heightDoubleDie Höhe der Form in Punkten.
wrapTypeWrapTypeGibt an, wie der Text um die Form herumfließen soll.

Rückgabewert

Der eingefügte Formknoten.

Beispiele

Zeigt, wie DML-Formen in ein Dokument eingefügt werden.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Unten sind zwei Umbrucharten aufgeführt, die Formen haben können.
// 1 - Schwebend:
builder.InsertShape(ShapeType.TopCornersRounded, RelativeHorizontalPosition.Page, 100,
        RelativeVerticalPosition.Page, 100, 50, 50, WrapType.None);

// 2 - Inline:
builder.InsertShape(ShapeType.DiagonalCornersRounded, 50, 50);

// Wenn Sie „nicht-primitive“ Formen erstellen müssen, wie z. B. SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped,
// TopCornersOneRoundedOneSnipped, SingleCornerRounded, TopCornersRounded oder DiagonalCornersRounded,
// Speichern Sie das Dokument dann mit der Konformität „Strict“ oder „Transitional“, wodurch die Form als DML gespeichert werden kann.
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions(SaveFormat.Docx);
saveOptions.Compliance = OoxmlCompliance.Iso29500_2008_Transitional;

doc.Save(ArtifactsDir + "Shape.ShapeInsertion.docx", saveOptions);

Siehe auch