Compartilhar via


CWnd::GetDlgItemText

Chamar essa função de membro para recuperar o título ou para texto associado com um controle em uma caixa de diálogo.

int GetDlgItemText( 
   int nID, 
   LPTSTR lpStr, 
   int nMaxCount  
) const; 
int GetDlgItemText( 
   int nID, 
   CString& rString  
) const;

Parâmetros

  • nID
    Especifica o identificador inteiro de controle cujo título deve ser recuperado.

  • lpStr
    Aponta para o buffer para receber o título ou o texto do controle.

  • nMaxCount
    Especifica o comprimento máximo (de caracteres) de cadeia de caracteres a ser copiada para lpStr. Se a cadeia de caracteres é maior que nMaxCount, será truncada.

  • rString
    Uma referência a CString.

Valor de retorno

Especifica o número real de caracteres copiados para o buffer, não incluindo o caractere de terminação zero. o valor é 0 se nenhum texto é copiado.

Comentários

A função de membro de GetDlgItemText copia texto para o local apontado por lpStr e retorna uma contagem o número de bytes que copia.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico da hierarquia

CWnd::GetDlgItem

CWnd::GetDlgItemInt

GetDlgItemText

WM_GETTEXT