Estrutura TRACKMOUSEEVENT (winuser.h)

  • Artigo

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
TME_CANCEL
0x80000000
 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 .
TME_HOVER
0x00000001
 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.
TME_LEAVE
0x00000002
 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.
TME_NONCLIENT
0x00000010
 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 .
TME_QUERY
0x40000000
 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)

Confira também

Entrada por mouse