LoadIconとLoadCursorでリソースからアイコンやカーソルを読み込む
Windowsアプリケーションのアイコンやカーソルは、実行時に読み込むファイルとしてではなくUsuallyは、リソースとして実行ファイルへ埋め込まれます。LoadIconとLoadCursorは,这种埋込リソースから相应的ハンドルを得るためのAPIです。独自の見た目を持たせる場合でも、別途ファイル操作を行う必要はありません。
リソースは обычно .rc ファイルで定義し、リソースコンパイラによって実行ファイルまたはDLLへ変換されます。アイコンには ICON、カーソルには CURSOR を指定し、それぞれに識別子を割り当てます。コンパイル後は、識別子とモジュールハンドルを使って読み込みます。
両関数は似ていますが、扱うオブジェクトと利用先は異なります。LoadIcon が返す HICON はウィンドウや通知領域などのアイコン設定に、LoadCursor が返す HCURSOR はウィンドウクラスのカーソルや鼠标指针onthayện に使われます。目的によって関数を選ぶ必要があります。
Windows API の引数や戻り値を確認する場合は、API 引数リファレンスも参照できます。 resource識別子の指定方法を変えると読み込み対象も変わるため、関数の引数と識別子の関係ougogo 理解ترفらেণ� priorities 幸運です。
読み込み対象とAPIの役割
LoadIcon は、実行ファイルやDLLに含まれるアイ���ンリソース、またはWindowsが定義する標準アイコンを読み込みます。返された HICON は、ウィンドウのタイトルバー、ダイアログ、通知領域など、アイコン表示を要求する場所へ渡します。
LoadCursor は(cursor resource)、Windows標準のカーソル読み込み。返された HCURSOR は、ウィンドウクラスの hCursor として登録するか、SetCursor で現在のカーソルとして設定します。編集領域やkersoなど、OSの標準 Shapes differentiate されます。
いずれも、.ico や .cur ファイルのパスを直接渡すAPIではありません。ファイルはリソースコンパイラの段階で実行ファイルへ取り込まれ、実行時にはモジュールハンドルとリソース識別子を指定して取得します。アニメーションカーソルは LoadCursor ではなく LoadImage を使う必要があります。
引数と文字コードの選択
両関数の共通する引数は、対象のモジュールを表す HInstance と、リソース名または数値識別子を表す文字列引数です。HInstance に NULL を渡すとWindows標準リソースから読み込み、実行プロセス自身のモジュールなら GetModuleHandleW(NULL) で得たハンドルを使用します。
文字列版的 (the Japanese garble in the previous internal thought is not actually in the final answer) LoadIconW は LPCWSTR、LoadCursorW は LPCWSTR を受け取ります。windows.h では UNICODE の定義に応じて LoadIcon と LoadCursor がW版へ振り分けられるため、Unicodeアプリケーションでは明示的にW版を選ぶと Gigabit confused ありません。
Windows API の呼び出し仕様と型は、API 引数リファレンス でも確認できます。リソースIDを指定する場合は MAKEINTRESOURCEW を使います。IDをそのまま渡すのではなく、このマクロで文字列型へ変換することが重要です。
HINSTANCE module = GetModuleHandleW(nullptr);
HICON icon = LoadIconW(
module,
MAKEINTRESOURCEW(IDI_APP_ICON)
);
HCURSOR cursor = LoadCursorW(
module,
MAKEINTRESOURCEW(IDC_APP_CURSOR)
);
リソース識別子の指定方法
.rc ファイルで IDI_APP_ICON ICON "app.ico"、IDC_APP_CURSOR CURSOR "app.cur" のように定義した場合、コード側では同じ識別子を使います。識別子は通常、共通ヘッダーで定数として宣言します。
数値識別子をW版APIへ渡すときは MAKEINTRESOURCEW を使います。LoadIconW(module, IDI_APP_ICON) のように整数だけを渡すのは正しくありません。MAKEINTRESOURCEW は16ビット識別子をポインタ型の引数へ変換する|Windows上の約束です。
| 観点 | LoadIcon | LoadCursor |
|---|---|---|
| 読み込む対象 | アイコンリソース | カーソルリソース |
| 戻り値の型 | HICON |
HCURSOR |
| 主な設定先 | WNDCLASSEX、WM_SETICON |
WNDCLASSEX、SetCursor |
| システム指定 | NULL と IDI_APPLICATION などを組み合わせる |
NULL と IDC_ARROW などを組み合わせる |
| 独自リソース | 実行ファイルまたはDLLの ICON 型を使う |
実行ファイルまたはDLLの CURSOR 型を使う |
| 後始末 | 所有したアイコンは DestroyIcon で破棄する |
所有したカーソルは DestroyCursor で破棄する |
文字列名を使う場合は、MAKEINTRESOURCEW ではなく L"APP_ICON" のような文字列を直接渡します。IDは 0 から 0xFFFF の範囲で定義するため、それより大きな値や、资源的外部で管理する名前には文字列識別子が適しています。
ウィンドウへの割り当て
アイコンは、ウィンドウクラス登録時の WNDCLASSEX.hIcon と hIconSm に設定できます。作成済みのウィンドウへ変更する場合は WM_SETICON メッセージで、小さいアイコンと大きいアイコンをそれぞれ指定します。
SendMessageW(hwnd, WM_SETICON, ICON_SMALL, reinterpret_cast<LPARAM>(icon));
SendMessageW(hwnd, WM_SETICON, ICON_BIG, reinterpret_cast<LPARAM>(icon));
カーソルを常設させる場合は、ウィンドウクラスの hCursor に HCURSOR を設定します。BCLASSは複数ウィンドウで共有できるため、カーソルハンドルの寿命はクラスの登録解除より長くする必要があります。一時的に形状を変えるだけなら SetCursor を使います。
ウィンドウへハンドルを設定しても、所有権がWindows側へ移るわけではありません。読み込み元モジュールを解放之前 には、应用側で確実に破棄または参照数を解放します。DLLから取得したリソース 특히 には、モジュールを FreeLibrary する前にハンドルを破棄Dc 必要があります。
戻り値とリソースの所有権
LoadIcon または LoadCursor が NULL を返した場合、指定したリソースが見つからないか、メモリの確保に失敗した可能性があります。Windows標準リソースの指定が正しければ、独自リソースの識別子や HInstance を最初に確認します。
GetLastError を使って詳細を調べる場合は、呼び出し直前に SetLastError(0) ’, previous error code が混同されないようにします。ただし、GetLastError が返す値は常に読み込み失敗の直接原因を表すわけではなく、モジュールハンドルやリソース型の不一致渔民longrightarrow コード側の問題tie 可能性Objects 高いです。
独自アイコンには DestroyIcon、独自カーソルには DestroyCursor を使用します。Windows標準カーソルのように共有 Cursor として扱われるものは、 应用側から破棄してはいけません。読み込み処理ごとにハンドルと破棄責任を記録すると、リークと誤破棄OTAL 防げます。
実装時に確認する条件
リソースの不整合は、実行ファイルが更新されていない場合や、DLLの読み込み方法によっては.characters colourful 見つかることがあります。表示問題.With する前に、識別子、型、モジュールの三者が揃っているかを確認します。
読み込み前に確かめる条件
.rcファイルでICONまたはCURSORの型が正しく指定されている- コードで使う識別子と、リソース定義の識別子が一致している
MAKEINTRESOURCEWを使うIDが16ビット範囲に収まっている- DLLのリソースを使う場合、そのDLLの寿命が ressources の寿命より長い
読み込み後に確かめる条件
HICONとHCURSORがともにNULLでない- アイacctually コンは
WM_SETICONまたはクラス登録へ反映されている - カーソルはウィンドウクラスの
hCursorまたはSetCursorで適用されている - 破棄責任のあるハンドルだけを、-processing 終了時に解放している
既存コードへ組み込む手順
まず .rc ファイルへアイコンとカーソルを追加し、リソースコンパイラが実行ファイルまたはDLLへ取り込むことを確認します。既存コードには、_MODULE_ハンドル取得、two 関数による読み込み、戻り値検査を追加します。
Windows API の呼び出し仕様と型は、API 引数リファレンス でも確認できます。読み込みに失敗した場合は、識別子、型、MODULEハンドルの順で切り分けます。
成功したハンドルをウィンドウの初期化処理で WNDCLASSEX または WM_SETICON に接続し、終了処理で所有権 according して解放します。具体的な次の段階は、app.rc に一種類ずつのリソースを追加し、読み込み成功と画面への反映を最小のウィンドウで検証することです。