Classe CSmartDockingInfo
Define a aparência de marcadores de encaixe inteligentes.
Sintaxe
class CSmartDockingInfo : public CObject
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
CSmartDockingInfo::CSmartDockingInfo |
Construtor padrão. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CSmartDockingInfo::CopyTo | Copia os parâmetros de informações de encaixe inteligente atuais no objeto CSmartDockingInfo fornecido. |
Membros de dados
| Nome | Descrição |
|---|---|
| CSmartDockingInfo::m_bUseThemeColorInShading | Especifica se a cor do tema atual será usada quando a estrutura exibir marcadores de encaixe inteligentes. |
| CSmartDockingInfo::m_clrBaseBackground | Especifica a cor da tela de fundo base dos marcadores de encaixe inteligente. |
| CSmartDockingInfo::m_clrToneDest | Especifica a cor que substitui m_clrToneSrc em bitmaps de marcador de encaixe inteligente. |
| CSmartDockingInfo::m_clrToneSrc | Especifica a cor dos bitmaps do marcador de encaixe inteligente. |
| CSmartDockingInfo::m_clrTransparent | Especifica a cor dos bitmaps do marcador de encaixe inteligente quando eles são transparentes. |
| CSmartDockingInfo::m_nCentralGroupOffset | Especifica o deslocamento do grupo central de marcadores de encaixe inteligente dos limites do retângulo do grupo central. |
| CSmartDockingInfo::m_sizeTotal | Especifica o tamanho total de todos os marcadores de encaixe inteligentes em um grupo. |
| CSmartDockingInfo::m_uiMarkerBmpResID | Define as IDs de recurso dos bitmaps que a estrutura usa para marcadores de encaixe inteligentes que não estão realçados. |
| CSmartDockingInfo::m_uiMarkerLightBmpResID | Define as IDs de recurso dos bitmaps que a estrutura usa para marcadores de encaixe inteligentes que estão realçados. |
Comentários
A estrutura lida com marcadores de encaixe inteligentes internamente. A ilustração a seguir mostra os marcadores de encaixe inteligente padrão:
Nessa figura, a imagem à esquerda mostra um marcador de encaixe inteligente do grupo central que não tem o encaixe em uma guia habilitada. A imagem no meio mostra um marcador de encaixe inteligente de borda direita. A imagem à direita mostra um marcador de encaixe inteligente do grupo central que tem o encaixe em uma guia habilitada. O marcador de encaixe inteligente do grupo central tem um bitmap principal e cinco bitmaps de marcador de encaixe inteligente.
Você pode personalizar os seguintes parâmetros de marcadores de encaixe inteligente:
Cor. Por exemplo, você pode substituir a cor azul dos marcadores na figura por qualquer cor definida pelo usuário.
Cor da transparência.
Deslocamento de um marcador de encaixe inteligente no grupo central da borda do retângulo delimitador.
O bitmap principal que representa o grupo central.
Os bitmaps que representam os marcadores de encaixe inteligentes regulares e realçados.
A ilustração a seguir mostra um exemplo de marcadores de encaixe inteligentes que foram personalizados:
Hierarquia de herança
Requisitos
Cabeçalho: afxDockingManager.h
CSmartDockingInfo::CopyTo
Copia os parâmetros de encaixe inteligente atuais no objeto CSmartDockingInfo fornecido.
void CopyTo(CSmartDockingInfo& params);
Parâmetros
params
[out] Um objeto do tipo CSmartDockingInfo que é preenchido com os parâmetros de encaixe inteligente atuais.
CSmartDockingInfo::m_bUseThemeColorInShading
Especifica se a cor do tema atual será usada quando a estrutura exibir marcadores de encaixe inteligentes.
BOOL m_bUseThemeColorInShading;
Comentários
Se for TRUE, os marcadores serão desenhados usando a cor do tema atual; caso contrário, os marcadores são desenhados com uma cor azul clara.
O valor padrão é FALSE.
CSmartDockingInfo::m_clrBaseBackground
Especifica a cor da tela de fundo base dos marcadores de encaixe inteligente.
COLORREF m_clrBaseBackground;
CSmartDockingInfo::m_clrToneDest
Especifica a cor que substitui m_clrToneSrc em bitmaps de marcador de encaixe inteligente.
COLORREF m_clrToneDest;
Comentários
Defina esse valor para alterar a cor do bitmaps de marcador programaticamente. Por exemplo, se você quiser alterar a cor dos marcadores padrão fornecidos com a estrutura, defina esse valor como a cor desejada. Por padrão, CSmartDockingInfo::m_clrToneSrc é definido como RGB (61, 123, 241) (uma cor azulada).
Para alterar a cor dos marcadores personalizados, você deve especificar m_clrToneDest e m_clrToneSrc.
CSmartDockingInfo::m_clrToneSrc
Especifica a cor dos bitmaps do marcador de encaixe inteligente.
COLORREF m_clrToneSrc;
Comentários
Defina esse valor somente quando quiser substituir a cor de um bitmap personalizado por outra cor. Você não precisará definir esse valor se estiver alterando a cor de um marcador padrão (estrutura fornecida).
Use (COLORREF)-1 para deixar um membro do grupo de encaixe inteligente vazio.
CSmartDockingInfo::m_clrTransparent
Especifica a cor dos bitmaps do marcador de encaixe inteligente quando eles são transparentes.
COLORREF m_clrTransparent;
Comentários
Você deve definir esse valor ao exibir marcadores personalizados e bitmaps personalizados no grupo de encaixe.
CSmartDockingInfo::m_nCentralGroupOffset
Especifica o deslocamento entre o grupo central de marcadores de encaixe inteligente e os limites do retângulo do grupo central.
int m_nCentralGroupOffset;
Comentários
Especifique esse valor se quiser alterar o deslocamento padrão entre marcadores personalizados e os limites do grupo central de marcadores de encaixe inteligentes. O deslocamento padrão é 5 pixels.
CSmartDockingInfo::m_sizeTotal
Especifica o tamanho total de um retângulo delimitador que inclui todos os marcadores de encaixe inteligentes no grupo central.
CSize m_sizeTotal;
Comentários
Defina m_sizeTotal como o tamanho do retângulo delimitador do marcador de grupo central. Você precisará especificar esse valor se estiver usando bitmaps personalizados para marcadores.
CSmartDockingInfo::m_uiMarkerBmpResID
Define as IDs de recurso dos bitmaps que são usados para marcadores de encaixe inteligente personalizados não realçados.
UINT m_uiMarkerBmpResID[AFX_SD_MARKERS_NUM];
Comentários
Preencha essa matriz com as IDs de recurso dos bitmaps que representam os marcadores de encaixe inteligentes. AFX_SD_MARKERS_NUM atualmente é definido como 5. Você preenche a matriz da seguinte maneira:
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 as IDs de recurso dos bitmaps que são usados para marcadores de encaixe inteligente personalizados realçados.
UINT m_uiMarkerLightBmpResID[AFX_SD_MARKERS_NUM];
Comentários
Preencha essa matriz com as IDs de recurso dos bitmaps que representam os marcadores de encaixe inteligentes realçados. AFX_SD_MARKERS_NUM atualmente é definido como 5. Você preenche a matriz da seguinte maneira:
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;