Estrutura HDITEMA (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_ITEMA {
UINT mask;
int cxy;
LPSTR pszText;
HBITMAP hbm;
int cchTextMax;
int fmt;
LPARAM lParam;
int iImage;
int iOrder;
UINT type;
void *pvFilter;
UINT state;
} HDITEMA, *LPHDITEMA;
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 |
|---|---|
|
O membro hbm é válido. |
|
Ao manipular 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 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 configurados.) |
|
O membro fmt é válido. |
|
Os membros type e pvFilter são válidos. Isso é usado para filtrar os valores especificados no membro de tipo . |
|
O mesmo que HDI_WIDTH. |
|
O membro iImage é válido e especifica a imagem a ser exibida com o item. |
|
O membro lParam é válido. |
|
O membro iOrder é válido e especifica o valor da ordem do item. |
|
Versão 6.00 e posterior. O membro do estado é válido. |
|
Os membros pszText e cchTextMax são válidos. |
|
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 |
|---|---|
|
Defina um dos seguintes sinalizadores para especificar a justificativa de texto: |
|
O conteúdo do item é centralizado. |
|
O conteúdo do item é alinhado à esquerda. |
|
O conteúdo do item está alinhado à direita. |
|
Defina um dos seguintes sinalizadores para controlar a exibição: |
|
O item exibe um bitmap. |
|
O bitmap aparece à direita do texto. |
|
O proprietário do controle de cabeçalho desenha o item. |
|
O item exibe uma cadeia de caracteres. |
|
O valor anterior pode ser combinado com: |
|
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. |
|
Isole os bits correspondentes aos três sinalizadores de justificativa listados na tabela anterior. |
|
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. |
|
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 nessa coluna em ordem decrescente. Esse sinalizador não pode ser combinado com HDF_IMAGE ou HDF_BITMAP. |
|
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 nessa coluna em ordem crescente. Esse sinalizador não pode ser combinado com HDF_IMAGE ou HDF_BITMAP. |
|
Versão 6.00 e posterior. O item exibe uma caixa de seleção. O sinalizador só é válido quando o estilo de HDS_CHECKBOXES é definido pela primeira vez no controle de cabeçalho. |
|
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 é definido. |
|
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. |
|
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 de divisão é clicado. |
lParam
Tipo: LPARAM
Dados de item definidos pelo aplicativo.
iImage
Tipo: int
O índice baseado em zero de uma imagem dentro da 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 à 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 |
|---|---|
|
Dados de cadeia de caracteres. |
|
Dados numéricos. |
|
Ignorar pvFilter. |
|
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 e com suporte para esse membro é o seguinte:
| Valor | Significado |
|---|---|
|
O item tem o foco do teclado. |
Comentários
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 |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de