目次 - API(機能別) - マウス - SDL_GetGlobalMouseState

# SDL_GetGlobalMouseState

マウスのデスクトップからの座標を得る

## 構文

`Uint32 SDL_GetGlobalMouseState(int* x, int* y)`

## 引数

x | 現在のデスクトップからのX座標を代入するポインタ. NULLも可能
y | 現在のデスクトップからのY座標を代入するポインタ. NULLも可能

## 戻り値

ボタンの状態をSDL_BUTTON(X)マクロでテストできるビットマスクで戻す.

## 詳細

これはSDL_GetMouseState()と同じような働きをする. しかし, デスクトップの左上からの相対座標が報告される. これは, ウィンドウの外のマウスを追跡する必要があるが, SDL_CaptureMouse()が適さないときに有用である. 例えば, ウィンドウをドラッグしている最中にマウスを追跡する必要がある場合, そのウィンドウからの相対座標は常に同期しているとは限らないため, この関数が有用であろう.

注意: SDL_GetMouseState()はSDLのイベントキューから最後に得たマウスの座標を戻す.しかし, この関数はOSに現在のマウスの位置を問い合わせる. それゆえにこの関数はあまり効率的でない. 自分が何をしているのかわかっていて, この関数を使わなければならない理由がない限り, 代わりにSDL_GetMouseState()を使うほうがよいだろう.

## バージョン

SDL 2.0.4以降

## 関連項目(関数)

SDL_CaptureMouse

## SDL Wikiへのリンク

SDL_GetGlobalMouseState - SDL Wiki