Classe PrimarySelectionPolicy

Articolo
08/11/2011

Criteri che specificano l'elemento selezionato in modo primario.

Gerarchia di ereditarietà

System.Object
  Microsoft.Windows.Design.Policies.ItemPolicy
    Microsoft.Windows.Design.Policies.SelectionPolicy
      Microsoft.Windows.Design.Policies.PrimarySelectionPolicy

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

Sintassi

'Dichiarazione
Public Class PrimarySelectionPolicy _
    Inherits SelectionPolicy

public class PrimarySelectionPolicy : SelectionPolicy

public ref class PrimarySelectionPolicy : public SelectionPolicy

type PrimarySelectionPolicy =  
    class
        inherit SelectionPolicy
    end

public class PrimarySelectionPolicy extends SelectionPolicy

Il tipo PrimarySelectionPolicy espone i seguenti membri.

Costruttori

	Nome	Descrizione
	PrimarySelectionPolicy	Inizializza una nuova istanza della classe PrimarySelectionPolicy.

In alto

Proprietà

	Nome	Descrizione
	Context	Ottiene il contesto di modifica per la finestra di progettazione. (Ereditato da ItemPolicy)
	IsSurrogate	Ottiene un valore che indica se i criteri sono criteri sostitutivi. (Ereditato da ItemPolicy)
	PolicyItems	Ottiene un'enumerazione di elementi interessati da questi criteri. (Ereditato da SelectionPolicy)

In alto

Metodi

	Nome	Descrizione
	Equals	Determina se l'oggetto Object specificato è uguale all'oggetto Object corrente. (Ereditato da Object)
	Finalize	Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection. (Ereditato da Object)
	GetHashCode	Funge da funzione hash per un determinato tipo. (Ereditato da Object)
	GetPolicyItems	Restituisce i criteri che rappresentano la selezione primaria. (Esegue l'override di SelectionPolicy.GetPolicyItems(Selection)).
	GetSurrogateItems	Restituisce un set facoltativo di elementi sostitutivi per questo elemento. (Ereditato da ItemPolicy)
	GetType	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
	IsInPolicy	Ottiene un valore che indica se l'elemento specificato deve essere incluso nei criteri. (Ereditato da SelectionPolicy)
	MemberwiseClone	Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
	OnActivated	Viene chiamato quando i criteri vengono attivati. (Ereditato da SelectionPolicy)
	OnDeactivated	Viene chiamato quando i criteri vengono disattivati. (Ereditato da SelectionPolicy)
	OnPolicyItemsChanged	Genera l'evento PolicyItemsChanged. (Ereditato da ItemPolicy)
	ToString	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

In alto

Eventi

	Nome	Descrizione
	PolicyItemsChanged	Si verifica quando i criteri vengono modificati. (Ereditato da ItemPolicy)

In alto

Note

La classe PrimarySelectionPolicy è un oggetto ItemPolicy abilitato per l'elemento selezionato principalmente quando SelectionTool è lo strumento attivo.

Esempi

Nell'esempio di codice seguente viene illustrato come implementare criteri sostitutivi personalizzati per la selezione primaria. 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;
        }
    }
}