GetCursorPos 関数 (winuser.h)

[アーティクル]
03/13/2024

マウスカーソルの位置を画面座標で取得します。

構文

BOOL GetCursorPos(
  [out] LPPOINT lpPoint
);

パラメーター

[out] lpPoint

種類: LPPOINT

カーソルの画面座標を受け取る POINT 構造体へのポインター。

戻り値

種類: BOOL

成功した場合は 0 以外、それ以外の場合は 0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

カーソル位置は常に画面座標で指定され、カーソルを含むウィンドウのマッピングモードの影響を受けられません。

呼び出し元プロセスには、ウィンドウステーションへの WINSTA_READATTRIBUTES アクセス権が必要です。

GetCursorPos を呼び出すときは、入力デスクトップが現在のデスクトップである必要があります。 OpenInputDesktop を呼び出して、現在のデスクトップが入力デスクトップであるかどうかを判断します。そうでない場合は、 OpenInputDesktop によって返された HDESK を使用して SetThreadDesktop を呼び出して、そのデスクトップに切り替えます。

例

例については、「キーボードを使用してカーソルを移動する」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-window-l1-1-2 (Windows 10 バージョン 10.0.10240 で導入)