CListCtrl::InsertItem

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 devuelto

El índice del nuevo elemento si tiene éxito o -1 lo contrario.

Parámetros

pItem

Puntero a un LVITEM estructura que especifica los atributos del elemento, como se describe en el SDK de la plataforma.

nItem

Índice del elemento que se insertará.

lpszItem

 Dirección de una cadena que contiene el elemento de etiqueta, o LPSTR_TEXTCALLBACK si el elemento es un elemento de devolución de llamada. Para obtener información sobre artículos de devolución de llamada, consulte CListCtrl::GetCallbackMask.

nImage

Índice de la imagen del elemento, o I_IMAGECALLBACK si el elemento es un elemento de devolución de llamada. Para obtener información sobre artículos de devolución de llamada, consulte CListCtrl::GetCallbackMask.

nMask

El parámetro nMask especifica qué elemento atributos pasadas como parámetros son válidos. Puede ser uno o más de los valores de máscara se describe en LVITEM estructura en el SDK de la plataforma. Los valores válidos pueden combinarse con el operador OR bit a bit.

nState

Indica el estado del elemento, la imagen de Estado y imagen superpuesta. Consulte los temas de Platform SDK LVITEM para obtener más información y Estados de punto de vista de lista para obtener una lista de indicadores válidos.

nStateMask

Indica qué bits de Estado miembro serán obtenidos o modificados. Ver LVITEM en el SDK de la plataforma para obtener más información.

nImage

Índice de la imagen del elemento dentro de la lista de imágenes.

lParam

Un valor de 32 bits específica de la aplicación asociado al elemento. Si se especifica este parámetro, debe establecer el atributo de nMask LVIF_PARAM.

Observaciones

Inserta un elemento en el control de vista de lista.

I&ntroducción a CListCtrl |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;CListCtrl::DeleteItem, CListCtrl::DeleteAllItems

Index