Compartilhar via


Rótulos do item de controle de árvore

Normalmente, você especifica o texto do rótulo de um item ao adicionar o item ao controle de árvore (CTreeCtrl). A função membro InsertItem pode passar uma estrutura TVITEM que define as propriedades do item, incluindo uma cadeia de caracteres que contém o texto do rótulo. InsertItem tem várias sobrecargas que podem ser chamadas com várias combinações de parâmetros.

Um controle de árvore aloca memória para armazenar cada item; o texto dos rótulos de item ocupa uma parte significativa dessa memória. Se o aplicativo mantiver uma cópia das cadeias de caracteres no controle de árvore, você poderá diminuir os requisitos de memória do controle especificando o valor LPSTR_TEXTCALLBACK no membro pszText de TV_ITEM ou no parâmetro lpszItem em vez de passar cadeias de caracteres reais para o controle de árvore. Usar LPSTR_TEXTCALLBACK faz com que o controle de árvore recupere o texto do rótulo de um item do aplicativo sempre que o item precisar ser redesenhado. Para recuperar o texto, o controle de árvore envia uma mensagem de notificação TVN_GETDISPINFO, que inclui o endereço de uma estrutura NMTVDISPINFO. Você deve responder definindo os membros apropriados da estrutura incluída.

Um controle de árvore usa memória alocada do heap do processo que cria o controle de árvore. O número máximo de itens em um controle de árvore baseia-se na quantidade de memória disponível no heap. Cada item toma 64 bytes.

Confira também

Usando CTreeCtrl
Controles