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

関連項目

概念

カーソル

カーソルの作成

CreateCursor

CreateIconIndirect

GetCursor

GetSystemMetrics

LoadCursor

Loadimage

リファレンス

SetCursorPos

ShowCursor