Classe CSmartDockingInfo

Define a aparência dos marcadores de acoplamento inteligente.

Sintaxe

class CSmartDockingInfo : public CObject

Membros

Construtores Públicos

Métodos Públicos

Membros de Dados

Observações

A estrutura gere internamente os marcadores de acoplamento inteligente. A ilustração seguinte mostra os marcadores padrão de acoplamento inteligente:

Nesta figura, a imagem à esquerda mostra um marcador de acoplamento inteligente de grupo central que não tem o acoplamento a um separador ativado. A imagem no meio mostra um marcador de acoplamento inteligente na borda direita. A imagem à direita mostra um marcador de acoplamento inteligente de grupo central que tem o acoplamento a um separador ativado. O marcador de acoplamento inteligente do grupo central tem um bitmap principal e cinco bitmaps de marcadores inteligentes de acoplamento.

Pode personalizar os seguintes parâmetros dos marcadores de acoplamento inteligente:

• Cor. Por exemplo, podes substituir a cor azul dos marcadores na figura por qualquer cor definida pelo utilizador.

• Cor de transparência.

• Deslocamento de um marcador de acoplamento inteligente no grupo central em relação à borda do retângulo delimitador.

• O bitmap principal que representa o grupo central.

• Os bitmaps que representam os marcadores de acoplamento inteligente normais e destacados.

A ilustração seguinte mostra um exemplo de marcadores de acoplamento inteligente que foram personalizados:

Hierarquia de herança

CObject

CSmartDockingInfo

Requerimentos

Cabeçalho: afxDockingManager.h

CSmartDockingInfo::CopyTo

Copia os parâmetros atuais de acoplamento inteligente para o objeto CSmartDockingInfo fornecido.

void CopyTo(CSmartDockingInfo& params);

Parâmetros

params
[fora] Um objeto do tipo CSmartDockingInfo que está preenchido com os parâmetros atuais de acoplamento inteligente.

CSmartDockingInfo::m_bUseThemeColorInShading

Especifica se deve usar a cor do tema atual quando o framework exibe marcadores de acoplamento inteligentes.

BOOL m_bUseThemeColorInShading;

Observações

Se TRUE, os marcadores sã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 de fundo base dos marcadores de acoplamento inteligentes.

COLORREF m_clrBaseBackground;

CSmartDockingInfo::m_clrToneDest

Especifica a cor que irá substituir m_clrToneSrc nos bitmaps de marcadores de acoplamento inteligente.

COLORREF m_clrToneDest;

Observações

Defina este valor para alterar a cor dos bitmaps do marcador programaticamente. Por exemplo, se quiser alterar a cor dos marcadores padrão fornecidos com a estrutura, defina esse valor para a cor desejada. Por defeito, o CSmartDockingInfo::m_clrToneSrc está definido para RGB (61, 123, 241) (uma cor azulada).

Para alterar a cor dos marcadores personalizados, deve especificar tanto m_clrToneDest como m_clrToneSrc.

CSmartDockingInfo::m_clrToneSrc

Especifica a cor dos bitmaps de marcadores de acoplamento inteligente.

COLORREF m_clrToneSrc;

Observações

Defina este valor apenas quando quiser substituir a cor de um bitmap personalizado por outra cor. Não é necessário definir este valor se estiver a alterar a cor de um marcador padrão (fornecido por framework).

Costumo (COLORREF)-1 deixar um membro do grupo de acoplamento inteligente vazio.

CSmartDockingInfo::m_clrTransparent

Especifica a cor dos bitmaps de marcadores de acoplamento inteligente quando são transparentes.

COLORREF m_clrTransparent;

Observações

Deve definir este valor quando exibe marcadores personalizados e bitmaps personalizados no grupo de docking.

CSmartDockingInfo::m_nCentralGroupOffset

Especifica o deslocamento entre o grupo central de marcadores de acoplamento inteligente e os limites do retângulo do grupo central.

int m_nCentralGroupOffset;

Observações

Especifique este valor se quiser alterar o deslocamento predefinido entre marcadores personalizados e os limites do grupo central de marcadores de acoplamento inteligente. O deslocamento padrão é de 5 píxeis.

CSmartDockingInfo::m_sizeTotal

Especifica o tamanho total de um retângulo delimitador que envolve todos os marcadores inteligentes de acoplamento no grupo central.

CSize m_sizeTotal;

Observações

Definido m_sizeTotal para o tamanho do retângulo delimitador do marcador central do grupo. É obrigado a especificar este valor se estiver a usar bitmaps personalizados para marcadores.

CSmartDockingInfo::m_uiMarkerBmpResID

Define os IDs dos recursos dos bitmaps usados para marcadores de acoplamento inteligente personalizados não destacados.

UINT m_uiMarkerBmpResID[AFX_SD_MARKERS_NUM];

Observações

Preencha este array com os IDs de recursos dos bitmaps que representam os marcadores de acoplamento inteligente. AFX_SD_MARKERS_NUM é atualmente definido como 5. Preenche o array da seguinte forma:

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 os IDs de recursos dos bitmaps usados para marcadores de acoplamento inteligente personalizados destacados.

UINT m_uiMarkerLightBmpResID[AFX_SD_MARKERS_NUM];

Observações

Preencha este array com os IDs de recursos dos bitmaps que representam os marcadores de acoplamento inteligente destacados. AFX_SD_MARKERS_NUM é atualmente definido como 5. Preenche o array da seguinte forma:

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;

Consulte também

Gráfico de Hierarquia
Classes
CObject Classe