InkOverlay.EditingMode 屬性

發行項
10/29/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
    }
}