다음을 통해 공유


CreateIconFromResourceEx 함수(winuser.h)

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

통사론

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 맞춤 버퍼 포인터입니다. 이러한 비트는 일반적으로 LookupIconIdFromDirectoryExLoadResource 함수에 대한 호출에 의해 로드됩니다.

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

[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 함수를 LookupIconIdFromDirectoryEx 함수를 사용하면 셸 애플리케이션과 아이콘 브라우저가 시스템 전체에서 리소스를 검사하고 사용할 수 있습니다.

CreateIconFromResourceEx사용하여 만든 커서에 대해 DestroyIcon 호출하거나 DestroyCursor 호출해야 합니다.

예제

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

요구 사항

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

참고 항목

BITMAPINFOHEADER

개념

CreateIconFromResource

CreateIconIndirect

DestroyIcon

GetIconInfo

아이콘

LoadResource

lookupIconIdFromDirectoryEx

기타 리소스

참조