SelectionPolicy, classe

Article
08/10/2011

Stratégie qui rend tous les éléments de la sélection disponibles.

Hiérarchie d'héritage

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

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

Syntaxe

'Déclaration
<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

Le type SelectionPolicy expose les membres suivants.

Constructeurs

	Nom	Description
	SelectionPolicy	Initialise une nouvelle instance de la classe SelectionPolicy.

Début

Propriétés

	Nom	Description
	Context	Reçoit le contexte d'édition pour le concepteur. (Hérité de ItemPolicy.)
	IsSurrogate	Obtient une valeur qui indique si la stratégie est une stratégie de substitution. (Hérité de ItemPolicy.)
	PolicyItems	Obtient une énumération des éléments affectés par cette stratégie. (Substitue ItemPolicy.PolicyItems.)

Début

Méthodes

	Nom	Description
	Equals	Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
	Finalize	Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetPolicyItems	Retourne les éléments de stratégie de la sélection spécifiée.
	GetSurrogateItems	Retourne un ensemble facultatif d'éléments de substitution pour cet élément. (Hérité de ItemPolicy.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	IsInPolicy	Obtient une valeur qui indique si l'élément spécifié sera inclus dans la stratégie.
	MemberwiseClone	Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
	OnActivated	Appelée lorsque cette stratégie est activée. (Substitue ItemPolicy.OnActivated().)
	OnDeactivated	Appelée lorsque cette stratégie est désactivée. (Substitue ItemPolicy.OnDeactivated().)
	OnPolicyItemsChanged	Déclenche l'événement PolicyItemsChanged. (Hérité de ItemPolicy.)
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Événements

	Nom	Description
	PolicyItemsChanged	Se produit lors de modifications de stratégie. (Hérité de ItemPolicy.)

Début

Notes

Dérivez de cette stratégie et substituez les méthodes IsInPolicy et GetPolicyItems pour filtrer la sélection selon les besoins.

Exemples

L'exemple de code suivant indique comment implémenter une stratégie de remplacement personnalisée pour la sélection primaire. Pour obtenir l'intégralité du code, consultez Comment : créer une stratégie de substitution.

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

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.