GetWindowText

La funzione GetWindowText copia il testo della barra del titolo della finestra specificata (se ne ha uno) in un buffer. Se la finestra specificata di un controllo, viene copiato il testo del controllo. Tuttavia, GetWindowText non possono recuperare il testo di un controllo in un'altra applicazione.

int (GetWindowText HWND  hWnd, / / handle a una finestra o di controllo con il testoLPTSTRlpString, / / indirizzo del buffer per il testointnMaxCount / / massimo numero di caratteri da copiare);
 

Parametri

hWnd
Gestire alla finestra o di controllo che contiene il testo.
lpString
Puntatore al buffer che riceverà il testo.
nMaxCount
Specifica il numero massimo di caratteri da copiare nel buffer, incluso il carattere NULL. Se il testo supera questo limite, esso viene troncato.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è la lunghezza, in caratteri della stringa copiata, non compreso il carattere di terminazione null. Se la finestra non ha nessuna barra del titolo o testo, se la barra del titolo è vuota, o se l'handle di finestra o di controllo non è valido, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Questa funzione non può recuperare il testo di un controllo di modifica in un'altra applicazione.

Osservazioni

Se la finestra di destinazione è di proprietà del processo corrente, GetWindowText provoca un messaggio WM_GETTEXT essere inviati alla finestra specificata o il controllo. Se la finestra di destinazione è di proprietà di un altro processo e ha una didascalia, GetWindowText recupera il testo della didascalia finestra. Se la finestra non ha una didascalia, il valore restituito è una stringa null.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Panoramica di Windows, le funzioni finestra, GetWindowTextLength, SetWindowText, WM_GETTEXT

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index