Estrutura HDITEMW (commctrl.h)

Contém informações sobre um item em um controle de cabeçalho. Essa estrutura substitui a estrutura HD_ITEM .

Sintaxe

typedef struct _HD_ITEMW {
  UINT    mask;
  int     cxy;
  LPWSTR  pszText;
  HBITMAP hbm;
  int     cchTextMax;
  int     fmt;
  LPARAM  lParam;
  int     iImage;
  int     iOrder;
  UINT    type;
  void    *pvFilter;
  UINT    state;
} HDITEMW, *LPHDITEMW;

Membros

mask

Tipo: UINT

Sinalizadores que indicam quais outros membros da estrutura contêm dados válidos ou devem ser preenchidos. Esse membro pode ser uma combinação dos seguintes valores:

Valor Significado
HDI_BITMAP
O membro hbm é válido.
HDI_DI_SETITEM
Ao lidar com a mensagem HDM_GETITEM, o controle de cabeçalho pode não ter todos os valores necessários para concluir a solicitação. Nesse caso, o controle deve chamar o aplicativo de volta para os valores por meio da notificação de HDN_GETDISPINFO . Se HDI_DI_SETITEM tiver sido passado na mensagem HDM_GETITEM , o controle armazenará em cache todos os valores retornados de HDN_GETDISPINFO (caso contrário, os valores permanecerão não definidos).)
HDI_FORMAT
O membro fmt é válido.
HDI_FILTER
Os membros type e pvFilter são válidos. Isso é usado para filtrar os valores especificados no membro do tipo .
HDI_HEIGHT
O mesmo que HDI_WIDTH.
HDI_IMAGE
O membro iImage é válido e especifica a imagem a ser exibida com o item.
HDI_LPARAM
O membro lParam é válido.
HDI_ORDER
O membro iOrder é válido e especifica o valor da ordem do item.
HDI_STATE

Versão 6.00 e posterior. O membro do estado é válido.

HDI_TEXT
Os membros pszText e cchTextMax são válidos.
HDI_WIDTH
O membro cxy é válido e especifica a largura do item.

cxy

Tipo: int

A largura ou altura do item.

pszText

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres de item. Se o texto estiver sendo recuperado do controle, esse membro deverá ser inicializado para apontar para um buffer de caracteres. Se esse membro estiver definido como LPSTR_TEXTCALLBACK, o controle solicitará informações de texto para esse item enviando um código de notificação HDN_GETDISPINFO. Observe que, embora o controle de cabeçalho permita que uma cadeia de caracteres de qualquer comprimento seja armazenada como texto do item, somente os primeiros 260 TCHARs são exibidos.

hbm

Tipo: HBITMAP

Um identificador para o bitmap do item.

cchTextMax

Tipo: int

O comprimento da cadeia de caracteres do item, em TCHARs. Se o texto estiver sendo recuperado do controle, esse membro deverá conter o número de TCHARs no endereço especificado por pszText.

fmt

Tipo: int

Sinalizadores que especificam o formato do item.

Valor Significado
Justificativa de texto:
Defina um dos seguintes sinalizadores para especificar a justificativa de texto:
HDF_CENTER
O conteúdo do item é centralizado.
HDF_LEFT
O conteúdo do item é alinhado à esquerda.
HDF_RIGHT
O conteúdo do item está alinhado à direita.
Exibição:
Defina um dos seguintes sinalizadores para controlar a exibição:
HDF_BITMAP
O item exibe um bitmap.
HDF_BITMAP_ON_RIGHT
O bitmap aparece à direita do texto.
HDF_OWNERDRAW
O proprietário do controle de cabeçalho desenha o item.
HDF_STRING
O item exibe uma cadeia de caracteres.
Combinando sinalizadores:
O valor anterior pode ser combinado com:
HDF_IMAGE
Exibir uma imagem de uma lista de imagens. Especifique a lista de imagens enviando uma mensagem HDM_SETIMAGELIST . Especifique o índice da imagem no membro iImage dessa estrutura.
HDF_JUSTIFYMASK
Isole os bits correspondentes aos três sinalizadores de justificativa listados na tabela anterior.
HDF_RTLREADING
Normalmente, as janelas exibem texto da esquerda para a direita (LTR). O Windows pode ser espelhado para exibir idiomas como hebraico ou árabe que leem da direita para a esquerda (RTL). Normalmente, o texto do cabeçalho é lido na mesma direção que o texto em sua janela pai. Se HDF_RTLREADING estiver definido, o texto do cabeçalho será lido na direção oposta do texto na janela pai.
HDF_SORTDOWN

