SetupDiDrawMiniIcon 函数 (setupapi.h)

SetupDiDrawMiniIcon 函数在请求的位置绘制指定的微型图标。

语法

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

参数

[in] hdc

将绘制微型图标的设备上下文的句柄。

[in] rc

在指定设备上下文句柄中绘制微型图标的矩形。

[in] MiniIconIndex

从 SetupDiLoadClassIcon 或 SetupDiGetClassBitmapIndex 检索到的微型图标的索引。 可以使用设备的以下预定义索引：

[in] Flags

这些标志控制绘图操作。 LOWORD 包含定义的实际标志，如下所示：

DMI_MASK

将微型图标的掩码绘制到 HDC 中。

DMI_BKCOLOR

使用 标志 的 HIWORD 中指定的系统颜色索引作为背景色。 如果未设置此标志，则使用COLOR_WINDOW。

DMI_USERECT

如果已设置， SetupDiDrawMiniIcon 将使用提供的矩形并拉伸图标以适应。

返回值

此函数返回字符串应从其中开始的 rc 左侧的偏移量。 如果绘制操作失败，函数返回零。

注解

默认情况下，图标垂直居中，并强制在指定矩形的左侧。

SetupDiDrawMiniIcon 绘制 由 MiniIconIndex 参数指定的 16 位版本的图标。 应将 SetupDiLoadClassIcon 与 DrawIcon 或 DrawIconEx 一起使用来绘制图标的 32 位版本，而不是 SetupDiDrawMiniIcon。 下面是如何使用 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 和 .NET Framework 4.0 的 Microsoft Windows 软件开发工具包 (SDK) 文档。

要求

另请参阅

SetupDiGetClassBitmapIndex

SetupDiLoadClassIcon