Condividi tramite


Funzione ShowCaret (winuser.h)

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)

Vedi anche

Punti di inserimento

Informazioni concettuali

CreateCaret

DestroyCaret

GetCaretPos

HideCaret

Riferimento

SetCaretPos