Versão 6.00 e posterior. Desenha uma seta para baixo neste item. Normalmente, isso é usado para indicar que as informações na janela atual são classificadas nesta coluna em ordem decrescente. Esse sinalizador não pode ser combinado com HDF_IMAGE ou HDF_BITMAP.

HDF_SORTUP

Versão 6.00 e posterior. Desenha uma seta para cima neste item. Normalmente, isso é usado para indicar que as informações na janela atual são classificadas nesta coluna em ordem crescente. Esse sinalizador não pode ser combinado com HDF_IMAGE ou HDF_BITMAP.

HDF_CHECKBOX

Versão 6.00 e posterior. O item exibe uma caixa de seleção. O sinalizador só é válido quando o estilo HDS_CHECKBOXES é definido pela primeira vez no controle de cabeçalho.

HDF_CHECKED

Versão 6.00 e posterior. O item exibe uma caixa de seleção marcada. O sinalizador só é válido quando HDF_CHECKBOX também está definido.

HDF_FIXEDWIDTH

Versão 6.00 e posterior. A largura do item não pode ser modificada por uma ação do usuário para redimensioná-lo.

HDF_SPLITBUTTON

Versão 6.00 e posterior. O item exibe um botão de divisão. A notificação HDN_DROPDOWN é enviada quando o botão dividir é clicado.

lParam

Tipo: LPARAM

Dados de item definidos pelo aplicativo.

iImage

Tipo: int

O índice baseado em zero de uma imagem na lista de imagens. A imagem especificada será exibida no item de cabeçalho, além de qualquer imagem especificada no campo hbm . Se iImage estiver definido como I_IMAGECALLBACK, o controle solicitará informações de texto para esse item usando um código de notificação HDN_GETDISPINFO . Para limpar a imagem, defina esse valor como I_IMAGENONE.

iOrder

Tipo: int

A ordem na qual o item aparece dentro do controle de cabeçalho, da esquerda para a direita. Ou seja, o valor do item de extrema esquerda é 0. O valor do próximo item à direita é 1 e assim por diante.

type

Tipo: UINT

O tipo de filtro especificado por pvFilter. Os tipos possíveis incluem:

Valor Significado
HDFT_ISSTRING
Dados de cadeia de caracteres.
HDFT_ISNUMBER
Dados numéricos.
HDFT_HASNOVALUE
Ignorar pvFilter.
HDFT_ISDATE

Versão 6.00 e posterior. Dados de data. O membro pvFilter é um ponteiro para uma estrutura SYSTEMTIME .

pvFilter

Tipo: void*

O endereço de um item de dados definido pelo aplicativo. O tipo de filtro de dados é determinado definindo o valor do sinalizador do membro. Use o sinalizador HDFT_ISSTRING para indicar uma cadeia de caracteres e HDFT_ISNUMBER para indicar um inteiro. Quando o sinalizador HDFT_ISSTRING é usado pvFilter é um ponteiro para uma estrutura HDTEXTFILTER .

state

Tipo: UINT

O estado. O único valor válido com suporte para esse membro é o seguinte:

Valor Significado
HDIS_FOCUSED
O item tem o foco do teclado.

Comentários

Observe que Comctl32.dll versão 6 não é redistribuível, mas está incluído no Windows. Para usar Comctl32.dll versão 6, especifique-a em um manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.
 

Observação

O cabeçalho commctrl.h define HDITEM 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