CWnd::SetWindowText

Define o título da janela para o texto especificado.

void SetWindowText(
   LPCTSTR lpszString 
);

Parâmetros

  • lpszString
    Aponta para um CString objeto ou seqüência de caracteres terminada com caractere nulo a ser usado sistema autônomo o novo texto de título ou controle.

Comentários

Se a janela é um controle, o texto dentro do controle será conjunto.

Essa função faz com que um WM_SETTEXT mensagem seja enviada a essa janela.

Exemplo

// set the text in IDC_EDITNAME
CWnd* pWnd = GetDlgItem(IDC_EDITNAME);
pWnd->SetWindowText(_T("Gerald Samper"));

// Get the text back. CString is convenient, because MFC
// will automatically allocate enough memory to hold the
// text--no matter how large it is.

CString str;
pWnd->GetWindowText(str);
ASSERT(str == _T("Gerald Samper"));

// The LPTSTR override works, too, but it might be too short.
// If we supply a buffer that's too small, we'll only get those
// characters that fit.

TCHAR sz[10];
int nRet = pWnd->GetWindowText(sz, 10);

// Nine characters, plus terminating null
ASSERT(_tcscmp(sz, _T("Gerald Sa")) == 0);
ASSERT(nRet == 9);

// You can query the length of the text without the length of
// the string using CWnd::GetWindowTextLength()
nRet = pWnd->GetWindowTextLength();
ASSERT(nRet == 13);

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CWnd

Gráfico de hierarquia

CWnd::GetWindowText

SetWindowText

Outros recursos

Membros CWnd