InkOverlay.Selection-Eigenschaft

Artikel
11/26/2008

Ruft die derzeit im InkOverlay-Steuerelement ausgewählte Strokes-Auflistung ab, oder legt diese fest.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
<BrowsableAttribute(False)> _
Public Property Selection As Strokes
'Usage
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)

Eigenschaftenwert

Typ: Microsoft.Ink.Strokes
Die Strokes-Auflistung, die derzeit im InkOverlay-Steuerelement ausgewählt ist. Der Standardwert ist eine leere Strokes-Auflistung.

Hinweise

Um das umgebende Rechteck der Strokes-Auflistung nach dem Verschieben oder Ändern der Größe abzurufen, rufen Sie die GetBoundingBox-Methode der Strokes-Auflistung auf, die von dieser Eigenschaft zurückgegeben wurde.

Um das umgebende Rechteck der Strokes-Auflistung abzurufen, bevor es verschoben wurde, behandeln Sie das SelectionMoved-Ereignis, und rufen Sie die OldSelectionBoundingRect-Eigenschaft des InkOverlaySelectionMovedEventArgs-Objekts ab.

Um das umgebende Rechteck der Strokes-Auflistung vor der Größenänderung abzurufen, behandeln Sie das SelectionResized-Ereignis, und rufen Sie die OldSelectionBoundingRect-Eigenschaft des InkOverlaySelectionResizedEventArgs-Objekts ab.

Beispiele

In diesem Beispiel werden alle Striche des InkOverlay-Objekts ausgewählt, indem die Selection-Eigenschaft auf dieselbe Strokes-Auflistung festgelegt wird, die vom zugeordneten Ink-Objekt verwendet wird.

Nach der Auswahl wird die EditingMode-Eigenschaft auf Select festgelegt.

Die EditingMode-Eigenschaft kann nicht geändert werden, während das Objekt Freihandeingaben erfasst. Da die Erfassung von Freihandeingaben in einem anderen Thread und nicht im Anwendungscode behandelt wird, kann der Wert der CollectingInk-Eigenschaft in true geändert werden, während der Anwendungscode unter der Annahme ausgeführt wird, dass der Wert immer noch false ist. Um diesen Fall zu behandeln, sollte der Zugriff auf die EditingMode-Eigenschaft in einem try-catch-Block enthalten sein.

' 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
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.