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
鍵盤 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 左側傳回應該啟動字串的位移。 如果繪製作業失敗，函式會傳回零。

備註

根據預設，圖示會垂直置中，並針對指定矩形的左側強制。

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的詳細資訊，請參閱 Microsoft Windows 軟體發展工具組 (SDK) for Windows 7 和 .NET Framework 4.0 檔。

需求

   
最低支援的用戶端 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。
目標平台 桌上型
標頭 setupapi.h (包括 Setupapi.h)
程式庫 Setupapi.lib
Dll Setupapi.dll

另請參閱

SetupDiGetClassBitmapIndex

SetupDiLoadClassIcon