Condividi tramite


Funzione SetCaretPos (winuser.h)

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)

Vedi anche

Punti di inserimento

Informazioni concettuali

GetCaretPos

HideCaret

Riferimento

ShowCaret