共用方式為


LoadIconWithScaleDown 函式 (commctrl.h)

載入圖示。 如果圖示不是標準大小,此函式會縮小較大的影像,而不是相應增加較小的影像。

語法

HRESULT LoadIconWithScaleDown(
  [in]  HINSTANCE hinst,
  [in]  PCWSTR    pszName,
  [in]  int       cx,
  [in]  int       cy,
  [out] HICON     *phico
);

參數

[in] hinst

類型: HINSTANCE

包含要載入之圖示之 DLL 或可執行檔 (.exe) 檔案模組的句柄。 如需詳細資訊,請參閱 GetModuleHandle

若要載入預先定義的系統圖示或獨立圖示檔案,請將此參數設定為 NULL

[in] pszName

類型: PCWSTR

Null 終止的 Unicode 緩衝區指標,其中包含要載入之圖示的位置資訊。

如果 hinst 為非 NULL,pszName 會依名稱或序數指定圖示資源。 此序數必須使用 MAKEINTRESOURCE 宏封裝。

如果 hinstNULL,pszName 會指定要載入之預先定義系統圖示) 開頭為IDI_前置詞的標識碼 (

[in] cx

類型: int

圖示所需的寬度,以像素為單位。

[in] cy

類型: int

圖示所需的高度,以像素為單位。

[out] phico

類型: HICON*

當此函式傳回時,會包含載入之圖示句柄的指標。

傳回值

類型: HRESULT

如果成功,則傳回S_OK,否則傳回錯誤值,包括下列專案:

傳回碼 Description
E_INVALIDARG
pszName 所指向之緩衝區的內容不符合任何預期的解譯。

備註

此函式會先搜尋圖示檔案,尋找大小完全相同的圖示。 如果找不到相符專案,除非 cxcy 都符合其中一個標準圖示大小,也就是 16、32、48 或 256 像素,否則會選取下一個最大的圖示,然後向下縮放至所需的大小。 例如,如果呼叫ign 應用程式要求 x 維度為 40 像素的圖示,則會使用 48 像素圖示,並縮小為 40 圖元。 相反地, LoadImage 函式會選取 32 像素圖示,並將它調整為 40 圖元。

如果函式找不到較大的圖示,它會預設為尋找下一個最小圖標的標準行為,並將它相應增加至所需的大小。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 commctrl.h
程式庫 Comctl32.lib
Dll Comctl32.dll