次の方法で共有

CreateCursor 関数 (winuser.h)

  • [アーティクル]

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

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

構文

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呼び出します。

備考

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

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

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

AND ビットマスク XOR ビットマスク 陳列
0 0 黒い
0 1 白い
1 0 スクリーン
1 1 画面の反転

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

DPI 仮想化

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

例

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winuser.h (Windows.h を含む)
ライブラリ User32.lib
DLL User32.dll

関連項目

CreateIcon の

CreateIconIndirect の

DestroyCursor を する

GetSystemMetrics の

SetCursor の

カーソル