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
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 de HDN_GETDISPINFO. Se HDI_DI_SETITEM tiver sido passado na mensagem HDM_GETITEM, o controle armazenará em cache os valores retornados de HDN_GETDISPINFO (caso contrário, os valores permanecerão não definidos).) |
|
O membro fmt é válido. |
|
Os membros do tipo |
|
O mesmo que HDI_WIDTH. |
|
O membro iImage é válido e especifica a imagem a ser exibida com o item. |
|
O membro lParam |
|
O membro iOrder é válido e especifica o valor da ordem do item. |
|
versão 6.00 e posterior. O membro de estado |
|
Os membros do |
|
O membro cxy é válido e especifica a largura do item. |
cxy
Tipo: int
A largura ou altura do item.
pszText
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 este 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 TCHAR são exibidos.
hbm
Um identificador para o bitmap do item.
cchTextMax
Tipo: int
O comprimento da cadeia de caracteres do item, em TCHAR. Se o texto estiver sendo recuperado do controle, esse membro deverá conter o número de de
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 iImage membro 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). As janelas podem ser espelhadas 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 nesta 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 nesta 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 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
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
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
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 |
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
state
O estado. O único valor válido com suporte para este membro é o seguinte:
| Valor | Significado |
|---|---|
|
O item tem o foco do teclado. |
Observações
Nota
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 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 2003 [somente aplicativos da área de trabalho] |
| cabeçalho | commctrl.h |