CListCtrl::InsertItem

Artigo
08/25/2010

Insere um item para o controle de modo 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 para um LVITEM estrutura que especifica atributos do item, conforme descrito no Windows SDK.
nItem
Índice do item a ser inserido.
lpszItem
Endereço de uma seqüência de caracteres que contém o rótulo do item ou LPSTR_TEXTCALLBACK Se o item for 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 for um item de retorno de chamada. Para obter informações sobre itens de retorno de chamada, consulte CListCtrl::GetCallbackMask.
nMask
The nMask parâmetro especifica qual item atributos passados sistema autônomo parâmetros são válido. Pode ser um ou mais dos valores de máscara descritos em LVITEM Structure no Windows SDK. Os valores válido podem ser combinados com o operador OR bit a bit.
nState
Indica o estado do item, imagem de estado e imagem de sobreposição.Consulte o Windows SDK tópicos LVITEM Structure Para obter mais informações e List-View Item States Para obter uma lista de sinalizadores válido.
nStateMask
Indica os bits do membro estado será ou modificados.See LVITEM Structure no Windows SDK Para obter mais informações.
lParam
Um valor específico do aplicativo de 32 bit associado ao item.Se este parâmetro for especificado, você deve conjunto o nMask atributo LVIF_PARAM.

Valor de retorno

O índice do novo item se for bem-sucedido ou -1 caso contrário.

Comentários

Chamar esse método pode fazer com que o LVM_INSERTITEM mensagem seja enviada para a janela do controle.O manipulador de mensagens associada para o controle pode falhar ao conjunto o texto do item sob determinadas condições (por exemplo, usando a janela estilos, sistema autônomo LVS_OWNERDRAW).Para obter mais informações nestas condições, consulte LVM_INSERTITEM in the 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);
   }
}