InkOverlay.EditingMode プロパティ

[アーティクル]
10/28/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
InkOverlay がインクモード、削除モード、または選択/編集モードかどうかを示す InkOverlayEditingMode 値の 1 つ。

解説

インクの収集中に EditingMode プロパティを変更しようとすると、例外が発生します。この競合を避けるには、EditingMode プロパティを変更する前に CollectingInk プロパティが false になっていることを確認します。

インクの消去の詳細については、「Erasing Ink with the Pen」を参照してください。

例

この例では、InkOverlay オブジェクトの EditingMode プロパティを変更する ListBox コントロールのイベントハンドラを示します。

オブジェクトがインクを収集している間は、EditingMode プロパティは変更できません。インク収集はアプリケーションコードとは別のスレッドで処理されるため、CollectingInk プロパティを true に変更し、同時に、プロパティが false のままであるという前提でアプリケーションコードを動作させることができます。このような不測の事態を処理するには、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
    }
}