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 |