Estrutura TVITEMEXA (commctrl.h)
Especifica ou recebe atributos de um item de exibição de árvore. Essa estrutura é um aprimoramento da estrutura de
Sintaxe
typedef struct tagTVITEMEXA {
UINT mask;
HTREEITEM hItem;
UINT state;
UINT stateMask;
LPSTR pszText;
int cchTextMax;
int iImage;
int iSelectedImage;
int cChildren;
LPARAM lParam;
int iIntegral;
UINT uStateEx;
HWND hwnd;
int iExpandedImage;
int iReserved;
} TVITEMEXA, *LPTVITEMEXA;
Membros
mask
Matriz de sinalizadores que indicam quais dos outros membros da estrutura contêm dados válidos. Quando essa estrutura é usada com a mensagem TVM_GETITEM, a máscara membro indica os atributos de item a serem recuperados. Se usado com a mensagem TVM_SETITEM, a máscara indicará os atributos a serem definidos. Esse membro pode ser um ou mais dos seguintes valores:
| Valor | Significado |
|---|---|
|
O membro cChildren |
|
O controle de exibição de árvore manterá as informações fornecidas e não as solicitará novamente. Esse sinalizador só é válido ao processar a notificação de TVN_GETDISPINFO. |
|
|
|
O membro hItem é válido. |
|
O membro do iImage é válido. |
|
O membro iIntegral é válido. |
|
O membro lParam |
|
O membro iSelectedImage |
|
Os membros state |
|
|
|
Os membros do |
hItem
Tipo: HTREEITEM
Manipule para o item.
state
Conjunto de sinalizadores de bits e índices de lista de imagens que indicam o estado do item. Ao definir o estado de um item, o stateMask membro indica os bits válidos desse membro. Ao recuperar o estado de um item, esse membro retorna o estado atual para os bits indicados no stateMask membro. Para obter mais informações sobre esse membro, consulte a seção comentários.
Os bits 0 a 7 deste membro contêm os sinalizadores de estado do item. Para obter uma lista de possíveis sinalizadores de estado de item, consulte Tree-View estados de item de controle.
Os bits 8 a 11 deste membro especificam o índice de imagem de sobreposição baseada em um. A imagem de sobreposição é sobreposta sobre a imagem de ícone do item. Se esses bits forem zero, o item não terá nenhuma imagem de sobreposição. Para isolar esses bits, use a máscara de TVIS_OVERLAYMASK. Para definir o índice de imagem de sobreposição neste membro, use a macro INDEXTOOVERLAYMASK. As imagens de sobreposição da lista de imagens são definidas com a função ImageList_SetOverlayImage.
Uma imagem de estado é exibida ao lado do ícone de um item para indicar um estado definido pelo aplicativo. Especifique a lista de imagens de estado enviando uma mensagem TVM_SETIMAGELIST. Para definir a imagem de estado de um item, inclua o valor de
Para definir o índice de imagem de estado, use INDEXTOSTATEIMAGEMASK. Essa macro usa um índice e define os bits de 12 a 15 adequadamente. Para indicar que o item não tem nenhuma imagem de estado, defina o índice como zero. Essa convenção significa que a imagem zero na lista de imagens de estado não pode ser usada como uma imagem de estado. Para isolar os bits de 12 a 15 do membro de estado
stateMask
Bits do estado membro válido. Se você estiver recuperando o estado de um item, defina os bits do stateMask membro para indicar os bits a serem retornados no estado membro. Se você estiver definindo o estado de um item, defina os bits do stateMask membro para indicar os bits do estado membro que você deseja definir. Para definir ou recuperar o índice de imagem de sobreposição de um item, defina o TVIS_OVERLAYMASK bits. Para definir ou recuperar o índice de imagem de estado de um item, defina os bits TVIS_STATEIMAGEMASK.
pszText
Ponteiro para uma cadeia de caracteres terminada em nulo que contém o texto do item se a estrutura especificar atributos de item. Se esse membro for o valor LPSTR_TEXTCALLBACK, a janela pai será responsável por armazenar o nome. Nesse caso, o controle de exibição de árvore envia à janela pai um código de notificação TVN_GETDISPINFO quando precisa do texto do item para exibição, classificação ou edição e um código de notificação TVN_SETDISPINFO quando o texto do item é alterado. Se a estrutura estiver recebendo atributos de item, esse membro será o endereço do buffer que recebe o texto do item. Observe que, embora o controle de exibição de árvore permita que qualquer cadeia de caracteres de comprimento seja armazenada como texto do item, somente os primeiros 260 caracteres são exibidos.
cchTextMax
Tipo: int
Tamanho do buffer apontado pelo membro pszText
iImage
Tipo: int
Indexe na lista de imagens do controle de exibição de árvore da imagem de ícone a ser usada quando o item estiver no estado não selecionado. Se esse membro for o valor I_IMAGECALLBACK, a janela pai será responsável por armazenar o índice. Nesse caso, o controle de exibição de árvore envia ao pai um código de notificação TVN_GETDISPINFO para recuperar o índice quando ele precisa exibir a imagem.
iSelectedImage
Tipo: int
Indexe na lista de imagens do controle de exibição de árvore da imagem de ícone a ser usada quando o item estiver no estado selecionado. Se esse membro for o valor I_IMAGECALLBACK, a janela pai será responsável por armazenar o índice. Nesse caso, o controle de exibição de árvore envia ao pai um código de notificação TVN_GETDISPINFO para recuperar o índice quando ele precisa exibir a imagem.
cChildren
Tipo: int
Sinalizador que indica se o item tem itens filho associados. Esse membro pode ser um dos seguintes valores:
| Valor | Significado |
|---|---|
|
O item não tem itens filho. |
|
O item tem um ou mais itens filho. |
|
A janela pai controla se o item tem itens filho. Nesse caso, quando o controle de exibição de árvore precisa exibir o item, o controle envia ao pai um código de notificação TVN_GETDISPINFO para determinar se o item tem itens filho. Se o controle de exibição de árvore tiver o estilo TVS_HASBUTTONS, ele usará esse membro para determinar se o botão indica a presença de itens filho. Você pode usar esse membro para forçar o controle a exibir o botão, mesmo que o item não tenha nenhum item filho inserido. Isso permite que você exiba o botão minimizando o uso de memória do controle inserindo itens filho somente quando o item estiver visível ou expandido. |
|
versão 6.0destinada ao uso interno; não recomendado para uso em aplicativos. O controle de exibição de árvore determina automaticamente se o item tem itens filho.
Observação Esse sinalizador pode não ter suporte em versões futuras do Comctl32.dll. Além disso, esse sinalizador não é definido em commctrl.h. Adicione a seguinte definição aos arquivos de origem do aplicativo para usar o sinalizador:
|
lParam
Um valor a ser associado ao item.
iIntegral
Tipo: int
Altura do item, em múltiplos da altura do item padrão (consulte TVM_SETITEMHEIGHT). Por exemplo, definir esse membro como 2 dará ao item o dobro da altura padrão. O controle de exibição de árvore não desenha na área extra, que aparece abaixo do conteúdo do item, mas esse espaço pode ser usado pelo aplicativo para desenho ao usar desenho personalizado. Os aplicativos que não estão usando o desenho personalizado devem definir esse valor como 1, caso contrário, o comportamento é indefinido.
uStateEx
Internet Explorer 6 e posteriores. Um ou mais (como uma combinação bit a bit) dos seguintes estados estendidos.
hwnd
Internet Explorer 6 e posteriores. Não usado; deve ser NULL.
iExpandedImage
Tipo: int
Internet Explorer 6 e posteriores. Índice da imagem na lista de imagens do controle a ser exibido quando o item estiver no estado expandido.
iReserved
Tipo: int
Membro reservado. Não use.
Observações
Nota
O cabeçalho commctrl.h define TVITEMEX 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 |