PrimarySelectionPolicy (Clase)

Artículo
08/10/2011

Una directiva que especifica el elemento seleccionado como principal.

Jerarquía de herencia

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

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

Sintaxis

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

El tipo PrimarySelectionPolicy expone los siguientes miembros.

Constructores

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

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. (Se hereda de SelectionPolicy).

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 el elemento de directiva que representa la selección principal. (Invalida a SelectionPolicy.GetPolicyItems(Selection)).
	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. (Se hereda de SelectionPolicy).
	MemberwiseClone	Crea una copia superficial del objeto Object actual. (Se hereda de Object).
	OnActivated	Se llama cuando se activa esta directiva. (Se hereda de SelectionPolicy).
	OnDeactivated	Se llama cuando se desactiva esta directiva. (Se hereda de SelectionPolicy).
	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

La clase PrimarySelectionPolicy es un ItemPolicy que está habilitado para el elemento seleccionado como principal cuando SelectionTool es la herramienta activa.

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.