InkPicture.EditingMode プロパティ
InkPicture がインク モード、削除モード、または選択/編集モードかどうかを示す値を取得または設定します。
名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)
構文
'宣言
<BrowsableAttribute(True)> _
Public Property EditingMode As InkOverlayEditingMode
'使用
Dim instance As InkPicture
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 値のいずれか。
解説
インクの収集中に EditingMode プロパティを変更しようとすると、例外が発生します。この競合を避けるには、EditingMode プロパティを変更する前に CollectingInk プロパティが false になっていることを確認します。
インクの消去の詳細については、「Erasing Ink with the Pen」を参照してください。
例
この例では、InkPicture オブジェクトの 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
}
}
プラットフォーム
Windows Vista
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 3.0