Шаблон элемента управления значением
Описывает рекомендации и соглашения для реализации IValueProvider, включая сведения о свойствах и методах. Шаблон значения используется для поддержки элементов управления, которые имеют встроенное значение, не охватывающее диапазон и которое может быть представлено в виде строки.
Строка значения может быть редактируемой в зависимости от элемента управления и его параметров. Примеры элементов управления, реализующих этот шаблон элемента управления, см. в типах элементов управления и их поддерживаемых шаблонах элементов управления.
В этом разделе содержатся следующие разделы.
- руководящих принципов и соглашений о реализации
- обязательные элементы для IValueProvider
- связанные разделы
Рекомендации по реализации и соглашения
При реализации шаблона элемента управления value обратите внимание на следующие рекомендации и соглашения:
Элементы управления, такие как элемент списка или элемент дерева, должны поддерживать шаблон элемента управления значение, если значение любого из элементов можно изменить независимо от текущего режима редактирования элемента управления. Родительский элемент управления также должен поддерживать шаблон value, если дочерние элементы можно изменить. На следующем рисунке показан пример редактируемого элемента списка.
Элементы управления редактирования с несколькими строками должны реализовывать ITextProvider для предоставления содержимого только для чтения.
Элементы управления многострочный редактирования должны реализовать IValueProvider, если их содержимое можно изменить.
IValueProvider не поддерживает получение сведений о форматировании или значений подстроки. Реализуйте ITextProvider в этих сценариях.
IValueProvider должны быть реализованы элементами управления, такими как элемент управления выбора цвета из Microsoft Word (см. следующее изображение), который поддерживает сопоставление строк между значением цвета (например, желтым) и эквивалентным внутренним RGB значением.
Элемент управления должен иметь свойство IsEnabled значение TRUE и свойство ITextProvider::IsReadOnly значение false , прежде чем разрешить вызов ITextProvider::SetValue.
Обязательные элементы для IValueProvider
Для реализации интерфейса IValueProvider требуются следующие свойства и методы.
| Обязательные элементы | Тип элемента | Примечания |
|---|---|---|
| IsReadOnly | Свойство | Никакой |
| значение | Свойство | Никакой |
| SetValue | Метод | Никакой |
Этот шаблон элемента управления не имеет связанных событий.
Связанные разделы
-
Типы элементов управления и поддерживаемые шаблоны элементов управления
-
Обзор шаблонов элементов управления автоматизации пользовательского интерфейса