AdornerPlacementCollection-Klasse

Článek
08/23/2008

Aktualisiert: November 2007

Ermöglicht die präzise Platzierung von Adornern in einem AdornerPanel.

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

Syntax

'Declaration
Public Class AdornerPlacementCollection _
    Inherits ObservableCollection(Of IAdornerPlacement)
'Usage
Dim instance As AdornerPlacementCollection

public class AdornerPlacementCollection : ObservableCollection<IAdornerPlacement>

public ref class AdornerPlacementCollection : public ObservableCollection<IAdornerPlacement^>

public class AdornerPlacementCollection extends ObservableCollection<IAdornerPlacement>

Hinweise

Mit der AdornerPlacementCollection-Klasse können Sie die Position, die Größe und die Skalierungseigenschaften für ein AdornerPanel relativ zu dem Steuerelement angeben, das es verziert.

Rufen Sie die PositionRelativeToAdornerHeight-Methode und die PositionRelativeToAdornerWidth-Methode auf, um den AdornerPanel relativ zur Höhe und Breite seines Adornersteuerelements zu platzieren.

Rufen Sie die SizeRelativeToAdornerDesiredWidth-Methode und die SizeRelativeToContentHeight-Methode auf, um die Größe des AdornerPanel relativ zur Größe seines Adornersteuerelements anzupassen.

Rufen Sie die entsprechenden inhaltsbasierten Methoden auf, um Größe und Position des AdornerPanel relativ zum verzierten Inhalt anzupassen.

Aufrufe an die Größen- und Positionsmethoden sind kumulativ. Im folgenden Codebeispiel werden zwei Aufrufe der PositionRelativeToAdornerHeight-Methode gezeigt, durch die der AdornerPanel über dem verzierten Steuerelement platziert wird. Dabei entspricht der Offset auf der y-Achse der Höhe des Adorners plus fünf Pixel.

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

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie die Position eines Adorners in einem Adornerbereich mithilfe einer AdornerPlacementCollection angegeben werden kann. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Entwurfszeitadorners.

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

Vererbungshierarchie

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

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.