InkOverlay.Selection プロパティ

[アーティクル]
10/28/2008

InkOverlay コントロール内で現在選択されている Strokes コレクションを取得または設定します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
<BrowsableAttribute(False)> _
Public Property Selection As Strokes
'使用
Dim instance As InkOverlay
Dim value As Strokes

value = instance.Selection

instance.Selection = value

[BrowsableAttribute(false)]
public Strokes Selection { get; set; }

[BrowsableAttribute(false)]
public:
property Strokes^ Selection {
    Strokes^ get ();
    void set (Strokes^ value);
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public Strokes get_Selection()
/** @property */
/** @attribute BrowsableAttribute(false) */
public  void set_Selection(Strokes value)

public function get Selection () : Strokes
public function set Selection (value : Strokes)

プロパティ値

型 : Microsoft.Ink.Strokes
InkOverlay コントロール内で現在選択されている Strokes コレクション。既定値は空の Strokes コレクションです。

解説

Strokes コレクションが移動またはサイズ変更された後、外接する四角形を取得するには、このプロパティにより返される Strokes コレクションの GetBoundingBox メソッドを呼び出します。

Strokes コレクションが移動される前に、外接する四角形を取得するには、SelectionMoved イベントを処理して、InkOverlaySelectionMovedEventArgs オブジェクトの OldSelectionBoundingRect プロパティを取得します。

Strokes コレクションがサイズ変更される前に、外接する四角形を取得するには、SelectionResized イベントを処理して、InkOverlaySelectionResizedEventArgs オブジェクトの OldSelectionBoundingRect プロパティを取得します。

例

この例では、Selection プロパティを、関連付けられている Ink オブジェクトによって使用されているものと同じ Strokes コレクションに設定することで、InkOverlay オブジェクトのすべてのストロークが選択されます。

選択の完了後に、EditingMode プロパティが Select に設定されます。

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