Classe AdornerPlacementCollection

Artigo
08/25/2010

Permite o posicionamento preciso de adornos dentro de um AdornerPanel.

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

Sintaxe

Public Class AdornerPlacementCollection _
    Inherits ObservableCollection(Of IAdornerPlacement)

Dim instance As AdornerPlacementCollection

public class AdornerPlacementCollection : ObservableCollection<IAdornerPlacement>

public ref class AdornerPlacementCollection : public ObservableCollection<IAdornerPlacement^>

public class AdornerPlacementCollection extends ObservableCollection<IAdornerPlacement>

Comentários

Use o AdornerPlacementCollection classe para especificar o local, dimensionar e propriedades de dimensionamento de um AdornerPanel em relação ao controle adorns.

telefonar the PositionRelativeToAdornerHeight e PositionRelativeToAdornerWidth métodos para colocar o AdornerPanel relativas a seu controle de adorno altura e largura.

telefonar the SizeRelativeToAdornerDesiredWidth e SizeRelativeToContentHeight métodos para dimensionar de AdornerPanel em relação ao dimensionar do seu controle de adorno.

Chamar os métodos baseados em conteúdo correspondentes ao dimensionar e posicionar o AdornerPanel em relação ao conteúdo adorned.

Chamadas para os métodos de dimensionar e posição são cumulativas.O exemplo de código a seguir mostra duas chamadas para o PositionRelativeToAdornerHeight método, que tem o efeito de colocar o AdornerPanel acima do controle com um eixo y adorned deslocamento igual à altura de adorno além de cinco pixels.

' 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)

// 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);

Exemplos

O exemplo de código a seguir mostra como usar um AdornerPlacementCollection Para especificar a posição de um adorno em um painel de adorno. Para obter mais informações, consulte Demonstra Passo a passo: Criando um Adorner de tempo de design.

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)

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.Collections.ObjectModel.Collection<IAdornerPlacement>
    System.Collections.ObjectModel.ObservableCollection<IAdornerPlacement>
      Microsoft.Windows.Design.Interaction.AdornerPlacementCollection

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.