SetInputScope-Funktion (inputscope.h)

Artikel
08/24/2023

Legt einen Eingabebereich für das angegebene Fenster fest.

Syntax

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

Parameter

[in] hwnd

Das Fenster, in dem der Bereich festgelegt werden soll.

[in] inputscope

Der Eingabebereich, der dem Fenster zugeordnet werden soll. Um die Zuordnung des Eingabebereichs zu entfernen, übergeben Sie IS_DEFAULT an diesen Parameter.

Rückgabewert

Wert	Bedeutung
S_OK	Die Methode war erfolgreich.

Hinweise

Durch aufrufen dieser Methode wird der bereich ersetzt, der dem Fenster zugeordnet ist.

Eine Anwendung muss diese Methode aufrufen und IS_DEFAULT an den hwnd-Parameter übergeben, um die Eingabebereichszuordnung zu entfernen, bevor das Fenster zerstört wird.

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 sie mit E_INVALIDARG fehl.

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

Beispiele

[C++]

Der folgende Code veranschaulicht, wie ein Eingabebereich für ein Fenster festgelegt wird.


SetInputScope(hwnd, IS_EMAIL_USERNAME);

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