CreateCaret-Funktion (winuser.h)

Artikel
08/27/2023

Erstellt eine neue Form für das System caret und weist dem angegebenen Fenster den Besitz des Carets zu. Das Caret-Shape kann eine Linie, ein Block oder eine Bitmap sein.

Syntax

BOOL CreateCaret(
  [in]           HWND    hWnd,
  [in, optional] HBITMAP hBitmap,
  [in]           int     nWidth,
  [in]           int     nHeight
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster, das den Caret besitzt.

[in, optional] hBitmap

Typ: HBITMAP

Ein Handle für die Bitmap, die das Caret-Shape definiert. Wenn dieser Parameter NULL ist, ist der Caret ein solider Wert. Wenn dieser Parameter ist, ist (HBITMAP) 1der Caret grau. Wenn es sich bei diesem Parameter um ein Bitmaphandle handelt, ist das Caret die angegebene Bitmap. Das Bitmaphandle muss von der Funktion CreateBitmap, CreateDIBitmap oder LoadBitmap erstellt worden sein.

Wenn hBitmap ein Bitmaphandle ist, ignoriert CreateCaret die Parameter nWidth und nHeight . die Bitmap definiert ihre eigene Breite und Höhe.

[in] nWidth

Typ: int

Die Breite des Carets in logischen Einheiten. Wenn dieser Parameter 0 ist, wird die Breite auf die systemdefinierte Fensterrahmenbreite festgelegt. Wenn hBitmap ein Bitmaphandle ist, ignoriert CreateCaret diesen Parameter.

[in] nHeight

Typ: int

Die Höhe des Carets in logischen Einheiten. Wenn dieser Parameter 0 ist, wird die Höhe auf die systemdefinierte Fensterrahmenhöhe festgelegt. Wenn hBitmap ein Bitmaphandle ist, ignoriert CreateCaret diesen Parameter.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die Parameter nWidth und nHeight geben die Breite und Höhe des Carets in logischen Einheiten an. Die genaue Breite und Höhe in Pixel hängt vom Zuordnungsmodus des Fensters ab.

CreateCaret zerstört automatisch das vorherige Caret-Shape, sofern vorhanden, unabhängig vom Fenster, das das Caret besitzt. Das Caret wird ausgeblendet, bis die Anwendung die ShowCaret-Funktion aufruft , um das Caret sichtbar zu machen.

Das System stellt einen Caret pro Warteschlange bereit. Ein Fenster sollte nur dann ein Caret erstellen, wenn es den Tastaturfokus hat oder aktiv ist. Das Fenster sollte das Caret zerstören, bevor der Tastaturfokus verloren geht oder inaktiv wird.

DPI-Virtualisierung

Diese API ist nicht an der DPI-Virtualisierung beteiligt. Die Breiten- und Höhenparameter werden als logische Größen im Hinblick auf das betreffende Fenster interpretiert. Der aufrufende Thread wird nicht berücksichtigt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-caret-l1-1-0 (in Windows 8 eingeführt)