CreateIcon 함수(winuser.h)
지정된 크기, 색 및 비트 패턴이 있는 아이콘을 만듭니다.
런타임에 색이 지정된 아이콘을 만들려면 ICONINFO 구조체의 내용에 따라 아이콘을 만드는 CreateIconIndirect 함수를 사용할 수 있습니다.
구문
HICON CreateIcon(
[in, optional] HINSTANCE hInstance,
[in] int nWidth,
[in] int nHeight,
[in] BYTE cPlanes,
[in] BYTE cBitsPixel,
[in] const BYTE *lpbANDbits,
[in] const BYTE *lpbXORbits
);
매개 변수
[in, optional] hInstance
형식: HINSTANCE
아이콘을 만드는 모듈의 instance 대한 핸들입니다.
[in] nWidth
형식: int
아이콘의 너비(픽셀)입니다. 설명을 참조하세요.
[in] nHeight
형식: int
아이콘의 높이(픽셀)입니다. 설명을 참조하세요.
[in] cPlanes
형식: BYTE
아이콘의 XOR 비트 마스크에 있는 평면의 수입니다. 설명을 참조하세요.
[in] cBitsPixel
형식: BYTE
아이콘의 XOR 비트 마스크에 있는 픽셀당 비트 수입니다.
[in] lpbANDbits
형식: const BYTE*
아이콘의 AND 비트 마스크에 대한 비트 값을 포함하는 바이트 배열입니다. 이 비트 마스크는 단색 비트맵을 설명합니다. 설명을 참조하세요.
[in] lpbXORbits
형식: const BYTE*
아이콘의 XOR 비트 마스크에 대한 비트 값을 포함하는 바이트 배열입니다. 이 비트 마스크는 단색 또는 색 비트맵을 설명합니다. 설명을 참조하세요.
반환 값
형식: HICON
함수가 성공하면 반환 값은 아이콘에 대한 핸들입니다.
함수가 실패하면 반환 값은 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
아이콘의 명목 크기를 확인하려면 GetSystemMetrics 함수를 사용하여 SM_CXICON 또는 SM_CYICON 값을 지정합니다. 또한 이 API의 DPI 인식 버전을 사용할 수 있습니다. (GetSystemMetricsForDpi)(/windows/win32/api/winuser/nf-winuser-getsystemmetricsfordpi)를 참조하세요. 자세한 내용은 Windows의 아이콘 크기 및 높은 DPI 데스크톱 애플리케이션 개발을 참조하세요.
lpbANDbits 및 lpbXORbits 매개 변수에 대한 자세한 내용은 CreateBitmap 함수의 lpBits 매개 변수에 대한 설명을 참조하세요.
단색 아이콘 의 경우 CreateIcon 은 AND 및 XOR 비트 마스크에 다음 진리 테이블을 적용합니다.
| AND 비트 마스크 | XOR 비트 마스크 | 표시 |
|---|---|---|
| 0 | 0 | 검정 |
| 0 | 1 | 흰색 |
| 1 | 0 | 화면 |
| 1 | 1 | 역방향 화면 |
아이콘 사용을 마치면 DestroyIcon 함수를 사용하여 삭제합니다.
예제
예제는 아이콘 만들기를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h(Windows.h 포함) |
| 라이브러리 | User32.lib |
| DLL | User32.dll |