次の方法で共有


CreateCursor 関数 (winuser.h)

指定したサイズ、ビット パターン、ホット スポットを持つモノクロ カーソルを作成します。

実行時に色付きカーソルを作成するには、ICONINFO 構造体の内容に基づいてカーソルを作成する CreateIconIndirect 関数を使用できます。

構文

HCURSOR CreateCursor(
  [in, optional] HINSTANCE  hInst,
  [in]           int        xHotSpot,
  [in]           int        yHotSpot,
  [in]           int        nWidth,
  [in]           int        nHeight,
  [in]           const VOID *pvANDPlane,
  [in]           const VOID *pvXORPlane
);

パラメーター

[in, optional] hInst

種類: HINSTANCE

カーソルを作成しているアプリケーションの現在のインスタンスへのハンドル。

[in] xHotSpot

型: int

カーソルのホット スポットの水平方向の位置。

[in] yHotSpot

型: int

カーソルのホット スポットの垂直方向の位置。

[in] nWidth

型: int

カーソルの幅 (ピクセル単位)。

[in] nHeight

型: int

カーソルの高さ (ピクセル単位)。

[in] pvANDPlane

型: const VOID*

モノクロ ビットマップのように、カーソルの AND マスクのビット値を含むバイト配列。 「解説」を参照してください。

[in] pvXORPlane

型: const VOID*

モノクロ ビットマップのように、カーソルの XOR マスクのビット値を含むバイト配列。 「解説」を参照してください。

戻り値

型: HCURSOR

関数が成功した場合、戻り値はカーソルへのハンドルです。

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

解説

カーソルの名目サイズを確認するには、 GetSystemMetrics 関数を使用して、 SM_CXCURSOR または SM_CYCURSOR 値を指定します。 また、この API の DPI 対応バージョンを使用することもできます。(GetSystemMetricsForDpi)(/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi) を参照してください。 詳細については、「 Windows での高 DPI デスクトップ アプリケーション開発」を参照してください。

pvANDPlane パラメーターと pvXORPlane パラメーターの詳細については、「CreateBitmap 関数の lpBits パラメーターの説明」を参照してください。

CreateCursor では 、AND ビットマスクと XOR ビットマスクに次の真理値テーブルが適用されます。

AND ビットマスク XOR ビットマスク 表示
0 0 Black
0 1 White
1 0 Screen
1 1 画面の反転

終了する前に、アプリケーションで DestroyCursor 関数を呼び出して、カーソルに関連付けられているシステム リソースを解放する必要があります。

DPI 仮想化

この API は、DPI 仮想化には参加しません。 返される出力は物理座標の観点からであり、呼び出し元スレッドの DPI の影響を受けません。 作成されたカーソルは、描画先の特定のウィンドウの DPI と一致するようにスケーリングされる場合があることに注意してください。

例については、「 カーソルの作成」を参照してください。

要件

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

こちらもご覧ください

CreateIcon

CreateIconIndirect

DestroyCursor

GetSystemMetrics

SetCursor

カーソル