LoadCursorA 関数 (winuser.h)

  • [アーティクル]

アプリケーション インスタンスに関連付けられている実行可能ファイル (.EXE) から、指定したカーソル リソースを読み込みます。

注意

この関数は LoadImage 関数に置き換わりました ( LR_DEFAULTSIZE フラグと LR_SHARED フラグが設定されています)。

構文

HCURSOR LoadCursorA(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCSTR    lpCursorName
);

パラメーター

[in, optional] hInstance

種類: HINSTANCE

読み込まれるカーソルを含む DLL または実行可能ファイル (.exe) のいずれかのモジュールへのハンドル。 詳細については、「 GetModuleHandle」を参照してください。

定義済みのシステム カーソルを読み込むには、このパラメーターを NULL に設定 します。

[in] lpCursorName

型: LPCTSTR

hInstance が NULL 以外の場合、lpCursorName はカーソル リソースを名前または序数で指定します。 この序数は 、MAKEINTRESOURCE マクロを使用してパッケージ化する必要があります。

hInstance が NULL の場合、lpCursorName は、読み込む定義済みのシステム カーソルの識別子 (IDC_ プレフィックスで始まる) を指定します。

戻り値

種類: HCURSOR

関数が成功した場合、戻り値は新しく読み込まれたカーソルへのハンドルです。

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

解説

LoadCursor 関数は、読み込まれていない場合にのみカーソル リソースを読み込みます。それ以外の場合は、既存のリソースへのハンドルを取得します。 この関数は、 lpCursorName パラメーターがカーソル リソースへのポインターである場合にのみ、有効なカーソル ハンドルを返します。 lpCursorName がカーソル以外の任意の種類のリソース (アイコンなど) へのポインターである場合、有効なカーソル ハンドルではない場合でも、戻り値は NULL ではありません。

LoadCursor 関数は、現在のディスプレイ デバイスのカーソルに最も適したカーソル リソースを検索します。 カーソル リソースには、カラー ビットマップまたはモノクロ ビットマップを指定できます。

DPI 仮想化

この API は DPI 仮想化には参加しません。 返される出力は、呼び出し元スレッドの DPI の影響を受けません。

例

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

注意

winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして LoadCursor を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

関連項目

概念

カーソル

Loadimage

MAKEINTRESOURCE

IS_INTRESOURCE

リファレンス

SetCursor

SetCursorPos

ShowCursor