Estrutura TVINSERTSTRUCTW (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 tagTVINSERTSTRUCTW {
  HTREEITEM hParent;
  HTREEITEM hInsertAfter;
  union {
    TVITEMEXW itemex;
    TV_ITEMW  item;
  } DUMMYUNIONNAME;
} TVINSERTSTRUCTW, *LPTVINSERTSTRUCTW;

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: TVITEMEX

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

DUMMYUNIONNAME.item

Tipo: TVITEM

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

Comentários

Os sindicatos nesta 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.
 

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho commctrl.h