Стандартные свойства
OLE определяет набор стандартных DISPID для всех трех видов свойств: управления, окружения и расширенного. В следующих таблицах перечислены эти стандарты для свойств элемента управления, свойств окружения и расширенных свойств.
| Свойство элемента управления | Тип | Описание |
|---|---|---|
| BackColor, ForeColor, FillColor, BorderColor |
OLE_COLOR |
Цветовая схема элемента управления |
| BackStyle, FillStyle, BorderStyle, BorderWidth, BorderVisible, DrawStyle, DrawWidth |
короткий или длинный |
Биты, определяющие визуальное поведение элемента управления, такие как сплошные или прозрачные, имеющие толстые или тонкие границы, стили линий и т. д. |
| Шрифт |
Idispatch* |
Шрифт, используемый в элементе управления, который является указателем IDispatch на стандартный объект шрифта. Дополнительные сведения см. в разделе "Стандартный объект шрифта". |
| Заголовок, текст |
BSTR |
Строки, содержащие метку элемента управления (подпись) или его текстовое содержимое (текст). Обратите внимание, что подпись не обязательно называет элемент управления в контейнере. Дополнительные свойства Name см. в следующей таблице. |
| Включен |
BOOL |
Определяет, включен или отключен элемент управления. При отключении элемент управления, вероятно, серый. |
| Окно |
HWND |
Дескриптор окна элемента управления, если он имеет один. |
| TabStop |
BOOL |
Определяет, является ли этот элемент управления остановкой табуляции. |
| Свойство ambient | Тип | Описание |
|---|---|---|
| BackColor, ForeColor |
OLE_COLOR |
Предоставляет элементы управления с цветами фона и переднего плана по умолчанию. Использование элемента управления является необязательным. |
| Шрифт |
Idispatch* |
Указатель на стандартный объект шрифта, определяющий шрифт по умолчанию для формы. Использование элемента управления является необязательным. Дополнительные сведения см. в разделе "Стандартный объект шрифта". |
| LocaleID |
LCID |
Язык, используемый в контейнере. Рекомендуется использовать элемент управления. |
| UserMode |
BOOL |
Описывает, находится ли контейнер в режиме конструктора (FALSE) или режиме выполнения (TRUE), который элемент управления должен использовать для изменения доступных функций по мере необходимости. |
| UIDead |
BOOL |
Описывает, находится ли контейнер в режиме, в котором элементы управления должны игнорировать входные данные пользователя. Это относится независимо от UserMode. Контейнер всегда может задать uiDead значение TRUE в режиме конструктора и может задать значение TRUE, если он попал в точку останова или такой в режиме выполнения. Элемент управления должен обратить внимание на это свойство. |
| Сообщение Рефлексия |
BOOL |
Указывает, хотите ли контейнер получать сообщения Windows, такие как WM_CTLCOLOR, WM_DRAWITEM, WM_PARENTNOTIFY и т. д. в качестве событий. |
| ПоддержкаMnemonics |
BOOL |
Описывает, обрабатывает ли контейнер mnemonics или нет. Элемент управления может делать все, что он хочет с этой информацией, например не подчеркивание символов, которые обычно используются в качестве mnemonic. |
| ShowGrabHandles, ShowHatching |
BOOL |
Описывает, должен ли элемент управления отображать границу люка или дескриптор (на границе люка) при активном действии. Элементы управления должны подчиняться этим свойствам, предоставляя контейнеру конечный контроль над тем, кто фактически рисует эти биты пользовательского интерфейса. Контейнер элементов управления может потребоваться нарисовать собственный вместо того, чтобы полагаться на каждый элемент управления, в этом случае эти внешние среды всегда будут иметь значение FALSE. |
| DisplayAsDefault |
BOOL |
Контейнер будет предоставлять значение TRUE для этого свойства с помощью любого сайта, содержащего то, что помечено как кнопка по умолчанию, когда элемент управления кнопкой должен нарисовать себя с более толстым фреймом по умолчанию. |
| Расширенное свойство | Тип | Description |
|---|---|---|
| Имя. |
BSTR |
Имя контейнера для элемента управления. |
| Видимо |
BOOL |
Видимость элемента управления. |
| Parent |
Idispatch* |
Преобразовывание формы, содержащей элемент управления. |
| По умолчанию, отмена |
BOOL |
Указывает, является ли этот элемент управления кнопкой по умолчанию или отменой. |
Все эти стандартные свойства имеют отрицательные значения DISPID, указывающие на их стандартное состояние.
Обратите внимание, что чтобы избежать конфликтов в программных символах для этих DISPID, все внешние свойства предоставляются в виде DISPID_AМБIENT_property, как в DISPID_AМБIENT_FORECOLOR. Все остальные символы используют DISPID_property как обычно.
Некоторые свойства окружающей среды, а также свойства элемента управления включают цвета. Тип OLE_COLOR, упоминание в предыдущих таблицах, может ссылаться на стандартный тип COLORREF, индекс на палитру, относительный индекс палитры или системный индекс цвета, используемый с функцией GetSysColor. Функция OleTranslateColor преобразует тип OLE_COLOR в тип COLORREF , заданный палитрой.