InkPicture.Selection 屬性

發行項
10/29/2008

取得或設定目前在 InkPicture 控制項內選取的 Strokes 集合。

命名空間： Microsoft.Ink
組件： Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
<BrowsableAttribute(False)> _
Public Property Selection As Strokes
'用途
Dim instance As InkPicture
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
目前在 InkPicture 控制項內選取的 Strokes 集合。預設值為空的 Strokes 集合。

備註

若要取得移動或調整大小後的 Strokes 集合之週框，請呼叫由這個屬性傳回之 Strokes 集合的 GetBoundingBox 方法。

若要取得移動前的 Strokes 集合之週框，請處理 SelectionMoved 事件並取得 InkOverlaySelectionMovedEventArgs 物件的 OldSelectionBoundingRect 屬性。

若要取得調整大小前的 Strokes 集合之週框，請處理 SelectionResized 事件並取得 InkOverlaySelectionResizedEventArgs 物件的 OldSelectionBoundingRect 屬性。

範例

在這個範例中，InkPicture 物件的所有筆劃都是透過將 Selection 屬性設定為關聯的 Ink 物件所使用的相同 Strokes 集合而進行選取。

在選取筆劃之後，EditingMode 屬性會設定為 Select。

當物件正在收集筆墨時，無法變更 EditingMode 屬性。因為筆墨收集是在與應用程式程式碼不同的執行緒上處理的，所以當應用程式程式碼是在假設 CollectingInk 屬性仍是 false 而作業時，這個屬性可能會變更為 true。若要處理這項應變，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
}