ItemPolicy.IsSurrogate, propriété

Article
08/10/2011

Obtient une valeur qui indique si la stratégie est une stratégie de substitution.

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

Syntaxe

'Déclaration
Public Overridable ReadOnly Property IsSurrogate As Boolean
    Get

public virtual bool IsSurrogate { get; }

public:
virtual property bool IsSurrogate {
    bool get ();
}

abstract IsSurrogate : bool
override IsSurrogate : bool

function get IsSurrogate () : boolean

Valeur de propriété

Type : System.Boolean
true si la stratégie est une stratégie de substitution ; sinon, false.

Notes

Les stratégies de substitution offrent un ensemble alternatif d'éléments, utilisés pour localiser des fournisseurs de fonctionnalités. Les stratégies de substitution sont le plus souvent utilisées par les conteneurs de contrôle qui offrent des tâches et des ornements supplémentaires à leurs enfants. Dans ce scénario, le conteneur offre une stratégie de remplacement dans laquelle la méthode GetSurrogateItems retourne le parent de l'élément fourni.

Exemples

L'exemple de code suivant indique comment créer une stratégie de remplacement personnalisée en implémentant la propriété IsSurrogate et la méthode GetSurrogateItems. 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é .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.