Share via

CreateIconIndirect 함수(winuser.h)

  • 아티클

ICONINFO 구조체에서 아이콘 또는 커서를 만듭니다.

구문

HICON CreateIconIndirect(
  [in] PICONINFO piconinfo
);

매개 변수

[in] piconinfo

형식: PICONINFO

함수가 아이콘 또는 커서를 만드는 데 사용하는 ICONINFO 구조체에 대한 포인터입니다.

반환 값

형식: HICON

함수가 성공하면 반환 값은 생성된 아이콘 또는 커서에 대한 핸들입니다.

함수가 실패하면 반환 값은 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

시스템에서 아이콘 또는 커서를 만들기 전에 ICONINFO 구조체의 비트맵을 복사합니다. 시스템에서 디바이스 컨텍스트에서 비트맵을 일시적으로 선택할 수 있으므로 ICONINFO 구조의 hbmMask 및 hbmColor 멤버를 디바이스 컨텍스트로 선택하지 않아야 합니다. 애플리케이션은 원래 비트맵을 계속 관리하고 더 이상 필요하지 않은 경우 삭제해야 합니다.

아이콘 사용을 마치면 DestroyIcon 함수를 사용하여 삭제합니다.

예제

예제는 커서 만들기를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 winuser.h(Windows.h 포함)
라이브러리 User32.lib
DLL User32.dll
API 세트 ext-ms-win-ntuser-gui-l1-3-0(Windows 10 버전 10.0.10240에 도입됨)

추가 정보

개념

DestroyIcon

ICONINFO

아이콘