CDockablePane::GetDockingStatus
Determina a capacidade de um painel de ser encaixada fornecido com base no local do ponteiro.
virtual AFX_CS_STATUS GetDockingStatus(
CPoint pt,
int nSensitivity
);
Parâmetros
[in] pt
O local do ponteiro na tela coordena.[in] nSensitivity
A distância, em pixels, fora da borda de um retângulo o ponteiro deve ser ativar o encaixe.
Valor de retorno
Um dos seguintes valores de status:
Valor deAFX_CS_STATUS |
Significado |
|---|---|
CS_NOTHING |
O ponteiro não está sobre um site da plataforma.A estrutura não entram no painel. |
CS_DOCK_IMMEDIATELY |
O ponteiro está localizado no site da plataforma no modo imediato (painel que usa DT_IMMEDIATE entra no modo).A estrutura entra no painel imediatamente. |
CS_DELAY_DOCK |
O ponteiro está sobre um site da plataforma que é outro painel de encaixe ou é uma borda de quadro chave.A estrutura entra no painel após um atraso.Consulte a seção comentários para obter mais informações sobre este atraso. |
CS_DELAY_DOCK_TO_TAB |
O ponteiro está localizado em um site da plataforma que faz com que o painel a ser inserido em uma janela com guias.Isso ocorre quando o ponteiro é colocado sobre a legenda de outro painel de encaixe ou na área de tabulação um painel com guias. |
Comentários
A estrutura chama esse método para manipular o encaixe de um painel flutuante.
Para barras de ferramentas ou painéis flutuante do encaixe que usam DT_IMMEDIATE que insere o modo, a estrutura atrasa o comando da plataforma permitir que o usuário para mover a janela fora da área cliente do quadro pai antes de inserir ocorra.O comprimento do atraso é medido em milissegundos e controlado pelo membro de dados de CDockingManager::m_nTimeOutBeforeToolBarDock .O valor padrão para CDockingManager::m_nTimeOutBeforeToolBarDock é 200.Esse comportamento emula o comportamento de encaixe de Microsoft Word 2007.
Para tarde entre estados (CS_DELAY_DOCK e CS_DELAY_DOCK_TO_TAB), a estrutura não executa o encaixe até que o usuário libere o botão do mouse.Se um painel que usa DT_STANDARD entra no modo, a estrutura exibe um retângulo no local de encaixe projetada.Se um painel que usa DT_SMART entra no modo, a estrutura exibir marcadores inteligentes de encaixe retângulos semi-transparentes no e local de encaixe projetada.Para especificar o modo de encaixe para o painel, chame o método de CBasePane::SetDockingMode .Para obter mais informações sobre o encaixe inteligente, consulte CDockingManager::GetSmartDockingParams.
Requisitos
Cabeçalho: afxdockablepane.h