Classe ItemPolicy

Artigo
08/01/2011

Uma diretiva que especifica um conjunto de regras no designer.

Hierarquia de herança

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

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

Sintaxe

'Declaração
Public MustInherit Class ItemPolicy

public abstract class ItemPolicy

public ref class ItemPolicy abstract

[<AbstractClass>]
type ItemPolicy =  class end

public abstract class ItemPolicy

O tipo ItemPolicy expõe os membros a seguir.

Construtores

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

Início

Propriedades

	Nome	Descrição
	Context	Obtém o contexto de edição para o designer.
	IsSurrogate	Obtém um valor indicando se a diretiva é um substituto.
	PolicyItems	Obtém uma enumeração de todos os itens na diretiva.

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.)
	GetSurrogateItems	Retorna um conjunto opcional de itens de substitutos para este item.
	GetType	Obtém o Type da instância atual. (Herdado de Object.)
	MemberwiseClone	Cria uma cópia superficial do atual Object. (Herdado de Object.)
	OnActivated	Chamado quando uma diretiva é ativada.
	OnDeactivated	Chamado quando a diretiva é desativada.
	OnPolicyItemsChanged	Raises the PolicyItemsChanged event.
	ToString	Retorna um string que representa o objeto atual. (Herdado de Object.)

Início

Eventos

	Nome	Descrição
	PolicyItemsChanged	Ocorre quando a diretiva é alterado.

Início

Comentários

Derivar abstrata ItemPolicy classe para fornecer uma associação entre um conjunto de itens e provedores de recurso correspondente.

Use diretivas para descobrir os recursos de extensibilidade em itens que estão executando no designer. As diretivas são usadas por ferramentas, adornos e outras áreas do designer são extensíveis. O SelectionPolicy classe é um exemplo de política que monitora a seleção muda e eleva o PolicyItemsChanged evento quando alterações de seleção. O designer trata os eventos de alteração de todas as diretivas de execução e toma a ação adequada. No caso de SelectionPolicy, as consultas de designer para o conjunto de tarefas ativas que devem estar disponíveis e o conjunto de adornos que devem ser visíveis na superfície de design.

Uma única instância de um tipo de diretiva é ativada quando o designer descobre nos metadados. As diretivas durar a vida do designer e nunca são desativadas, a menos que o designer propriamente dito é descartado. Se você tiver uma diretiva que mantém uma referência para recursos globais de processos, implementar a OnDeactivated método, que é chamado quando o policy manager é encerrado.

A a política de substitutos oferece um conjunto alternativo de itens que são usados para localizar provedores de recurso. Políticas de substitutos são mais frequentemente usadas por recipientes de controle que oferecem tarefas adicionais e adorners em seus filhos. Nesse cenário, o recipiente oferece uma política de substitutos na qual o GetSurrogateItems método retorna o pai do item fornecido.

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.