LookupIconIdFromDirectoryEx 函式 (winuser.h)
搜尋圖示 (RT_GROUP_ICON) 或游標 (，RT_GROUP_CURSOR 最適合目前顯示裝置的圖示或游標) 資源資料。
如果資源群組中有一個以上的映射，此方法會使用下列準則來選擇影像：
- 選取最接近但未超過要求大小的影像。
- 如果存在該大小的兩個或多個影像，則會選擇符合顯示器色彩深度的影像。
- 如果沒有影像完全符合顯示器的色彩深度，則會選擇未超過顯示器色彩深度的最大色彩深度影像。 如果全部都超過色彩深度，則會選擇最低色彩深度的色彩深度。
語法
int LookupIconIdFromDirectoryEx(
[in] PBYTE presbits,
[in] BOOL fIcon,
[in] int cxDesired,
[in] int cyDesired,
[in] UINT Flags
);
參數
[in] presbits
類型： PBYTE
圖示或資料指標目錄資料。 因為此函式不會驗證資源資料，所以會導致 GP (一般保護) 錯誤，如果 預先位 未指向有效的資源資料，則會傳回未定義的值。
[in] fIcon
類型： BOOL
指出是否要搜尋圖示或游標。 如果此參數為 TRUE，則函式正在搜尋圖示;如果 參數為 FALSE，則函式正在搜尋資料指標。
[in] cxDesired
類型： int
圖示所需的寬度，以圖元為單位。 如果此參數為零，函式會使用 SM_CXICON 或 SM_CXCURSOR 系統計量值。
[in] cyDesired
類型： int
圖示所需的高度，以圖元為單位。 如果此參數為零，函式會使用 SM_CYICON 或 SM_CYCURSOR 系統計量值。
[in] Flags
類型： UINT
下列值的組合。
| 值 | 意義 |
|---|---|
|
使用預設色彩格式。 |
|
建立單色圖示或游標。 |
傳回值
類型： int
如果函式成功，則傳回值是圖示的整數資源識別碼， (RT_ICON) 或游標 (RT_CURSOR 最適合目前顯示裝置的) 。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
類型 為 RT_GROUP_ICON (的資源檔 ，RT_GROUP_CURSOR表示 資料指標) 包含數種裝置相依和裝置無關格式的資料 (或資料指標) 資料。 LookupIconIdFromDirectoryEx 會搜尋資源檔，尋找最適合目前顯示裝置的圖示 (或游標) ，並傳回其整數識別碼。 FindResource 和 FindResourceEx函式會使用此識別碼的MAKEINTRESOURCE宏來尋找模組中的資源。
圖示目錄會從資源檔載入，其資源類型RT_GROUP_ICON (或資料指標RT_GROUP_CURSOR) ，以及要載入之特定圖示的整數資源名稱 (RT_ICON) 或資料指標 (RT_CURSOR) 。 LoadResource 和 CreateIconFromResourceEx 函式可用來建立對應的圖示或游標。
LoadIcon、LoadImage和LoadCursor函式會使用此函式來搜尋最適合目前顯示裝置之圖示或游標的指定資源資料。 LoadIconWithScaleDown 會使用替代的搜尋準則，以符合最佳需求。
範例
如需範例，請參閱 共用圖示資源。
規格需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winuser.h (包括 Windows.h) |
| 程式庫 | User32.lib |
| Dll | User32.dll |
另請參閱
概念
參考