InkPicture.InkEnabled プロパティ

[アーティクル]
10/28/2008

InkPicture コントロールがペン入力を収集するかどうかを指定する値を取得または設定します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
<BrowsableAttribute(True)> _
Public Property InkEnabled As Boolean
'使用
Dim instance As InkPicture
Dim value As Boolean

value = instance.InkEnabled

instance.InkEnabled = value

[BrowsableAttribute(true)]
public bool InkEnabled { get; set; }

[BrowsableAttribute(true)]
public:
property bool InkEnabled {
    bool get ();
    void set (bool value);
}

/** @property */
/** @attribute BrowsableAttribute(true) */
public boolean get_InkEnabled()
/** @property */
/** @attribute BrowsableAttribute(true) */
public  void set_InkEnabled(boolean value)

public function get InkEnabled () : boolean
public function set InkEnabled (value : boolean)

プロパティ値

型 : System.Boolean
InkPicture コントロールがペン入力を収集する場合は、true。既定。
InkPicture コントロールがペン入力を報告しない場合は、false。ペンが関連するイベントは発生しません。

解説

インクに加えて、ペン入力には in-air パケット、範囲内のカーソルイベントなどが含まれる場合があります。

InkPicture コントロールは、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 がインストールされていない場合、InkEnabled プロパティは常に false です。

有効な InkCollector または InkOverlay (コンストラクタまたは SetWindowInputRectangle メソッドにより設定される) のウィンドウ入力の四角形が InkPicture のウィンドウ入力の四角形と重なる場合、COMException 例外がスローされます。

メモ :
入力された四角形の 1 つのみが有効にされている場合に限り、重なりが許可されます。

コントロールが有効ではない間は、イベントを受け取りません。

コンテナコントロールの Enabled プロパティを false に設定する場合、含まれるコントロールもすべて無効にされます。

コントロールがインクを収集している間 (CollectingInk プロパティが true) は、InkEnabled プロパティは false に設定できません。

InkEnabled プロパティを false に設定してから、コントロールの特定のプロパティおよびメソッドを設定または呼び出す必要があります。指定されたプロパティを変更したり、または指定されたメソッドを呼び出そうとした場合、エラーが発生します。

次のプロパティおよびメソッドは、InkEnabled プロパティを最初に false に設定していない限り、設定することも、呼び出すこともできません。

プロパティ
- Ink
- MarginX
- MarginY
メソッド
- SetAllTabletsMode
- SetSingleTabletIntegratedMode

InkPicture コントロールの InkEnabled プロパティを false に設定してから、アプリケーションを終了する必要があります。

例

次の例では、ButtonClick イベントのイベントハンドラを定義します。イベントが発生するときに、ハンドラが InkEnabled プロパティの値を切り替え、Button のテキストを更新して、次のクリックで実行されるアクションを反映させます。

' Event handler for the button's Click event.
Private Sub buttonToggle_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles buttonToggle.Click
    ' toggle the InkEnabled property and update button text
    mInkPicture.InkEnabled = Not mInkPicture.InkEnabled
    If mInkPicture.InkEnabled Then
        DirectCast(sender, Button).Text = "Disable Ink"
    Else
        DirectCast(sender, Button).Text = "Enable Ink"
    End If

End Sub

// Event handler for the button's Click event.
private void buttonToggle_Click(object sender, System.EventArgs e)
{
    // toggle the InkEnabled property and update button text
    mInkPicture.InkEnabled = !mInkPicture.InkEnabled;
    ((Button)sender).Text = (mInkPicture.InkEnabled) ? "Disable Ink" : "Enable Ink";
}