Шаблон элемента управления значением

Описание рекомендаций и соглашений по реализации IValueProvider, включая сведения о свойствах и методах. Шаблон элемента управления Значение используется для поддержки элементов управления, которые имеют внутреннее значение, не охватывающее диапазон, и которые могут быть представлены в виде строки.

Строка значения может быть редактируемой в зависимости от элемента управления и его параметров. Примеры элементов управления, реализующих этот шаблон элемента управления, см. в разделе Типы элементов управления и поддерживаемые ими шаблоны элементов управления.

В этом разделе содержатся следующие подразделы.

• Правила и соглашения реализации
• Обязательные элементы для IValueProvider
• Связанные темы

Правила и соглашения реализации

При реализации шаблона элемента управления значением обратите внимание на следующие рекомендации и соглашения.

• Такие элементы управления, как элемент списка или элемент дерева, должны поддерживать шаблон элемента управления Значение , если значение любого из элементов доступно для редактирования, независимо от текущего режима редактирования элемента управления. Родительский элемент управления также должен поддерживать шаблон элемента управления Значение , если дочерние элементы доступны для редактирования. На следующем рисунке показан пример редактируемого элемента списка.

  

• Однострочные и многострочные элементы управления редактированием должны реализовывать ITextProvider для предоставления содержимого только для чтения.

• Многострочный элемент управления редактированием должен реализовывать IValueProvider , если их содержимое можно изменить.

• IValueProvider не поддерживает получение сведений о форматировании или значений подстроки. Реализуйте ITextProvider в этих сценариях.

• IValueProvider должен быть реализован с помощью таких элементов управления, как элемент управления выбора цвета от Microsoft Word (см. следующее изображение), который поддерживает сопоставление строк между значением цвета (например, "желтым") и эквивалентным внутренним RGB-значением.

  

• Свойство IsEnabled элемента управления должно иметь значение TRUE , а свойство ITextProvider::IsReadOnly — FALSE , прежде чем разрешить вызов ITextProvider::SetValue.

Обязательные элементы для IValueProvider

Для реализации интерфейса IValueProvider требуются следующие свойства и методы.

Этот шаблон элемента управления не имеет связанных событий.

Связанные темы

Типы элементов управления и поддерживаемые ими шаблоны элементов управления

Общие сведения о шаблонах элементов управления модели автоматизации пользовательского интерфейса

Общие сведения о дереве модели автоматизации пользовательского интерфейса

Шаблоны элементов управления Text и TextRange