GetMouseMovePoints

[Esta é a documentação preliminar e estão sujeitos a alterações.]

A função GetMouseMovePoints recupera um histórico de até 64 coordenadas anteriores de mouse ou caneta.

int (GetMouseMovePoints UINTcbSize / /  tamanho da estrutura MOUSEMOVEPOINTLPMOUSEMOVEPOINTLPPT, / / ponteiro para atual do mouse Mover pontoLPMOUSEMOVEPOINTlpptBuf, / / buffer para armazenar os pontos int nBufPoints, / / quantos pontos o buffer pode armazenarDWORDresolução  / / resolução dos pontos);
 

Parâmetros

cbSize
Tamanho da estrutura MOUSEMOVEPOINT.
lppt
Ponteiro para uma estrutura MOUSEMOVEPOINT que contém as coordenadas do mouse válido (em coordenadas da tela). Ele também pode conter um carimbo de data / hora.

A função GetMouseMovePoints procura o ponto da história de coordenadas do mouse. Se a função localiza o ponto, ele retorna o último nBufPoints antes e incluindo o fornecido point.

Se seu aplicativo fornece um carimbo de tempo, a função GetMouseMovePoints usá-lo para diferenciar entre dois pontos iguais que foram gravados em momentos diferentes.

Um aplicativo deve chamar esta função usando as coordenadas de mouse recebidas a mensagem WM_MOUSEMOVE e convertê-los em coordenadas da tela.

lpptBuf
Ponteiro para um buffer que receberá os pontos. Deve ser pelo menos cbSize*nBuffPoints em tamanho.
nBufPoints
Especifica o número de pontos para recuperar.
resolução
Especifica a resolução desejada. Este parâmetro pode ser uma dos seguinte valores.
Valor Significado
GMMP_USE_DISPLAY_POINTS Recupera os pontos usando a resolução de vídeo.
GMMP_USE_DRIVER_POINTS Recupera os pontos usando a resolução do driver. A plataforma Windows CE suporta pen drivers com uma resolução muito maior do que a resolução do monitor. Neste caso, GetMouseMovePoints pode ser usado por aplicativos (como software de reconhecimento de escrita manual ou software de desenho assistido por computador) que precisam de uma resolução muito mais precisa.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é o número de pontos no buffer. Caso contrário, a função retorna – 1. Para obter informações de erro estendidas, seu aplicativo pode chamar GetLastError. O GetLastError função pode retornar o seguinte código de erro.

Valor Significado
GMMP_ERR_POINT_NOT_FOUND O apontar especificado por lppt não é pôde ser encontrado ou não está mais no buffer de sistema.

Observações

O sistema mantém as coordenadas de mouse última 64 e seus carimbos de hora. Se seu material de aplicação a coordenada do mouse para GetMouseMovePoints e a coordenar existe no mouse do sistema coordenar a história, a função recupera o número especificado de coordenadas de história dos sistemas. Você também pode fornecer um carimbo de hora, que será usado para diferenciar entre pontos idênticos na história.

A função GetMouseMovePoints retornará pontos que eventualmente foram despachados para o thread de chamada, mas também para outros segmentos.

QuickInfo

nbsp; Windows &NT: requer versão 5.0 ou posterior.
Windows:Requer o Windows 98.
Windows CE:Requer a versão 2.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral da entrada do Mouse, Mouse entrada funções, MOUSEMOVEPOINT

Index