IInkCollector::get_AutoRedraw method (msinkaut.h)

Article
02/22/2024

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

This property is read/write.

Syntax

HRESULT get_AutoRedraw(
  VARIANT_BOOL *AutoRedraw
);

Parameters

AutoRedraw

Return value

None

Remarks

If VARIANT_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 VARIANT_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 VARIANT_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 VARIANT_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 Control	Event
InkCollector Object	The underlying controls Invalidated and Paint events.
InkOverlay Object	The underlying controls Invalidated and Paint events.
InkPicture Control	InkPicture controls inherited Invalidated and Paint events.

Requirements

Requirement	Value
Minimum supported client	Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	msinkaut.h
Library	InkObj.dll