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
- Membros necessários para IValueProvider
- Tópicos relacionados
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.
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.
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.
Tópicos relacionados