Funzione SetCaretPos (winuser.h)

Articolo
03/13/2024

Sposta il cursore sulle coordinate specificate. Se la finestra proprietaria del cursore è stata creata con lo stile della classe CS_OWNDC , le coordinate specificate sono soggette alla modalità di mapping del contesto di dispositivo associato a tale finestra.

Sintassi

BOOL SetCaretPos(
  [in] int X,
  [in] int Y
);

Parametri

[in] X

Tipo: int

Nuova coordinata x del cursore.

[in] Y

Tipo: int

Nuova coordinata y 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

SetCaretPos sposta il cursore se il cursore è nascosto.

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. Una finestra può impostare la posizione del cursore solo se è proprietaria del cursore.

Virtualizzazione DPI

Questa API non partecipa alla virtualizzazione DPI. La posizione specificata viene interpretata come coordinate logiche in termini di finestra associata al cursore. Il thread chiamante non viene preso in considerazione.

Esempio

Per un esempio, vedere Creazione e visualizzazione di un cursore.

Requisiti

Requisito	Valore
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)