Funzione CreateCaret (winuser.h)
Crea una nuova forma per il cursore di sistema e assegna la proprietà del cursore alla finestra specificata. La forma del cursore può essere una linea, un blocco o una bitmap.
Sintassi
BOOL CreateCaret(
[in] HWND hWnd,
[in, optional] HBITMAP hBitmap,
[in] int nWidth,
[in] int nHeight
);
Parametri
[in] hWnd
Tipo: HWND
Handle per la finestra proprietaria del cursore.
[in, optional] hBitmap
Tipo: HBITMAP
Handle per la bitmap che definisce la forma del cursore. Se questo parametro è NULL, il cursore è solido. Se questo parametro è (HBITMAP) 1
, il cursore è grigio. Se questo parametro è un handle bitmap, il cursore è la bitmap specificata. L'handle bitmap deve essere stato creato dalla funzione CreateBitmap, CreateDIBitmap o LoadBitmap .
Se hBitmap è un handle bitmap, CreateCaret ignora i parametri nWidth e nHeight ; la bitmap definisce la larghezza e l'altezza.
[in] nWidth
Tipo: int
Larghezza del cursore, in unità logiche. Se questo parametro è zero, la larghezza viene impostata sulla larghezza del bordo della finestra definita dal sistema. Se hBitmap è un handle bitmap, CreateCaret ignora questo parametro.
[in] nHeight
Tipo: int
Altezza del cursore, in unità logiche. Se questo parametro è zero, l'altezza viene impostata sull'altezza del bordo della finestra definita dal sistema. Se hBitmap è un handle bitmap, CreateCaret ignora questo parametro.
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
I parametri nWidth e nHeight specificano la larghezza e l'altezza del cursore, in unità logiche; la larghezza e l'altezza esatte, in pixel, dipendono dalla modalità di mapping della finestra.
CreateCaret elimina automaticamente la forma del cursore precedente, se presente, indipendentemente dalla finestra proprietaria del cursore. Il cursore viene nascosto finché l'applicazione non chiama la funzione ShowCaret per rendere visibile il cursore.
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.
Virtualizzazione DPI
Questa API non partecipa alla virtualizzazione DPI. I parametri di larghezza e altezza vengono interpretati come dimensioni logiche in termini di finestra in questione. Il thread chiamante non viene preso in considerazione.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
Informazioni concettuali
Altre risorse
Riferimento
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per