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 宏封裝。

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

[in] cx

類型： int

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

[in] cy

類型： int

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

[out] phico

類型： HICON*

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

傳回值

類型： HRESULT

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

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

備註

此函式會先搜尋圖示檔案，尋找大小完全相同的圖示。 如果找不到相符專案，除非 cx 和 cy 都符合其中一個標準圖示大小，也就是 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