ListView_InsertItem
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
Essa macro insere um novo item em uma lista-controle de exibição. Você pode usar essa macro ou enviar a mensagem LVM_INSERTITEM explicitamente.
Syntax
int ListView_InsertItem(
HWND hwnd,
const LVITEM FAR* pitem
);
Parameters
- hwnd
Identificador para a lista-controle de exibição.
pitem
Ponteiro para um LVITEM estrutura que especifica os atributos da lista-exibição item. O iItem membro da estrutura especifica o índice do novo item.Não é possível usar ListView_InsertItem Ou LVM_INSERTITEM para inserir subitens; o iSubItem membro das LVITEM estrutura deve ser zero.
Return Value
O índice do novo item indica sucesso. – 1 Indica falha.
Remarks
Se uma lista-exibição controle tem o LVS_SORTASCENDING ou LVS_SORTDESCENDING estilo janela, uma mensagem LVM_INNSETITEM falhará se você tentar inserir um item que tenha LPSTR_TEXTCALLBACK como o pszText membro de seu LVITEM estrutura.
Mensagem relacionada: LVM_INSERTITEM
Requirements
| Header | commctrl.h |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |