SetupDiDrawMiniIcon 함수(setupapi.h)

아티클
08/26/2023

SetupDiDrawMiniIcon 함수는 요청된 위치에 지정된 미니 아이콘을 그립니다.

구문

WINSETUPAPI INT SetupDiDrawMiniIcon(
  [in] HDC   hdc,
  [in] RECT  rc,
  [in] INT   MiniIconIndex,
  [in] DWORD Flags
);

매개 변수

[in] hdc

미니 아이콘을 그릴 디바이스 컨텍스트에 대한 핸들입니다.

[in] rc

미니 아이콘을 그릴 지정된 디바이스 컨텍스트 핸들의 사각형입니다.

[in] MiniIconIndex

SetupDiLoadClassIcon 또는 SetupDiGetClassBitmapIndex에서 검색된 미니 아이콘의 인덱스입니다. 디바이스에 대해 다음과 같은 미리 정의된 인덱스를 사용할 수 있습니다.

클래스	인덱스
컴퓨터/시스템	0
디스플레이/모니터	2
네트워크 어댑터	3
마우스	5
Keyboard	6
소리	8
FDC/HDC	9
포트	10
프린터	14
네트워크 전송	15
네트워크 클라이언트	16
네트워크 서비스	17
Unknown	18

[in] Flags

이러한 플래그는 그리기 작업을 제어합니다. LOWORD에는 다음과 같이 정의된 실제 플래그가 포함됩니다.

DMI_MASK

미니 아이콘의 마스크를 HDC에 그립니다.

DMI_BKCOLOR

플래그의 HIWORD에 지정된 시스템 색 인덱 스 를 배경색으로 사용합니다. 이 플래그가 설정되지 않으면 COLOR_WINDOW 사용됩니다.

DMI_USERECT

설정되면 SetupDiDrawMiniIcon 은 제공된 사각형을 사용하고 아이콘을 맞게 늘입니다.

반환 값

이 함수는 문자열이 시작되어야 하는 rc 의 왼쪽에서 오프셋을 반환합니다. 그리기 작업이 실패하면 함수는 0을 반환합니다.

설명

기본적으로 아이콘은 세로로 가운데에 배치되며 지정된 사각형의 왼쪽에 강제로 적용됩니다.

SetupDiDrawMiniIcon 은 MiniIconIndex 매개 변수로 지정된 아이콘의 16비트 버전을 그립니다. SetupDiDrawMiniIcon 대신 DrawIcon 또는 DrawIconEx와 함께 SetupDiLoadClassIcon을 사용하여 32비트 버전의 아이콘을 그려야 합니다. 다음은 DrawIconEx 를 사용하여 아이콘을 표시하는 방법의 예입니다.

HICON hIcon;

if (SetupDiLoadClassIcon(&GUID_DEVCLASS_USB, &hIcon, NULL)) {
    DrawIconEx(hDC, 0, 0, hIcon, GetSystemMetrics(SM_CXSMICON),GetSystemMetrics(SM_CYSMICON), 0, NULL, DI_NORMAL); 
DestroyIcon(hIcon);
}

DrawIcon 또는 DrawIconEx에 대한 자세한 내용은 Windows 7용 Microsoft Windows SDK(소프트웨어 개발 키트) 및 .NET Framework 4.0 설명서를 참조하세요.

요구 사항


지원되는 최소 클라이언트	Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	setupapi.h(Setupapi.h 포함)
라이브러리	Setupapi.lib
DLL	Setupapi.dll

추가 정보

SetupDiGetClassBitmapIndex

SetupDiLoadClassIcon

다음을 통해 공유