InkOverlay.Enabled プロパティ
InkOverlay オブジェクトがペン入力を収集するかどうかを指定する値を取得または設定します。
名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)
構文
'宣言
<BrowsableAttribute(False)> _
Public Property Enabled As Boolean
'使用
Dim instance As InkOverlay
Dim value As Boolean
value = instance.Enabled
instance.Enabled = value
[BrowsableAttribute(false)]
public bool Enabled { get; set; }
[BrowsableAttribute(false)]
public:
property bool Enabled {
bool get ();
void set (bool value);
}
/** @property */
/** @attribute BrowsableAttribute(false) */
public boolean get_Enabled()
/** @property */
/** @attribute BrowsableAttribute(false) */
public void set_Enabled(boolean value)
public function get Enabled () : boolean
public function set Enabled (value : boolean)
プロパティ値
型 : System.Boolean
InkOverlay オブジェクトがペン入力を収集するかどうか。
InkOverlay オブジェクトがペン入力を収集する場合は、true。
InkOverlay オブジェクトがペン入力を報告しない場合は、false。ペンが関連するイベントは発生しません。
解説
インクに加えて、ペン入力には in-air パケット、範囲内のカーソル イベントなどが含まれる場合があります。
InkOverlay オブジェクトは、Microsoft Windows Vista、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 メソッドにより設定される) のウィンドウ入力の四角形が InkOverlayのウィンドウ入力の四角形と重なる場合、COMException 例外がスローされます。
.gif "メモ") メモ : |
|---|
入力された四角形の 1 つのみが有効にされている場合に限り、重なりが許可されます。 |
コントロールが有効ではない場合、イベントを受け取りません。
コンテナ コントロールの Enabled プロパティを false に設定する場合、含まれるコントロールもすべて無効にされます。
オブジェクトがインクを収集している間 (CollectingInk プロパティが true) は、Enabled プロパティは false に設定できません。
Enabled プロパティを false に設定してから、オブジェクトの特定のプロパティおよびメソッドを設定または呼び出す必要があります。指定されたプロパティを変更したり、または指定されたメソッドを呼び出そうとした場合、エラーが発生します。
次のプロパティおよびメソッドは Enabled プロパティを最初に false に設定してからでなければ設定または呼び出すことはできません。
InkOverlay オブジェクトの Enabled プロパティを false に設定してから、アプリケーションを終了する必要があります。
例
この C# の例では、InkOverlay オブジェクトを作成し有効にします。
using Microsoft.Ink;
//...
InkOverlay theInkOverlay = new InkOverlay(Handle);
theInkOverlay.Enabled = true;
//...
この Microsoft Visual Basic .NET の例では、InkOverlay オブジェクトを作成し有効にします。
Imports Microsoft.Ink
'...
Dim theInkOverlay As New InkOverlay(Handle)
theInkOverlay.Enabled() = True
'...
プラットフォーム
Windows Vista
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 3.0