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

추가 정보

CreateIconIndirect

아이콘

아이콘 크기