ZOrder

ShapeBase.ZOrder property

Determina el orden de visualización de las formas superpuestas.

public int ZOrder { get; set; }

Observaciones

Tiene efecto sólo para formas de nivel superior.

El valor predeterminado es 0.

El número representa la precedencia de apilamiento. Una forma con un número mayor se mostrará como si estuviera superpuesta (en “frente”) a una forma con un número menor.

El orden de las formas superpuestas es independiente para las formas en el encabezado y en el texto main del documento.

El orden de visualización de las formas secundarias en una forma de grupo está determinado por su orden dentro de la forma de grupo.

Ejemplos

Muestra cómo manipular el orden de las formas.

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

// Inserta tres rectángulos de diferentes colores que se superpongan parcialmente entre sí.
// Cuando insertamos una forma que se superpone a otra forma, Aspose.Words coloca la forma más nueva encima de la anterior.
// El rectángulo verde claro se superpondrá al rectángulo azul claro y lo oscurecerá parcialmente.
// y el rectángulo azul claro oscurecerá el rectángulo naranja.
Shape shape = builder.InsertShape(ShapeType.Rectangle, RelativeHorizontalPosition.LeftMargin, 100,
    RelativeVerticalPosition.TopMargin, 100, 200, 200, WrapType.None);
shape.FillColor = Color.Orange;

shape = builder.InsertShape(ShapeType.Rectangle, RelativeHorizontalPosition.LeftMargin, 150,
    RelativeVerticalPosition.TopMargin, 150, 200, 200, WrapType.None);
shape.FillColor = Color.LightBlue;

shape = builder.InsertShape(ShapeType.Rectangle, RelativeHorizontalPosition.LeftMargin, 200,
    RelativeVerticalPosition.TopMargin, 200, 200, 200, WrapType.None);
shape.FillColor = Color.LightGreen;

Shape[] shapes = doc.GetChildNodes(NodeType.Shape, true).OfType<Shape>().ToArray();

// La propiedad "ZOrder" de una forma determina su prioridad de apilamiento entre otras formas superpuestas.
// Si dos formas superpuestas tienen diferentes valores de "ZOrder",
// Microsoft Word colocará la forma con un valor más alto sobre la forma con el valor más bajo. 
// Establece los valores de "ZOrder" de nuestras formas para colocar el primer rectángulo naranja sobre el segundo azul claro
// y el segundo rectángulo azul claro sobre el tercer rectángulo verde claro.
// Esto invertirá su orden de apilamiento original.
shapes[0].ZOrder = 3;
shapes[1].ZOrder = 2;
shapes[2].ZOrder = 1;

doc.Save(ArtifactsDir + "Shape.ZOrder.docx");

Ver también

ShapeBase.WrapType ShapeBase.AdjustWithEffects