PenInputPanel.EnableTsf-Methode
Veraltet. Gibt an, ob das PenInputPanel-Objekt versucht, über das Textdienst-Framework (Text Services Framework, TSF) Text an das ihm zugeordnete Steuerelement zu senden und die Verwendung der Korrektur-Benutzerschnittstelle zu aktivieren. PenInputPanel wurde durch Microsoft.Ink.TextInput ersetzt.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted := True)> _
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Sub EnableTsf ( _
enable As Boolean _
)
'Usage
Dim instance As PenInputPanel
Dim enable As Boolean
instance.EnableTsf(enable)
[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true)]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public void EnableTsf(
bool enable
)
[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction::Demand, Unrestricted = true)]
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public:
void EnableTsf(
bool enable
)
/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
/** @attribute SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true) */
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public void EnableTsf(
boolean enable
)
public function EnableTsf(
enable : boolean
)
Parameter
- enable
Typ: System.Boolean
Eine boolesche Variable, die angibt, ob das PenInputPanel-Objekt versucht, über das Textdienst-Framework (Text Services Framework, TSF) Text an das ihm zugeordnete Steuerelement zu senden und die Verwendung der Korrektur-Benutzerschnittstelle zu aktivieren.
Wenn true, sendet das PenInputPanel-Objekt über das Textdienst-Framework (Text Services Framework, TSF) Text an das ihm zugeordnete Steuerelement, und die Korrektur-Benutzerschnittstelle ist aktiviert.
Wenn false, versucht das PenInputPanel-Objekt, das Textdienst-Framework (Text Services Framework, TSF) für das zugeordnete Steuerelement zu deaktivieren. Die Korrektur-Benutzeroberfläche ist nicht verfügbar.
Hinweise
Der Aufruf dieser Methode mit dem auf true festgelegten enable-Parameter bewirkt, dass das PenInputPanel-Objekt versucht, das Textdienst-Framework (Text Services Framework, TSF) für das zugeordnete Steuerelement zu starten.
Hinweis
Das Textdienst-Framework (Text Services Framework, TSF) unterstützt jetzt alle Desktop-Anwendungen und bietet ihnen eine einheitliche Benutzeroberfläche. Diese neue Unterstützung ermöglicht Legacyanwendungen und -steuerelementen, die TSF bisher nicht kannten, von manchen erweiterten Textdiensten Gebrauch zu machen. So kann jetzt beispielsweise über direkte Sprach- und Handschrifteingabe Text in Dokumente jeder Anwendung eingegeben werden.
Dieses neue Feature ist in Microsoft® Windows® XP-Tablet PC Edition standardmäßig verfügbar und aktiviert. So aktivieren oder deaktivieren Sie dieses Feature:
1. Klicken Sie in der Systemsteuerung auf Regions- und Sprachoptionen.
2. Klicken Sie auf der Registerkarte Sprachen auf Details.
3. Aktivieren oder Deaktivieren Sie im Dialogfeld Textdienste und Eingabesprachen auf der Registerkarte Erweitert das Kontrollkästchen Erweiterte Textdienste in allen Programmen unterstützen.
Wenn erfolgreich, wird der Text über das Textdienst-Framework (Text Services Framework, TSF) an das zugeordnete Steuerelement gesendet. Wenn das Steuerelement TSF unterstützt (und den Text über TSF nicht nur deswegen erhält, weil die erweiterten Textdienste, wie vorher beschrieben, aktiviert wurden), wird darüber hinaus die Korrektur-Benutzeroberfläche im Steuerelement angezeigt, wobei auch der Zugriff auf Alternativen der Handschrifteingaben möglich ist. Der Aufruf dieser Methode mit dem auf false festgelegten enable-Parameter bewirkt, dass das PenInputPanel-Objekt versucht, das Textdienst-Framework (Text Services Framework, TSF) für das zugeordnete Steuerelement zu deaktivieren.
Verwenden Sie die EnableTsf-Methode, damit PenInputPanel für den TSF-Einfügekontext aktiviert wird, statt die SendInput-Funktion zu verwenden, um die Ergebnisse der Handschrifterkennung an das Steuerelement zu senden. Ist PenInputPanel für die Verwendung des TSF-Einfügekontexts aktiviert, kann Text auch dann eingefügt werden, wenn das Feld den Fokus nicht mehr besitzt.
Wenn Sie diese Methode mit dem auf true festgelegten enable-Parameter aufrufen, sendet das PenInputPanel-Objekt eine EM_SETEDITSTYLE-Meldung an das zugeordnete Steuerelement. Wenn das Steuerelement diese Meldung nicht unterstützt, sind die Ergebnisse unvorhersehbar.
Das InkEdit-Steuerelement unterstützt TSF.
.gif "Sicherheitshinweis") Sicherheitshinweis: |
|---|
Bei Verwendung mit teilweiser Vertrauenswürdigkeit sind für diese Methode die SecurityPermissionFlag.AllFlags-Berechtigung sowie die von PenInputPanel geforderten Berechtigungen erforderlich. Weitere Informationen finden Sie unter Security and Trust. |
Beispiele
In diesem C#-Beispiel wird das PenInputPanel-Objekt thePenInputPanel an das InkEdit-Steuerelement theInkEdit angefügt. Die EnableTsf-Methode wird für PenInputPanel aufgerufen, um TSF zu starten.
[C#]
// Declare, create, and attach a new
// PenInputPanel to an InkEdit control.
PenInputPanel thePenInputPanel = new PenInputPanel(theInkEdit);
// Start the Text Services Framework
thePenInputPanel.EnableTsf(true);
In diesem Microsoft Visual Basic® .NET-Beispiel wird das PenInputPanel-Objekt thePenInputPanel an das InkEdit-Steuerelement theInkEdit angefügt. Die EnableTsf-Methode wird für PenInputPanel aufgerufen, um TSF zu starten.
[Visual Basic]
'Declare, create, and attach a new
'PenInputPanel to an InkEdit control.
Dim thePenInputPanel As New PenInputPanel(theInkEdit)
'Start the Text Services Framework
thePenInputPanel.EnableTsf(True)
Plattformen
Windows Vista
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Versionsinformationen
.NET Framework
Unterstützt in: 3.0