Skip to main content

IGameInputReading::GetMouseState

Recupera uma exibição da leitura de entrada que descreve o estado de um mouse.

Sintaxe

Parâmetros

state   _Out_
Tipo: GameInputMouseState*
Interpretação da entrada como um mouse.

Valor retornado

Tipo: bool Retorna true quando uma entrada de mouse é interpretada com êxito. Retorna false ao tentar ler uma entrada que não é reconhecida como uma entrada de mouse.

Comentários

Chame o método IGameInputReading::GetInputKind para ver quais funções Get*State retornarão uma interpretação válida para determinada IGameInputReading. Cada função Get*State tem uma entrada correspondente na enumeração IGameInputReading::GetInputKind. Se você tentar chamar uma função Get*State cujo sinalizador correspondente de IGameInputReading::GetInputKind não esteja definido, a função retornará valores padrão de repouso, além de um valor retornado false. O movimento do mouse é relatado nativamente pelo dispositivo como valores delta relativos e/ou valores absolutos, dependendo dos recursos do dispositivo. Posições relativas não são muito compatíveis com uma API de sondagem, porque solicitar periodicamente a leitura atual do mouse provavelmente fará perder vários deltas intermediários. Em vez de forçar os aplicativos que usam as APIs de sondagem a percorrer potencialmente dezenas de leituras históricas do mouse e somar os deltas, a API GameInput expõe o movimento relativo do mouse acumulando continuamente os deltas em um valor virtual de “posição”. Os aplicativos então calculam seus próprios deltas subtraindo o valor de “posição” da leitura anterior que obtiveram. Isso permite acessar deltas individuais quando calculados para leituras consecutivas, ou deltas acumulados quando leituras intermediárias foram ignoradas intencionalmente. Vale ressaltar que o valor de “posição” do mouse é apenas a soma de todos os deltas de movimento e não tem nenhuma correlação com coordenadas do espaço da tela.

Requisitos

Cabeçalho: GameInput.h Visão geral da API de entrada
IGameInputReading

Histórico de versões

Last modified on October 6, 2026