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 の起動を試みます。
.gif "メモ") メモ : |
|---|
TSF にサポートが追加され、デスクトップ全体のすべてのアプリケーションに統一されたユーザー インターフェイスが提供されます。この新しいサポートにより、TSF に対応していない従来のアプリケーションまたはコントロールが、高度なテキスト サービスを活用することが可能になります。たとえば、音声ディクテーションと手書きを使用して、任意のアプリケーションのドキュメントにテキストを入力することが可能になります。 この新しい機能は、Microsoft® Windows® XP Tablet PC Edition で使用でき、既定で有効になっています。この機能を有効または無効にするには、次の操作を行います。 1. [コントロール パネル] の [地域と言語のオプション] をクリックします。 2. [言語] タブの [詳細] をクリックします。 3. [テキスト サービスと入力言語] ダイアログ ボックスの [詳細設定] タブで、[詳細なテキスト サービスのサポートをプログラムのすべてに拡張する] をオンまたはオフにします。 成功した場合、TSF を使用して、結合されたコントロールにテキストが送信されます。さらに、コントロールが TSF をサポートしている場合 (かつ、前の手順で説明したように、高度なテキスト サービスを有効にしたために TSF からテキストを受け取らない場合)、修正ユーザー インターフェイスがコントロールに表示され、手書き候補にアクセスできます。enable パラメータを false に設定してこのメソッドを呼び出すと、PenInputPanel オブジェクトが結合されたコントロールで TSF の無効化を試みます。 |
PenInputPanel を有効にし、SendInput Function ではなく TSF 挿入コンテキストを使用して手書き認識結果をコントロールに送信するには、EnableTsf メソッドを使用します。PenInputPanel を有効にして TSD 挿入コンテキストを使用すると、フィールドにフォーカスがない場合でもテキストを挿入できます。
enable パラメータを true に設定してこのメソッドを呼び出すと、PenInputPanel オブジェクトは結合されたコントロールに EM_SETEDITSTYLE メッセージを送信します。コントロールがこのメッセージをサポートしていない場合、結果が予測不可能な場合があります。
InkEdit コントロールは、TSF をサポートしません。
.gif "セキュリティに関するメモ") セキュリティに関するメモ : |
|---|
部分信頼で使用している場合、このメソッドには PenInputPanel により必要とされるアクセス許可に加えて、SecurityPermissionFlag.AllFlags アクセス許可が必要です。詳細については、「Security and Trust」を参照してください。 |
例
この C# の例では、PenInputPanel オブジェクト thePenInputPanel を InkEdit コントロール theInkEdit に結合します。EnableTsf メソッドを PenInputPanel で呼び出し、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 に結合します。EnableTsf メソッドを PenInputPanel で呼び出し、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