LoadIcon(),載入系統圖標說明
阿新 • • 發佈:2019-02-10
最近需要在對話方塊(CDialog)上任意位置繪製系統圖標,搜尋一遍後,最後在MSDN上找到了方法,MSDN原文地址
//////////////////////////////////////////////////// 以下為譯文 //////////////////////////////////////////////////////////////////
函式說明
從與程式(application)例項相關聯的可執行檔案(.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) | 預設程式圖示, Win2000:Windows logo圖示 |
返回值
型別:HICON
如果函式呼叫成功,返回新載入的圖示控制代碼。
如果函式呼叫失敗,返回值為NULL,要得到更詳細的錯誤資訊,呼叫GetLastError()
備註
只有當圖示未被載入,LoadIcon才會進行載入;否則,該API將找到並返回已經存在的資源控制代碼。該API搜尋圖示對應的最適合當前顯示環境的圖示資源。圖示資源可以是單色bitmap。 該API只能載入尺寸適合 SM_CXICON和SM_CYICON系統值的圖示。可以使用LoadImage載入其他尺寸的圖示。