PrimarySelectionPolicy-Klasse

Artikel
08/10/2011

Eine Richtlinie, die das primär ausgewählte Element angibt.

Vererbungshierarchie

System.Object
  Microsoft.Windows.Design.Policies.ItemPolicy
    Microsoft.Windows.Design.Policies.SelectionPolicy
      Microsoft.Windows.Design.Policies.PrimarySelectionPolicy

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

Syntax

'Declaration
Public Class PrimarySelectionPolicy _
    Inherits SelectionPolicy

public class PrimarySelectionPolicy : SelectionPolicy

public ref class PrimarySelectionPolicy : public SelectionPolicy

type PrimarySelectionPolicy =  
    class
        inherit SelectionPolicy
    end

public class PrimarySelectionPolicy extends SelectionPolicy

Der PrimarySelectionPolicy-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	PrimarySelectionPolicy	Initialisiert eine neue Instanz der PrimarySelectionPolicy-Klasse.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	Context	Ruft den Bearbeitungskontext für den Designer ab. (Von ItemPolicy geerbt.)
	IsSurrogate	Ruft einen Wert ab, der angibt, ob die Richtlinie eine Ersatzrichtlinie ist. (Von ItemPolicy geerbt.)
	PolicyItems	Ruft eine Enumeration von Elementen ab, die von dieser Richtlinie beeinflusst werden. (Von SelectionPolicy geerbt.)

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Equals	Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetPolicyItems	Gibt das Richtlinienelement zurück, das die primäre Auswahl darstellt. (Überschreibt SelectionPolicy.GetPolicyItems(Selection).)
	GetSurrogateItems	Gibt einen optionalen Satz von Ersatzelementen für dieses Element zurück. (Von ItemPolicy geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	IsInPolicy	Ruft einen Wert ab, der angibt, ob das entsprechende Element in der Richtlinie enthalten sein soll. (Von SelectionPolicy geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	OnActivated	Wird aufgerufen, wenn diese Richtlinie aktiviert wird. (Von SelectionPolicy geerbt.)
	OnDeactivated	Wird aufgerufen, wenn diese Richtlinie deaktiviert wird. (Von SelectionPolicy geerbt.)
	OnPolicyItemsChanged	Löst das PolicyItemsChanged-Ereignis aus. (Von ItemPolicy geerbt.)
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	PolicyItemsChanged	Wird ausgelöst, wenn sich die Richtlinie ändert. (Von ItemPolicy geerbt.)

Zum Seitenanfang

Hinweise

Die PrimarySelectionPolicy-Klasse ist eine ItemPolicy, die für das primär ausgewählt Element aktiviert ist, wenn SelectionTool das aktive Tool ist.

Beispiele

Im folgenden Codebeispiel wird dargestellt, wie Sie eine benutzerdefinierte Ersatzrichtlinie für die primäre Auswahl implementieren. Eine vollständige Codeauflistung finden Sie unter Gewusst wie: Erstellen einer Ersatzrichtlinie.

' The DockPanelPolicy class implements a surrogate policy that
' provides container semantics for a selected item. By using 
' this policy, the DemoDockPanel container control offers 
' additional tasks and adorners on its children. 
Class DockPanelPolicy
    Inherits PrimarySelectionPolicy

    Public Overrides ReadOnly Property IsSurrogate() As Boolean 
        Get
            Return True
        End Get
    End Property

    Public Overrides Function GetSurrogateItems( _
        ByVal item As Microsoft.Windows.Design.Model.ModelItem) _
        As System.Collections.Generic.IEnumerable( _
        Of Microsoft.Windows.Design.Model.ModelItem)

        Dim parent As ModelItem = item.Parent

        Dim e As New System.Collections.Generic.List(Of ModelItem)

        If (parent IsNot Nothing) Then

            e.Add(parent)

        End If

        Return e

    End Function

End Class

// The DockPanelPolicy class implements a surrogate policy that
// provides container semantics for a selected item. By using 
// this policy, the DemoDockPanel container control offers 
// additional tasks and adorners on its children. 
class DockPanelPolicy : PrimarySelectionPolicy 
{
    public override bool IsSurrogate 
    {
        get 
        { 
            return true;
        }
    }

    public override IEnumerable<ModelItem> GetSurrogateItems(ModelItem item) 
    {
        ModelItem parent = item.Parent;

        if (parent != null)
        {
            yield return parent;
        }
    }
}

Threadsicherheit

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