Класс CSmartDockingInfo
Определяет внешний вид интеллектуальных маркеров закрепления.
Синтаксис
class CSmartDockingInfo : public CObject
Участники
Открытые конструкторы
| Имя | Описание |
|---|---|
CSmartDockingInfo::CSmartDockingInfo |
Конструктор по умолчанию. |
Открытые методы
| Имя | Описание |
|---|---|
| CSmartDockingInfo::CopyTo | Копирует текущие параметры сведений о смарт-закреплении в предоставленный объект CSmartDockingInfo . |
Элементы данных
| Имя | Описание |
|---|---|
| CSmartDockingInfo::m_bUseThemeColorInShading | Указывает, следует ли использовать текущий цвет темы, когда платформа отображает смарт-маркеры закрепления. |
| CSmartDockingInfo::m_clrBaseBackground | Задает базовый цвет фона смарт-док-маркеров. |
| CSmartDockingInfo::m_clrToneDest | Указывает цвет, заменяющий m_clrToneSrc растровые изображения маркеров смарт-закрепления. |
| CSmartDockingInfo::m_clrToneSrc | Задает цвет точечных изображений маркеров смарт-закрепления. |
| CSmartDockingInfo::m_clrTransparent | Задает цвет точечных карт маркера смарт-закрепления, когда они прозрачны. |
| CSmartDockingInfo::m_nCentralGroupOffset | Указывает смещение центральной группы смарт-док-маркеров из границ прямоугольника центральной группы. |
| CSmartDockingInfo::m_sizeTotal | Указывает общий размер всех маркеров интеллектуальной док-станции в группе. |
| CSmartDockingInfo::m_uiMarkerBmpResID | Определяет идентификаторы ресурсов растровых изображений, которые платформа использует для меток интеллектуальной док-станции, которые не выделены. |
| CSmartDockingInfo::m_uiMarkerLightBmpResID | Определяет идентификаторы ресурсов растровых изображений, которые платформа использует для меток интеллектуальной док-станции, выделенных. |
Замечания
Платформа обрабатывает маркеры интеллектуального закрепления внутри системы. На следующем рисунке показаны стандартные маркеры смарт-закрепления:
На этом рисунке на левом рисунке показан маркер интеллектуальной док-станции центральной группы, который не включает закрепление на вкладке. На изображении в середине показан маркер смарт-закрепления правого края. На изображении справа показан маркер интеллектуальной док-станции центральной группы с включенным закреплением на вкладке. Маркер интеллектуальной док-станции центральной группы имеет основное растровое изображение и пять точечных карт маркеров смарт-закрепления.
Вы можете настроить следующие параметры маркеров смарт-закреплений:
Цвет. Например, можно заменить синий цвет маркеров на рисунке любым определяемым пользователем цветом.
Цвет прозрачности.
Смещение маркера интеллектуальной док-станции в центральной группе с границы ограничивающего прямоугольника.
Основное растровое изображение, представляющее центральную группу.
Растровые изображения, представляющие обычные и выделенные маркеры смарт-закреплений.
На следующем рисунке показан пример меток смарт-закрепления, которые были настроены:
Иерархия наследования
Требования
Заголовок: afxDockingManager.h
CSmartDockingInfo::CopyTo
Копирует текущие параметры интеллектуальной док-станции в предоставленный объект CSmartDockingInfo .
void CopyTo(CSmartDockingInfo& params);
Параметры
params
[out] Объект типа CSmartDockingInfo , заполненный текущими параметрами интеллектуальной док-станции.
CSmartDockingInfo::m_bUseThemeColorInShading
Указывает, следует ли использовать текущий цвет темы, когда платформа отображает смарт-маркеры закрепления.
BOOL m_bUseThemeColorInShading;
Замечания
Если значение TRUE, маркеры рисуются с помощью текущего цвета темы; в противном случае маркеры рисуются с светло-голубым цветом.
Значение по умолчанию — FALSE.
CSmartDockingInfo::m_clrBaseBackground
Задает базовый цвет фона смарт-док-маркеров.
COLORREF m_clrBaseBackground;
CSmartDockingInfo::m_clrToneDest
Указывает цвет, который заменится m_clrToneSrc на растровые изображения маркеров смарт-закрепления.
COLORREF m_clrToneDest;
Замечания
Задайте это значение, чтобы изменить цвет растровых изображений маркеров программным способом. Например, если вы хотите изменить цвет стандартных маркеров, предоставленных платформой, задайте для этого значения нужный цвет. По умолчанию CSmartDockingInfo::m_clrToneSrc имеет значение RGB (61, 123, 241) (голубой цвет).
Чтобы изменить цвет пользовательских маркеров, необходимо указать оба m_clrToneDest и m_clrToneSrc.
CSmartDockingInfo::m_clrToneSrc
Задает цвет точечных изображений маркеров смарт-закрепления.
COLORREF m_clrToneSrc;
Замечания
Задайте это значение только в том случае, если вы хотите заменить цвет пользовательской растровой карты другим цветом. Если вы изменяете цвет стандартного (предоставленного платформой) маркера, вам не нужно задавать это значение.
Используйте (COLORREF)-1 , чтобы оставить члена группы интеллектуальной док-станции пустым.
CSmartDockingInfo::m_clrTransparent
Задает цвет точечных карт маркера смарт-закрепления, когда они прозрачны.
COLORREF m_clrTransparent;
Замечания
Это значение необходимо задать при отображении пользовательских маркеров и пользовательских растровых изображений в группе закреплений.
CSmartDockingInfo::m_nCentralGroupOffset
Указывает смещение между центральной группой маркеров смарт-закрепления и границами прямоугольника центральной группы.
int m_nCentralGroupOffset;
Замечания
Укажите это значение, если требуется изменить смещение по умолчанию между пользовательскими маркерами и границами центральной группы смарт-док-маркеров. Смещение по умолчанию — 5 пикселей.
CSmartDockingInfo::m_sizeTotal
Указывает общий размер ограничивающего прямоугольника, который заключает все маркеры интеллектуального закрепления в центральную группу.
CSize m_sizeTotal;
Замечания
Задайте m_sizeTotal размер ограничивающего прямоугольника центрального маркера группы. Это значение необходимо указать, если для маркеров используются пользовательские растровые изображения.
CSmartDockingInfo::m_uiMarkerBmpResID
Определяет идентификаторы ресурсов растровых изображений, которые используются для не выделенных пользовательских маркеров интеллектуальной док-станции.
UINT m_uiMarkerBmpResID[AFX_SD_MARKERS_NUM];
Замечания
Заполните этот массив идентификаторами ресурсов растровых изображений, представляющих смарт-маркеры закрепления. AFX_SD_MARKERS_NUM в настоящее время определяется как 5. Вы заполняете массив следующим образом:
params.m_uiMarkerBmpResID[0] = IDB_MARKER_LEFT;
params.m_uiMarkerBmpResID[1] = IDB_MARKER_RIGHT;
params.m_uiMarkerBmpResID[2] = IDB_MARKER_TOP;
params.m_uiMarkerBmpResID[3] = IDB_MARKER_BOTTOM;
params.m_uiMarkerBmpResID[4] = IDB_MARKER_CENTER;
CSmartDockingInfo::m_uiMarkerLightBmpResID
Определяет идентификаторы ресурсов растровых изображений, которые используются для выделенных пользовательских маркеров интеллектуальной док-станции.
UINT m_uiMarkerLightBmpResID[AFX_SD_MARKERS_NUM];
Замечания
Заполните этот массив идентификаторами ресурсов растровых изображений, представляющих выделенные маркеры интеллектуальной док-станции. AFX_SD_MARKERS_NUM в настоящее время определяется как 5. Вы заполняете массив следующим образом:
params.m_uiMarkerLightBmpResID[0] = IDB_MARKER_LEFT_LIGHT;
params.m_uiMarkerLightBmpResID[1] = IDB_MARKER_RIGHT_LIGHT;
params.m_uiMarkerLightBmpResID[2] = IDB_MARKER_TOP_LIGHT;
params.m_uiMarkerLightBmpResID[3] = IDB_MARKER_BOTTOM_LIGHT;
params.m_uiMarkerLightBmpResID[4] = IDB_MARKER_CENTER_LIGHT;