InkCollector.AutoRedraw (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene o establece un valor que especifica si el objeto InkCollector vuelve a dibujar la entrada manuscrita cuando se invalida la ventana.

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

Sintaxis

'Declaración
Public Property AutoRedraw As Boolean
'Uso
Dim instance As InkCollector
Dim value As Boolean

value = instance.AutoRedraw

instance.AutoRedraw = value

public bool AutoRedraw { get; set; }

public:
property bool AutoRedraw {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_AutoRedraw()
/** @property */
public  void set_AutoRedraw(boolean value)

public function get AutoRedraw () : boolean
public function set AutoRedraw (value : boolean)

Valor de propiedad

Tipo: System.Boolean
Es true si el objeto InkCollector vuelve a dibujar la entrada manuscrita cuando se invalida la ventana; en caso contrario, es false.

Comentarios

El valor de la propiedad AutoRedraw especifica si el objeto Ink asociado actualmente al objeto InkCollector se vuelve a dibujar o no automáticamente cuando la ventana asociada al objeto InkCollector recibe una notificación de Paint. Por ejemplo, si AutoRedraw se establece en true, la entrada manuscrita se vuelve a dibujar automáticamente al minimizar la ventana y restaurarla después. Si se establece en false, al minimizar la ventana y restaurarla después, la entrada manuscrita desaparece de la vista.

Cuando la propiedad AutoRedraw es false, la entrada manuscrita aparece al escribir a mano, a menos que la propiedad DynamicRendering sea false.

Si la aplicación realiza una representación personalizada o tiene problemas al pintar, la puede volver a dibujar y establecer la propiedad AutoRedraw en false para el control InkPicture. En ese caso agregue un delegado al controlador de eventos OnPaint del control subyacente para dibujar personalmente la entrada manuscrita o administrar el evento Invalidate del control subyacente para modificar el objeto InvalidateEventArgs.

Ejemplos

En este ejemplo se muestran los trazos de un objeto InkCollector estableciendo la propiedad AutoRedraw en false y, a continuación, dibujando manualmente la entrada manuscrita. El controlador de eventos Paint del control al que está asociado el objeto InkCollector comprueba el tamaño de cada trazo. Si el trazo es menor de 400 unidades del espacio de entrada manuscrita, el trazo aparece en azul.

Private Sub mInkObjectControl_Paint(ByVal sender As Object, ByVal e As PaintEventArgs)

    ' Check if AutoRedraw is off
    ' mInkObject can be InkCollector, InkOverlay, or InkPicture
    If Not mInkObject.AutoRedraw Then

        ' Draw each stroke manually
        For Each stroke As Stroke In mInkObject.Ink.Strokes
            ' See if this stroke is small
            Dim strokeBounds As Rectangle = stroke.GetBoundingBox()
            If strokeBounds.Width < 400 And strokeBounds.Height < 400 Then
                ' Change the drawing color to blue
                Dim newAttributes As DrawingAttributes = stroke.DrawingAttributes.Clone()
                newAttributes.Color = Color.Blue
                ' Draw with these special drawing attributes
                mInkObject.Renderer.Draw(e.Graphics, stroke, newAttributes)
            Else
                ' Draw stroke with its own drawing attributes
                mInkObject.Renderer.Draw(e.Graphics, stroke)
            End If
        Next
    End If

End Sub

private void mInkObjectControl_Paint(object sender, PaintEventArgs e)
{
    // Check if AutoRedraw is off
    // mInkObject can be InkCollector, InkOverlay, or InkPicture
    if (!mInkObject.AutoRedraw)
    {
        // Draw each stroke manually
        foreach (Stroke stroke in mInkObject.Ink.Strokes)
        {
            // See if this stroke is small
            Rectangle strokeBounds = stroke.GetBoundingBox();
            if (strokeBounds.Width < 400 && strokeBounds.Height < 400)
            {
                // Change the drawing color to blue
                DrawingAttributes newAttributes = stroke.DrawingAttributes.Clone();
                newAttributes.Color = Color.Blue;

                // Draw with these special drawing attributes
                mInkObject.Renderer.Draw(e.Graphics, stroke, newAttributes);
            }
            else
            {
                // Draw stroke with its own drawing attributes
                mInkObject.Renderer.Draw(e.Graphics, stroke);
            }
        }
    }

}

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.