InkPicture コントロール リファレンス
InkPicture コントロールを使用すると、アプリケーションにイメージを配置し、その上にインクを追加できます。 これは、インクがテキストとして認識されず、代わりにインクとして格納されるシナリオを対象としています。
InkPicture コントロールは、C++ で CoCreateInstance メソッドを呼び出すことによってインスタンス化できます。
注意
InkPicture コントロールは、スクリプト作成に安全であるとマークされていません。 InkPicture コントロールは、HTML または ASP.NET ページでは使用しないでください。
透明なコントロールの背後に InkPicture コントロールを作成すると (WS_EX_TRANSPARENT プロパティ セットを持つ GroupBox など)、InkPicture がインクを収集できなくなります。
メンバー
| 列挙 | 説明 |
|---|---|
| InkPictureSizeMode | InkPicture コントロール内での背景画像の動作を指定する値を定義します。 |
| Event | 説明 |
|---|---|
| ChangeUICues | 非推奨になりました。 |
| クリック | ユーザーが InkPicture コントロールをクリックしたときに発生します。 |
| CursorButtonDown イベント |
InkCollector コントロールがダウンしている IInkCursorButton オブジェクトを検出したときに発生します。 |
| CursorButtonUp イベント | InkPicture コントロールが、稼働中の IInkCursorButton を 検出したときに発生します。 |
| CursorDown イベント | カーソルの先端がデジタイズタブレットの表面に接触したときに発生します。 |
| CursorInRange イベント | カーソルがタブレット コンテキストの物理的な検出範囲 (近接) に入ったときに発生します。 |
| CursorOutOfRange イベント | カーソルがタブレット コンテキストの物理的な検出範囲 (近接) から離れると発生します。 |
| DblClick | InkPicture コントロールがダブルクリックされたときに発生します。 このイベント メソッドは、 _IInkPictureEvents インターフェイスで定義されます。 _IInkPictureEvents インターフェイスは、DISPID_IPEDblClickの識別子を持つ IDispatch インターフェイスを実装します。 |
| ジェスチャ イベント | アプリケーション ジェスチャが認識されたときに発生します。 |
| KeyDown イベント [InkPicture コントロール] | InkPicture コントロールにフォーカスがあるときに、キーが押され、下の位置に置かれたときに発生します。 |
| KeyPress イベント[InkPicture コントロール] | InkPicture コントロールにフォーカスがあるときにキーが押されたときに発生します。 |
| KeyUp イベント [InkPicture コントロール] | InkPicture コントロールにフォーカスがあるときにキーが離されたときに発生します。 |
| MouseDown イベント [InkPicture コントロール] | マウス ポインターが InkPicture コントロールの上にあり、マウス ボタンが押されたときに発生します。 |
| Mouseenter | マウス ポインターが InkPicture コントロールに入ったときに発生します。 |
| MouseHover | マウス ポインターが InkPicture コントロールの上にマウス ポインターを置いたときに発生します。 |
| Mouseleave | マウス ポインターが InkPicture コントロールから離れると発生します。 |
| MouseMove イベント [InkPicture コントロール] | マウス ポインターが InkPicture コントロールの上に移動したときに発生します。 |
| MouseUp イベント [InkPicture コントロール] | マウス ポインターが InkPicture コントロールの上にあり、マウス ボタンが離されたときに発生します。 |
| Mousewheel | InkPicture コントロールにフォーカスがあるときにマウス ホイールが移動したときに発生します。 |
| NewInAirPackets イベント | インエア パケットが見られると発生します。 |
| NewPackets イベント | InkPicture コントロールがパケットを受信したときに発生します。 |
| 塗装 | InkPicture コントロール自体の再描画が完了したときに発生します。 |
| 描画 | InkPicture コントロールが再描画される前に発生します。 |
| サイズ変更 | InkPicture コントロールのサイズが変更されたときに発生します。 |
| SelectionChanged | ユーザー インターフェイスの変更、切り取りおよび貼り付けプロシージャ、 Selection プロパティなど、InkPicture コントロール内のテキストの選択が変更されたときに発生します。 |
| SelectionChanging | ユーザー インターフェイスの変更、切り取りと貼り付けのプロシージャ、 Selection プロパティなど、InkPicture コントロール内のテキストの選択が変更されようとしているときに発生します。 |
| SelectionMoved | ユーザー インターフェイスの変更、切り取りおよび貼り付けプロシージャ、 Selection プロパティなど、現在の選択範囲の位置が変更されたときに発生します。 |
| SelectionMoving イベント [InkPicture コントロール] | ユーザー インターフェイスの変更、切り取りおよび貼り付けプロシージャ、 Selection プロパティなど、現在の選択範囲の位置が変更されようとしているときに発生します。 |
| SelectionResized | ユーザー インターフェイスの変更、切り取りおよび貼り付けプロシージャ、 Selection プロパティなど、現在の選択範囲のサイズが変更されたときに発生します。 |
| SelectionResizing | ユーザー インターフェイスの変更、切り取りおよび貼り付けプロシージャ、 Selection プロパティなど、現在の選択範囲のサイズが変更されようとしているときに発生します。 |
| Sizechanged | InkPicture コントロールのサイズが変更された後、特に Width プロパティまたは Height プロパティの値が変更された後に発生します。 |
| SizeModeChanged | InkPicture コントロールの SizeMode プロパティが変更された後に発生します。 |
| StyleChanged | 実装されていません。 |
| ストローク | ユーザーが任意のタブレットに新しいストロークを描画するときに発生します。 |
| StrokesDeleted |
IInkStrokeDisp オブジェクトが Ink プロパティから削除された後に発生します。 |
| StrokesDeleting |
IInkStrokeDisp オブジェクトが Ink プロパティから削除される前に発生します。 |
| SystemColorsChanged | システムの色が変更された後に発生します。 |
| SystemGesture | システム ジェスチャが認識されたときに発生します。 |
| TabletAdded イベント | タブレットがシステムに追加されたときに発生します。 |
| TabletRemoved イベント | タブレットがシステムから削除されたときに発生します。 |
| 方法 | 説明 |
|---|---|
| GetEventInterest メソッド | InkPicture コントロールが特定のイベントに関心があるかどうかを示す値を返します。 |
| GetGestureStatus | InkPicture コントロールが特定のアプリケーション ジェスチャに関心があるかどうかを示す値を返します。 |
| GetWindowInputRectangle メソッド | インクを描画するウィンドウの四角形をピクセル単位で返します。 |
| HitTestSelection |
SelectionHitResult 列挙体のメンバーを返します。これは、ヒット テスト中にヒットした選択範囲の部分 (存在する場合) を指定します。 |
| SetAllTabletsMode メソッド | InkPicture コントロールで、タブレット PC に接続されている任意のタブレットからインクを収集できるようにします。 |
| SetEventInterest メソッド | InkPicture コントロールが指定したイベントに関心があるかどうかを示す値を設定します。 |
| SetFocus | フォーカスを InkPicture コントロールに移動します。 |
| SetGestureStatus メソッド | 指定したアプリケーション ジェスチャの InkPicture オブジェクトの関心を設定します。 |
| SetSingleTabletIntegratedMode メソッド | InkPicture コントロールを設定して、タブレット PC に接続されている 1 つのタブレットからのみインクを収集します。 他のタブレットからのインクは無視されます。 |
| SetWindowInputRectangle メソッド | インクを描画するウィンドウ座標で設定するウィンドウの四角形を指定します。 |
| ShowWhatsThis | 32 ビット Microsoft Windows オペレーティング システムのヘルプで提供される "What's This" ポップアップを使用して、選択したトピックをヘルプ ファイルに表示します (デザイン時のみ)。 |
| ZOrder | Z オーダーの前面または背面に、グラフィカル レベル内にコントロールを配置します (デザイン時のみ)。 |
| プロパティ | 説明 |
|---|---|
| AutoRedraw プロパティ | ウィンドウが無効になったときに InkPicture コントロールを再描画するかどうかを指定する値を取得または設定します (InkPicture に関連付けられているウィンドウがWM_PAINTメッセージを受信したときに、InkPicture コントロールに現在関連付けられている InkDisp オブジェクトが自動的に再描画されるかどうか)。 |
| Backcolor | InkPicture コントロールの背景色を取得または設定します。 既定の背景色はシステム ウィンドウの背景色で、通常は白です。 |
| CollectingInk プロパティ | InkPicture コントロールがインクを収集するかどうかを指定する値を取得します (実行時のみ)。 |
| CollectionMode | インク、ジェスチャ、またはインクとジェスチャをユーザーの書き込みとして認識するかどうかを決定するコレクション モードを取得または設定します。 |
| Cursors プロパティ | InkPicture コントロールのインク領域で使用できる IInkCursors コレクションを取得します。 |
| CustomStrokes | インクで永続化する IInkCustomStrokes コレクションを取得します (デザイン時のみ)。 |
| DefaultDrawingAttributes プロパティ | インクの描画と表示時に使用する既定の InkDrawingAttributes コレクションを取得または設定します (実行時のみ)。 |
| DesiredPacketDescription プロパティ | InkPicture コントロールのパケットの説明を取得または設定します (実行時のみ)。 |
| DynamicRendering プロパティ | InkPicture コントロールがインクを収集時に動的にレンダリングするかどうかを指定する値を取得または設定します。 |
| EditingMode | InkPicture コントロールがインク モード、削除モード、または選択/編集モードかどうかを指定する値を取得または設定します。 |
| Enabled | InkPicture コントロールがユーザーが生成したイベントに応答できるかどうかを決定する値を取得または設定します。 メモ： このプロパティは InkEnabled プロパティと同じです。 |
| 消しゴムモード | ストロークまたはポイントによってインクを消去するかどうかを指定する値を取得または設定します。 |
| EraserWidth | 消しゴムのペン先の幅を指定する値を取得または設定します。 |
| Hwnd | InkPicture コントロールがバインドされているウィンドウ ハンドルを取得します。 (実行時のみ) |
| インク | InkPicture コントロールに関連付けられている InkDisp オブジェクトを取得または設定します (実行時のみ)。 |
| InkEnabled | InkPicture コントロールがペン入力 (空中パケット、範囲内のカーソル イベントなど) を収集するかどうかを指定する値を取得または設定します。 |
| MarginX プロパティ | 画面座標のウィンドウ四角形の周りの x 軸の余白を取得または設定します。 |
| MarginY プロパティ | 画面座標のウィンドウ四角形の周りの y 軸の余白を取得または設定します。 |
| MouseIcon プロパティ | 現在のカスタム マウス アイコンを取得または設定します。 |
| MousePointer プロパティ | InkPicture コントロールの特定の部分にマウスが置かれたときに表示されるマウス ポインターの種類を示す値を取得または設定します。 |
| 画像 | InkPicture コントロールに表示されるグラフィックス ファイルを取得します。 |
| Renderer プロパティ | InkPicture コントロールにインクを描画するために使用される InkRenderer オブジェクトを取得または設定します (実行時のみ)。 |
| [選択] | InkPicture コントロール内で現在選択されている InkStrokes コレクションを取得します (実行時のみ)。 |
| OLE サイズ | コントロールがイメージの配置とサイズ設定を処理する方法を取得または設定します。 |
| SupportHighContrastInk プロパティ | システムがハイ コントラスト モードの場合にインクを 1 色としてレンダリングするかどうかを示す値を取得します。Color = COLOR_WINDOWTEXT (GetSystemMetrics 呼び出しから)。 |
| SupportHighContrastSelectionUI | システムがハイ コントラスト モードのときに、すべての選択ユーザー インターフェイス (選択境界ボックスと選択ハンドル) をハイ コントラストで描画するかどうかを指定する値を取得または設定します。 |
| Tablet プロパティ | InkPicture コントロールが入力の収集に現在使用している IInkTablet オブジェクトを取得します。 |
解説
InkPicture コントロールの実行時ユーザー インターフェイスは、不透明なインクを含む不透明な背景 (単一色、図の背景、またはその両方) を持つウィンドウです。
InkPicture コントロールを使用すると、Microsoft Windows 2000、Windows Server 2003、Windows XP Tablet PC Edition 以外の Windows XP の任意のエディション、および任意のバージョンの Windows Vista でインクをレンダリングできます。 ただし、インクの入力、ジェスチャの受け入れ、または手書きの認識は、次の条件でのみ行うことができます。
- Windows Vista または XP Tablet PC Edition 2005 がインストールされている場合は、インクを入力して認識できます。
- ジェスチャも認識できます。
- 認識エンジンが存在する限り、古いバージョンの Windows を実行しているマシンで手書きが発生した場合、手書きはテキストとして認識できます。
Windows XP Tablet PC Edition 2005 以外の Windows XP のエディションである Windows 2000、Windows Server 2003 を使用する場合は、InkPicture コントロールのアンビエント プロパティに値を割り当ててから、インクをコピーして他のアプリケーションに貼り付けることができます。 ただし、InkEnabled プロパティの値は常に FALSE になります。
永続化された InkDisp オブジェクトは、Windows Vista と XP のすべてのエディション、および Windows XP Tablet PC Edition ソフトウェア開発キット (SDK) のみがインストールされているシステムに読み込んで表示できます。 InkDisp オブジェクトは、Windows Vista または Windows XP Tablet PC Edition 2005 がインストールされている場合にのみ、テキスト (認識) に変換できます。
このコントロールに対する操作が成功しない場合は、有効な HRESULT が返されます。 エラー条件が発生した場合は、返された HRESULT をエラーに対してチェックします。
インク コントロールの詳細については、「 Ink」を参照してください。
特定のイベントを発生させるスレッドについては、「イベントが 発生するスレッド」を参照してください。
アプリケーションのパフォーマンスを向上させるには、InkPicture コントロールが不要になったら手動で破棄します。
注意
InkPicture コントロールが別のコントロール (透明に設定された GroupBox など) とオーバーレイされている場合、InkPicture はインクを収集しません。 InkPicture は、Z オーダーの最上位のコントロールであるか、 GroupBox の子である必要があります。
COM の実装
このオブジェクトは、 IInkPicture COM インターフェイスを実装します。