Classe AdornerPanel

Fornece um contêiner para base de apresentação Windows controles (WPF), que são usados em time de design sistema autônomo adorners.

Namespace: Microsoft.Windows.Design.Interaction
Assembly: Microsoft.Windows.Design.Interaction (em Microsoft.Windows.Design.Interaction.dll)

Sintaxe

Public Class AdornerPanel _
    Inherits Panel

Dim instance As AdornerPanel

public class AdornerPanel : Panel

public ref class AdornerPanel : public Panel

public class AdornerPanel extends Panel

Comentários

Use o AdornerPanel classe para manter o time de design adorners. An adorno é uma parte da interface de usuário (UI) adorns outra parte da interface do usuário.

Adicionar controles que representarão adorners o Children coleção.

telefonar the SetHorizontalStretch e SetVerticalStretch métodos para dimensionar o painel de adorno relativo para o controle adorned.

Para dimensionar e posicionar adornos, crie um AdornerPlacementCollection e chamar seus métodos relacionados a tamanho e posição. Adicionar o AdornerPlacementCollection no painel de adorno usando o SetPlacements método.

Quando o painel de adorno é configurado, adicione-à Adorners coleção de um AdornerProvider implementação.

São adorners limite a ferramenta comandos através da propriedade ferramenta anexada.Quando um mouse focaliza um adorno, ligações de adorno estão disponível sistema autônomo parte de entrada e roteamento de comando.Além disso, o modelo associado ao elemento UI adorned se torna o valor de fonte de “ ” de quaisquer dados de gesto são gerados quando o adorno está ativo.

Exemplos

O exemplo de código a seguir mostra como usar um AdornerPanel para hospedar um Slider controle, que é usada em time de design para conjunto o Background propriedade do controle adorned. Para obter mais informações, consulte Demonstra Passo a passo: Criando um Adorner de tempo de design.

' Setup the adorner panel.
' All adorners are placed in an AdornerPanel
' for sizing and layout support.
Dim myPanel = Me.Panel

AdornerPanel.SetHorizontalStretch(opacitySlider, AdornerStretch.Stretch)
AdornerPanel.SetVerticalStretch(opacitySlider, AdornerStretch.None)

Dim placement As New AdornerPlacementCollection()

' The adorner's width is relative to the content.
' The slider extends the full width of the control it adorns.
placement.SizeRelativeToContentWidth(1.0, 0)

' The adorner's height is the same as the slider's.
placement.SizeRelativeToAdornerDesiredHeight(1.0, 0)

' Position the adorner above the control it adorns.
placement.PositionRelativeToAdornerHeight(-1.0, 0)

' Position the adorner up 5 pixels. This demonstrates 
' that these placement calls are additive. These two calls
' are equivalent to the following single call:
' PositionRelativeToAdornerHeight(-1.0, -5).
placement.PositionRelativeToAdornerHeight(0, -5)

AdornerPanel.SetPlacements(opacitySlider, placement)

// Setup the adorner panel.
// All adorners are placed in an AdornerPanel
// for sizing and layout support.
AdornerPanel myPanel = this.Panel;

AdornerPanel.SetHorizontalStretch(opacitySlider, AdornerStretch.Stretch);
AdornerPanel.SetVerticalStretch(opacitySlider, AdornerStretch.None);

AdornerPlacementCollection placement = new AdornerPlacementCollection();

// The adorner's width is relative to the content.
// The slider extends the full width of the control it adorns.
placement.SizeRelativeToContentWidth(1.0, 0);

// The adorner's height is the same as the slider's.
placement.SizeRelativeToAdornerDesiredHeight(1.0, 0);

// Position the adorner above the control it adorns.
placement.PositionRelativeToAdornerHeight(-1.0, 0);

// Position the adorner up 5 pixels. This demonstrates 
// that these placement calls are additive. These two calls
// are equivalent to the following single call:
// PositionRelativeToAdornerHeight(-1.0, -5).
placement.PositionRelativeToAdornerHeight(0, -5);

AdornerPanel.SetPlacements(opacitySlider, placement);

Hierarquia de herança

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Media.Visual
        System.Windows.UIElement
          System.Windows.FrameworkElement
            System.Windows.Controls.Panel
              Microsoft.Windows.Design.Interaction.AdornerPanel

Acesso thread-safe

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.