Compartilhar via

Estrutura TVINSERTSTRUCTA (commctrl.h)

  • Artigo

Contém informações usadas para adicionar um novo item a um controle de exibição de árvore. Essa estrutura é usada com a mensagem TVM_INSERTITEM. A estrutura é idêntica à estrutura TV_INSERTSTRUCT, mas foi renomeada para seguir as convenções de nomenclatura atuais.

Sintaxe

typedef struct tagTVINSERTSTRUCTA {
  HTREEITEM hParent;
  HTREEITEM hInsertAfter;
  union {
    TVITEMEXA itemex;
    TV_ITEMA  item;
  } DUMMYUNIONNAME;
} TVINSERTSTRUCTA, *LPTVINSERTSTRUCTA;

Membros

hParent

Tipo: HTREEITEM

Manipule para o item pai. Se esse membro for o valor TVI_ROOT ou NULL, o item será inserido na raiz do controle de exibição de árvore.

hInsertAfter

Tipo: HTREEITEM

Manipule para o item após o qual o novo item deve ser inserido ou um dos seguintes valores:

Valor Significado
TVI_FIRST
 Insere o item no início da lista.
TVI_LAST
 Insere o item no final da lista.
TVI_ROOT
 Adicione o item como um item raiz.
TVI_SORT
 Insere o item na lista em ordem alfabética.

DUMMYUNIONNAME

DUMMYUNIONNAME.itemex

Tipo de : TVITEMEX

versão 4.71. estrutura TVITEMEX que contém informações sobre o item a ser adicionado.

DUMMYUNIONNAME.item

Tipo de : TVITEM

estrutura TVITEM que contém informações sobre o item a ser adicionado.

Observações

Os sindicatos nessa estrutura foram atualizados para trabalhar com compiladores que não dão suporte a uniões sem nome. Se o compilador não der suporte a uniões sem nome, defina o token NONAMELESSUNION antes de incluir o arquivo de cabeçalho commctrl.h.

Importante Usar TVI_LAST para inserir um item em um nó de exibição de árvore que já contém um grande número de itens pode levar muito tempo, fazendo com que o aplicativo pare de responder até que a operação de inserção seja concluída.
 

Nota

O cabeçalho commctrl.h define TVINSERTSTRUCT 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