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 |