Compartilhar via


CWnd::GetWindowText

Copia o CWnd título da legenda (caso haja algum) para o buffer apontado por lpszStringBuf ou na seqüência de destino rString.

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

Parâmetros

  • lpszStringBuf
    Aponta para o buffer que receberá a seqüência 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 nulo de terminação.Se a seqüência de caracteres for maior do que o número de caracteres especificado em nMaxCount, será truncado.

  • rString
    A CString objeto que deve receber a seqüência de caracteres copiada de título da janela.

Valor de retorno

Especifica o comprimento, em caracteres da seqüência de caracteres copiada, sem o caractere nulo de terminação.Ele será 0 se CWnd não tem nenhuma legenda ou se a legenda está vazia.

Comentários

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

Esta função de membro faz com que o WM_GETTEXT mensagem seja enviada para o CWnd objeto.

Exemplo

Consulte o exemplo para CWnd::SetWindowText.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CWnd

Gráfico de hierarquia

CWnd::SetWindowText

WM_GETTEXT

CWnd::GetWindowTextLength

Outros recursos

Membros CWnd