Propriedade ShapeElement.ZOrder
Determina a ordem na qual esta forma será exibida em relação a outras formas no diagrama.Defina normalmente da ordem das formas filhas.
Namespace: Microsoft.VisualStudio.Modeling.Diagrams
Assembly: Microsoft.VisualStudio.Modeling.Sdk.Diagrams.11.0 (em Microsoft.VisualStudio.Modeling.Sdk.Diagrams.11.0.dll)
Sintaxe
'Declaração
Public Overridable Property ZOrder As Double
public virtual double ZOrder { get; set; }
Valor de propriedade
Tipo: System.Double
Comentários
São recomendados para não definir o valor diretamente, pois o diagrama que define o ZOrder de todas as suas formas como parte do processo de pintura.Em vez disso, para alterar a ordem na qual as formas são exibidas, reordenar as formas de NestedChildShapesou RelativeChildShapese, em seguida, chame shape.Diagram.NeedsRenumber = true.Isso garante que o diagrama redefine o ZOrders.Consulte o exemplo a seguir.
Exemplos
/// <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();
}
}
Para certificar-se de que sua forma sempre aparece na parte superior do diagrama, você pode substituir essa propriedade como a seguir.
/// <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
}
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.