Função InternalGetWindowText (winuser.h)
[Essa função não se destina ao uso geral. Ele pode estar alterado ou indisponível nas versões subsequentes do Windows.]
Copia o texto da barra de título da janela especificada (se tiver um) em um buffer.
Essa função é semelhante à função GetWindowText . No entanto, ele obtém o texto da janela diretamente da estrutura da janela associada ao identificador da janela especificada e sempre fornece o texto como uma cadeia de caracteres Unicode. Isso é diferente de GetWindowText , que obtém o texto enviando à janela uma mensagem WM_GETTEXT . Se a janela especificada for um controle, o texto do controle será obtido.
Sintaxe
int InternalGetWindowText(
[in] HWND hWnd,
[out] LPWSTR pString,
[in] int cchMaxCount
);
Parâmetros
[in] hWnd
Digite: HWND
Um identificador para a janela ou controle que contém o texto.
[out] pString
Tipo: LPWSTR
O buffer que deve 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] cchMaxCount
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.
Retornar valor
Tipo: int
Se a função for bem-sucedida, o valor retornado será o comprimento, em caracteres, da cadeia de caracteres copiada, sem incluir o caractere nulo de terminação.
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.
Comentários
Essa função não foi incluída nos cabeçalhos e bibliotecas do SDK até o Windows XP com o Service Pack 1 (SP1) e o Windows Server 2003. Se você não tiver um arquivo de cabeçalho e uma biblioteca de importação para essa função, poderá chamar a função usando LoadLibrary e GetProcAddress.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |
Confira também
Conceitual
Referência