LoadIcon()、ロードシステムアイコンの説明
最近、ダイアログボックス(CDialog)上の任意の位置にシステムアイコンを描画する必要があります.
以下は訳文//
関数の説明
プログラムインスタンスに関連付けられた実行可能ファイル(.exe)から特定のアイコンリソースをロードします.なお、この関数はLoadImage関数に置き換えられています.
構文
パラメータ
hInstance[入参、オプション]
タイプ:HINSTANCE
説明:ロードされるアイコンを含むモジュールインスタンスのハンドルです.システムアイコンがロードされている場合、このパラメータはNULLでなければなりません.
lpIconName[入参]
タイプ:LPCTSTR
説明:ロードするアイコンリソースの名前.あるいは、このパラメータは低バイトにリソースフラグを含み、高バイトは0に設定されます.MAKEINTRESOURCEマクロを使用して値を作成
システムアイコンを使用する場合は、hInstanceをNULLに設定し、lpIconNameを次のいずれかのパラメータに設定します.
Value
意味
IDI_APPLICATION MAKEINTRESOURCE(32512)
デフォルトのプログラムアイコン
IDI_ASTERISK MAKEINTRESOURCE(32516)
Asteriskアイコン、IDI_INFORMATION同様
IDI_ERROR MAKEINTRESOURCE(32513)
Hand-shapedアイコン
IDI_EXCLAMATION MAKEINTRESOURCE(32515)
感嘆符アイコン、IDI_WARNING同様
IDI_HAND MAKEINTRESOURCE(32513)
Hand-shapedアイコン、IDI_ERROR同様
IDI_INFORMATION MAKEINTRESOURCE(32516)
Asteriskアイコン
IDI_QUESTION MAKEINTRESOURCE(32514)
疑問符アイコン
IDI_SHIELD MAKEINTRESOURCE(32518)
傘のアイコン
IDI_WARNING MAKEINTRESOURCE(32515)
感嘆符アイコン
IDI_WINLOGO MAKEINTRESOURCE(32517)
デフォルトのプログラムアイコン、Win 2000:Windows logoアイコン
戻り値
タイプ:HICON
関数呼び出しに成功した場合は、新しくロードされたアイコンハンドルを返します.
関数呼び出しに失敗した場合、NULLの値が返され、より詳細なエラー情報が得られるようにGetLastError()が呼び出されます.
コメント
LoadIconは、アイコンがロードされていない場合にのみロードされます.そうでない場合、APIはすでに存在するリソースハンドルを見つけて返します.このAPIは、現在の表示環境に最も適したアイコンリソースを検索する.アイコンリソースは、単色bitmapであってもよい.
このAPIはSM_に適合するサイズしかロードできないCXICONとSM_CYICONシステム値のアイコン.LoadImageを使用して、他のサイズのアイコンをロードできます.
以下は訳文//
関数の説明
プログラムインスタンスに関連付けられた実行可能ファイル(.exe)から特定のアイコンリソースをロードします.なお、この関数はLoadImage関数に置き換えられています.
構文
HICON WINAPI LoadIcon(
_In_opt_ HINSTANCE hInstance,
_In_ LPCTSTR lpIconName
);パラメータ
hInstance[入参、オプション]
タイプ:HINSTANCE
説明:ロードされるアイコンを含むモジュールインスタンスのハンドルです.システムアイコンがロードされている場合、このパラメータはNULLでなければなりません.
lpIconName[入参]
タイプ:LPCTSTR
説明:ロードするアイコンリソースの名前.あるいは、このパラメータは低バイトにリソースフラグを含み、高バイトは0に設定されます.MAKEINTRESOURCEマクロを使用して値を作成
システムアイコンを使用する場合は、hInstanceをNULLに設定し、lpIconNameを次のいずれかのパラメータに設定します.
Value
意味
IDI_APPLICATION MAKEINTRESOURCE(32512)
デフォルトのプログラムアイコン
IDI_ASTERISK MAKEINTRESOURCE(32516)
Asteriskアイコン、IDI_INFORMATION同様
IDI_ERROR MAKEINTRESOURCE(32513)
Hand-shapedアイコン
IDI_EXCLAMATION MAKEINTRESOURCE(32515)
感嘆符アイコン、IDI_WARNING同様
IDI_HAND MAKEINTRESOURCE(32513)
Hand-shapedアイコン、IDI_ERROR同様
IDI_INFORMATION MAKEINTRESOURCE(32516)
Asteriskアイコン
IDI_QUESTION MAKEINTRESOURCE(32514)
疑問符アイコン
IDI_SHIELD MAKEINTRESOURCE(32518)
傘のアイコン
IDI_WARNING MAKEINTRESOURCE(32515)
感嘆符アイコン
IDI_WINLOGO MAKEINTRESOURCE(32517)
デフォルトのプログラムアイコン、Win 2000:Windows logoアイコン
戻り値
タイプ:HICON
関数呼び出しに成功した場合は、新しくロードされたアイコンハンドルを返します.
関数呼び出しに失敗した場合、NULLの値が返され、より詳細なエラー情報が得られるようにGetLastError()が呼び出されます.
コメント
LoadIconは、アイコンがロードされていない場合にのみロードされます.そうでない場合、APIはすでに存在するリソースハンドルを見つけて返します.このAPIは、現在の表示環境に最も適したアイコンリソースを検索する.アイコンリソースは、単色bitmapであってもよい.
このAPIはSM_に適合するサイズしかロードできないCXICONとSM_CYICONシステム値のアイコン.LoadImageを使用して、他のサイズのアイコンをロードできます.