Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 item pai. Um item filho é exibido abaixo do item pai e está recuado para indicar que está subordinado ao pai. Um item que não tem pai está no topo da hierarquia e é chamado de item raiz.
A qualquer momento, o estado da lista de itens filho de um item pai 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 alterna automaticamente entre os estados expandido e recolhido quando o utilizador faz duplo clique no item pai ou, se o pai tiver a funcionalidade TVS_HASBUTTONS quando o utilizador clica no botão associado ao item pai. Uma aplicação pode expandir ou recolher os itens filho usando a função membro Expand.
Você adiciona um item a um controlo de árvore ao chamar diretamente a função membro InsertItem. Esta função retorna um identificador do tipo HTREEITEM , que identifica exclusivamente o item. Ao adicionar um item, você deve especificar o identificador do item pai do novo item. Se você especificar NULL ou o valor TVI_ROOT em vez de um identificador de item pai na estrutura TVINSERTSTRUCT ou no parâmetro hParent , o item será adicionado como um item raiz.
Um controle de árvore envia uma mensagem de notificação TVN_ITEMEXPANDING quando a lista de itens filho de um item pai está prestes a ser expandida ou recolhida. A notificação oferece a oportunidade de evitar a alteração ou ajustar quaisquer atributos do item pai que dependem do estado da lista de itens filho. Depois de alterar o estado da lista, o controle de árvore envia uma mensagem de notificação TVN_ITEMEXPANDED .
Quando uma lista de itens filho é expandida, ela é indentada em relação ao item principal. Você pode definir a quantidade de recuo usando a função de membro SetIndent ou recuperar a quantidade atual usando a função de membro GetIndent .