ZOrder

ShapeBase.ZOrder property

Determina l’ordine di visualizzazione delle forme sovrapposte.

public int ZOrder { get; set; }

Osservazioni

Ha effetto solo per le forme di livello superiore.

Il valore predefinito è 0.

Il numero rappresenta la precedenza di impilamento. Una forma con un numero più alto verrà visualizzata come se si sovrapponesse (davanti a) una forma con un numero più basso.

L’ordine delle forme sovrapposte è indipendente per le forme nell’intestazione e nel testo main del documento.

L’ordine di visualizzazione delle forme secondarie in una forma di gruppo è determinato dal relativo order all’interno della forma di gruppo.

Esempi

Mostra come manipolare l’ordine delle forme.

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

// Inserisci tre rettangoli di colore diverso che si sovrappongono parzialmente l'uno all'altro.
// Quando inseriamo una forma che si sovrappone a un'altra forma, Aspose.Words posiziona la forma più nuova sopra quella vecchia.
// Il rettangolo verde chiaro si sovrapporrà al rettangolo azzurro e lo oscurerà parzialmente,
// e il rettangolo azzurro oscurerà il rettangolo arancione.
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 proprietà "ZOrder" di una forma determina la sua priorità di impilamento tra le altre forme sovrapposte.
// Se due forme sovrapposte hanno valori "ZOrder" diversi,
// Microsoft Word posizionerà la forma con un valore più alto sopra la forma con il valore più basso. 
// Imposta i valori "ZOrder" delle nostre forme per posizionare il primo rettangolo arancione sopra il secondo azzurro
// e il secondo rettangolo azzurro sopra il terzo rettangolo verde chiaro.
// Ciò invertirà l'ordine di impilamento originale.
shapes[0].ZOrder = 3;
shapes[1].ZOrder = 2;
shapes[2].ZOrder = 1;

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

Guarda anche

ShapeBase.WrapType ShapeBase.AdjustWithEffects