Propriedade ItemPolicy.IsSurrogate

Artigo
08/01/2011

Obtém um valor indicando se a diretiva é um substituto.

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

Sintaxe

'Declaração
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 propriedade

Tipo: System.Boolean
true Se a diretiva é um substituto; Caso contrário, false.

Comentários

Políticas de substitutos oferecem um conjunto alternativo de itens que são usados para localizar provedores de recurso. Políticas de substitutos são mais frequentemente usadas por recipientes de controle que oferecem tarefas adicionais e adorners em seus filhos. Nesse cenário, o recipiente oferece uma política de substitutos na qual o GetSurrogateItems método retorna o pai do item fornecido.

Exemplos

O exemplo de código a seguir mostra como criar uma diretiva personalizada de substitutos, Implementando o IsSurrogate propriedade e o GetSurrogateItems método. Para obter uma listagem de código completo, consulte Como: criar uma diretiva substituto.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.