SelectionPolicy (Clase)

Artículo
08/10/2011

Una directiva que hace que todos los elementos de la selección estén disponibles.

Jerarquía de herencia

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

Espacio de nombres: Microsoft.Windows.Design.Policies
Ensamblado: Microsoft.Windows.Design.Interaction (en Microsoft.Windows.Design.Interaction.dll)

Sintaxis

'Declaración
<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

El tipo SelectionPolicy expone los siguientes miembros.

Constructores

	Nombre	Descripción
	SelectionPolicy	Inicializa una nueva instancia de la clase SelectionPolicy.

Arriba

Propiedades

	Nombre	Descripción
	Context	Obtiene el contexto de edición para el diseñador. (Se hereda de ItemPolicy).
	IsSurrogate	Obtiene un valor que indica si la directiva es una directiva suplente. (Se hereda de ItemPolicy).
	PolicyItems	Obtiene una enumeración de los elementos que se verán afectados por esta directiva. (Invalida a ItemPolicy.PolicyItems).

Arriba

Métodos

	Nombre	Descripción
	Equals	Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
	Finalize	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
	GetHashCode	Actúa como función hash para un tipo concreto. (Se hereda de Object).
	GetPolicyItems	Devuelve los elementos de directiva de la selección especificada.
	GetSurrogateItems	Devuelve un conjunto opcional de elementos suplente para este elemento. (Se hereda de ItemPolicy).
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	IsInPolicy	Obtiene un valor que indica si el elemento especificado va a estar incluido en la directiva.
	MemberwiseClone	Crea una copia superficial del objeto Object actual. (Se hereda de Object).
	OnActivated	Se llama cuando se activa esta directiva. (Invalida a ItemPolicy.OnActivated()).
	OnDeactivated	Se llama cuando se desactiva esta directiva. (Invalida a ItemPolicy.OnDeactivated()).
	OnPolicyItemsChanged	Provoca el evento PolicyItemsChanged (Se hereda de ItemPolicy).
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).

Arriba

Eventos

	Nombre	Descripción
	PolicyItemsChanged	Se produce cuando la directiva cambia. (Se hereda de ItemPolicy).

Arriba

Comentarios

Derive de esta directiva e invalide los métodos IsInPolicy y GetPolicyItems para filtrar la selección según sea necesario.

Ejemplos

En el ejemplo de código siguiente se muestra cómo implementar una directiva suplente personalizada para la selección principal. Para obtener una lista de código completa, vea Cómo: Crear una directiva suplente.

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

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.