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

  • Статья

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

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

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

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

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

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

    Иллюстрация, показывающая редактируемый элемент списка

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

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

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

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

    Иллюстрация, показывающая сопоставление строк цветовой гаммы

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

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

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

Обязательные члены Тип члена Примечания
IsReadOnly Свойство Нет
Значение Свойство Нет
SetValue Метод Нет

 

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

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

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

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

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