Classe PrimarySelectionPolicy

Artigo
08/01/2011

Uma diretiva que especifica o elemento principalmente selecionado.

Hierarquia de herança

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

Namespace: Microsoft.Windows.Design.Policies
Assembly: Microsoft.Windows.Design.Interaction (em Microsoft.Windows.Design.Interaction.dll)

Sintaxe

'Declaração
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

O tipo PrimarySelectionPolicy expõe os membros a seguir.

Construtores

	Nome	Descrição
	PrimarySelectionPolicy	Initializes a new instance of the PrimarySelectionPolicy class.

Início

Propriedades

	Nome	Descrição
	Context	Obtém o contexto de edição para o designer. (Herdado de ItemPolicy.)
	IsSurrogate	Obtém um valor indicando se a diretiva é um substituto. (Herdado de ItemPolicy.)
	PolicyItems	Obtém uma enumeração de itens que são afetados por essa política. (Herdado de SelectionPolicy.)

Início

Métodos

	Nome	Descrição
	Equals	Determina se o especificado Object é igual a atual Object. (Herdado de Object.)
	Finalize	Permite que um objeto tentar liberar recursos e executar outras operações de limpeza antes que ele é recuperado pela coleta de lixo. (Herdado de Object.)
	GetHashCode	Serves as a hash function for a particular type. (Herdado de Object.)
	GetPolicyItems	Retorna o item de diretiva que representa a seleção principal. (Substitui SelectionPolicy.GetPolicyItems(Selection).)
	GetSurrogateItems	Retorna um conjunto opcional de itens de substitutos para este item. (Herdado de ItemPolicy.)
	GetType	Obtém o Type da instância atual. (Herdado de Object.)
	IsInPolicy	Obtém um valor que indica se o item especificado está para ser incluído na diretiva. (Herdado de SelectionPolicy.)
	MemberwiseClone	Cria uma cópia superficial do atual Object. (Herdado de Object.)
	OnActivated	Chamado quando essa diretiva é ativada. (Herdado de SelectionPolicy.)
	OnDeactivated	Chamado quando essa diretiva está desativada. (Herdado de SelectionPolicy.)
	OnPolicyItemsChanged	Raises the PolicyItemsChanged event. (Herdado de ItemPolicy.)
	ToString	Retorna um string que representa o objeto atual. (Herdado de Object.)

Início

Eventos

	Nome	Descrição
	PolicyItemsChanged	Ocorre quando a diretiva é alterado. (Herdado de ItemPolicy.)

Início

Comentários

O PrimarySelectionPolicy classe é um ItemPolicy que está habilitado para o elemento selecionado principalmente quando SelectionTool é a ferramenta ativa.

Exemplos

O exemplo de código a seguir mostra como implementar uma diretiva do substituto personalizado para a seleção principal. Para obter uma listagem de código completo, consulte Como: criar uma diretiva substituto.

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

Acesso thread-safe

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.