CreateIconFromResourceEx 함수(winuser.h)

아티클
03/13/2024

아이콘을 설명하는 리소스 비트에서 아이콘 또는 커서를 만듭니다.

구문

HICON CreateIconFromResourceEx(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer,
  [in] int   cxDesired,
  [in] int   cyDesired,
  [in] UINT  Flags
);

매개 변수

[in] presbits

형식: PBYTE

아이콘(RT_ICON) 또는 커서(RT_CURSOR) 리소스 비트를 포함하는 DWORD 정렬 버퍼 포인터입니다. 이러한 비트는 일반적으로 LookupIconIdFromDirectoryEx 및 LoadResource 함수에 대한 호출에 의해 로드됩니다.

아이콘 및 커서 리소스 형식에 대한 자세한 내용은 커서 및 아이콘 리소스를 참조하세요.

[in] dwResSize

형식:DWORD

pbIconBits 매개 변수가 가리키는 비트 집합의 크기(바이트)입니다.

[in] fIcon

형식: BOOL

아이콘 또는 커서를 만들 것인지 여부를 나타냅니다. 이 매개 변수가 TRUE이면 아이콘이 만들어집니다. FALSE이면 커서를 만들어야 합니다.

LOCALHEADER 구조는 커서 핫스팟을 정의하며 커서 리소스 비트에서 읽은 첫 번째 데이터입니다.

[in] dwVer

형식:DWORD

presbits 매개 변수가 가리키는 리소스 비트에 대한 아이콘 또는 커서 형식의 버전 번호입니다. 값은 0x00020000 보다 크거나 같아야 하며 0x00030000 보다 작거나 같아야 합니다. 이 매개 변수는 일반적으로 0x00030000 설정됩니다.

[in] cxDesired

형식: int

아이콘 또는 커서의 너비(픽셀)입니다. 이 매개 변수가 0이고 Flags 매개 변수가 LR_DEFAULTSIZE 경우 함수는 SM_CXICON 또는 SM_CXCURSOR 시스템 메트릭 값을 사용하여 너비를 설정합니다. 이 매개 변수가 0이고 LR_DEFAULTSIZE 사용되지 않는 경우 함수는 실제 리소스 너비를 사용합니다.

[in] cyDesired

형식: int

아이콘 또는 커서의 높이(픽셀)입니다. 이 매개 변수가 0이고 Flags 매개 변수가 LR_DEFAULTSIZE 경우 함수는 SM_CYICON 또는 SM_CYCURSOR 시스템 메트릭 값을 사용하여 높이를 설정합니다. 이 매개 변수가 0이고 LR_DEFAULTSIZE 사용되지 않는 경우 함수는 실제 리소스 높이를 사용합니다.

[in] Flags

형식: UINT

다음 값의 조합입니다.

값	의미
LR_DEFAULTCOLOR 0x00000000	기본 색 형식을 사용합니다.
LR_DEFAULTSIZE 0x00000040	cxDesired 또는 cyDesired 값이 0으로 설정된 경우 커서 또는 아이콘에 대한 시스템 메트릭 값으로 지정된 너비 또는 높이를 사용합니다. 이 플래그를 지정하지 않고 cxDesired 및 cyDesired 가 0으로 설정된 경우 함수는 실제 리소스 크기를 사용합니다.
LR_MONOCHROME 0x00000001	단색 아이콘 또는 커서를 만듭니다.
LR_SHARED 0x00008000	아이콘 또는 커서가 여러 번 만들어지면 아이콘 또는 커서 핸들을 공유합니다. LR_SHARED 설정되지 않은 경우 동일한 리소스에 대한 CreateIconFromResourceEx에 대한 두 번째 호출은 아이콘 또는 커서를 다시 만들고 다른 핸들을 반환합니다. 이 플래그를 사용하면 시스템이 더 이상 필요하지 않을 때 리소스를 삭제합니다. 표준이 아닌 크기가 있거나 로드 후 변경되거나 파일에서 로드되는 아이콘이나 커서에는 LR_SHARED 사용하지 마세요.

반환 값

형식: HICON

함수가 성공하면 반환 값은 아이콘 또는 커서에 대한 핸들입니다.

함수가 실패하면 반환 값은 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo 및 LookupIconIdFromDirectoryEx 함수를 사용하면 셸 애플리케이션 및 아이콘 브라우저가 시스템 전체에서 리소스를 검사하고 사용할 수 있습니다.

CreateIconFromResourceEx를 사용하여 만든 커서의 경우 아이콘에 DestroyIcon을 호출하거나 DestroyCursor를 호출해야 합니다.

예제

예제는 공유 아이콘 리소스를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll