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 检索到的微型图标的索引。 可以使用设备的以下预定义索引：

类 索引
计算机/系统 0
显示/监视器 2
网络适配器 3
鼠标 5
Keyboard 6
声音 8
FDC/HDC 9
端口 10
打印机 14
网络传输 15
网络客户端 16
Network Service 17
未知 18

[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) 文档。

要求

   
最低受支持的客户端 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台 桌面
标头 setupapi.h (包括 Setupapi.h)
Library Setupapi.lib
DLL Setupapi.dll

另请参阅

SetupDiGetClassBitmapIndex

SetupDiLoadClassIcon