ItemPolicy.IsSurrogate-Eigenschaft

Artikel
08/10/2011

Ruft einen Wert ab, der angibt, ob die Richtlinie eine Ersatzrichtlinie ist.

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

Syntax

'Declaration
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

Eigenschaftswert

Typ: System.Boolean
true, wenn die Richtlinie eine Ersatzrichtlinie ist, andernfalls false.

Hinweise

Ersatzrichtlinien bieten einen alternativen Satz von Elementen, die verwendet werden, um Featureanbieter zu suchen. Ersatzrichtlinien werden hauptsächlich von Steuerelementcontainern verwendet, die zusätzliche Aufgaben und Adorner für ihre untergeordneten Elemente bieten. In diesem Szenario bietet der Container eine Ersatzrichtlinie, in der die GetSurrogateItems-Methode das übergeordnete Element des angegebenen Elements zurückgibt.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie eine benutzerdefinierte Ersatzrichtlinie erstellen, indem Sie die IsSurrogate-Eigenschaft und die GetSurrogateItems-Methode 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;
        }
    }
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.