Share via

IPenInputPanel：：EnableTsf 方法 (peninputpanel.h)

  • 發行項

[ PenInputPanel 已由 文字輸入面板取代 (TIP) ]。]

已取代。 取得或設定 Boolean 值，指出 PenInputPanel 物件是否嘗試透過 Text Services Framework (TSF) 將文字傳送至附加控制項，並啟用 更正 使用者介面的使用。

語法

HRESULT EnableTsf(
  VARIANT_BOOL Enable
);

參數

Enable

True 是表示 如果 PenInputPanel 物件應該嘗試使用 TSF 將文字傳送至附加控制項，而且應該啟用更正使用者介面;否則為 FALSE。 預設值為 TRUE。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼 描述
S_OK
 成功。
E_UNEXPECTED
 非預期的參數或屬性類型。
E_NOINTERFACE
 附加控制項上不會公開 TSF 介面。
E_FAIL
 發生未指定的錯誤。

備註

呼叫將 Enable 設為 TRUE 的這個方法會導致 PenInputPanel 物件嘗試在附加控制項上啟動 TSF。

EnableTsf 應該用來讓 PenInputPanel 使用 TSF 插入內容，而不是 SendInput 函式，將手寫辨識結果傳送至控制項。 結果是即使欄位不再有焦點，也可以插入文字。

當您以TRUE值呼叫EnableTsf時，PenInputPanel物件會將EM_SETEDITSTYLE訊息傳送至附加的控制項。 如果控制項不支援此訊息，結果可能會無法預期。 InkEdit控制項支援 TSF。

支援繼承應用程式

已將支援新增至 TSF 和 Microsoft Windows，為桌面上的所有應用程式提供一致的使用者介面。 這項新支援可讓不知道 TSF 的繼承應用程式或控制項免費利用某些進階文字服務。 例如，語音聽寫和手寫現在可用來在任何應用程式中將文字輸入檔中。

這項新功能預設可在 Windows XP Tablet PC Edition 上啟用。 若要啟用或停用它：

  1. 在 [主控台] 中，按一下 [地區和語言選項]。
  2. 在 [ 語言] 索引標籤上，按一下 [詳細資料]。
  3. 在 [文字服務和輸入語言] 對話方塊的 [進階] 索引標籤上，選取或清除 [將進階文字服務的支援延伸至所有程式]。
如果成功，文字會透過 TSF 傳送至附加控制項。 此外，如果控制項支援 TSF (，而且不只是從 TSF 接收文字，只是因為已針對主控台中的所有程式啟用進階文字服務，如上述) 所述，則更正使用者介面會出現在控制項中，並允許存取手寫替代專案。 呼叫將 Enable 設為 FALSE 的這個方法會導致 PenInputPanel 物件嘗試關閉附加控制項上的 TSF。

需求

   
最低支援的用戶端 Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 peninputpanel.h
程式庫 InkObj.dll

另請參閱

IPenInputPanel

PenInputPanel