Implementando o padrão de controle de valor da automação da interface do usuário

Observação

Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar as classes de automação da interface do usuário gerenciadas definidas no namespace System.Windows.Automation. Para obter as informações mais recentes sobre a automação da interface de utilizador, consulte API de automação do Windows: Automação da Interface de Utilizador.

Este tópico apresenta diretrizes e convenções para a implementação de IValueProvider, incluindo informações sobre eventos e propriedades. Links para referências adicionais estão listados no final do tópico.

O ValuePattern padrão de controle é usado para dar suporte a controles que têm um valor intrínseco que não abrange um intervalo e que pode ser representado como uma cadeia de caracteres. Essa cadeia de caracteres pode ser editável, dependendo do controle e suas configurações. Para obter exemplos de controles que implementam esse padrão, consulte Mapeamento de padrão de controle para clientes de automação da interface do usuário.

Orientações e convenções de aplicação

Ao implementar o padrão de controle de valor, observe as seguintes diretrizes e convenções:

• Controles como ListItem e TreeItem devem suportar ValuePattern se o valor de qualquer um dos itens é editável, independentemente do modo de edição atual do controle. O controlador pai também deve oferecer suporte ValuePattern se os itens filho forem editáveis.

Exemplo de um item de lista editável

• Os controlos de edição de linha única suportam o acesso programático ao seu conteúdo implementando o IValueProvider. No entanto, os controles de edição de várias linhas não implementam IValueProvider, em vez disso, fornecem acesso ao seu conteúdo implementando ITextProvider.

• Para recuperar o conteúdo textual de um controle de edição de várias linhas, o controle deve implementar ITextProvider. No entanto, ITextProvider não suporta a definição do valor de um controle.

• IValueProvider não suporta a recuperação de informações de formatação ou valores de substring. Implemente ITextProvider nesses cenários.

• IValueProvider deve ser implementado por controles como o controle de seleção do Seletor de Cores do Microsoft Word (ilustrado abaixo), que oferece suporte ao mapeamento de cadeia de caracteres entre um valor de cor (por exemplo, "amarelo") e uma estrutura RGB interna equivalente.

Exemplo de mapeamento de amostra de cor

• Um controle deve ter seu IsEnabledProperty definido como true e seu IsReadOnlyProperty definido como false antes de permitir uma chamada para SetValue.

Membros necessários para IValueProvider

As seguintes propriedades e métodos são necessários para a implementação do IValueProvider.

Membros obrigatórios	Tipo de membro	Observações
IsReadOnlyProperty	Propriedade	Nenhum
ValueProperty	Propriedade	Nenhum
SetValue	Método	Nenhum

Exceções

Os provedores devem lançar as seguintes exceções.

Tipo de exceção	Condição
InvalidOperationException	SetValue - Se as informações específicas da localidade forem passadas para um controle em um formato incorreto, como uma data formatada incorretamente.
ArgumentException	SetValue - Se um novo valor não pode ser convertido de uma cadeia de caracteres para um formato que o controle reconhece.
ElementNotEnabledException	SetValue - Quando é feita uma tentativa de manipular um controle que não está habilitado.

Ver também

• Visão geral dos padrões de controle de automação da interface do usuário
• Suportar Padrões de Controle em um Provedor de Automação de Interface do Usuário
• Padrões de Controle de Automação da Interface do Usuário para Clientes
• Exemplo de Inserção de Texto para o ValuePattern
• Visão geral da árvore de automação da interface do usuário
• Use o armazenamento em cache na automação da interface do utilizador