SetCaretBlinkTime-Funktion (winuser.h)

Legt die Caret-Blinkzeit auf die angegebene Anzahl von Millisekunden fest. Die Blinkzeit ist die verstrichene Zeit in Millisekunden, die zum Umkehren der Pixel des Carets erforderlich ist.

Syntax

BOOL SetCaretBlinkTime(
  [in] UINT uMSeconds
);

Parameter

[in] uMSeconds

Typ: UINT

Die neue Blinkzeit in Millisekunden.

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

Der Benutzer kann die Blinkzeit mithilfe des Systemsteuerung festlegen. Anwendungen sollten die vom Benutzer gewählte Einstellung berücksichtigen. Die SetCaretBlinkTime-Funktion sollte nur von einer Anwendung verwendet werden, die es dem Benutzer ermöglicht, die Blinkzeit festzulegen, z. B. ein Systemsteuerung Applet.

Wenn Sie die Blinkzeit ändern, verwenden anschließend aktivierte Anwendungen die geänderte Blinkzeit, auch wenn Sie die vorherige Blinkzeit wiederherstellen, wenn Sie den Tastaturfokus verlieren oder inaktiv werden. Dies ist auf die Multithreadumgebung zurückzuführen, in der die Deaktivierung Ihrer Anwendung nicht mit der Aktivierung einer anderen Anwendung synchronisiert wird. Dieses Feature ermöglicht es dem System, eine andere Anwendung zu aktivieren, auch wenn die aktuelle Anwendung nicht reagiert.

Anforderungen

Anforderung	Wert
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 (eingeführt in Windows 8)

Weitere Informationen

Carets

Konzept

GetCaretBlinkTime

Referenz