CListBox::GetText

Artigo
08/25/2010

Obtém uma cadeia de caracteres de uma caixa de listagem.

int GetText(
   int nIndex,
   LPTSTR lpszBuffer 
) const;
void GetText(
   int nIndex,
   CString& rString 
) const;

Parâmetros

nIndex
Especifica o índice baseado em zero da seqüência de caracteres a serem recuperados.
lpszBuffer
Aponta para o buffer que recebe a seqüência de caracteres.O buffer deve ter espaço suficiente para a seqüência de caracteres e um caractere nulo de terminação.O dimensionar da seqüência de caracteres pode ser determinado antes do time, chamando o GetTextLen função de membro.
rString
Uma referência a um CString objeto.

Valor de retorno

O comprimento (em bytes) da seqüência de caracteres, exceto o caractere nulo de terminação.If nIndex não especifica um índice válido, o valor retornado é LB_ERR.

Comentários

O segundo formulário desta função de membro preenche um CString objeto com o texto da seqüência.

Exemplo

// Dump all of the items in the list box.
CString str, str2;
int n;
for (int i = 0; i < m_myListBox.GetCount(); i++)
{
   n = m_myListBox.GetTextLen(i);
   m_myListBox.GetText(i, str.GetBuffer(n));
   str.ReleaseBuffer();

   str2.Format(_T("item %d: %s\r\n"), i, str.GetBuffer(0));
   AFXDUMP(str2);
}