LoadCursorFromFileA 関数 (winuser.h)

ファイルに含まれるデータに基づいてカーソルを作成します。

手記

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

構文

HCURSOR LoadCursorFromFileA(
  [in] LPCSTR lpFileName
);

パラメーター

[in] lpFileName

型: LPCTSTR

カーソルの作成に使用するファイル データのソース。 ファイル内のデータは、次のいずれかである必要があります。CUR または .ANI 形式。

lpFileName の上位ワード 0 以外の場合は、カーソル データを含むファイルの完全修飾名である文字列へのポインターです。

戻り値

型: HCURSOR

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

関数が失敗した場合、戻り値は NULL。 拡張エラー情報を取得するには、GetLastError呼び出します。 GetLastError は、次の値を返す場合があります。

リターン コード	形容
ERROR_FILE_NOT_FOUND	指定したファイルが見つかりません。

備考

DPI 仮想化

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

手記

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

必要条件

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

関連項目

概念

カーソル

LoadCursor

リファレンス

SetCursor の

SetSystemCursor の