CDockablePane::GetDockingStatus
Determina a capacidade de um painel para ser encaixado com base no local do ponteiro fornecido.
virtual AFX_CS_STATUS GetDockingStatus(
CPoint pt,
int nSensitivity
);
Parâmetros
[in] pt
O local do ponteiro nas coordenadas da tela.[in] nSensitivity
A distância em pixels, distante da borda de um retângulo, o ponteiro deve estar ativar o encaixe.
Valor de retorno
Um dos seguintes valores de status:
AFX_CS_STATUS valor |
Significado |
|---|---|
CS_NOTHING |
O ponteiro não está em um site de encaixar.O estrutura não encaixar o painel. |
CS_DOCK_IMMEDIATELY |
O ponteiro estiver localizado em site encaixar no modo imediato (o painel usa o DT_IMMEDIATE modo de encaixar). A estrutura encaixa o painel imediatamente. |
CS_DELAY_DOCK |
O ponteiro está sobre um site de encaixar que seja outro painel encaixar ou uma borda do quadro principal.A estrutura encaixa o painel após um atraso.Consulte a seção de comentários para obter mais informações sobre esse atraso. |
CS_DELAY_DOCK_TO_TAB |
O ponteiro estiver localizado em um site de encaixar que faz com que o painel para ser encaixado em uma janela com abas.Isso ocorre quando o ponteiro está localizado sobre a legenda de outro painel encaixe ou na área de guia de um painel com guias. |
Comentários
A estrutura chama esse método para manipular o encaixe de um painel flutuante.
Para barras de ferramentas flutuante ou encaixando painéis que usam o DT_IMMEDIATE modo de encaixe, a estrutura atrasa o comando Encaixar para permitir que o usuário mover a janela fora da área de cliente do quadro pai antes de o encaixe ocorre. O período de atraso é medido em milissegundos e é controlado pelo CDockingManager::m_nTimeOutBeforeToolBarDock membro de dados O valor padrão para CDockingManager::m_nTimeOutBeforeToolBarDock é 200.Esse comportamento emula o comportamento de encaixe de Microsoft Word 2007.
Para atrasar encaixe estados (CS_DELAY_DOCK e CS_DELAY_DOCK_TO_TAB), a estrutura não realiza o encaixe até que o usuário libera o botão do mouse. Se um painel usa o DT_STANDARD modo de encaixe, a estrutura exibe um retângulo no local de encaixe projetado. Se um painel usa o DT_SMART modo de encaixe, exibe a estrutura SMART encaixe marcadores e retângulos semi-transparente no local de encaixe projetado. Para especificar o modo de encaixe para seu painel, telefonar o CBasePane::SetDockingMode método. Para obter mais informações sobre encaixe inteligentes, consulte CDockingManager::GetSmartDockingParams.
Requisitos
Cabeçalho: afxdockablepane.h