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) 오류가 발생하거나 presbits 가 유효한 리소스 데이터를 가리키지 않는 경우 정의되지 않은 값을 반환합니다.
[in] fIcon
형식: BOOL
아이콘 또는 커서를 찾는지 여부를 나타냅니다. 이 매개 변수가 TRUE이면 함수는 아이콘을 검색합니다. 매개 변수가 FALSE이면 함수가 커서를 검색합니다.
[in] cxDesired
형식: int
아이콘의 원하는 너비(픽셀)입니다. 이 매개 변수가 0이면 함수는 SM_CXICON 또는 SM_CXCURSOR 시스템 메트릭 값을 사용합니다.
[in] cyDesired
형식: int
아이콘의 원하는 높이(픽셀)입니다. 이 매개 변수가 0이면 함수는 SM_CYICON 또는 SM_CYCURSOR 시스템 메트릭 값을 사용합니다.
[in] Flags
형식: UINT
다음 값의 조합입니다.
| 값 | 의미 |
|---|---|
|
기본 색 형식을 사용합니다. |
|
단색 아이콘 또는 커서를 만듭니다. |
반환 값
형식: int
함수가 성공하면 반환 값은 현재 디스플레이 디바이스에 가장 적합한 아이콘(RT_ICON) 또는 커서(RT_CURSOR)의 정수 리소스 식별자입니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 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 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h(Windows.h 포함) |
| 라이브러리 | User32.lib |
| DLL | User32.dll |
추가 정보
개념
참조