CreateCaret

De functie CreateCaret maakt een nieuwe shape voor het systeeminvoegteken en eigendom van de caret toegewezen aan het opgegeven venster. De caret vorm kan worden een lijn, een blok of een bitmap.

BOOL CreateCaret ()  HWND  hWnd, / / verwerken naar eigenaar vensterHBITMAPhBitmap, / / ingang naar bitmap voor caret vormintnWidth, / / caret breedteintnHeight / / caret hoogte);
 

Parameters

hWnd

Het venster dat eigenaar is van de caret identificeert.

hBitmap

Identificeert de bitmap die de caret vorm definieert. Als deze parameter NULL is, is de caret solide. Als deze parameter (HBITMAP) 1 is, is de caret grijs. Als deze parameter een bitmap handvat is, is de caret de opgegeven bitmap. De greep van de bitmap moet zijn gemaakt door de CreateBitmap, CreateDIBitmap, of LoadBitmap -functie.

Als hBitmap een bitmap handvat is, negeert CreateCaret de nWidth en nHeight parameters; de bitmap definieert zijn eigen breedte en hoogte.

nWidth

Hiermee geeft u de breedte van de caret in logische eenheden. Als deze parameter nul is, is de breedte ingesteld op de breedte van de rand systeem gedefinieerde venster. Als hBitmap een bitmap handvat is, negeert CreateCaret deze parameter.

nHeight

Hiermee geeft u de hoogte, in logische eenheden, van de caret. Als deze parameter nul is, is de hoogte ingesteld op de hoogte van de rand systeem gedefinieerde venster. Als hBitmap een bitmap handvat is, negeert CreateCaret deze parameter.

Retourwaarden

Als de functie slaagt, is de retourwaarde aan nul.

Als de functie mislukt, is de retourwaarde nul. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

De nWidth en nHeight parameters opgeven van de caret breedte en hoogte, in logische eenheden; de exacte breedte en hoogte, in pixels, afhankelijk van het venster toewijzing modus.

CreateCaret vernietigt automatisch de vorige caret vorm, indien van toepassing, ongeacht het venster dat eigenaar is van de caret. De caret is verborgen totdat de toepassing roept de functie ShowCaret om zichtbaar te maken de caret.

Het systeem biedt een caret per wachtrij. Een venster moet Maak een caret-teken alleen wanneer het de focus heeft of actief is. Het venster moet de caret vernietigen voordat de toetsenbordfocus te verliezen of steeds inactief.

U kunt ophalen de hoogte of breedte van de vensterrand van het systeem met behulp van de functie GetSystemMetrics , geven de waarden SM_CXBORDER en SM_CYBORDER. Met behulp van het venster grens breedte of hoogte garandeert dat de caret zichtbaar op een hoge resolutie scherm.

Windows CE: Windows CE biedt geen ondersteuning voor de hBitmap -parameter en het moet worden ingesteld op NULL. Windows CE wordt standaard ingesteld op een solide caret.

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.

Zie ook

Caret overzicht, Caret functies, CreateBitmap, CreateDIBitmap, DestroyCaret, GetSystemMetrics, HideCaret, LoadBitmap, ShowCaret

Index