SetCursor 関数 (winuser.h)
カーソルの図形を設定します。
構文
HCURSOR SetCursor(
[in, optional] HCURSOR hCursor
);
パラメーター
[in, optional] hCursor
型: HCURSOR
カーソルへのハンドル。
カーソルは 、CreateCursor 関数または CreateIconIndirect 関数によって作成されているか、 LoadCursor または LoadImage 関数によって読み込まれている必要があります。
このパラメーターが NULL の場合、カーソルは画面から削除されます。
戻り値
型: HCURSOR
戻り値は、前のカーソルへのハンドル (存在する場合) です。
前のカーソルがなかった場合、戻り値は NULL です。
注釈
カーソルは、新しいカーソルが前のカーソルと異なる場合にのみ設定されます。それ以外の場合、関数は直ちにを返します。
カーソルは共有リソースです。 ウィンドウは、カーソルがクライアント領域にある場合、またはウィンドウがマウス入力をキャプチャしている場合にのみ、カーソルの形状を設定する必要があります。 マウスのないシステムでは、カーソルがクライアント領域から離れる前、または別のウィンドウに制御を放棄する前に、ウィンドウが前のカーソルを復元する必要があります。
アプリケーションがウィンドウ内にある間にカーソルを設定する必要がある場合は、指定したウィンドウのクラスのクラス カーソルが NULL に設定されていることを確認 します。 クラス カーソルが NULL でない場合、マウスが移動されるたびにクラス カーソルが復元されます。
内部カーソル表示数が 0 未満の場合、カーソルは画面に表示されません。 これは、アプリケーションで ShowCursor 関数を使用してカーソルを非表示にする回数が、カーソルを表示する回数よりも多い場合に発生します。
例
例については、「 カーソルの表示」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |
関連項目
概念
リファレンス