int InsertItem ( const LVITEM * pItem );
int InsertItem (int nItem, LPCTSTR lpszItem );
int InsertItem (int nItem, LPCTSTR lpszItem, int nImage );
int InsertItem (UINT nMask, int nItem, LPCTSTR lpszItem, UINT nState, UINT nStateMask, int nImage, LPARAM lParam );
Valor de retorno
O índice do novo item se bem-sucedida ou -1 caso contrário.
Parâmetros
pItem
Ponteiro para um estrutura LVITEM que especifica os atributos do item, conforme descrito no Plataforma SDK.
nItem
Índice do item a ser inserido.
lpszItem
Endereço de uma Cadeia de caracteres que contém o rótulo do item, ou LPSTR_TEXTCALLBACK se o item é um item de retorno de chamada. Para obter informações sobre itens de retorno de chamada, consulte CListCtrl:: GetCallbackMask.
nImage
Índice de imagem do item ou I_IMAGECALLBACK se o item é um item de retorno de chamada. Para obter informações sobre itens de retorno de chamada, consulte CListCtrl:: GetCallbackMask.
nMask
O parâmetro nMask especifica qual item atributos passados como parâmetros são válidos. Ele pode ser um ou mais dos valores de máscara descritos no LVITEM structure in The Plataforma SDK. Os valores válidos podem ser combinados com o operador OR bit a bit.
nState
Indica o item estado estado imagem e imagem sobreposição. Consulte os tópicos LVITEM a Plataforma SDK para obter mais informações e Estados do Item de Exibir de lista para obter uma lista de sinalizadores válidos.
nStateMask
Indica os bits da Estado Membro serão ser recuperados ou modificados. Consulte LVITEM no Plataforma SDK para obter mais informações.
nImage
Índice de imagem do item dentro da lista de imagem.
lParam
Um valor de específicas do aplicativo de 32 bits associado ao item. Se este parâmetro for especificado, você deve definir o atributo de nMask LVIF_PARAM.
Observações
Insere um item para o Controlarar de Exibir de lista.
Visão geral de CListCtrl | Membros de classe | Gráfico de hierarquia
Co&nsulte tambémnbsp;CListCtrl::DeleteItem, CListCtrl::DeleteAllItems