Funzione HideCaret (winuser.h)

Articolo
08/27/2023

Rimuove il cursore dalla schermata. Nascondere un cursore non distrugge la forma corrente o invalida il punto di inserimento.

Sintassi

BOOL HideCaret(
  [in, optional] HWND hWnd
);

Parametri

[in, optional] hWnd

Tipo: HWND

Handle per la finestra proprietaria del cursore. Se questo parametro è NULL, HideCaret cerca la finestra che possiede il cursore nell'attività corrente.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

HideCaret nasconde il cursore solo se la finestra specificata è proprietaria del cursore. Se la finestra specificata non possiede il cursore, HideCaret non esegue alcuna operazione e restituisce FALSE.

Il nascondiglio è cumulativo. Se l'applicazione chiama HideCaret cinque volte in una riga, deve anche chiamare ShowCaret cinque volte prima che venga visualizzato il cursore.

Per un esempio, vedere Nascondere un cursore.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-caret-l1-1-0 (introdotto in Windows 8)