SetInputScopes-Funktion (inputscope.h)

Artikel
08/24/2023

Legt eine Kombination aus einem Eingabebereich, mehreren Eingabebereichen, einer Ausdrucksliste, einem regulären Ausdruck und/oder SRGS-Regeln (Speech Recognition Grammar Specification) für das angegebene Fenster fest.

Syntax

HRESULT SetInputScopes(
  [in] HWND             hwnd,
  [in] const InputScope *pInputScopes,
  [in] UINT             cInputScopes,
  [in] PWSTR            *ppszPhraseList,
  [in] UINT             cPhrases,
  [in] PWSTR            pszRegExp,
  [in] PWSTR            pszSRGS
);

Parameter

[in] hwnd

Das Fenster, in dem der Bereich festgelegt werden soll.

[in] pInputScopes

Zeiger auf ein Array von Eingabebereichen. Kann NULL sein. Wenn nicht NULL, werden alle Eingabebereiche im Array als Eingabebereich des Fensters mit gleicher Gewichtung festgelegt. Verwenden Sie IS_DEFAULT, um auch alle anderen Eingabebereiche zu akzeptieren.

[in] cInputScopes

Die Anzahl der Eingabebereiche im Array, auf die von *pInputScopes verwiesen wird. Dieser Wert muss null sein, wenn das Array NULL ist.

[in] ppszPhraseList

Zeiger auf ein Array von Zeigern auf NULL-beendete Ausdrücke. Kann NULL sein.

[in] cPhrases

Anzahl der Zeiger, auf die von **ppszPhraseList verwiesen wird, die die Anzahl der Ausdrücke darstellt.

[in] pszRegExp

Zeiger auf eine NULL-beendete Zeichenfolge, die den zu erkennenden regulären Ausdruck enthält. 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	Die Methode war erfolgreich.

Hinweise

Das Aufrufen dieser Methode ersetzt den bereich, der dem Fenster zugeordnet ist.

Diese API funktioniert nur, wenn sich das Fenster (hwnd-Parameter) und der aufrufende Thread im selben Thread befinden. Wenn Sie diese API für das Fenster eines anderen Threads aufrufen, schlägt dies mit E_INVALIDARG fehl.

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