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 |
|
Nomes Unicode e ANSI |
LVM_INSERTITEMW (Unicode) e ANSI (LVM_INSERTITEMA ) |