Método ItemPolicy.GetSurrogateItems

Artigo
08/01/2011

Retorna um conjunto opcional de itens de substitutos para este item.

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

Sintaxe

'Declaração
Public Overridable Function GetSurrogateItems ( _
    item As ModelItem _
) As IEnumerable(Of ModelItem)

public virtual IEnumerable<ModelItem> GetSurrogateItems(
    ModelItem item
)

public:
virtual IEnumerable<ModelItem^>^ GetSurrogateItems(
    ModelItem^ item
)

abstract GetSurrogateItems : 
        item:ModelItem -> IEnumerable<ModelItem> 
override GetSurrogateItems : 
        item:ModelItem -> IEnumerable<ModelItem>

public function GetSurrogateItems(
    item : ModelItem
) : IEnumerable<ModelItem>

Parâmetros

item
Tipo: Microsoft.Windows.Design.Model.ModelItem
Recuperar o substituto para o item.

Valor de retorno

Tipo: System.Collections.Generic.IEnumerable<ModelItem>
Uma enumeração de itens de substitutos para verificar.O padrão retorna uma enumeração vazia.

Comentários

Os itens de substitutos fornecem recursos adicionais para o item especificado. Itens de substitutos não são parte dos itens que são expostas aos consumidores da diretiva. Retorne os itens de substitutos, se você precisar de um objeto pai para oferecer recursos para uma criança. Para retornar um conjunto de itens de substitutos, substituir o IsSurrogate propriedade, de modo que ele retorna true.

Observação
Não retornam nulluma referência nula (Nothing no Visual Basic) de seu GetSurrogateItems de implementação.

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.