InkPicture.CollectingInk 属性

获取一个值,该值指定当前是否正在 InkPicture 控件上绘制墨迹

命名空间:  Microsoft.Ink
程序集:  Microsoft.Ink(在 Microsoft.Ink.dll 中)

语法

声明
<BrowsableAttribute(False)> _
Public ReadOnly Property CollectingInk As Boolean
用法
Dim instance As InkPicture
Dim value As Boolean

value = instance.CollectingInk
[BrowsableAttribute(false)]
public bool CollectingInk { get; }
[BrowsableAttribute(false)]
public:
property bool CollectingInk {
    bool get ();
}
/** @property */
/** @attribute BrowsableAttribute(false) */
public boolean get_CollectingInk()
public function get CollectingInk () : boolean

属性值

类型:System.Boolean
一个值,该值指定当前是否正在 InkPicture 控件上绘制墨迹

含义

true

正在 InkPicture 控件上绘制墨迹。

false

未在 InkPicture 控件上绘制墨迹。

备注

使用 CollectingInk 属性可以检查是否正在 InkPicture 控件上绘制墨迹,而不用监视 Stroke 事件。

备注

由于墨迹收集是在与应用程序代码独立的线程上处理的,因此,即使应用程序代码是在假定 CollectingInk 属性仍为 false 的情况下运行的,该属性也可以更改为 true。为了处理这种情况,应将与 CollectingInk 属性值有关的代码包含在一个 try-catch 块中。

示例

在此示例中,通过将 Selection 属性设置为关联 Ink 对象所使用的同一 Strokes 集合,选择 InkPicture 对象的所有笔画。

在进行选择之后,EditingMode 属性被设置为 Select

在对象正在收集墨迹期间,无法更改 EditingMode 属性。由于墨迹收集是在与应用程序代码独立的线程上处理的,因此,即使应用程序代码是在假定 CollectingInk 属性仍为 false 的情况下运行的,该属性也可以更改为 true。为了处理这种情况,应将对 EditingMode 属性的访问包含在 try-catch 块中。

' Select all strokes
' mInkObject can be InkOverlay or InkPicture
Try
    If Not mInkObject.CollectingInk Then
        mInkObject.Selection = mInkObject.Ink.Strokes
        mInkObject.EditingMode = InkOverlayEditingMode.Select
    End If

Catch
    ' handle or rethrow
End Try
// Select all strokes
// mInkObject can be InkOverlay or InkPicture
try
{
    if (!mInkObject.CollectingInk)
    {
        mInkObject.Selection = mInkObject.Ink.Strokes;
        mInkObject.EditingMode = InkOverlayEditingMode.Select;
    }
}
catch
{
    // handle or rethrow
}

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求

版本信息

.NET Framework

受以下版本支持:3.0

另请参见

参考

InkPicture 类

InkPicture 成员

Microsoft.Ink 命名空间

InkPicture.Stroke