GetWindowText

De functie GetWindowText kopieert de tekst van de titelbalk van het opgegeven venster (als die er is) in een buffer. Als het opgegeven venster een besturingselement is, wordt de tekst van het besturingselement gekopieerd. Echter ophalen GetWindowText niet van de tekst van een besturingselement in een andere toepassing.

int () GetWindowText HWND  hWnd, / / verwerken naar venster of controle met tekstLPTSTRlpString, / / adres van de buffer voor tekstintnMaxCount / / maximum aantal tekens kopiŽren);
 

Parameters

hWnd
Ingang naar de venster of besturingselement met de tekst.
lpString
Pointer naar de buffer die de tekst ontvangt.
nMaxCount
Hiermee geeft u het maximum aantal tekens te kopiŽren naar de buffer, inclusief het NULL-teken. Als de tekst groter is dan deze limiet, wordt het afgekapt.

Retourwaarden

Als de functie slaagt, is de retourwaarde de lengte in tekens, van de gekopieerde tekenreeks, niet met inbegrip van het afsluitende null-teken. Als het venster heeft geen titelbalk of tekst, als de titelbalk leeg is, of als het venster of besturingselement handvat is ongeldig, is de retourwaarde nul. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Deze functie kan niet ophalen van de tekst van een edit-besturingselement in een andere toepassing.

Opmerkingen

Als het doelvenster is eigendom van het huidige proces, veroorzaakt GetWindowText een WM_GETTEXT -bericht worden verzonden naar het opgegeven venster of besturingselement. Als het doelvenster is eigendom van een ander proces en een bijschrift heeft, haalt GetWindowText het bijschrift van het venster. Als het venster geen een bijschrift heeft, is de retourwaarde een null-reeks.

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, GetWindowTextLength, SetWindowText, WM_GETTEXT

Index