Estrutura TRACKMOUSEEVENT (winuser.h)
Usada pela função TrackMouseEvent para acompanhar quando o ponteiro do mouse sai de uma janela ou passa o mouse sobre uma janela por um período especificado.
Sintaxe
typedef struct tagTRACKMOUSEEVENT {
DWORD cbSize;
DWORD dwFlags;
HWND hwndTrack;
DWORD dwHoverTime;
} TRACKMOUSEEVENT, *LPTRACKMOUSEEVENT;
Membros
cbSize
Tipo: DWORD
O tamanho da estrutura TRACKMOUSEEVENT , em bytes.
dwFlags
Tipo: DWORD
Os serviços solicitados. Esse membro pode ser uma combinação dos valores a seguir.
| Valor | Significado |
|---|---|
|
O chamador deseja cancelar uma solicitação de acompanhamento anterior. O chamador também deve especificar o tipo de acompanhamento que deseja cancelar. Por exemplo, para cancelar o rastreamento de foco, o chamador deve passar os sinalizadores TME_CANCEL e TME_HOVER . |
|
O chamador deseja a notificação de foco. A notificação é entregue como uma mensagem WM_MOUSEHOVER .
Se o chamador solicitar o controle de foco enquanto o rastreamento de foco já estiver ativo, o temporizador de foco será redefinido. Esse sinalizador será ignorado se o ponteiro do mouse não estiver sobre a janela ou área especificada. |
|
O chamador deseja sair da notificação. A notificação é entregue como uma mensagem WM_MOUSELEAVE . Se o mouse não estiver sobre a janela ou área especificada, uma notificação de licença será gerada imediatamente e nenhum acompanhamento adicional será executado. |
|
O chamador deseja passar o mouse e deixar a notificação para as áreas não cliente. A notificação é entregue como mensagens WM_NCMOUSEHOVER e WM_NCMOUSELEAVE . |
|
A função preenche a estrutura em vez de tratá-la como uma solicitação de acompanhamento. A estrutura é preenchida de modo que, se essa estrutura tivesse sido passada para TrackMouseEvent, geraria o acompanhamento atual. A única anomalia é que o tempo limite de foco retornado é sempre o tempo limite real e não HOVER_DEFAULT, se HOVER_DEFAULT foi especificado durante a solicitação TrackMouseEvent original. |
hwndTrack
Digite: HWND
Um identificador para a janela a ser rastreada.
dwHoverTime
Tipo: DWORD
O tempo limite de foco (se TME_HOVER foi especificado em dwFlags), em milissegundos. Pode ser HOVER_DEFAULT, o que significa usar o tempo limite de foco padrão do sistema.
Comentários
O tempo limite de foco padrão do sistema é inicialmente o tempo suspenso do menu, que é de 400 milissegundos. Você pode chamar SystemParametersInfo e usar SPI_GETMOUSEHOVERTIME para recuperar o tempo limite de foco padrão.
O retângulo de foco padrão do sistema é o mesmo que o retângulo de clique duplo. Você pode chamar SystemParametersInfo e usar SPI_GETMOUSEHOVERWIDTH e SPI_GETMOUSEHOVERHEIGHT para recuperar o tamanho do retângulo no qual o ponteiro do mouse deve permanecer para TrackMouseEvent gerar uma mensagem de WM_MOUSEHOVER .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | winuser.h (inclua Windows.h) |