Funzione SetInputScope (inputscope.h)

Articolo
03/11/2023

Imposta un ambito di input per la finestra specificata.

Sintassi

HRESULT SetInputScope(
  [in] HWND       hwnd,
  [in] InputScope inputscope
);

Parametri

[in] hwnd

Finestra su cui impostare l'ambito.

[in] inputscope

Ambito di input da associare alla finestra. Per rimuovere l'associazione dell'ambito di input, passare IS_DEFAULT a questo parametro.

Valore restituito

Valore	Significato
S_OK	Il metodo è stato eseguito correttamente.

Commenti

La chiamata a questo metodo sostituisce qualsiasi ambito sia associato alla finestra.

Un'applicazione deve chiamare questo metodo, passando IS_DEFAULT al parametro hwnd , per rimuovere l'associazione dell'ambito di input prima che la finestra venga eliminata.

Questa API funziona solo quando la finestra (parametro hwnd ) e il thread chiamante si trovano nello stesso thread. Se si chiama questa API per una finestra di thread diversa, non riesce con E_INVALIDARG.

Se si chiama questo metodo in una finestra (parametro hwnd ) che non è stato associato a un Document Manager, non vengono inviate notifiche di servizio di testo ai client interessati (ad esempio la tastiera virtuale) che potrebbero voler rispondere alla modifica dell'ambito.

Esempio

[C++]

Il codice seguente illustra come impostare un ambito di input per una finestra.


SetInputScope(hwnd, IS_EMAIL_USERNAME);

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	inputscope.h
DLL	Msctf.dll

Condividi tramite