InkOverlay.CollectingInk 属性

获取一个值,该值指定当前是否正在 InkOverlay 对象上绘制墨迹

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

语法

声明
<BrowsableAttribute(False)> _
Public ReadOnly Property CollectingInk As Boolean
用法
Dim instance As InkOverlay
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
一个值,该值指定当前是否正在 InkOverlay 对象上绘制墨迹
如果正在 InkOverlay 对象上绘制墨迹,则为 true;否则为 false。

备注

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

备注

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

示例

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

在进行选择之后,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

另请参见

参考

InkOverlay 类

InkOverlay 成员

Microsoft.Ink 命名空间

InkOverlay.Stroke