IPenInputPanel::EnableTsf メソッド (peninputpanel.h)
[ PenInputPanel は テキスト入力パネル (TIP) に置き換えられました。
非推奨になりました。 PenInputPanel オブジェクトが Text Services Framework (TSF) を介して添付コントロールにテキストを送信しようとし、修正ユーザー インターフェイスを使用できるかどうかを示すブール値を取得または設定します。
構文
HRESULT EnableTsf(
VARIANT_BOOL Enable
);
パラメーター
Enable
PenInputPanel オブジェクトが TSF を使用して添付コントロールにテキストを送信し、修正ユーザー インターフェイスを有効にする必要がある場合は TRUE。それ以外の場合は FALSE。 既定値は TRUE です。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
正常終了しました。 |
|
予期しないパラメーターまたはプロパティの型。 |
|
TSF インターフェイスは、アタッチされたコントロールでは公開されません。 |
|
未指定のエラーが発生しました。 |
解説
Enable を TRUE に設定してこのメソッドを呼び出すと、 PenInputPanel オブジェクトはアタッチされたコントロールで TSF を開始しようとします。
EnableTsf を使用して、PenInputPanel が SendInput 関数ではなく TSF 挿入コンテキストを使用して手書き認識結果をコントロールに送信できるようにする必要があります。 結果として、フィールドにフォーカスがなくなった場合でもテキストを挿入できます。
True の値を指定して EnableTsf を呼び出すと、PenInputPanel オブジェクトは添付コントロールにEM_SETEDITSTYLEメッセージを送信します。 コントロールがこのメッセージをサポートしていない場合、結果は予測できない可能性があります。 InkEdit コントロールは TSF をサポートしています。
レガシ アプリケーションのサポート
デスクトップ全体のすべてのアプリケーションに一貫したユーザー インターフェイスを提供するために、TSF と Microsoft Windows にサポートが追加されました。 この新しいサポートにより、TSF を認識していないレガシ アプリケーションまたはコントロールは、一部の高度なテキスト サービスを無料で利用できます。 たとえば、音声ディクテーションと手書き入力を使用して、任意のアプリケーションのドキュメントにテキストを入力できるようになりました。この新機能は、Windows XP Tablet PC Edition で既定で使用でき、有効になっています。 有効または無効にするには:
- [コントロール パネルで、[地域と言語のオプション] をクリックします。
- [言語] タブ で 、[ 詳細] をクリックします。
- [テキスト サービスと入力言語] ダイアログ ボックスの [詳細設定] タブで、[すべてのプログラムに高度なテキスト サービスのサポートを拡張する] をオンまたはオフにします。
要件
| サポートされている最小のクライアント | Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | peninputpanel.h |
| Library | InkObj.dll |