InsertShape

InsertShape(ShapeType, double, double)

Inserta una forma en línea con el tipo y tamaño especificados.

public Shape InsertShape(ShapeType shapeType, double width, double height)
ParámetroEscribeDescripción
shapeTypeShapeTypeEl tipo de forma que se insertará en el documento.
widthDoubleEl ancho de la forma en puntos.
heightDoubleLa altura de la forma en puntos.

Valor_devuelto

El nodo de forma que se insertó.

Ejemplos

Muestra cómo insertar formas DML en un documento.

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

// A continuación se muestran dos tipos de envoltura que pueden tener las formas.
// 1 - Flotante:
builder.InsertShape(ShapeType.TopCornersRounded, RelativeHorizontalPosition.Page, 100, 
        RelativeVerticalPosition.Page, 100, 50, 50, WrapType.None);

// 2 - En línea:
builder.InsertShape(ShapeType.DiagonalCornersRounded, 50, 50);

// Si necesita crear formas "no primitivas", como SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped,
// TopCornersOneRoundedOneSnipped, SingleCornerRounded, TopCornersRounded o DiagonalCornersRounded,
// luego guarda el documento con cumplimiento "Estricto" o "Transicional", lo que permite guardar la forma como DML.
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions(SaveFormat.Docx);
saveOptions.Compliance = OoxmlCompliance.Iso29500_2008_Transitional;

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

Ver también


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

Inserta una forma flotante con una posición, tamaño y tipo de ajuste de texto especificados.

public Shape InsertShape(ShapeType shapeType, RelativeHorizontalPosition horzPos, double left, 
    RelativeVerticalPosition vertPos, double top, double width, double height, WrapType wrapType)
ParámetroEscribeDescripción
shapeTypeShapeTypeEl tipo de forma para insertar en el documento.
horzPosRelativeHorizontalPositionEspecifica desde dónde se mide la distancia horizontal a la forma.
leftDoubleDistancia en puntos desde el origen hasta el lado izquierdo de la forma.
vertPosRelativeVerticalPositionEspecifica desde dónde se mide la distancia vertical a la forma.
topDoubleDistancia en puntos desde el origen hasta la parte superior de la forma.
widthDoubleEl ancho de la forma en puntos.
heightDoubleEl ancho de la forma en puntos.
wrapTypeWrapTypeEspecifica cómo ajustar el texto alrededor de la forma.

Valor_devuelto

El nodo de forma que se insertó.

Ejemplos

Muestra cómo insertar formas DML en un documento.

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

// A continuación se muestran dos tipos de envoltura que pueden tener las formas.
// 1 - Flotante:
builder.InsertShape(ShapeType.TopCornersRounded, RelativeHorizontalPosition.Page, 100, 
        RelativeVerticalPosition.Page, 100, 50, 50, WrapType.None);

// 2 - En línea:
builder.InsertShape(ShapeType.DiagonalCornersRounded, 50, 50);

// Si necesita crear formas "no primitivas", como SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped,
// TopCornersOneRoundedOneSnipped, SingleCornerRounded, TopCornersRounded o DiagonalCornersRounded,
// luego guarda el documento con cumplimiento "Estricto" o "Transicional", lo que permite guardar la forma como DML.
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions(SaveFormat.Docx);
saveOptions.Compliance = OoxmlCompliance.Iso29500_2008_Transitional;

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

Ver también