Funzione SetInputScopes2 (inputscope.h)

L'applicazione deve chiamare SetInputScope con IS_DEFAULT prima che una finestra venga eliminata per cancellare il riferimento dell'interfaccia.

Sintassi

HRESULT SetInputScopes2(
  [in] HWND             hwnd,
  [in] const InputScope *pInputScopes,
  [in] UINT             cInputScopes,
  [in] IEnumString      *pEnumString,
  [in] PWSTR            pszRegExp,
  [in] PWSTR            pszSRGS
);

Parametri

[in] hwnd

Finestra su cui impostare l'ambito. Questa chiamata sostituirà qualsiasi ambito possa essere stato chiamato prima.

[in] pInputScopes

Puntatore a una matrice di ambiti di input. Può essere NULL. Se non NULL, tutti gli ambiti contenuti all'interno verranno impostati come ambito di input dell'oggetto hwnd con peso uguale. Usare IS_DEFAULT per accettare anche tutti gli altri input (questa è l'opzione "non coerci").

[in] cInputScopes

Conteggio del numero di ambiti di input in pInputScopes. Deve essere zero se rgScopes è NULL, deve essere diverso da zero se pInputScopes non è NULL.

[in] pEnumString

Puntatore dell'interfaccia IenumString dell'elenco di frasi.

[in] pszRegExp

Puntatore a una stringa con terminazione NULL che descrive l'espressione regolare da riconoscere. Può essere NULL.

[in] pszSRGS

Puntatore a una stringa XML con terminazione NULL che fornisce hint e regole specifici per il riconoscimento vocale. Il formato XML è conforme allo standard SRGS (Speech Recognition Grammar Specification), descritto in http://www.w3.org/TR/speech-grammar. Può essere NULL. $

Valore restituito

Valore	Significato
S_OK	L'ambito di input impostato o cancellato correttamente.

Commenti

L'applicazione deve chiamare SetInputScope con IS_DEFAULT prima che una finestra venga eliminata per cancellare il riferimento dell'interfaccia.

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.

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