WM_GETTEXTLENGTH

Een toepassing verzendt een WM_GETTEXTLENGTH-bericht om te bepalen van de lengte, in tekens, van de tekst die is gekoppeld aan een venster. De lengte omvat niet het afsluitende null-teken.

WM_GETTEXTLENGTH wParam = 0; / / niet gebruikt; moet nul lParam = 0; / / niet gebruikt; moet nul zijn 
 

Parameters

Dit bericht heeft geen parameters.

Retourwaarden

De retourwaarde is de lengte, in tekens, van de tekst.

Standaardactie

De functie DefWindowProc retourneert 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.

Opmerkingen

Voor een besturingselement voor tekst is de tekst te kopiŽren de inhoud van het besturingselement voor bewerking. Voor een keuzelijst met invoervak is de tekst de inhoud van het bewerken besturingselement (of static-tekst) gedeelte van de keuzelijst met invoervak. Voor een knop is de tekst naam van de knop. Voor andere vensters is de tekst de venstertitel. Om te bepalen van de lengte van een item in een keuzelijst, kan een toepassing het bericht LB_GETTEXTLEN.

Onder bepaalde voorwaarden, de DefWindowProc functie geeft als resultaat een waarde die groter is dan de werkelijke lengte van de tekst. 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.

Gebruik om te verkrijgen de exacte lengte van de tekst, de berichten WM_GETTEXT, LB_GETTEXT of 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.

Zie ook

Windows-overzicht, venster berichten, CB_GETLBTEXT, DefWindowProc, GetWindowText, GetWindowTextLength, LB_GETTEXT, LB_GETTEXTLEN, WM_GETTEXT

Index