ItemPolicy.IsSurrogate (Propiedad)

Artículo
08/10/2011

Obtiene un valor que indica si la directiva es una directiva suplente.

Espacio de nombres: Microsoft.Windows.Design.Policies
Ensamblado: Microsoft.Windows.Design.Interaction (en Microsoft.Windows.Design.Interaction.dll)

Sintaxis

'Declaración
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

Valor de propiedad

Tipo: System.Boolean
true si la directiva es una directiva suplente; de lo contrario, false.

Comentarios

Las directivas suplente proporcionan un conjunto alternativo de elementos que se utilizan para buscar proveedores de características. Las directivas suplente las usan normalmente los contenedores de control que proporcionan tareas y adornos adicionales en sus elementos secundarios. En este escenario, el contenedor proporciona una directiva suplente en la que el método GetSurrogateItems devuelve el elemento primario del elemento proporcionado.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una directiva suplente personalizada mediante la implementación de la propiedad IsSurrogate y del método GetSurrogateItems. Para obtener una lista de código completa, vea Cómo: Crear una directiva suplente.

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

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.