Функция 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
Клавиатура	6
Звук	8
FDC/HDC	9
порты;	10
Принтерный	14
Сетевой транспорт	15
Network Client (Сетевой клиент)	16
Сетевая служба.	17
Неизвестно	18

[in] Flags

Эти флаги управляют операцией рисования. LOWORD содержит фактические флаги, определенные следующим образом:

DMI_MASK

Нарисуйте маску мини-значка в HDC.

DMI_BKCOLOR

Используйте системный индекс цвета, указанный в HIWORD флагов , в качестве цвета фона. Если этот флаг не установлен, используется COLOR_WINDOW.

DMI_USERECT

Если этот параметр задан, SetupDiDrawMiniIcon использует предоставленный прямоугольник и растягивает значок по размеру.

Возвращаемое значение

Эта функция возвращает смещение из левой части rc , где должна начинаться строка. Если операция рисования завершается сбоем, функция возвращает ноль.

SetupDiDrawMiniIcon рисует 16-разрядную версию значка, указанную параметром MiniIconIndex . Вместо SetupDiDrawMiniIcon следует использовать SetupDiLoadClassIcon вместе с DrawIcon или DrawIconEx для рисования 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 см. в документации по пакету средств разработки программного обеспечения (SDK) Microsoft Windows для Windows 7 и платформа .NET Framework 4.0.

Требования


Минимальная версия клиента	Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	setupapi.h (включая Setupapi.h)
Библиотека	Setupapi.lib
DLL	Setupapi.dll

См. также раздел

SetupDiGetClassBitmapIndex

SetupDiLoadClassIcon

Поделиться через