Draw Methods

The following methods are used to draw, redraw, and clear a dialog or dialog control.

Draw

>>-aDialogControl~Draw-----------------------------------------><


The Draw method draws the dialog or dialog control.

Return value:

0

Drawing was successful.

1

Drawing failed.

Clear

>>-aDialogControl~Clear----------------------------------------><


The Clear method draws the dialog or dialog control using the background brush.

Return value:

0

Clearing was successful.

1

Clearing failed.

ClearRect

>>-aDialogControl~ClearRect(--left--,--top--,--right--,--bottom--)-><


The ClearRect method draws the dialog or dialog control using the background brush.

Arguments:

The arguments are:

left,top

The upper left corner of the rectangle, in screen pixels.

right,bottom

The lower right corner of the rectangle, in screen pixels.

Return value:

0

Drawing was successful.

1

Drawing failed.

Redraw

>>-aDialogControl~Redraw---------------------------------------><


The Redraw method redraws the dialog or dialog control immediately.

Return value:

0

Redrawing was successful.

1

Redrawing failed.

RedrawRect

>>-aDialogControl~RedrawRect(--left--,--top--,--right--,--bottom-->

>--+-----------+--)----------------------------------------------><
   +-,erasebkg-+


The RedrawRect method immediately redraws the rectangle of the client area of the associated dialog. You can specify whether the background of the dialog is to be erased before redrawing.

Arguments:

The arguments are:

left,top

The upper left corner of the rectangle relative to the client area, in screen pixels.

right,bottom

The lower right corner of the rectangle relative to the client area, in screen pixels.

erasebkg

If this argument is 1 or "Y", the background of the dialog is erased before repainting.

Return value:

0

Redrawing was successful.

1

Redrawing failed.

RedrawClient

>>-aDialogControl~RedrawClient(--erasebkg--)-------------------><


The RedrawClient method immediately redraws the entire client area of the dialog or dialog control. You can specify whether the background of the dialog or dialog control is to be erased before redrawing.

Arguments:

The only argument is:

erasebkg

If you specify 1 or "Y", the background of the dialog is erased before redrawing.

Return value:

0

Redrawing was successful.

1

Redrawing failed.