Compartilhar via

Padrão de controle de valor

  • Artigo

Descreve diretrizes e convenções para implementar IValueProvider, incluindo informações sobre propriedades e métodos. O padrão de controle Value é usado para dar suporte a controles que têm um valor intrínseco que não abrange um intervalo e que podem ser representados como uma cadeia de caracteres.

A cadeia de caracteres de valor pode ser editável, dependendo do controle e de suas configurações. Para obter exemplos de controles que implementam esse padrão de controle, consulte tipos de controle e seus padrões de controle com suporte.

Este tópico contém as seções a seguir.

Diretrizes e convenções de implementação

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

  • Controles como um item de lista ou item de árvore devem dar suporte ao padrão de controle Valor se o valor de qualquer um dos itens for editável, independentemente do modo de edição atual do controle. O controle pai também deve dar suporte ao padrão de controle Value se os itens filho forem editáveis. A imagem a seguir mostra um exemplo de um item de lista editável.

    ilustração mostrando o item de lista editável

  • Controles de edição de linha única e múltipla devem implementar ITextProvider para expor seu conteúdo somente leitura.

  • Os controles de edição de várias linhas devem implementar IValueProvider se o conteúdo puder ser alterado.

  • IValueProvider não dá suporte à recuperação de informações de formatação ou valores de subcadeia de caracteres. Implemente ITextProvider nesses cenários.

  • IValueProvider deve ser implementado por controles como o controle de seleção do seletor de cores do Microsoft Word (consulte a imagem a seguir), que dá suporte ao mapeamento de cadeia de caracteres entre um valor de cor (por exemplo, "amarelo") e um valor de RGB interno equivalente.

    ilustração mostrando de mapeamento de cadeia de caracteres de amostra de cores

  • Um controle deve ter sua propriedade IsEnabled definida como TRUE e sua propriedade ITextProvider::IsReadOnly definida como FALSE antes de permitir uma chamada para ITextProvider::SetValue.

Membros necessários para IValueProvider

As propriedades e os métodos a seguir são necessários para implementar a interface deIValueProvider.

Membros necessários Tipo de membro Anotações
IsReadOnly Propriedade Nenhum
de valor de Propriedade Nenhum
SetValue Método Nenhum

 

Esse padrão de controle não tem eventos associados.

tipos de controle e seus padrões de controle com suporte

Visão geral dos padrões de controle de automação da interface do usuário

Visão geral da árvore de automação da interface do usuário

padrões de controle text and textRange