Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

AutoRedraw Property

AutoRedraw Property

Gets or sets a value that specifies whether an ink collector repaints the ink when the window is invalidated.

Declaration

[C++]

[propput] HRESULT put_AutoRedraw ([in] VARIANT_BOOL AutoRedraw);
[propget] HRESULT get_AutoRedraw ([out, retval] VARIANT_BOOL*
    AutoRedraw);

[Microsoft® Visual Basic® 6.0]

Public Property Get AutoRedraw() As Boolean
Public Property Let AutoRedraw(ByVal isAutoRedraw As Boolean)

Property Value

VARIANT_BOOL Value that specifies whether an ink collector repaints the ink when the window is invalidated.

This property is read/write.

TRUEDefault. The ink collector repaints the ink when the window is invalidated.
FALSEThe ink collector does not repaint the ink when the window is invalidated.

Return Value

HRESULT valueDescription
S_OKSuccess.
E_POINTERThe AutoRedraw parameter is an invalid pointer.
E_INK_EXCEPTIONAn exception occurred while processing.
E_INVALIDARGThe flag is invalid.

Remarks

If TRUE, the ink collector repaints the ink when the window is invalidated. For example, if you minimize the window and then restore it, the ink is automatically redrawn. If FALSE, the ink collector does not repaint the ink when the window is invalidated. For example, if you minimize the window and then restore it, the ink disappears from the screen.

When AutoRedraw is FALSE, the ink appears while inking unless the DynamicRendering property is false.

When your application is performing custom rendering or when your application is sensitive to painting issues, you can handle the repainting yourself and set the AutoRedraw property to FALSE for the InkCollector object, the InkOverlay object, or the InkPicture control. Use the events in the following table to handle the repainting.

Object or ControlEvent
InkCollector ObjectThe underlying control's Invalidated and Paint events.
InkOverlay ObjectThe underlying control's Invalidated and Paint events.
InkPicture ControlInkPicture control's inherited Invalidated and Paint events.

Example

[Visual Basic 6.0]

This Visual Basic 6.0 example returns the AutoRedraw value of an InkCollector.

Dim isAutoRedrawSet As Boolean
isAutoRedrawSet = theInkCollector.AutoRedraw

Applies To

Related Topics

Show:
© 2015 Microsoft