SetSystemCursor 関数 (winuser.h)

  • [アーティクル]

アプリケーションでシステム カーソルをカスタマイズできるようにします。 id パラメーターで指定されたシステム カーソルの内容を hcur パラメーターで指定されたカーソルの内容に置き換え、hcur を破棄します。

構文

BOOL SetSystemCursor(
  [in] HCURSOR hcur,
  [in] DWORD   id
);

パラメーター

[in] hcur

種類: HCURSOR

カーソルへのハンドル。 関数は、 id で指定されたシステム カーソルの内容を 、hcur によって処理されるカーソルの内容に置き換えます。

システムは DestroyCursor 関数を呼び出して hcur を破棄します。 したがって、 hcur は LoadCursor 関数を使用して読み込まれたカーソルにすることはできません。 リソースから読み込まれたカーソルを指定するには、 CopyCursor 関数を使用してカーソルをコピーし、そのコピーを SetSystemCursor に渡します。

[in] id

型: DWORD

置き換えるシステム カーソルを hcur の内容に置き換えます。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
OCR_NORMAL
32512		 通常の選択
OCR_IBEAM
32513		 テキスト選択
OCR_WAIT
32514		 ビジー
OCR_CROSS
32515		 有効桁数の選択
OCR_UP
32516		 代替選択
OCR_SIZENWSE
32642		 対角線のサイズ変更 1
OCR_SIZENESW
32643		 対角線のサイズ変更 2
OCR_SIZEWE
32644		 水平方向のサイズ変更
OCR_SIZENS
32645		 垂直方向のサイズ変更
OCR_SIZEALL
32646		 移動
OCR_NO
32648		 使用不可
OCR_HAND
32649		 リンクの選択
OCR_APPSTARTING
32650		 バックグラウンドでの作業

戻り値

種類: BOOL

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

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

解説

アプリケーションでOCR_定数のいずれかを使用するには、Windows.h ヘッダー ファイルを含める前に、定数 OEMRESOURCE を定義する必要があります。

要件

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

関連項目

概念

カーソル

DestroyCursor

LoadCursor

LoadCursorFromFile

リファレンス

SetCursor