CListCtrl::InsertItem

Artículo
02/19/2013

Inserta un elemento en el control de vista de lista.

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
);

Parámetros

pItem
Puntero a una estructura de LVITEM que especifica los atributos del elemento, como se describe en Windows SDK.
nItem
Índice del elemento que se va a insertar.
lpszItem
Dirección de una cadena que contiene la etiqueta de elemento, o LPSTR_TEXTCALLBACK si el elemento es un elemento de devolución de llamada.Para obtener información sobre elementos de devolución de llamada, vea CListCtrl::GetCallbackMask.
nImage
Índice del elemento, o I_IMAGECALLBACK si el elemento es un elemento de devolución de llamada.Para obtener información sobre elementos de devolución de llamada, vea CListCtrl::GetCallbackMask.
nMask
El parámetro de nMask especifica que los atributos del elemento pasadas como parámetros son válidos.Puede ser uno o varios de los valores de la máscara descritos en LVITEM Structure en Windows SDK.Los valores válidos se pueden combinar con el OR bit a bit el operador.
nState
Indica el estado del elemento, la imagen del estado, y la imagen de superposición.Vea los temas LVITEM Structure para obtener más información y List-View Item States de Windows SDK para una lista de marcas válidas.
nStateMask
Indica qué bits miembro de estado se recuperarán o modificados.Vea LVITEM Structure en Windows SDK para obtener más información.
lParam
Valor específico de la aplicación de 32 bits asociado al elemento.Si se especifica este parámetro, debe establecer el atributo LVIF_PARAMde nMask .

Valor devuelto

El índice del nuevo elemento si correctamente o -1 de otra manera.

Comentarios

Llamar a este método puede provocar el mensaje de LVM_INSERTITEM se envía a la ventana de control.El controlador de mensajes asociado para el control no pueda para establecer el texto del elemento en ciertas condiciones (como utilizar estilos de ventana como LVS_OWNERDRAW).Para obtener más información sobre estas condiciones, hace referencia a LVM_INSERTITEM en Windows SDK.

Ejemplo

        CString strText;
        int nColumnCount = m_myListCtrl.GetHeaderCtrl()->GetItemCount();

        // Insert 10 items in the list view control.
        for (int i = 0; i < 10; i++)
        {
            strText.Format(TEXT("item %d"), i);

            // Insert the item, select every other item.
            m_myListCtrl.InsertItem(LVIF_TEXT | LVIF_STATE, i, strText, 
                (i % 2) == 0 ? LVIS_SELECTED : 0, LVIS_SELECTED, 0, 0);

            // Initialize the text of the subitems.
            for (int j = 1; j < nColumnCount; j++)
            {
                strText.Format(TEXT("sub-item %d %d"), i, j);
                m_myListCtrl.SetItemText(i, j, strText);
            }
        }