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를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 머리글 | winuser.h(Windows.h 포함) |
추가 정보
개념
참조