Docking Windows

  • Article

You can dock certain Visual FoxPro Integrated Development Environment (IDE) windows to the Visual FoxPro desktop window or with each other. The following windows are dockable:

  • Call Stack
  • Command
  • Data Session (View)
  • Debugger
  • Document View
  • Locals
  • Output
  • Properties
  • Trace
  • Watch

Note   Historically in prior versions of Visual FoxPro, the Data Session window has always been referred to as the View window. Additionally, language used to control this window, such as HIDE WINDOW, ACTIVATE WINDOW, WONTOP( ), also refers to this window as the View window.

When you drag a dockable window to a Visual FoxPro desktop window boundary, the dockable window repositions itself against the chosen boundary. The state and location of docked windows persist from the last user session.

To dock windows and toolbars programmatically and retrieve their dock states, see DOCK WINDOW Command and ADOCKSTATE( ) Function.

You can change the dockable status of a dockable window.

To enable or disable dockable status

  1. Right-click the title bar of an open and dockable window.
  2. Click Dockable to enable or disable the dockable status of the window. A check mark appears when the window is dockable.

-or-

  1. Click the desired window to make the window active.
  2. On the Window menu, click Dockable to enable or disable the dockable status of the window. A check mark appears when the window is dockable.

For more information about retrieving the dockable status for a window programmatically, see WDOCKABLE( ) Function.

Docking Modes

You can dock windows in three different modes:

  • Normal docking

    Windows dock to a boundary of the Visual FoxPro desktop window.

  • Linked docking

    Windows dock to each other and share a dockable window container.

  • Tabbed docking

    Windows dock to each other and share the full window through the use of tabs.

You can use tabbed docking and linked docking together.

To create normal docking

  1. Make sure the docking status of the window or windows is set to Dockable.
  2. Drag the window title bar to a boundary of the Visual FoxPro desktop window.

To create linked docking

  1. Make sure the docking status of the window or windows is set to Dockable.
  2. Drag the title bar of the desired window to a boundary or docking zone of the target window.

The docking zone is indicated when the window you are dragging changes shape to fit the target window. Visual FoxPro creates an additional title bar for link-docked windows.

To create tabbed docking

  1. Make sure the docking status of the window or windows is set to Dockable.
  2. Drag the title bar of the desired window to the title bar of the target window.

Visual FoxPro adds tabs to the bottom boundary of the docked windows.

To undock windows

  • To undock normal-docked windows, drag the title bar of the desired window away from the shared window boundary.

-or-

  • To undock link-docked windows, drag the title bar of the desired window away from the shared window.

-or-

  • To undock tab-docked windows, drag the tab of the desired window away from the shared window.

You can disable docking behavior by holding the CTRL key while dragging a window.

Deleting or editing the FoxUser.dbf resource file, which contains your settings, restores or changes your default window settings. For more information about altering your settings, see FoxUser Resource File Structure.

See Also

Visual FoxPro System Windows | Document View Window