Classe SelectionPolicy

Articolo
08/11/2011

Criteri che rendono disponibili tutti gli elementi nella selezione.

Gerarchia di ereditarietà

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

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

Sintassi

'Dichiarazione
<RequiresContextItemAttribute(GetType(Selection))> _
<RequiresContextItemAttribute(GetType(Tool))> _
Public Class SelectionPolicy _
    Inherits ItemPolicy

[RequiresContextItemAttribute(typeof(Selection))]
[RequiresContextItemAttribute(typeof(Tool))]
public class SelectionPolicy : ItemPolicy

[RequiresContextItemAttribute(typeof(Selection))]
[RequiresContextItemAttribute(typeof(Tool))]
public ref class SelectionPolicy : public ItemPolicy

[<RequiresContextItemAttribute(typeof(Selection))>]
[<RequiresContextItemAttribute(typeof(Tool))>]
type SelectionPolicy =  
    class
        inherit ItemPolicy
    end

public class SelectionPolicy extends ItemPolicy

Il tipo SelectionPolicy espone i seguenti membri.

Costruttori

	Nome	Descrizione
	SelectionPolicy	Inizializza una nuova istanza della classe SelectionPolicy.

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. (Esegue l'override di ItemPolicy.PolicyItems).

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 della selezione specificata.
	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.
	MemberwiseClone	Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
	OnActivated	Viene chiamato quando i criteri vengono attivati. (Esegue l'override di ItemPolicy.OnActivated()).
	OnDeactivated	Viene chiamato quando i criteri vengono disattivati. (Esegue l'override di ItemPolicy.OnDeactivated()).
	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

Derivare da questi criteri ed eseguire l'override dei metodi IsInPolicy e GetPolicyItems per filtrare la selezione, se necessario.

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