Funzione InternalGetWindowText (winuser.h)

Articolo
03/13/2024

[Questa funzione non è destinata all'uso generale. Potrebbe essere modificata o non disponibile nelle versioni successive di Windows.]

Copia il testo della barra del titolo della finestra specificata (se presente) in un buffer.

Questa funzione è simile alla funzione GetWindowText . Tuttavia, ottiene il testo della finestra direttamente dalla struttura della finestra associata all'handle della finestra specificata e quindi fornisce sempre il testo come stringa Unicode. A differenza di GetWindowText , che ottiene il testo inviando alla finestra un messaggio di WM_GETTEXT . Se la finestra specificata è un controllo , viene ottenuto il testo del controllo .

Sintassi

int InternalGetWindowText(
  [in]  HWND   hWnd,
  [out] LPWSTR pString,
  [in]  int    cchMaxCount
);

Parametri

[in] hWnd

Tipo: HWND

Handle per la finestra o il controllo contenente il testo.

[out] pString

Tipo: LPWSTR

Buffer che deve ricevere il testo.

Se la stringa è lunga o più lunga del buffer, la stringa viene troncata e terminata con un carattere Null.

[in] cchMaxCount

Tipo: int

Numero massimo di caratteri da copiare nel buffer, incluso il carattere Null. Se il testo supera questo limite, viene troncato.

Valore restituito

Tipo: int

Se la funzione ha esito positivo, il valore restituito è la lunghezza, in caratteri, della stringa copiata, senza includere il carattere null di terminazione.

Se la finestra non ha barra del titolo o testo, se la barra del titolo è vuota o se la finestra o l'handle di controllo non è valido, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Questa funzione non è stata inclusa nelle intestazioni e nelle librerie dell'SDK fino a quando Windows XP con Service Pack 1 (SP1) e Windows Server 2003. Se non si dispone di un file di intestazione e di una libreria di importazione per questa funzione, è possibile chiamare la funzione usando LoadLibrary e GetProcAddress.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll