ClipCursor 関数 (winuser.h)

画面上の四角形の領域にカーソルを閉じ込めます。後続のカーソル位置 ( SetCursorPos 関数またはマウスによって設定) が四角形の外側にある場合、四角形領域内にカーソルを保持するように自動的に位置が調整されます。

構文

BOOL ClipCursor(
  [in, optional] const RECT *lpRect
);

[in, optional] lpRect

型: const RECT*

閉じ込める四角形の左上隅と右下隅の画面座標を含む構造体へのポインター。このパラメーターが NULL の場合、カーソルは画面上の任意の場所に自由に移動できます。

種類: BOOL

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

カーソルは共有リソースです。アプリケーションがカーソルを閉じ込める場合は、別のアプリケーションに制御を放棄する前に 、ClipCursor を 使用してカーソルを解放する必要があります。

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

例については、「カーソルの閉じ込め」を参照してください。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll