[PenInputPanel は TextInput に置き換えられました。 詳細については、「 テキスト入力パネルのプログラミング」を参照してください。
Microsoft Windows XP Tablet PC Edition Software Development Kit (SDK) バージョン 1.0 以降、システム レベルの Tablet PC 入力パネルには、プログラムによるアクセスは提供されませんが、Windows プラットフォーム全体でテキスト入力を実行するためのユニバーサル メカニズムが用意されています。 Tablet PC SDK バージョン 1.5 PenInputPanel オブジェクトは、テキスト入力ツールをアプリケーションに統合します。
次の図は、 自動要求フォームのサンプルに表示されるペン入力パネルを示しています。
PenInputPanel オブジェクトは、アプリケーション開発者にとって便利です。 既存のフォームのコントロールを置き換える必要はありません。 テキスト入力を受け取る既存のコントロールに PenInputPanel オブジェクトをアタッチするだけで、 PenInputPanel オブジェクトからの入力の受信を開始できます。
PenInputPanel オブジェクトは、次のプロパティの入力パネルの設定を採用します。
- レイアウト
- インクの厚さ
- 認識タイムアウト
- ボックス サイズ、送信モード、および東アジアのボックス化された入力に固有のその他の設定
PenInputPanel オブジェクトは、基になるインクへのアクセスを提供しません。 インクを取得するには、 InkPicture コントロールを使用します。
PenInputPanel オブジェクトは、アプリケーションのエンド ユーザーが簡単に検出できるインプレース ユーザー インターフェイス (UI) を提供します。 ユーザーがタブレット ペンを使用して PenInputPanel オブジェクトを使用してウィンドウをタップすると、自動的にアクティブ化されます。 PenInputPanel オブジェクトがアタッチされているウィンドウの CursorButtonUp イベントがシステムによって検出されると、ペン入力パネルが自動的に表示されます。 自動アクティブ化を無効にするには、 AutoShow プロパティを FALSE に設定 します。
ペン入力パネルは、マウス イベントに自動的に表示されません。 ターミナル サービスを使用すると、ペン イベントがマウス イベントに変換されます。 PenInputPanel オブジェクトは、ターミナル サービス接続では機能しません。
ペン入力パネルの入力モード
PenInputPanel オブジェクトを使用すると、キーボード機能または手書き入力を使用でき、入力を支援するためのキーパッドが追加されています。 ペン入力パネルの UI には、次のものが含まれます。
- 書き込みパッド
- 東アジア言語用の書き込みパッド
- QuickKeys キーパッド
- その場で使えるキーボード
東アジア言語用の書き込みパッドと一般の書き込みパッドの可用性は、オペレーティングシステムにおけるユーザーの既定のロケール設定によって異なります。
書き込みパッド
書き込みパッドは、使い慣れた入力パネル UI に似ています。
書き込みパッドは、エンド ユーザーから手書きを収集します。 基本的な UI には、ユーザーがデジタル ペンでテキストを記述できる 1 行の書き込み行が含まれています。 ユーザーが書き込みを完了し、[送信] ボタンをタップするか、タイムアウトが発生するまで待機すると、手書きが認識エンジンに送信されます。
インクは、最後のインク ストロークが収集されてから、指定した時間が経過した後に認識されます。 タイムアウトが発生すると、インクがコレクション サーフェイスから削除され、認識が行われます。 認識されたテキストは、 PenInputPanel オブジェクトがアタッチされているコントロールに挿入されます。
東アジアマルチボックスパッド
ペン入力パネルの東アジア版では、アジア文字を入力するためのマルチボックス インターフェイスが表示されます。 代替手段が提供され、入力パネル UI に似ています。 ユーザーは、書き込みボックスをタップし、ペン入力パネルの上部にあるバーの代替候補の一覧から正しい文字を選択することで、誤認識された文字を修正できます。 フィルター ボタンを使用すると、認識代替の一覧を、シンボルなどの指定した種類の文字に絞り込みます。
韓国語および日本語バージョンのライティング パッドには、すべての言語スキンに共通のミニ クイック キーに加えて変換キーがあります。
東アジア言語の書き込みパッドでラテン文字を取得するには、 Factoid プロパティを設定して、ラテン文字認識の精度を高めます。 数字の場合は Factoid オブジェクトの Digit メンバー、アルファベットと数字の場合は Factoid オブジェクトの OneChar メンバーを設定します。
QuickKeys キー操作盤
ペン入力パネルには、記号と数字を入力するための 2 つの小さなキーパッドが用意されています。
その場で使うキーボード
ペン入力パネルには、手書き認識が不十分な状況に対応するキーボード モードが用意されています。 たとえば、パスワードや部品番号を入力する場合、ユーザーはペン入力パネル キーボードを使用して、書き込みパッドよりも多くの成功を収める可能性があります。 これは、パスワードまたは部品番号が書き込みパッドの認識エンジン 辞書に含まれる可能性が低いためです。
認識エンジンのサポート
PenInputPanel オブジェクトは、Windows XP Tablet PC Edition バージョン 1.0 および Tablet PC SDK バージョン 1.5 の配送認識エンジンをサポートしています。
自動位置決め
既定では、ペン入力パネルは、アタッチ先のコントロールを基準にして自動的に配置されます。 ペン入力パネルとコントロールの両方に十分な画面のプロパティがない場合、または開発者がペン入力パネルの位置を明示的に設定しない限り、コントロールは重なりません。
自動配置関数は、開発者が MoveTo メソッドを使用して明示的に位置を設定していない場合にのみ機能します。 自動配置をオーバーライドするには、PanelMoving イベント ハンドラーの Top プロパティと Left プロパティの値を変更します。
ペン入力パネルの位置は、画面の端によって制限されます。 ペン入力パネルの端は、画面の境界線から 0.25 インチより近くすることはできません。
既定では、ペン入力パネルの上部は、それがアタッチされているコントロールの下部に表示され、 VerticalOffset プロパティの値によってコントロールから分離されます。 コントロールの下に十分なスペースがない場合は、ペン入力パネルの下部がアタッチされているコントロールの上部に表示され、 VerticalOffset プロパティの値によってコントロールから分離されます。 全画面表示の編集コントロールの場合と同様に、まだ十分なスペースがない場合は、ペン入力パネルがコントロールと重なります。
左端のペン入力パネルは、それがアタッチされているコントロールの左端に表示され、画面の境界を除き、 HorizontalOffset プロパティの値によってコントロールから分離されます。 目的の位置でペン入力パネルが使用可能な画面境界を超える場合、ペン入力パネルは可能な限り最も近い水平位置を想定します。
強制オーバーラップ
全画面表示の編集コントロールの場合と同様に、ペン入力パネルがアタッチされたコントロールと重なるようにすることが必要な場合があります。 このような場合、ペン入力パネルの自動配置は、次の規則を使用して決定されます。
- 挿入ポイントが取り付けられたコントロールの上半分にある場合、ペン入力パネルの垂直位置は画面の下部にあり、コントロールの下部に配置される可能性があります。
- 挿入ポイントが接続されたコントロールの下半分にある場合、ペン入力パネルの垂直方向の位置は画面の上部にあり、場合によってはコントロールの上半分に配置されます。
ウィンドウレス コントロール
PenInputPanel オブジェクトがウィンドウレス コントロールにアタッチされている場合、ペン入力パネルはウィンドウレス コントロールの親を基準にして配置されます。 PanelMoving イベント ハンドラーで Top プロパティと Left プロパティを設定するか、MoveTo メソッドを使用してペン入力パネルを手動で配置します。