CSmartDockingInfo (clase)
Define el aspecto de los marcadores de acoplamiento inteligente.
Sintaxis
class CSmartDockingInfo : public CObject
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
CSmartDockingInfo::CSmartDockingInfo |
Constructor predeterminado. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| CSmartDockingInfo::CopyTo | Copia los parámetros de información de acoplamiento inteligente actuales en el objeto CSmartDockingInfo proporcionado. |
Miembros de datos
| Nombre | Descripción |
|---|---|
| CSmartDockingInfo::m_bUseThemeColorInShading | Especifica si se usa el color de tema actual cuando el marco muestra marcadores de acoplamiento inteligente. |
| CSmartDockingInfo::m_clrBaseBackground | Especifica el color de fondo base de los marcadores de acoplamiento inteligente. |
| CSmartDockingInfo::m_clrToneDest | Especifica el color que reemplaza m_clrToneSrc en mapas de bits del marcador de acoplamiento inteligente. |
| CSmartDockingInfo::m_clrToneSrc | Especifica el color de los mapas de bits del marcador de acoplamiento inteligente. |
| CSmartDockingInfo::m_clrTransparent | Especifica el color de los mapas de bits del marcador de acoplamiento inteligente cuando son transparentes. |
| CSmartDockingInfo::m_nCentralGroupOffset | Especifica el desplazamiento del grupo central de marcadores de acoplamiento inteligente desde los límites del rectángulo del grupo central. |
| CSmartDockingInfo::m_sizeTotal | Especifica el tamaño total de todos los marcadores de acoplamiento inteligente de un grupo. |
| CSmartDockingInfo::m_uiMarkerBmpResID | Define los identificadores de recursos de los mapas de bits que usa el marco para los marcadores de acoplamiento inteligente que no están resaltados. |
| CSmartDockingInfo::m_uiMarkerLightBmpResID | Define los identificadores de recursos de los mapas de bits que usa el marco para los marcadores de acoplamiento inteligente que están resaltados. |
Comentarios
El marco controla internamente los marcadores de acoplamiento inteligente. En la siguiente ilustración se muestran los marcadores de acoplamiento inteligente estándar:
En esta ilustración, la imagen de la izquierda muestra un marcador de acoplamiento inteligente de grupo central que no tiene habilitado el acoplamiento a una pestaña. La imagen del centro muestra un marcador de acoplamiento inteligente de borde derecho. La imagen de la derecha muestra un marcador de acoplamiento inteligente de grupo central que tiene habilitado el acoplamiento a una pestaña. El marcador de acoplamiento inteligente de grupo central tiene un mapa de bits principal y cinco mapas de bits de marcador de acoplamiento inteligente.
Puede personalizar los siguientes parámetros de los marcadores de acoplamiento inteligente:
Color. Por ejemplo, puede reemplazar el color azul de los marcadores de la figura por cualquier color definido por el usuario.
Color de transparencia.
Desplazamiento de un marcador de acoplamiento inteligente en el grupo central desde el borde del rectángulo delimitador.
El mapa de bits principal que representa el grupo central.
Los mapas de bits que representan los marcadores de acoplamiento inteligente normales y resaltados.
En la siguiente ilustración se muestra un ejemplo de marcadores de acoplamiento inteligente que se han personalizado:
Jerarquía de herencia
Requisitos
Encabezado: afxDockingManager.h
CSmartDockingInfo::CopyTo
Copia los parámetros de información de acoplamiento inteligente actuales en el objeto CSmartDockingInfo proporcionado.
void CopyTo(CSmartDockingInfo& params);
Parámetros
params
[out] Objeto de tipo CSmartDockingInfo que se rellena con los parámetros de acoplamiento inteligente actuales.
CSmartDockingInfo::m_bUseThemeColorInShading
Especifica si se usa el color de tema actual cuando el marco muestra marcadores de acoplamiento inteligente.
BOOL m_bUseThemeColorInShading;
Comentarios
Si es TRUE, los marcadores se dibujan utilizando el color de tema actual; de lo contrario, los marcadores se dibujan con un color azul claro.
El valor predeterminado es FALSE.
CSmartDockingInfo::m_clrBaseBackground
Especifica el color de fondo base de los marcadores de acoplamiento inteligente.
COLORREF m_clrBaseBackground;
CSmartDockingInfo::m_clrToneDest
Especifica el color que reemplazará m_clrToneSrc en mapas de bits del marcador de acoplamiento inteligente.
COLORREF m_clrToneDest;
Comentarios
Establezca este valor para cambiar mediante programación el color de los mapas de bits del marcador. Por ejemplo, si desea cambiar el color de los marcadores estándar proporcionados con el marco, establezca este valor en el color deseado. De forma predeterminada, CSmartDockingInfo::m_clrToneSrc se establece en RGB (61, 123, 241) (un color azulado).
Para cambiar el color de los marcadores personalizados, debe especificar m_clrToneDest y m_clrToneSrc.
CSmartDockingInfo::m_clrToneSrc
Especifica el color de los mapas de bits del marcador de acoplamiento inteligente.
COLORREF m_clrToneSrc;
Comentarios
Establezca este valor solo cuando desee reemplazar el color de un mapa de bits personalizado por otro color. No es necesario establecer este valor si está cambiando el color de un marcador estándar (proporcionado por el marco).
Use (COLORREF)-1 para dejar vacío un miembro del grupo de acoplamiento inteligente.
CSmartDockingInfo::m_clrTransparent
Especifica el color de los mapas de bits del marcador de acoplamiento inteligente cuando son transparentes.
COLORREF m_clrTransparent;
Comentarios
Debe establecer este valor al mostrar marcadores personalizados y mapas de bits personalizados en el grupo de acoplamiento.
CSmartDockingInfo::m_nCentralGroupOffset
Especifica el desplazamiento entre el grupo central de marcadores de acoplamiento inteligente y los límites del rectángulo del grupo central.
int m_nCentralGroupOffset;
Comentarios
Especifique este valor si desea cambiar el desplazamiento predeterminado entre los marcadores personalizados y los límites del grupo central de los marcadores de acoplamiento inteligente. El desplazamiento predeterminado es de 5 píxeles.
CSmartDockingInfo::m_sizeTotal
Especifica el tamaño total de un rectángulo delimitador que incluye todos los marcadores de acoplamiento inteligente del grupo central.
CSize m_sizeTotal;
Comentarios
Establezca m_sizeTotal en el tamaño del rectángulo delimitador del marcador de grupo central. Debe especificar este valor si usa mapas de bits personalizados para marcadores.
CSmartDockingInfo::m_uiMarkerBmpResID
Define los identificadores de recursos de los mapas de bits que se usan para los marcadores de acoplamiento inteligente personalizados no resaltados.
UINT m_uiMarkerBmpResID[AFX_SD_MARKERS_NUM];
Comentarios
Rellene esta matriz con los identificadores de recursos de los mapas de bits que representan los marcadores de acoplamiento inteligente. AFX_SD_MARKERS_NUM se define actualmente como 5. Rellene la matriz de la siguiente manera:
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
Define los identificadores de recursos de los mapas de bits que se usan para los marcadores de acoplamiento inteligente personalizados resaltados.
UINT m_uiMarkerLightBmpResID[AFX_SD_MARKERS_NUM];
Comentarios
Rellene esta matriz con los identificadores de recursos de los mapas de bits que representan los marcadores de acoplamiento inteligente resaltados. AFX_SD_MARKERS_NUM se define actualmente como 5. Rellene la matriz de la siguiente manera:
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;