CListBox::GetText

Artigo
02/25/2013

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 com base zero de cadeia de caracteres a ser recuperada.
lpszBuffer
Aponta para o buffer que recebe a cadeia de caracteres.O buffer deve ter espaço suficiente para a cadeia de caracteres e um caractere de terminação zero.O tamanho da cadeia de caracteres pode ser determinado antemão chamar a função de membro de GetTextLen .
rString
Uma referência a um objeto de CString .

Valor de retorno

O comprimento (em bytes) de cadeia de caracteres, excluindo o caractere de terminação zero.Se nIndex não especifica um índice válido, o valor de retorno é LB_ERR.

Comentários

O segundo formulário de essa função de membro preenche um objeto de CString com o texto da cadeia de caracteres.

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