InkCollector.Enabled プロパティ
InkCollector オブジェクトがペン入力を収集するかどうかを指定する値を取得または設定します。
名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)
構文
'宣言
Public Property Enabled As Boolean
'使用
Dim instance As InkCollector
Dim value As Boolean
value = instance.Enabled
instance.Enabled = value
public bool Enabled { get; set; }
public:
property bool Enabled {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_Enabled()
/** @property */
public void set_Enabled(boolean value)
public function get Enabled () : boolean
public function set Enabled (value : boolean)
プロパティ値
型 : System.Boolean
InkCollector オブジェクトがペン入力を収集する場合は true。InkCollector オブジェクトがペン入力を報告しない場合は false。ペンが関連するイベントは発生しません。
解説
インクに加えて、ペン入力には in-air パケット、範囲内のカーソル イベントなどが含まれる場合があります。
InkCollector オブジェクトは、Microsoft® Windows® XP Tablet PC Edition または Windows XP Tablet PC Edition SDK がインストールされた Windows 2000、Windows Server 2003、Windows XP でインクを収集します。ただし、手書き認識は Windows XP Tablet PC Edition を使用している場合にのみ発生します。Windows 2000、Windows Server 2003、または Windows XP Tablet PC Edition 以外の Windows XP では、Windows XP Tablet PC Edition SDK がインストールされていない場合、Enabled プロパティは常に false です。
有効な InkCollector または InkOverlay (コンストラクタまたは SetWindowInputRectangle メソッドにより設定される) のウィンドウ入力の四角形が InkCollectorのウィンドウ入力の四角形と重なる場合、COMException 例外がスローされます。
.gif "メモ") メモ : |
|---|
入力された四角形の 1 つのみが有効にされている場合に限り、重なりが許可されます。 |
コントロールが有効ではない場合、イベントを受け取りません。
コンテナ コントロールの Enabled プロパティを false に設定する場合、含まれるコントロールもすべて無効にされます。
オブジェクトがインクを収集している間 (CollectingInk プロパティが true) は、Enabled プロパティは false に設定できません。
Enabled プロパティを false に設定してから、オブジェクトの特定のプロパティおよびメソッドを設定または呼び出す必要があります。指定されたプロパティを変更したり、または指定されたメソッドを呼び出そうとした場合、エラーが発生します。
次のプロパティおよびメソッドは Enabled プロパティを最初に false に設定してからでなければ設定または呼び出すことはできません。
InkCollector オブジェクトの Enabled プロパティを false に設定してから、アプリケーションを終了する必要があります。
| メモ : |
|---|
この関数は、特定のメッセージ ハンドラ内で Enabled プロパティが設定された場合に再入力されることがあり、予期しない結果が生じる可能性があります。WM_ACTIVATE、WM_ACTIVATEAPP、WM_NCACTIVATE、WM_PAINT、wParam が SC_HOTKEY または SC_TASKLIST に設定されている場合のWM_SYSCOMMAND および WM_SYSKEYDOWN (Alt+Tab キーまたは Alt+Esc キーの組み合わせで処理される場合) のいずれかのメッセージを処理するときは、再入呼び出しを回避するように注意してください。これはシングル スレッド アパートメント モデル アプリケーションに関する問題です。 |
例
この C# の例では、InkCollector オブジェクトを作成し有効にします。
using Microsoft.Ink;
//...
InkCollector theInkCollector = new InkCollector(Handle);
theInkCollector.Enabled = true;
//...
この Microsoft Visual Basic .NET の例では、InkCollector オブジェクトを作成し有効にします。
Imports Microsoft.Ink
'...
Dim theInkCollector As New InkCollector(Handle)
theInkCollector.Enabled() = True
'...
プラットフォーム
Windows Vista
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 3.0
参照
参照
InkCollector.SetAllTabletsMode