Compartilhar via

Estrutura ICONINFOEXA (winuser.h)

  • Artigo

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

hbmColor

Tipo: HBITMAP

Um identificador para a cor do ícone bitmap.

wResID

Tipo: word

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

Você pode usar macroMAKEINTRESOURCE (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 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 .

Observações

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 cores, os hbmMask e hbmColor bitmaps têm o mesmo tamanho, cada um deles do tamanho do ícone.

Você pode usar uma função GetObject para obter 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 de ICONINFO com membros szModNameszResNamewResID adiciona is 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 funções LookupIconIdFromDirectoryEx.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Consulte também

Conceitual

CreateIconIndirect

GetIconInfo

Ícones

bitmaps

GetObject

BITMAP

GetDIBits

de referência de