SetInputScopes2-Funktion (inputscope.h)

Artikel
08/24/2023

Die Anwendung muss SetInputScope mit IS_DEFAULT aufrufen, bevor ein Fenster zerstört wird, um den Verweis auf die Schnittstelle zu löschen.

Syntax

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

Parameter

[in] hwnd

Das Fenster, in dem der Bereich festgelegt werden soll. Dieser Aufruf ersetzt den Bereich, der sich möglicherweise zuvor auf dem hwnd-Bereich befunden hat.

[in] pInputScopes

Zeiger auf ein Array von Eingabebereichen. Kann NULL sein. Wenn nicht NULL, werden alle darin enthaltenen Bereiche als Eingabebereich des hwnd mit gleicher Gewichtung festgelegt. Verwenden Sie IS_DEFAULT, um auch alle anderen Eingaben zu akzeptieren (dies ist die Option "Nicht zwangen").

[in] cInputScopes

Eine Anzahl der Eingabebereiche in pInputScopes. Muss null sein, wenn rgScopes NULL ist, muss nonzero sein, wenn pInputScopes nicht NULL ist.

[in] pEnumString

IenumString-Schnittstellenzeiger der Ausdrucksliste.

[in] pszRegExp

Zeiger auf eine NULL-beendete Zeichenfolge, die den zu erkennenden regulären Ausdruck beschreibt. Kann NULL sein.

[in] pszSRGS

Zeiger auf eine MIT NULL beendete XML-Zeichenfolge, die sprachspezifische Hinweise und Regeln zur Unterstützung der Spracherkennung bereitstellt. Das XML-Format entspricht dem SRGS-Standard (Speech Recognition Grammar Specification), der unter http://www.w3.org/TR/speech-grammarbeschrieben wird. Kann NULL sein. $

Rückgabewert

Wert	Bedeutung
S_OK	Der Eingabebereich wurde erfolgreich festgelegt oder gelöscht.

Hinweise

Die Anwendung muss SetInputScope mit IS_DEFAULT aufrufen, bevor ein Fenster zerstört wird, um den Verweis auf die Schnittstelle zu löschen.

Wenn Sie diese Methode in einem Fenster (hwnd-Parameter ) aufrufen, das nicht einem Dokument-Manager zugeordnet wurde, werden keine Textdienstbenachrichtigungen an interessierte Clients (z. B. die Touchtastatur) gesendet, die möglicherweise auf die Bereichsänderung reagieren möchten.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	inputscope.h
DLL	Msctf.dll

Freigeben über