InkPicture.CollectingInk (Propiedad)

Artículo
10/28/2008

Actualización: noviembre 2007

Obtiene un valor que especifica si la entrada manuscrita se dibuja actualmente en un control InkPicture.

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

Sintaxis

'Declaración
<BrowsableAttribute(False)> _
Public ReadOnly Property CollectingInk As Boolean
'Uso
Dim instance As InkPicture
Dim value As Boolean

value = instance.CollectingInk

[BrowsableAttribute(false)]
public bool CollectingInk { get; }

[BrowsableAttribute(false)]
public:
property bool CollectingInk {
    bool get ();
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public boolean get_CollectingInk()

public function get CollectingInk () : boolean

Valor de propiedad

Tipo: System.Boolean
Valor que especifica si la entrada manuscrita se dibuja actualmente en un control InkPicture.

Valor	Significado
true	La entrada manuscrita se dibuja en el control InkPicture.
false	La entrada manuscrita no se dibuja en el control InkPicture.

Comentarios

Puede utilizar la propiedad CollectingInk para ver si la entrada manuscrita se dibuja en un control InkPicture en lugar de supervisar el evento Stroke.

Nota

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 código que depende del valor de la propiedad CollectingInk se debería incluir dentro de un bloque try-catch.

Ejemplos

En este ejemplo, se seleccionan todos los trazos del objeto InkPicture 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 se debería incluir dentro de 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.