InkPicture.InkEnabled 属性

项目
11/04/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 packet、光标在范围中事件，等等。

在 Microsoft(R) Windows(R) XP Tablet PC Edition 或安装了 Windows XP Tablet PC Edition SDK 的 Windows 2000、Windows Server 2003 或 Windows XP 的任何版本中，InkPicture 控件都收集墨迹。但是，仅当使用 Windows XP Tablet PC Edition 时，才会进行手写识别。除 Windows XP Tablet PC Edition 外，Windows 2000、Windows Server 2003 或 Windows XP 的任何版本中，如果不安装 Windows XP Tablet PC Edition SDK，则 InkEnabled 属性始终是 false。

如果启用的 InkCollector 或 InkOverlay（在构造函数中设置或使用 SetWindowInputRectangle 方法设置）的窗口输入矩形与 InkPicture 的窗口输入矩形重叠，则会引发 COMException 异常。

备注

任何时候只要仅启用一个输入矩形，那么即使发生重叠也不会出错。

如果未启用控件，则不会接收到任何事件。

如果将容器控件的 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";
}