PenInputPanel.EnableTsf 方法

已取代。指出 PenInputPanel 物件是否透過 Text Services Framework (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 物件是否透過 Text Services Framework (TSF) 嘗試將文字傳送至附加的控制項，以及是否允許使用 [更正] 使用者介面。
  如果為 true，則 PenInputPanel 物件會嘗試透過 Text Services Framework (TSF) 將文字傳送至附加的控制項，並且會啟用 [更正] 使用者介面。
  如果為 false，則 PenInputPanel 物件會嘗試在附加的控制項上停用 TSF。[修正] 使用者介面將無法使用。

備註

若在 enable 參數設為 true 時呼叫這個方法，會造成 PenInputPanel 物件嘗試在附加的控制項上啟動 TSF。

注意事項：

TSF 中已加入支援，該支援還提供整個桌面的所有應用程式使用一致的使用者介面。這項新支援可讓未使用 TSF 的舊有應用程式或控制項，運用部分進階的文字服務。例如，可以在任何應用程式中，使用語音聽寫和「手寫」將文字輸入至文件。 這項新功能目前已提供使用，並且為 Microsoft® Windows® XP Tablet PC Edition 的預設功能。若要啟用或停用這項功能： 1. 在 [控制台] 中按一下 [地區及語言選項]。 2. 在 [語言] 索引標籤上按一下 [詳細資料]。 3. 在 [文字服務和輸入語言] 對話方塊的 [進階] 索引標籤上，選取或清除 [延伸對所有程式的進階文字服務支援]。 如果成功的話，文字就會透過 TSF 傳送至附加的控制項。此外，如果控制項支援 TSF (而且不會因為啟用 [進階文字服務] 而只接收來自 TSF 的文字，如之前的程序所示)，則 [更正] 使用者介面會出現在控制項中，並且可從中存取手寫替代項目。若在 enable 參數設為 false 時呼叫這個方法，會造成 PenInputPanel 物件嘗試在附加的控制項上停用 TSF。

使用 EnableTsf 方法可讓 PenInputPanel 使用 TSF 插入內容，而不是使用 SendInput 函式 (英文) 將手寫辨識結果傳送至控制項。透過讓 PenInputPanel 使用 TSF 插入內容的方式，即使焦點不在欄位中，也能插入文字。

若您在 enable 參數設定為 true 時呼叫這個方法，PenInputPanel 物件會將 EM_SETEDITSTYLE 訊息傳送至附加的控制項。如果控制項不支援這個訊息，則可能產生無法預期的結果。

InkEdit 控制項不支援 TSF。

安全性注意事項：
如果在部分信任的情況下使用，除了 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® .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

請參閱

參考

PenInputPanel 類別

PenInputPanel 成員

Microsoft.Ink 命名空間