PrimarySelectionPolicy, classe

Article
08/10/2011

Stratégie qui spécifie l'élément sélectionné à l'origine.

Hiérarchie d'héritage

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

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

Syntaxe

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

Le type PrimarySelectionPolicy expose les membres suivants.

Constructeurs

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

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. (Hérité de SelectionPolicy.)

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 l'élément de stratégie qui représente la sélection primaire. (Substitue SelectionPolicy.GetPolicyItems(Selection).)
	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. (Hérité de SelectionPolicy.)
	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. (Hérité de SelectionPolicy.)
	OnDeactivated	Appelée lorsque cette stratégie est désactivée. (Hérité de SelectionPolicy.)
	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

La classe PrimarySelectionPolicy est un ItemPolicy qui est activé pour l'élément sélectionné à l'origine lorsque SelectionTool est l'outil actif.

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.