GetWindowTextLength

La funzione GetWindowTextLength recupera lunghezza in caratteri di testo barra del titolo della finestra specificata (se la finestra ha una barra del titolo). Se la finestra specificata è un controllo, la funzione recupera la lunghezza del testo all'interno del controllo. Tuttavia, GetWindowTextLength non è possibile recuperare la lunghezza del testo di un controllo di modifica in un'altra applicazione.

int (GetWindowTextLength HWND  hWnd / / handle a una finestra o di controllo con il testo);
 

Parametri

hWnd
Gestire alla finestra o di controllo.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è la lunghezza, in caratteri del testo. In determinate condizioni, questo valore può effettivamente essere maggiore della lunghezza del testo. Per ulteriori informazioni, vedere la sezione Osservazioni seguente.

Se la finestra non ha nessun testo, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

Se la finestra di destinazione è di proprietà del processo corrente, GetWindowTextLength provoca un messaggio WM_GETTEXTLENGTH essere inviati alla finestra specificata o il controllo.

In determinate condizioni, la funzione GetWindowTextLength può restituire un valore maggiore rispetto alla lunghezza effettiva del testo. Questo si verifica con alcune miscele di ANSI e Unicode ed è grazie al sistema che consente la possibile esistenza di caratteri DBCS all'interno del testo. Il valore restituito, tuttavia, sarà sempre grande almeno quanto la lunghezza effettiva del testo; è possibile quindi sempre utilizzarlo per guidare l'allocazione del buffer. Questo comportamento può verificarsi quando un'applicazione utilizza sia funzioni ANSI e finestre di dialogo comuni, che utilizzano Unicode. Può verificarsi anche quando un'applicazione utilizza la versione ANSI della GetWindowTextLength con una finestra in cui la routine della finestra è Unicode o la versione Unicode della GetWindowTextLength con una finestra in cui la routine della finestra è ANSI. Per ulteriori informazioni sulle funzioni ANSI e Unicode, vedere Prototipi di funzione Win32.

Per ottenere l'esatta lunghezza del testo, utilizzare i messaggi WM_GETTEXT, LB_GETTEXTo CB_GETLBTEXT , o la funzione GetWindowText.

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, CB_GETLBTEXT, GetWindowText, LB_GETTEXT, SetWindowText, WM_GETTEXT, WM_GETTEXTLENGTH

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

Index