Função SetupDiDrawMiniIcon (setupapi.h)

A função SetupDiDrawMiniIcon desenha o miniconícone especificado no local solicitado.

Sintaxe

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

Parâmetros

[in] hdc

O identificador para o contexto do dispositivo no qual o mini-ícone será desenhado.

[in] rc

O retângulo no identificador de contexto do dispositivo especificado no qual desenhar o mini-ícone.

[in] MiniIconIndex

O índice do mini-ícone, conforme recuperado de SetupDiLoadClassIcon ou SetupDiGetClassBitmapIndex. Os seguintes índices predefinidos para dispositivos podem ser usados:

Classe	Índice
Computador/Sistema	0
Exibir/Monitorar	2
Adaptador de rede	3
Mouse	5
Keyboard	6
Som	8
FDC/HDC	9
Portas	10
Impressora	14
Transporte de rede	15
Cliente de Rede	16
Serviço de Rede	17
Unknown	18

[in] Flags

Esses sinalizadores controlam a operação de desenho. O LOWORD contém os sinalizadores reais definidos da seguinte maneira:

DMI_MASK

Desenhe a máscara do mini-ícone no HDC.

DMI_BKCOLOR

Use o índice de cores do sistema especificado em HIWORD de Flags como a cor da tela de fundo. Se esse sinalizador não estiver definido, COLOR_WINDOW será usado.

DMI_USERECT

Se definido, SetupDiDrawMiniIcon usa o retângulo fornecido e alonga o ícone para caber.

Valor retornado

Essa função retorna o deslocamento do lado esquerdo de rc em que a cadeia de caracteres deve ser iniciada. Se a operação de desenho falhar, a função retornará zero.

Comentários

Por padrão, o ícone é centralizado verticalmente e forçado no lado esquerdo do retângulo especificado.

SetupDiDrawMiniIcon desenha a versão de 16 bits do ícone especificado pelo parâmetro MiniIconIndex . Em vez de SetupDiDrawMiniIcon, você deve usar SetupDiLoadClassIcon junto com DrawIcon ou DrawIconEx para desenhar a versão de 32 bits do ícone. Veja a seguir um exemplo de como usar DrawIconEx para exibir um ícone:

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);
}

Para obter mais informações sobre DrawIcon ou DrawIconEx, consulte a documentação do Microsoft Windows Software Development Kit (SDK) para Windows 7 e .NET Framework 4.0.

Requisitos

Cliente mínimo com suporte	Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	setupapi.h (inclua Setupapi.h)
Biblioteca	Setupapi.lib
DLL	Setupapi.dll

Confira também

SetupDiGetClassBitmapIndex

SetupDiLoadClassIcon