PenInputPanel.EnableTsf 方法
已否决。指示 PenInputPanel 对象是否尝试通过文本服务框架 (TSF) 将文本发送到附加控件，并启用更正 用户界面。PenInputPanel 已由 Microsoft.Ink.TextInput 替换。
命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）
语法
声明
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted := True)> _
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Sub EnableTsf ( _
enable As Boolean _
)
用法
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
)
参数
- enable
类型：System.Boolean
布尔变量，指示 PenInputPanel 对象是否尝试通过文本服务框架 (TSF) 将文本发送到附加控件，并启用更正用户界面。
如果为 true，则 PenInputPanel 对象将尝试通过文本服务框架 (TSF) 将文本发送到附加控件，并启用更正用户界面。
如果为 false，则 PenInputPanel 对象将尝试在附加控件上禁用 TSF。更正用户界面不可用。
备注
如果用设置为 true 的 enable 参数调用该方法，则 PenInputPanel 对象将尝试在附加控件上启动 TSF。
备注
已添加对 TSF 的支持，以便为跨桌面的所有应用程序提供一致的用户界面。通过这一新支持，不能识别 TSF 的旧应用程序或控件能够利用某些高级文本服务。例如，现在可以在任何应用程序中使用语音听写和手写 将文本输入到文档中。
默认情况下，Microsoft(R) Windows(R) XP Tablet PC 版本提供和启用这一新功能。若要启用或禁用此功能，请执行以下操作：
1. 在“控件面板”中，单击“区域和语言选项”。
2. 在“语言”选项卡上，单击“详细信息”。
3. 在“文本服务和输入语言”对话框的“高级”选项卡上，选中或清除“将高级文本服务支持应用于所有程序”。
如果成功，则文本将通过 TSF 发送到附加控件。此外，如果控件支持 TSF（并且仅因为如前面步骤所示启用了高级文本服务而不从 TSF 接收文本），则更正用户界面将出现在控件中，可用于访问手写替代设备。如果用设置为 false 的 enable 参数调用该方法，则 PenInputPanel 对象将尝试在附加控件上禁用 TSF。
通过使用 EnableTsf 方法，PenInputPanel 可以使用 TSF 插入上下文（而不是 SendInput Function（SendInput 函数））将手写识别结果发送到控件中。通过启用 PenInputPanel 来使用 TSF 插入上下文，即使字段不再具有焦点也可以插入文本。
如果用设置为 true 的 enable 参数调用该方法，则 PenInputPanel 对象将 EM_SETEDITSTYLE 消息发送到附加控件。如果该控件不支持该消息，则无法预测结果。
InkEdit 控件支持 TSF。
.gif "安全说明") 安全说明： |
|---|
如果在部分信任环境下使用，则除了 PenInputPanel 所需的权限以外，该方法还需要 SecurityPermissionFlag.AllFlags 权限。有关更多信息，请参见Security and Trust。 |
示例
此 C# 示例将 PenInputPanel 对象 thePenInputPanel 附加到 InkEdit 控件 theInkEdit。对 PenInputPanel 调用 EnableTsf 方法来启动 TSF。
[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);
此 Microsoft Visual Basic(R) .NET 示例将 PenInputPanel 对象 thePenInputPanel 附加到 InkEdit 控件 theInkEdit。对 PenInputPanel 调用 EnableTsf 方法来启动 TSF。
[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)
平台
Windows Vista
.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。
版本信息
.NET Framework
受以下版本支持：3.0