1. 程式人生 > >LoadIcon(),載入系統圖標說明

LoadIcon(),載入系統圖標說明

最近需要在對話方塊(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載入其他尺寸的圖示。