CListCtrl::InsertItem

Artigo
02/25/2013

Insere um item no controle de exibição 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
Ponteiro a estrutura de LVITEM que especifica atributos de item, como descrito em Windows SDK.
nItem
Índice do item a ser inserido.
lpszItem
Endereço de uma cadeia de caracteres que contenha o nome do item, ou LPSTR_TEXTCALLBACK se o item for um item de retorno de chamada.Para obter informações sobre os itens de retorno de chamada, consulte CListCtrl::GetCallbackMask.
nImage
Índice de imagem do item, ou I_IMAGECALLBACK se o item for um item de retorno de chamada.Para obter informações sobre os itens de retorno de chamada, consulte CListCtrl::GetCallbackMask.
nMask
O parâmetro de nMask especifica que os atributos de item passado como parâmetros são válidos.Pode ser um ou mais dos valores de máscara descritos em LVITEM Structure em Windows SDK.Os valores válidos podem ser combinados com o operador OR bit a bit.
nState
Indica o estado do item, a imagem de estado, e a imagem de sobreposição.Consulte os tópicos LVITEM Structure para mais informações e List-View Item States de Windows SDK para obter uma lista de sinalizadores válidos.
nStateMask
Indica que bit de membro de estado serão recuperadas ou alterados.Consulte LVITEM Structure em Windows SDK para mais informações.
lParam
Um valor específico do aplicativo de 32 bits associado com o item.Se o parâmetro for especificado, você deve definir o atributo LVIF_PARAMde nMask .

Valor de retorno

O índice do novo item se com êxito ou -1 caso contrário.

Comentários

Chamar esse método pode causar a mensagem de LVM_INSERTITEM seja enviada para a janela do controle.O manipulador de mensagem associada para o controle pode não define o texto do item sob certas condições (como o uso de estilos de janela como LVS_OWNERDRAW).Para obter mais informações sobre essas condições, consulte LVM_INSERTITEM em Windows SDK.

Exemplo

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