ShapeElement.ZOrder, propriété

Article
05/15/2013

Détermine la commande dans laquelle cette forme sera affichée par rapport à d'autres formes sur le diagramme.Normalement défini de la commande de formes enfantes.

Espace de noms : Microsoft.VisualStudio.Modeling.Diagrams
Assembly : Microsoft.VisualStudio.Modeling.Sdk.Diagrams.11.0 (dans Microsoft.VisualStudio.Modeling.Sdk.Diagrams.11.0.dll)

Syntaxe

'Déclaration
Public Overridable Property ZOrder As Double

public virtual double ZOrder { get; set; }

Valeur de propriété

Type : System.Double

Notes

Il vous est recommandé pour ne pas définir la valeur directement, car le diagramme définit le ZOrder de toutes ses formes dans le cadre de le processus de peinture.À la place, pour modifier la commande dans laquelle des formes sont affichées, trient à nouveau les formes dans NestedChildShapes ou RelativeChildShapes, et appelez ensuite shape.Diagram.NeedsRenumber = true.Cela permet de s'assurer que le diagramme réinitialise le ZOrders.Voir l'exemple suivant.

Exemples

    /// <summary>
    /// Command to send current shapes to the back.
    /// </summary>
    private void OnMenuSendShapesToBackCommand(object sender, EventArgs e)
    {
      MenuCommand command = sender as MenuCommand;
      Store store = this.CurrentDocData.Store;
      foreach (object selectedItem in this.CurrentSelection)
      {
        ShapeElement shape = selectedItem as ShapeElement;
        if (shape == null || shape.ParentShape == null) continue;
        if (shape.IsNestedChild)
        {
          using (Transaction t = store.TransactionManager.BeginTransaction("sendToBack"))
          {
            // Make the current shape the first in the list.
            shape.ParentShape.NestedChildShapes.Move(shape, 0);
            // Update the ZOrder of the shapes to reflect the change.
            shape.Diagram.NeedsRenumber = true;
            // Make sure the shape is redrawn:
            shape.Invalidate();
            t.Commit();
          }
        }

Pour vérifier que votre forme apparaît toujours en haut du diagramme, vous pouvez substituer cette propriété comme suit.

/// <summary>
/// Gets the relative Z-Order for this ShapeElement.
/// Make sure that my shape stays above all other diagram elements.
///  Add a million to the Z-Order that we are given.
/// </summary>
public override double ZOrder
{
  get
  {
    return base.ZOrder + 1e6;
  }
  // leave set{ } as inherited
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

ShapeElement Classe

Microsoft.VisualStudio.Modeling.Diagrams, espace de noms

Partager via