Função GetWindowTextW (winuser.h)
Copia o texto da barra de título da janela especificada (se tiver um) em um buffer. Se a janela especificada for um controle, o texto do controle será copiado. No entanto, GetWindowText não pode recuperar o texto de um controle em outro aplicativo.
Sintaxe
int GetWindowTextW(
[in] HWND hWnd,
[out] LPWSTR lpString,
[in] int nMaxCount
);
Parâmetros
[in] hWnd
Tipo: HWND
Um identificador para a janela ou controle que contém o texto.
[out] lpString
Tipo: LPTSTR
O buffer que receberá o texto. Se a cadeia de caracteres for longa ou maior que o buffer, a cadeia de caracteres será truncada e terminada com um caractere nulo.
[in] nMaxCount
Tipo: int
O número máximo de caracteres a serem copiados para o buffer, incluindo o caractere nulo. Se o texto exceder esse limite, ele será truncado.
Valor de retorno
Tipo: int
Se a função for bem-sucedida, o valor retornado será o comprimento, em caracteres, da cadeia de caracteres copiada, não incluindo o caractere nulo de encerramento. Se a janela não tiver nenhuma barra de título ou texto, se a barra de título estiver vazia ou se a janela ou o identificador de controle for inválido, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Essa função não pode recuperar o texto de um controle de edição em outro aplicativo.
Observações
Se a janela de destino pertencer ao processo atual, GetWindowText fará com que uma mensagem WM_GETTEXT seja enviada para a janela ou controle especificado. Se a janela de destino pertencer a outro processo e tiver uma legenda, GetWindowText recuperará o texto da legenda da janela. Se a janela não tiver uma legenda, o valor retornado será uma cadeia de caracteres nula. Esse comportamento é por design. Ele permite que os aplicativos chamem GetWindowText sem ficar sem resposta se o processo que possui a janela de destino não estiver respondendo. No entanto, se a janela de destino não estiver respondendo e pertencer ao aplicativo de chamada, GetWindowText fará com que o aplicativo de chamada não responda.
Para recuperar o texto de um controle em outro processo, envie uma mensagem WM_GETTEXT diretamente em vez de chamar GetWindowText.
Exemplos
Para obter um exemplo, consulte Enviar uma mensagem.
Nota
O cabeçalho winuser.h define GetWindowText como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winuser.h (inclua Windows.h) |
| biblioteca | User32.lib |
| de DLL |
User32.dll |
| conjunto de API | ext-ms-win-ntuser-window-l1-1-4 (introduzido no Windows 10, versão 10.0.14393) |
Consulte também
Conceitual
de referência de