GetWindowTextLength

De GetWindowTextLength functie haalt de lengte in tekens, van de tekst van het opgegeven venster titelbalk (als het venster een titelbalk heeft). Als het opgegeven venster een besturingselement is, haalt de functie de lengte van de tekst binnen het besturingselement. Echter ophalen GetWindowTextLength niet van de lengte van de tekst van een edit-besturingselement in een andere toepassing.

int () GetWindowTextLength HWND  hWnd / / verwerken naar venster of controle met tekst);
 

Parameters

hWnd
Ingang naar de venster of besturingselement.

Retourwaarden

Als de functie slaagt, is de retourwaarde de lengte in tekens, van de tekst. Onder bepaalde voorwaarden, kan deze waarde daadwerkelijk worden groter is dan de lengte van de tekst. Voor meer informatie, zie de volgende sectie opmerkingen.

Als het venster geen tekst heeft, is de retourwaarde nul. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

Als het doelvenster is eigendom van het huidige proces, veroorzaakt GetWindowTextLength een WM_GETTEXTLENGTH -bericht worden verzonden naar het opgegeven venster of besturingselement.

De GetWindowTextLength functie kan onder bepaalde voorwaarden, een waarde die groter is dan de werkelijke lengte van de tekst retourneren. Dit gebeurt met bepaalde mengsels van ANSI en Unicode, en is te wijten aan het systeem toe te staan voor het mogelijke bestaan van DBCS-tekens in de tekst. De geretourneerde waarde, echter, zal altijd worden ten minste zo groot is als de werkelijke lengte van de tekst; je kan dus altijd gebruiken om te begeleiden buffertoewijzing. Dit probleem kan optreden wanneer een toepassing maakt gebruik van zowel ANSI functies en gemeenschappelijke dialogen, die gebruikmaken van Unicode. Het kan ook optreden wanneer een toepassing gebruikt de ANSI-versie van GetWindowTextLength met een venster waarvan venster procedure is Unicode, of de Unicode-versie van GetWindowTextLength met een venster waarvan venster procedure ANSI is. Zie voor meer informatie over functies van ANSI en Unicode, Win32 functie Prototypes.

Gebruik om te verkrijgen de exacte lengte van de tekst, de berichten WM_GETTEXT, LB_GETTEXTof CB_GETLBTEXT , of de GetWindowText -functie.

Syntaxisinfo

nbsp;áWindows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 1.0 of hoger vereist.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.
Unicode:Ge´mplementeerd als Unicode en ANSI-versies van Windows NT.

Zie ook

Windows, overzicht, functies van het venster, CB_GETLBTEXT, GetWindowText, LB_GETTEXT, SetWindowText, WM_GETTEXT, WM_GETTEXTLENGTH

Index