AdornerPlacementCollection, classe

Mise à jour : novembre 2007

Permet de positionner précisément des ornements dans un AdornerPanel.

Espace de noms : Microsoft.Windows.Design.Interaction
Assembly : Microsoft.Windows.Design.Interaction (dans Microsoft.Windows.Design.Interaction.dll)

Syntaxe

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>

Notes

Utilisez la classe AdornerPlacementCollection pour spécifier l'emplacement, la taille et les propriétés de mise à l'échelle d'un AdornerPanel relatif au contrôle qu'il orne.

Appelez les méthodes PositionRelativeToAdornerHeight et PositionRelativeToAdornerWidth pour placer le AdornerPanel en fonction de la hauteur et de la largeur de son contrôle d'ornement.

Appelez les méthodes SizeRelativeToAdornerDesiredWidth et SizeRelativeToContentHeight pour dimensionner le AdornerPanel en fonction de la taille de son contrôle d'ornement.

Appelez les méthodes basées sur contenu correspondantes pour dimensionner et positionner le AdornerPanel en fonction du contenu orné.

Les appels vers les méthodes de dimensionnement et de positionnement sont cumulatifs. L'exemple de code suivant présente deux appels à la méthode PositionRelativeToAdornerHeight, qui ont pour effet de placer le AdornerPanel au-dessus du contrôle orné avec un offset d'axe Y égal à la hauteur de l'ornement plus cinq 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);

Exemples

L'exemple de code suivant indique comment utiliser un AdornerPlacementCollection pour spécifier la position d'un ornement dans un panneau d'ornement. Pour plus d'informations, consultez Procédure pas à pas : création d'un ornement au moment du 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);

Hiérarchie d'héritage

System.Object
  System.Collections.ObjectModel.Collection<IAdornerPlacement>
    System.Collections.ObjectModel.ObservableCollection<IAdornerPlacement>
      Microsoft.Windows.Design.Interaction.AdornerPlacementCollection

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.