Funzione CreateCaret (winuser.h)

Articolo
03/15/2023

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)