AllowOutput Property

Specifies whether to allow default output to appear on a form. Read/write at design time and run time.

Form.AllowOutput = lExpr

Parameters

  • lExpr
    Logical data type. The following table lists the settings for lExpr.

    lExpr

    Description

    True (.T.)

    (Default) Sends user output to the form if it is active.

    False (.F.)

    Redirects user output to the desktop if the form is active.

Remarks

Applies To: Form Object

If the AllowOutput property is programmatically changed from True (.T.) to False (.F.), at run time, Visual FoxPro automatically redirects output to the desktop.

Note

Using the AllowOutput property can affect code that relies on the position and size of a window. This includes the use of WOUTPUT( ) or other commands, such as DEFINE POPUP...FROM, that implicitly base their coordinates on the output window.

Setting the AllowOutput property to False (.F.) on a form, changes the following Visual FoxPro behavior.

  • Painting of the form is redirected to the next output window or desktop. This affects commands, such as ?, ??, DIR, LIST, DISPLAY, CLEAR, and other commands that display output on a form.

  • The WOUTPUT( ) function does not return the name of the active form. It returns the name of the current output form or desktop.

  • The BROWSE command does not inherit the window size and window settings of the form.

  • The MCOL( ) and MROW( ) functions, without the use of their optional parameter, may not be relative to the form they are called on.

When a form closes with the AllowOutput property set to False (.F.), Visual FoxPro defaults to the next output form or desktop.

See Also

Reference

? | ?? Command

BROWSE Command

CLEAR Commands

DEFINE POPUP Command

DIR or DIRECTORY Command

DISPLAY Command

LIST Commands

WOUTPUT( ) Function

Other Resources

Properties (Visual FoxPro)