showrectangle
AREA

The showrectangle statement refreshes all or part of the current form window.


Parameters

This statement has one parameter:

area – is the rectangle to refresh (in form coordinates). If this is a zero height and width rectangle the entire form is refreshed Note: You can repeat this parameter to refresh multiple areas.


Description

This statement refreshes all or part of the current form window. This example refreshes a 1 inch high by 2 inch wide area in the top left corner of the form.

showrectangle rectangle(0,0,72,144)

This example refreshes three 1" squares on a diagonal from the upper left.

showrectangle rectangle(0,0,72,72),rectangle(72,72,72,72),rectangle(144,144,72,72),

This example refreshes the entire form.

showrectangle rectangle(0,0,0,0)

In most situations it’s better to use other methods to refresh the form, for example showvariables, showwindowvariables, showfields, etc. However, if there is no field or variable involved, you can perform the refresh using the showrectangle statement. For example, you can use it if you want to make several changes to graphic forms without causing excessive “flashiness”.

noshow
    new form object
    move form object
    delete form object
    change form object
    showrectangle area-that-changed
endnoshow

See Also


History

VersionStatusNotes
10.0NewNew in this version.