Estrutura ICONINFOEXA (winuser.h)

Artigo
03/13/2024

Contém informações sobre um ícone ou um cursor. Estende ICONINFO. Usado por GetIconInfoEx.

Sintaxe

typedef struct _ICONINFOEXA {
  DWORD   cbSize;
  BOOL    fIcon;
  DWORD   xHotspot;
  DWORD   yHotspot;
  HBITMAP hbmMask;
  HBITMAP hbmColor;
  WORD    wResID;
  CHAR    szModName[MAX_PATH];
  CHAR    szResName[MAX_PATH];
} ICONINFOEXA, *PICONINFOEXA;

Membros

cbSize

Tipo: DWORD

O tamanho, em bytes, dessa estrutura.

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 de acesso 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 bitmap de máscara monocromática do ícone.

hbmColor

Tipo: HBITMAP

Um identificador para o bitmap de cor do ícone.

wResID

Tipo: WORD

Identificador de recurso do recurso no módulo szModName . Se o ícone ou cursor tiver sido carregado pelo nome, wResID será zero e szResName conterá o nome do recurso.

Você pode usar a macro MAKEINTRESOURCE(wResID) para converter o identificador de recurso em um tipo de nome de recurso compatível com as funções de gerenciamento de recursos.

szModName[MAX_PATH]

Tipo: TCHAR[MAX_PATH]

Nome do módulo do qual um ícone ou cursor foi carregado.

Você pode usar a função GetModuleHandle para convertê-la no identificador de módulo compatível com as funções de gerenciamento de recursos.

szResName[MAX_PATH]

Tipo: TCHAR[MAX_PATH]

Nome do recurso no módulo szModName .

Comentários

Para ícones monocromáticos, 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 o conteúdo de hbmMask e hbmColor na estrutura BITMAP . Os bits de bitmap podem ser obtidos com a chamada para GetDIBits nos bitmaps nessa estrutura.

ICONINFOEX é uma versão estendida da estrutura ICONINFO com membros szModName/szResName/wResID adicionais que podem ser usados para consultar um ícone ou bits de recurso de cursor. Esses bits normalmente são carregados por chamadas para as funções FindResource, LoadResource, LockResource e LookupIconIdFromDirectoryEx .

Observação

O cabeçalho winuser.h define ICONINFOEX como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

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