SelectionPolicy-Klasse

Artikel
08/10/2011

Eine Richtlinie, die alle Elemente in der Auswahl verfügbar macht.

Vererbungshierarchie

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

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

Syntax

'Declaration
<RequiresContextItemAttribute(GetType(Selection))> _
<RequiresContextItemAttribute(GetType(Tool))> _
Public Class SelectionPolicy _
    Inherits ItemPolicy

[RequiresContextItemAttribute(typeof(Selection))]
[RequiresContextItemAttribute(typeof(Tool))]
public class SelectionPolicy : ItemPolicy

[RequiresContextItemAttribute(typeof(Selection))]
[RequiresContextItemAttribute(typeof(Tool))]
public ref class SelectionPolicy : public ItemPolicy

[<RequiresContextItemAttribute(typeof(Selection))>]
[<RequiresContextItemAttribute(typeof(Tool))>]
type SelectionPolicy =  
    class
        inherit ItemPolicy
    end

public class SelectionPolicy extends ItemPolicy

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

Konstruktoren

	Name	Beschreibung
	SelectionPolicy	Initialisiert eine neue Instanz der SelectionPolicy-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. (Überschreibt ItemPolicy.PolicyItems.)

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 die Richtlinienelemente aus der angegebenen Auswahl zurück.
	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.
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	OnActivated	Wird aufgerufen, wenn diese Richtlinie aktiviert wird. (Überschreibt ItemPolicy.OnActivated().)
	OnDeactivated	Wird aufgerufen, wenn diese Richtlinie deaktiviert wird. (Überschreibt ItemPolicy.OnDeactivated().)
	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

Leiten Sie von dieser Richtlinie ab, und überschreiben Sie die Methoden IsInPolicy und GetPolicyItems, um die Auswahl wie gewünscht zu filtern.

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.