LookupIconIdFromDirectory 函式 (winuser.h)

發行項
03/04/2024

針對最適合目前顯示裝置的圖示或游標，搜尋圖示 ( () RT_GROUP_ICON 或游標 (RT_GROUP_CURSOR) 資源數據。

若要指定所需的高度或寬度，請使用 LookupIconIdFromDirectoryEx函式。此函式會藉由在 cxDesiredcyDesired/ 參數中傳遞零來呼叫它。

語法

int LookupIconIdFromDirectory(
  [in] PBYTE presbits,
  [in] BOOL  fIcon
);

參數

[in] presbits

類型： PBYTE

圖示或數據指標目錄數據。由於此函式不會驗證資源數據，因此會導致一般保護 (GP) 錯誤，如果 presbits 未指向有效的資源數據，則會傳回未定義的值。

[in] fIcon

類型： BOOL

指出是否要搜尋圖示或游標。如果此參數為 TRUE，函式會搜尋圖示;如果參數為 FALSE，則函式會搜尋數據指標。

傳回值

類型： int

如果函式成功，則傳回值是圖示的整數資源標識碼， (RT_ICON) 或 游標 (RT_CURSOR 最符合目前顯示裝置) 。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

類型為 RT_GROUP_ICON (的資源檔RT_GROUP_CURSOR表示數據指標) 包含數個裝置相依和裝置無關格式的圖示 (或數據指標) 數據。 LookupIconIdFromDirectory 會搜尋資源文件，尋找最符合目前顯示裝置的圖示 (或游標) ，並傳回其整數標識符。 FindResource 和 FindResourceEx 函式會使用此識別符的 MAKEINTRESOURCE 宏來尋找模組中的資源。

圖示目錄會從資源檔載入，其資源類型 RT_GROUP_ICON ( 或 RT_GROUP_CURSOR 數據指標) ，以及要載入之特定圖示的整數資源名稱。 LookupIconIdFromDirectory 會傳回整數標識碼，這是最適合目前顯示裝置之圖標的資源名稱。

LoadIcon、LoadCursor 和 LoadImage 函式會使用此函式來搜尋最符合目前顯示裝置之圖示或游標的指定資源數據。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winuser.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll