Proprietà ItemPolicy.IsSurrogate

Articolo
08/11/2011

Ottiene un valore che indica se i criteri sono criteri sostitutivi.

Spazio dei nomi: Microsoft.Windows.Design.Policies
Assembly: Microsoft.Windows.Design.Interaction (in Microsoft.Windows.Design.Interaction.dll)

Sintassi

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

Valore proprietà

Tipo: System.Boolean
true se i criteri sono criteri sostitutivi; in caso contrario, false.

Note

I criteri sostitutivi offrono un set alternativo di elementi utilizzati per trovare provider di funzionalità. I criteri sostitutivi vengono utilizzati il più delle volte da contenitori di controlli che offrono attività e strumenti decorativi aggiuntivi negli elementi figlio. In questo scenario il contenitore offre criteri sostitutivi in cui il metodo GetSurrogateItems restituisce il padre dell'elemento specificato.

Esempi

Nell'esempio di codice seguente viene illustrato come creare criteri sostitutivi personalizzati implementando la proprietà IsSurrogate e il metodo GetSurrogateItems. Per un elenco completo di codice, vedere Procedura: creare un criterio sostitutivo.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.