Padrão de controle de valor

Descreve diretrizes e convenções para implementar 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 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 suportados.

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

• Diretrizes de Implementação e Convenções
• Membros necessários para IValueProvider
• Tópicos relacionados

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

Ao implementar o Value control pattern, observe as seguintes diretrizes e convenções:

• Controles como um item de lista ou item de árvore devem suportar o Valor padrão de controle 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 oferecer 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.

  de itens de lista editáveis

• Os 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 seu conteúdo puder ser alterado.

• 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 (consulte a imagem a seguir), que oferece suporte ao mapeamento de cadeia de caracteres entre um valor de cor (por exemplo, "amarelo") e um valor de RGB interno equivalente.

  

• 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 métodos a seguir são necessários para implementar o interface de IValueProvider.

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

Tópicos relacionados

tipos de controle e seus padrões de controle suportados

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

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

padrões de controle Text e TextRange