Compartilhar via


Padrão de controle de valor

Descreve as diretrizes e convenções para implementar o IValueProvider, incluindo informações sobre propriedades e métodos. O padrão de controle Valor é 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.

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 inclui 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 Valor 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

  • Os controles de edição de linha única e de várias linhas devem implementar o ITextProvider para expor o 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 RGB interno equivalente.

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

  • 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 IValueProvider .

Membros necessários Tipo de membro Observações
Isreadonly Propriedade Nenhum
Valor 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 de Padrões de Controle de Automação de Interface de Usuário

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

Padrões de controle Text e TextRange