startDrawingCapture

startDrawingCapture();

The startDrawingCapture method of the Picture class causes the picture control to enter a special mode in which each subsequent mouse down on the control draws a dot. While the mouse is down, each mouse move event draws a line between the previous point and the current mouse position.

When the method is called, any previous drawing on the control is cleared and the value of the autoRedraw property is set to true. All subsequent user drawing activity is captured and saved.

The points and lines are drawn using default values for the foreColor property (Black), the drawStyle property (DrawStyle_Solid), and the drawWidth property (1) of the picture.

While the picture control is in this special mode, any defined mouseDown, mouseUp, click, and dblClick event methods on the control are not called.

Call the stopDrawingCapture method to exit from the special drawing mode.