ICONINFOEXW 구조체(winuser.h)

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

통사론

typedef struct _ICONINFOEXW {
  DWORD   cbSize;
  BOOL    fIcon;
  DWORD   xHotspot;
  DWORD   yHotspot;
  HBITMAP hbmMask;
  HBITMAP hbmColor;
  WORD    wResID;
  WCHAR   szModName[MAX_PATH];
  WCHAR   szResName[MAX_PATH];
} ICONINFOEXW, *PICONINFOEXW;

회원

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

요구 사항

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

참고 항목

개념

CreateIconIndirect

GetIconInfo

아이콘

비트맵

GetObject

BITMAP

GetDIBits

참조