Compartilhar via


CWnd::GetWindowText

Copia o título de legenda de CWnd (se houver) no buffer apontado por lpszStringBuf ou na cadeia de caracteres rStringde destino.

int GetWindowText( 
   LPTSTR lpszStringBuf, 
   int nMaxCount  
) const; 
void GetWindowText( 
   CString& rString  
) const;

Parâmetros

  • lpszStringBuf
    Aponta para o buffer que deve receber a cadeia de caracteres copiada de título da janela.

  • nMaxCount
    Especifica o número máximo de caracteres a serem copiados para o buffer, incluindo o caractere de terminação zero. Se a cadeia de caracteres é maior que o número de caracteres especificados em nMaxCount, será truncada.

  • rString
    Um objeto de CString que é receber a cadeia de caracteres copiada de título da janela.

Valor de retorno

Especifica o comprimento, caracteres em, a cadeia de caracteres copiada, não incluindo o caractere de terminação zero. Se é 0 CWnd não tem nenhuma legenda ou se a legenda está vazia.

Comentários

Se o objeto de CWnd é um controle, a função de membro de GetWindowText copia texto dentro do controle em vez de copiar a legenda.

Essa função de membro faz com que a mensagem de WM_GETTEXT a ser enviada para o objeto de CWnd .

Exemplo

Consulte o exemplo para CWnd::SetWindowText.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico da hierarquia

CWnd::SetWindowText

WM_GETTEXT

CWnd::GetWindowTextLength