Estrutura ICONINFO (winuser.h)

Artigo
03/11/2023

Contém informações sobre um ícone ou cursor.

Sintaxe

typedef struct _ICONINFO {
  BOOL    fIcon;
  DWORD   xHotspot;
  DWORD   yHotspot;
  HBITMAP hbmMask;
  HBITMAP hbmColor;
} ICONINFO;

Membros

fIcon

Tipo: BOOL

Especifica se essa estrutura define um ícone ou um cursor. Um valor true especifica um ícone; FALSE especifica um cursor.

xHotspot

Tipo: DWORD

A coordenada x do ponto de acesso de um cursor. Se essa estrutura definir um ícone, o ponto de acesso estará sempre no centro do ícone e esse membro será ignorado.

yHotspot

Tipo: DWORD

A coordenada y do ponto quente do cursor. Se essa estrutura definir um ícone, o ponto de acesso estará sempre no centro do ícone e esse membro será ignorado.

hbmMask

Tipo: HBITMAP

Um identificador para o ícone bitmap de máscara monocromática.

hbmColor

Tipo: HBITMAP

Um identificador para o bitmap de cor do ícone.

Comentários

Para ícones monocromáticos, o hbmMask tem o dobro da altura do ícone (com a máscara AND na parte superior e a máscara XOR na parte inferior) e hbmColor é NULL. Além disso, nesse caso, a altura deve ser um múltiplo par de dois.

Para ícones de cor, os bitmaps hbmMask e hbmColor têm o mesmo tamanho, cada um com o tamanho do ícone.

Você pode usar uma função GetObject para obter conteúdo de hbmMask e hbmColor na estrutura BITMAP . Os bitmap bits podem ser obtidos com a chamada para GetDIBits nos bitmaps nessa estrutura.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	winuser.h (inclua Windows.h)