ICONINFOEXA 구조체(winuser.h)

아티클
05/25/2023

아이콘 또는 커서에 대한 정보를 포함합니다. ICONINFO를 확장합니다. GetIconInfoEx에서 사용됩니다.

구문

typedef struct _ICONINFOEXA {
  DWORD   cbSize;
  BOOL    fIcon;
  DWORD   xHotspot;
  DWORD   yHotspot;
  HBITMAP hbmMask;
  HBITMAP hbmColor;
  WORD    wResID;
  CHAR    szModName[MAX_PATH];
  CHAR    szResName[MAX_PATH];
} ICONINFOEXA, *PICONINFOEXA;

멤버

cbSize

형식:DWORD

이 구조체의 크기(바이트)입니다.

fIcon

형식: BOOL

이 구조체가 아이콘 또는 커서를 정의하는지 여부를 지정합니다. TRUE 값은 아이콘을 지정합니다. FALSE는 커서를 지정합니다.

xHotspot

형식:DWORD

커서 핫 스폿의 x 좌표입니다. 이 구조가 아이콘을 정의하는 경우 핫 스폿은 항상 아이콘의 가운데에 있으며 이 멤버는 무시됩니다.

yHotspot

형식:DWORD

커서 핫 스폿의 y 좌표입니다. 이 구조가 아이콘을 정의하는 경우 핫 스폿은 항상 아이콘의 가운데에 있으며 이 멤버는 무시됩니다.

hbmMask

형식: HBITMAP

아이콘 단색 마스크 비트맵에 대한 핸들입니다.

hbmColor

형식: HBITMAP

아이콘 색 비트맵에 대한 핸들입니다.

wResID

형식: WORD

szModName 모듈에 있는 리소스의 리소스 식별자입니다. 아이콘 또는 커서가 이름으로 로드된 경우 wResID 는 0이고 szResName 에는 리소스 이름이 포함됩니다.

MAKEINTRESOURCE(wResID) 매크로를 사용하여 리소스 식별자를 리소스 관리 함수와 호환되는 리소스 이름 형식으로 변환할 수 있습니다.

szModName[MAX_PATH]

형식: TCHAR[MAX_PATH]

아이콘 또는 커서가 로드된 모듈의 이름입니다.

GetModuleHandle 함수를 사용하여 리소스 관리 함수와 호환되는 모듈 핸들로 변환할 수 있습니다.

szResName[MAX_PATH]

형식: TCHAR[MAX_PATH]

szModName 모듈에 있는 리소스의 리소스 이름입니다.

설명

흑백 아이콘의 경우 hbmMask 는 아이콘 높이의 두 배이며(위쪽에 AND 마스크가 있고 아래쪽에 XOR 마스크가 있음) hbmColor 는 NULL입니다. 또한 이 경우 높이가 2의 짝수 배수여야 합니다.

색 아이콘의 경우 hbmMask 및 hbmColor 비트맵은 크기가 같으며 각각 아이콘의 크기입니다.

GetObject 함수를 사용하여 BITMAP 구조에서 hbmMask 및 hbmColor의 콘텐츠를 가져올 수 있습니다. 비트맵 비트는 이 구조체의 비트맵에서 GetDIBits 를 호출하여 가져올 수 있습니다.

ICONINFOEX는 아이콘 또는 커서 리소스 비트를 쿼리하는 데 사용할 수 있는 추가 szModName szResName//wResID 멤버가 있는 ICONINFO 구조체의 확장 버전입니다. 이러한 비트는 일반적으로 FindResource, LoadResource, LockResource 및 LookupIconIdFromDirectoryEx 함수에 대한 호출에 의해 로드됩니다.

참고

winuser.h 헤더는 ICONINFOEX를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	winuser.h(Windows.h 포함)