LVM_INSERTITEM mensagem

Insere um novo item em um controle de exibição de lista. Você pode enviar essa mensagem explicitamente ou usando a macro ListView_InsertItem .

Parâmetros

wParam

Deve ser zero.

lParam

Ponteiro para uma estrutura LVITEM que especifica os atributos do item de exibição de lista. Use o membro iItem para especificar o índice baseado em zero no qual o novo item deve ser inserido. Se esse valor for maior que o número de itens atualmente contidos pela visão de lista, o novo item será acrescentado ao final da lista e atribuído ao índice correto. Examine o valor retornado da mensagem para determinar o índice real atribuído ao item.

Valor retornado

Retorna o índice do novo item se tiver êxito ou -1 caso contrário.

Comentários

Não é possível usar ListView_InsertItem ou LVM_INSERTITEM para inserir subitems. O membro iSubItem da estrutura LVITEM deve ser zero. Consulte LVM_SETITEM para obter informações sobre como definir subitems.

Se um controle de exibição de lista tiver o conjunto de estilos LVS_EX_CHECKBOXES , qualquer valor colocado nos bits 12 a 15 do membro de estado da estrutura LVITEM será ignorado. Quando um item é adicionado com esse conjunto de estilos, ele sempre será definido como o estado desmarcado.

Se um controle de exibição de lista tiver o estilo de janela LVS_SORTASCENDING ou LVS_SORTDESCENDING , uma mensagem LVM_INSERTITEM falhará se você tentar inserir um item que tenha LPSTR_TEXTCALLBACK como o valor de seu membro pszText .

A mensagem LVM_INSERTITEM inserirá o novo item na posição adequada na ordem de classificação se as seguintes condições forem retensas:

  • Você está usando um dos estilos de LVS_SORTXXX.
  • Você não está usando o estilo LVS_OWNERDRAW .
  • O membro pszText da estrutura apontada por pitem não está definido como LPSTR_TEXTCALLBACK.

Se a estrutura LVITEM não contiver LVIF_GROUPID no membro mask , o valor do membro iGroupId será I_GROUPIDCALLBACK por padrã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
Nomes Unicode e ANSI
LVM_INSERTITEMW (Unicode) e ANSI (LVM_INSERTITEMA )