Refresh Method

Repaints a form or control and refreshes any values, or refreshes a project's visual display.

[Form.]Object.Refresh

-or-

Project.Refresh([lUpdateSCCStatus])

Parameters

  • lUpdateSCCStatus
    Logical data type. The lUpdateSCCStatus parameter specifies, for a project, if the source control status for each file under source control is updated. Visual FoxPro disregards lUpdateSCCStatus if no files in the project are under source control.

    The following table lists the values for lUpdateSCCStatus.

    lUpdateSCCStatus Description
    True (.T.) Updates the source control status for each file in the project under source control.
    False (.F.) or none Does not update the source control status.

Remarks

Generally, Visual FoxPro automatically handles painting a form or control while no events are occurring. You can use the Refresh method when you want to update the form or control immediately, force a complete repaint of a form or control, or to update the value of a control.

You can also use the Refresh method when you want to display a form while another form is loading, or when you want to update the contents of a control. To update the contents of a combo box or a list box, use the Requery method.

Note   When a form is refreshed, all controls on the form are also refreshed. When a page frame is refreshed, only the active page is refreshed.

When you call the Refresh method for a Label control, Visual FoxPro updates the Caption property and redraws the label.

When you call the Refresh method for a Shape control, Visual FoxPro redraws the shape.

When you call the Refresh method for projects, Visual FoxPro refreshes a project's visual display with any changes made to the project. For example, after programmatically adding files to the project with the Add method, you can call the Refresh method to display the newly added files in the project.

The GridRefresh method visually updates the grid's record indicator even if the grid does not have focus.

See Also

Paint Event | Requery Method

Applies To: CheckBox | Column | ComboBox | CommandButton | CommandGroup | Container Object | Control Object | EditBox | Form | FormSet | Grid | Header | Label | ListBox | OLE Bound Control | OLE Container Control | OptionButton | OptionGroup | Page | PageFrame | Project Object | _SCREEN | Shape | Spinner | TextBox | ToolBar