LookupIconIdFromDirectoryEx 함수(winuser.h)

아티클
05/25/2023

아이콘(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

다음 값의 조합입니다.

값	의미
LR_DEFAULTCOLOR 0x00000000	기본 색 형식을 사용합니다.
LR_MONOCHROME 0x00000001	단색 아이콘 또는 커서를 만듭니다.

반환 값

형식: 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