Compartilhar via


Controle pai e filho itens da árvore

Qualquer item em um controle de árvore (CTreeCtrl) pode ter uma lista de subitens, que são chamados de itens filho, associados a ele.Um item que tem um ou mais itens filho é chamado de um item pai.Um item filho é exibido abaixo do seu item pai e é recuado para indicar é subordinado ao pai.Um item que não tem um pai é o topo da hierarquia e é chamado de um item de raiz.

Em qualquer momento, o estado de lista de um item pai dos itens filho pode ser expandido ou recolhido.Quando o estado é expandido, os itens filho são exibidos abaixo do item pai.Quando é recolhido, os itens filho não são exibidos.A lista automaticamente alterna entre os estados expandidos e recolhidos quando o usuário clica duas vezes o item pai ou, se o pai tem o TVS_HASBUTTONS estilo, quando o usuário clica no botão associado ao item pai.Um aplicativo pode expandir ou recolher itens filho usando o Expandir função de membro.

Adicionar um item para um controle de árvore, chamando o InsertItem função de membro.Esta função retorna um identificador do HTREEITEM tipo, que identifica exclusivamente o item.Ao adicionar um item, você deve especificar o identificador do item de pai do novo item.Se você especificar Nulo ou TVI_ROOT valor em vez de um identificador do item pai na TVINSERTSTRUCT estrutura ou hParent parâmetro, o item é adicionado como um item raiz.

Um controle de árvore envia uma TVN_ITEMEXPANDING mensagem de notificação quando a lista de um item pai dos itens de filho está prestes a ser expandido ou recolhido.A notificação oferece a oportunidade para impedir a alteração ou definir os atributos do item pai dependem do estado da lista de itens filho.Depois de alterar o estado da lista, o controle de árvore envia uma TVN_ITEMEXPANDED mensagem de notificação.

Quando uma lista de itens filho é expandida, ele é recuado em relação ao item pai.Você pode definir a quantidade de recuo usando o SetIndent função de membro ou recuperar o valor atual usando o GetIndent função de membro.

Consulte também

Referência

Usando CTreeCtrl

Conceitos

Controles (MFC)