InkOverlay.EditingMode 属性

项目
11/04/2008

获取或设置一个值，该值指示 InkOverlay 是处于墨迹模式、删除模式还是选择/编辑模式。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
<BrowsableAttribute(True)> _
Public Property EditingMode As InkOverlayEditingMode
用法
Dim instance As InkOverlay
Dim value As InkOverlayEditingMode

value = instance.EditingMode

instance.EditingMode = value

[BrowsableAttribute(true)]
public InkOverlayEditingMode EditingMode { get; set; }

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

/** @property */
/** @attribute BrowsableAttribute(true) */
public InkOverlayEditingMode get_EditingMode()
/** @property */
/** @attribute BrowsableAttribute(true) */
public  void set_EditingMode(InkOverlayEditingMode value)

public function get EditingMode () : InkOverlayEditingMode
public function set EditingMode (value : InkOverlayEditingMode)

属性值

类型：Microsoft.Ink.InkOverlayEditingMode
InkOverlayEditingMode 值之一，指示 InkOverlay 是处于墨迹模式、删除模式还是选择/编辑模式。

备注

如果在收集墨迹期间更改 EditingMode 属性，则引发异常。若要避免这种冲突，请确保在更改 EditingMode 属性之前 CollectingInk 属性为 false。

有关擦除墨迹的更多信息，请参见Erasing Ink with the Pen。

示例

此示例演示一个 ListBox 控件的事件处理程序，该处理程序更改 InkOverlay 对象的 EditingMode 属性。

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

' SelectedIndexChanged event handler for a list box with 3 mode choices:
'  Ink     (index:0)
'  Erase   (index:1)
'  Select  (index:2)
Private Sub listBoxEditMode_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs)
    Try

        ' mInkObject can be InkOverlay or InkPicture
        If Not mInkObject.CollectingInk Then
            Select Case DirectCast(sender, ListBox).SelectedIndex
                Case 0
                    mInkObject.EditingMode = InkOverlayEditingMode.Ink
                Case 1
                    mInkObject.EditingMode = InkOverlayEditingMode.Delete
                Case 2
                    mInkObject.EditingMode = InkOverlayEditingMode.Select
            End Select
        End If

    Catch
        ' handle or rethrow
    End Try
End Sub

// SelectedIndexChanged event handler for a list box with 3 mode choices:
//  Ink     (index:0)
//  Erase   (index:1)
//  Select  (index:2)
private void listBoxEditMode_SelectedIndexChanged(object sender, EventArgs e)
{
    try
    {
        // mInkObject can be InkOverlay or InkPicture
        if (!mInkObject.CollectingInk)
        {
            switch (((ListBox)sender).SelectedIndex)
            {
                case 0:
                    mInkObject.EditingMode = InkOverlayEditingMode.Ink;
                    break;
                case 1:
                    mInkObject.EditingMode = InkOverlayEditingMode.Delete;
                    break;
                case 2:
                    mInkObject.EditingMode = InkOverlayEditingMode.Select;
                    break;
            }
        }
    }
    catch
    {
        // handle or rethrow
    }
}