Skip to main content

IGameInputReading::GetMouseState

Recupera una vista de la lectura de entrada que describe el estado de un mouse.

Sintaxis

Parámetros

state   _Out_
Tipo: GameInputMouseState*
Interpretación de la entrada como un mouse.

Valor devuelto

Tipo: bool Devuelve true si la interpretación como entrada de mouse se realiza correctamente. Devuelve false cuando se intenta leer una entrada que no se reconoce como una entrada de mouse.

Comentarios

Llame al método IGameInputReading::GetInputKind para ver qué funciones Get*State devolverán una interpretación válida para una determinada IGameInputReading. Cada función Get*State tiene una entrada correspondiente en la enumeración IGameInputReading::GetInputKind. Si intenta llamar a una función Get*State cuya marca correspondiente de IGameInputReading::GetInputKind no está establecida, la función devolverá los valores predeterminados de reposo, así como un valor devuelto false. El movimiento del mouse se notifica de forma nativa desde el dispositivo como valores delta relativos o valores absolutos, según las funcionalidades del dispositivo. Las posiciones relativas no son muy compatibles con una API de sondeo, porque preguntar periódicamente por la lectura actual del mouse probablemente omita varios deltas intermedios. En lugar de obligar a las aplicaciones que usan las API de sondeo a recorrer potencialmente docenas de lecturas históricas del mouse y sumar los deltas, la API de GameInput expone el movimiento relativo del mouse mediante la acumulación continua de deltas en un valor de “posición” virtual. Las aplicaciones calculan entonces sus propios deltas restando el valor de “posición” de la lectura anterior que obtuvieron. Esto permite el acceso a deltas individuales cuando se calculan para lecturas consecutivas, o a deltas acumulados cuando se han omitido intencionadamente lecturas intermedias. Cabe destacar que el valor de “posición” del mouse es simplemente la suma de todos los deltas de movimiento y no se correlaciona de ningún modo con las coordenadas del espacio de pantalla.

Requisitos

Encabezado: GameInput.h Información general de la API de entrada
IGameInputReading

Historial de versiones

Última modificación el 28 de agosto de 2026