> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GameInputMouseState

> GameInputMouseState

# GameInputMouseState

Descreve o estado de um mouse.

## Sintaxe

```cpp theme={null}
struct GameInputMouseState
{
    GameInputMouseButtons   buttons;
    GameInputMousePositions positions;
    int64_t                 positionX;
    int64_t                 positionY;
    int64_t                 absolutePositionX;
    int64_t                 absolutePositionY;
    int64_t                 wheelX;
    int64_t                 wheelY;
};
```

### Membros

*buttons*\

Tipo: [GameInputMouseButtons](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputmousebuttons.md)

Estado dos botões do mouse.

*positionFlags*\

Tipo: [GameInputMousePosition](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameInputmousepositions.md)

Estado das posições do mouse.

*positionX*\

Tipo: int64\_t

Alteração cumulativa no eixo x da posição do mouse.

*positionY*\

Tipo: int64\_t

Alteração cumulativa no eixo y da posição do mouse.

*absolutePositionX*\

Tipo: int64\_t

Posição absoluta do mouse no eixo x.

*absolutePositionY*\

Tipo: int64\_t

Posição absoluta do mouse no eixo y.

*wheelX*\

Tipo: int64\_t

Alteração cumulativa na roda de rolagem do eixo x.

*wheelY*\

Tipo: int64\_t

Alteração cumulativa na roda de rolagem do eixo y.

## Comentários

Essa estrutura é usada pelo método [IGameInputReading::GetMouseState](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getmousestate.md).

Os movimentos do mouse e da roda de rolagem não são relatados como posições absolutas. Calcule os deltas subtraindo os valores da leitura atual dos valores da leitura anterior.

O GameInput apresentará todos os dispositivos de trackpad disponíveis como um único dispositivo de mouse virtual.

Para obter mais informações, confira [Leituras do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-readings.md).

## Requisitos

**Cabeçalho:** GameInput.h

**Plataformas compatíveis:** Windows, consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Teclado e mouse no GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/advanced/input-keyboard-mouse.md)

## Confira também

[Visão geral do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-overview.md)\
[GameInput](https://docs.xbox.com/pt-BR/reference/input/gameinput/gameinput_members.md)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v1** | **Adicionados** os campos `positions` (bitmask GameInputMousePositions) e `absolutePositionX`/`absolutePositionY`. |
| **v0** | Introduzido. |

## Apêndice: versões anteriores

### v0

```cpp theme={null}
struct GameInputMouseState
{
    GameInputMouseButtons buttons;
    int64_t               positionX;
    int64_t               positionY;
    int64_t               wheelX;
    int64_t               wheelY;
};
```


## Related topics

- [GetMouseState](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getmousestate.md)
- [Teclado e mouse do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/advanced/input-keyboard-mouse.md)
- [GameInputMousePositions](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameInputmousepositions.md)
- [GameInputMouseButtons](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputmousebuttons.md)
- [Membros da API do GameInput](https://docs.xbox.com/pt-BR/reference/input/gameinput/gameinput_members.md)