PenInputPanel.InputFailed-Ereignis

Artikel
06/13/2023

Veraltet. PenInputPanel wurde durch den Texteingabebereich (TIP) ersetzt.

Tritt auf, wenn sich der Eingabefokus ändert, bevor das PenInputPanel-Objekt Benutzereingaben in das angefügte Steuerelement einfügen konnte.

Syntax

HRESULT InputFailed(
  [in] long  hWnd,
  [in] long  Key,
  [in] BSTR  Text,
  [in] short ShiftKey
);

Parameter

hWnd [in]

Das Fensterhandle des Steuerelements, das das PenInputPanel-Objekt aufgerufen hat.

Schlüssel [in]

Die virtuelle Taste, die der gedrückten Taste entspricht.

Text [in]

Die Zeichenfolge, die in das Steuerelement eingefügt werden sollte, das durch den hWnd-Parameter dargestellt wird, als das InputFailed-Ereignis ausgelöst wurde.

Weitere Informationen zum BSTR-Datentyp finden Sie unter Verwenden der COM-Bibliothek.

ShiftKey [in]

Der Status der Tastaturmodifizierer, einschließlich UMSCHALT, CAPS, STRG und ALT.

Rückgabewert

Wenn dieses Ereignis erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Das InputFailed-Ereignis tritt auf, wenn sich der Eingabefokus ändert, bevor die Benutzereingabe in das angefügte Steuerelement eingefügt wurde. Wenn der Benutzer beispielsweise Freihand in das Schreibpad eingibt und dann auf ein anderes Bearbeitungssteuerelement tippt, bevor die Erkennung die Möglichkeit hatte, den Vorgang abzuschließen, wird dieses Ereignis ausgelöst.

Mithilfe des an dieses Ereignis übergebenen Fensterhandles können Sie den Text selbst einfügen, wenn dieses Ereignis auftritt.

Hinweis

Ab Microsoft Windows XP Tablet PC Edition 2005 gilt das InputFailed-Ereignis nicht mehr. Text wird immer eingefügt, bevor der Fokus geändert wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Header	msinkaut.h (erfordert auch Msinkaut_i.c)
Bibliothek	InkObj.dll

Siehe auch

Peninputpanel

Freigeben über