Estrutura COMBOBOXEXITEMA (commctrl.h)

  • Artigo

Contém informações sobre um item em um controle ComboBoxEx.

Sintaxe

typedef struct tagCOMBOBOXEXITEMA {
  UINT    mask;
  INT_PTR iItem;
  LPSTR   pszText;
  int     cchTextMax;
  int     iImage;
  int     iSelectedImage;
  int     iOverlay;
  int     iIndent;
  LPARAM  lParam;
} COMBOBOXEXITEMA, *PCOMBOBOXEXITEMA;

Membros

mask

Tipo: UINT

Um conjunto de sinalizadores de bits que especificam atributos dessa estrutura ou de uma operação que está usando essa estrutura. Os sinalizadores especificam membros que são válidos ou devem ser preenchidos. Esse membro pode ser uma combinação dos valores a seguir.

Valor Significado
CBEIF_DI_SETITEM
 Defina esse sinalizador ao processar CBEN_GETDISPINFO; o controle ComboBoxEx manterá as informações fornecidas e não as solicitará novamente.
CBEIF_IMAGE
 O membro iImage é válido ou deve ser preenchido.
CBEIF_INDENT
 O membro iIndent é válido ou deve ser preenchido.
CBEIF_LPARAM
 O membro lParam é válido ou deve ser preenchido.
CBEIF_OVERLAY
 O membro iOverlay é válido ou deve ser preenchido.
CBEIF_SELECTEDIMAGE
 O membro iSelectedImage é válido ou deve ser preenchido.
CBEIF_TEXT
 O membro pszText é válido ou deve ser preenchido.

iItem

Tipo: INT_PTR

O índice de base zero do item.

pszText

Tipo: LPTSTR

Um ponteiro para um buffer de caracteres que contém ou recebe o texto do item. Se as informações de texto estiverem sendo recuperadas, esse membro deverá ser definido como o endereço de um buffer de caracteres que receberá o texto. O tamanho desse buffer também deve ser indicado em cchTextMax. Se esse membro estiver definido como LPSTR_TEXTCALLBACK, o controle solicitará as informações usando os códigos de notificação CBEN_GETDISPINFO .

cchTextMax

Tipo: int

O comprimento de pszText, em TCHARs. Se as informações de texto estiverem sendo definidas, esse membro será ignorado.

iImage

Tipo: int

O índice baseado em zero de uma imagem dentro da lista de imagens. A imagem especificada será exibida para o item quando ele não estiver selecionado. Se esse membro estiver definido como I_IMAGECALLBACK, o controle solicitará as informações usando CBEN_GETDISPINFO códigos de notificação.

iSelectedImage

Tipo: int

O índice baseado em zero de uma imagem dentro da lista de imagens. A imagem especificada será exibida para o item quando ele for selecionado. Se esse membro estiver definido como I_IMAGECALLBACK, o controle solicitará as informações usando CBEN_GETDISPINFO códigos de notificação.

iOverlay

Tipo: int

O índice baseado em um de uma imagem de sobreposição dentro da lista de imagens. Se esse membro estiver definido como I_IMAGECALLBACK, o controle solicitará as informações usando CBEN_GETDISPINFO códigos de notificação.

iIndent

Tipo: int

O número de espaços de recuo a serem exibidos para o item. Cada recuo é igual a 10 pixels. Se esse membro estiver definido como I_INDENTCALLBACK, o controle solicitará as informações usando CBEN_GETDISPINFO códigos de notificação.

lParam

Tipo: LPARAM

Um valor específico para o item.

Comentários

Observação

O cabeçalho commctrl.h define COMBOBOXEXITEM 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 2003 [somente aplicativos da área de trabalho]
Cabeçalho commctrl.h