IPenInputPanel::EnableTsf-Methode (peninputpanel.h)

  • Artikel

[ PenInputPanel wurde durch den Texteingabebereich (TIP) ersetzt.]

Veraltet. Ruft einen booleschen Wert ab, der angibt, ob das PenInputPanel-Objekt versucht, Text über das Text Services Framework (TSF) an das angefügte Steuerelement zu senden, und ermöglicht die Verwendung der Korrekturbenutzeroberfläche .

Syntax

HRESULT EnableTsf(
  VARIANT_BOOL Enable
);

Parameter

Enable

TRUE , wenn das PenInputPanel-Objekt versuchen soll, Mithilfe von TSF Text an das angefügte Steuerelement zu senden, und dass die Benutzeroberfläche für die Korrektur aktiviert sein sollte; andernfalls FALSE. Der Standardwert ist TRUE.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_UNEXPECTED
 Unerwarteter Parameter oder Eigenschaftstyp.
E_NOINTERFACE
 TSF-Schnittstellen werden für das angefügte Steuerelement nicht verfügbar gemacht.
E_FAIL
 Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Das Aufrufen dieser Methode, bei der Enable auf TRUE festgelegt ist, führt dazu, dass das PenInputPanel-Objekt versucht, die TSF für das angefügte Steuerelement zu starten.

EnableTsf sollte verwendet werden, damit PenInputPanel den TSF-Einfügekontext anstelle der SendInput-Funktion verwenden kann, um die Ergebnisse der Handschrifterkennung an das Steuerelement zu senden. Das Ergebnis ist, dass Text eingefügt werden kann, auch wenn das Feld keinen Fokus mehr hat.

Wenn Sie EnableTsf mit dem Wert TRUE aufrufen, sendet das PenInputPanel-Objekt eine EM_SETEDITSTYLE Nachricht an das angefügte Steuerelement. Wenn das Steuerelement diese Meldung nicht unterstützt, sind die Ergebnisse möglicherweise unvorhersehbar. Das InkEdit-Steuerelement unterstützt TSF.

Unterstützung für Legacyanwendungen

Es wurde Unterstützung für TSF und Microsoft Windows hinzugefügt, um eine konsistente Benutzeroberfläche für alle Anwendungen auf dem Desktop bereitzustellen. Mit dieser neuen Unterstützung können Ältere Anwendungen oder Steuerelemente, die TSF nicht kennen, einige erweiterte Textdienste kostenlos nutzen. Beispielsweise können Sprachdiktate und Handschrift jetzt verwendet werden, um Text in ein Dokument in einer beliebigen Anwendung einzugeben.

Dieses neue Feature ist unter Windows XP Tablet PC Edition verfügbar und standardmäßig aktiviert. So aktivieren oder deaktivieren Sie sie:

  1. Klicken Sie in Systemsteuerung auf Regional- und Sprachoptionen.
  2. Klicken Sie auf der Registerkarte Sprachen auf Details.
  3. Aktivieren oder deaktivieren Sie auf der Registerkarte Erweitert des Dialogfelds Textdienste und Eingabesprachendie Option Unterstützung erweiterter Textdienste auf alle Programme erweitern.
Bei erfolgreicher Ausführung wird Text über TSF an das angefügte Steuerelement gesendet. Wenn das Steuerelement TSF unterstützt (und nicht einfach Text von TSF empfängt, nur weil advanced Text Services für alle Programme in Systemsteuerung aktiviert wurde, wie oben erwähnt), wird die Benutzeroberfläche für korrekturen im Steuerelement angezeigt und ermöglicht den Zugriff auf handschriftliche Alternativen. Das Aufrufen dieser Methode, bei der Enable auf FALSE festgelegt ist, führt dazu, dass das PenInputPanel-Objekt versucht, TSF für das angefügte Steuerelement herunterzufahren.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile peninputpanel.h
Bibliothek InkObj.dll

Weitere Informationen

IPenInputPanel

Peninputpanel