Funzione ShowCaret (winuser.h)

Articolo
08/28/2023

Rende visibile il cursore sullo schermo nella posizione corrente del cursore. Quando il cursore diventa visibile, inizia a lampeggiare automaticamente.

Sintassi

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

Parametri

[in, optional] hWnd

Tipo: HWND

Handle per la finestra proprietaria del cursore. Se questo parametro è NULL, ShowCaret cerca la finestra corrente proprietaria del cursore.

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

ShowCaret mostra il cursore solo se la finestra specificata possiede il cursore, il cursore ha una forma e il cursore non è stato nascosto due o più volte in una riga. Se una o più di queste condizioni non vengono soddisfatte, ShowCaret 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 il cursore venga nuovamente visualizzato.

Il sistema fornisce un punto di inserimento per coda. Una finestra deve creare un punto di inserimento solo quando ha lo stato attivo della tastiera o è attivo. La finestra deve distruggere il cursore prima di perdere lo stato attivo della tastiera o diventare inattivo.

Esempio

Per un esempio, vedere Creazione e visualizzazione di 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)