InkOverlay.AutoRedraw 属性

项目
11/04/2008

获取或设置一个值，该值指定当窗口失效时 InkOverlay 对象是否重绘墨迹。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
<BrowsableAttribute(True)> _
Public Property AutoRedraw As Boolean
用法
Dim instance As InkOverlay
Dim value As Boolean

value = instance.AutoRedraw

instance.AutoRedraw = value

[BrowsableAttribute(true)]
public bool AutoRedraw { get; set; }

[BrowsableAttribute(true)]
public:
property bool AutoRedraw {
    bool get ();
    void set (bool value);
}

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

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

属性值

类型：System.Boolean
一个值，指定在窗口失效时 InkOverlay 对象是否重绘墨迹。
如果在窗口失效时 InkOverlay 对象重绘墨迹，则为 true；否则为 false。

备注

AutoRedraw 的值指定与 InkOverlay 对象关联的窗口接收到 Paint 通知时，是否自动重绘当前与 InkOverlay 对象关联的 Ink 对象。例如，如果设置为 true，则在最小化窗口然后还原该窗口时，将自动重绘墨迹。如果设置为 false，则在最小化窗口然后还原该窗口时，墨迹将消失。

如果 AutoRedraw 为 false，除非 DynamicRendering 属性为 false，否则在墨迹书写时将显示墨迹。

如果应用程序要执行自定义呈现，或者应用程序对绘制问题敏感，您可以自己处理重绘，并为 InkOverlay 对象将 AutoRedraw 属性设置为 false。这种情况下，请向 InkOverlay 对象的 OnPainted 事件处理程序添加一个委托，以便自己绘制墨迹或处理基础控件的 Invalidate 事件来修改 InvalidateEventArgs 对象。

示例

此示例通过将 AutoRedraw 属性设置为 false 来显示 InkOverlay 对象中的笔画，然后手动绘制墨迹。附加 InkCollector 的控件的 Paint 事件处理程序检查每个笔画的大小。如果笔画小于 400 个 墨迹空间单位，则笔画呈现蓝色。

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);
            }
        }
    }

}