InkOverlay.Selection (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene o establece la colección Strokes que está seleccionada actualmente dentro del control InkOverlay.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
<BrowsableAttribute(False)> _
Public Property Selection As Strokes
'Uso
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)

Valor de propiedad

Tipo: Microsoft.Ink.Strokes
Colección Strokes que está seleccionada actualmente dentro del control InkOverlay. El valor predeterminado es una colección Strokes vacía.

Comentarios

Para obtener el rectángulo delimitador de la colección Strokes después de moverla o cambiar su tamaño, llame al método GetBoundingBox de la colección Strokes devuelto por esta propiedad.

Para obtener el rectángulo delimitador de la colección Strokes antes de moverla, controle el evento SelectionMoved y obtenga la propiedad OldSelectionBoundingRect del objeto InkOverlaySelectionMovedEventArgs.

Para obtener el rectángulo delimitador de la colección Strokes antes de cambiar su tamaño, controle el evento SelectionResized y obtenga la propiedad OldSelectionBoundingRect del objeto InkOverlaySelectionResizedEventArgs.

Ejemplos

En este ejemplo, se seleccionan todos los trazos del objeto InkOverlay estableciendo la propiedad Selection en la misma colección Strokes utilizada por el objeto Ink asociado.

Una vez realizada la selección, la propiedad EditingMode se establece en Select.

No se puede cambiar la propiedad EditingMode mientras el objeto está recopilando entrada manuscrita. Como la recopilación de entrada manuscrita se controla mediante un subproceso independiente del código de la aplicación, la propiedad CollectingInk puede cambiar a true mientras el código de la aplicación funcione con la suposición de que sigue siendo false. Para solventar esta contingencia, el acceso a la propiedad EditingMode debe incluirse en un bloque 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
}

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.