Scout/Concepts/Desktop

Scout

Wiki Home

Website

Download • Git

Community

Forums • Blog • Twitter • G+

Bugzilla

Bugzilla

Desktop is the root component of Scout Client applications.

• implements: IDesktop
• extends: AbstractDesktop

Description

The desktop is the entry point of every Scout Client application. It can (may) consist of:

• Top-level menus
• Tools
• Set of available outlines and an active outline

• active message box stack
• active tableview
• active detail form
• active search form
• form stack (swing: dialogs on desktop as JInternalFrames; eclipse: editors or views)
• dialog stack of modal and non-modal dialogs (swing: dialogs as JDialog, JFrame; eclipse: dialogs in a new Shell)

Properties

Defined with getConfiguredXxxxxx() methods.

• Title: title of the application.
• Outlines: provide a list of the Outlines defined in the application.

Events

Defined with execXxxxxx() methods.

• Init

Application events

• Opened:

This event is occurs after the desktop was opened and setup in UI. It provide the possibility to define what will be displayed in the main windows. The corresponding forms are instantiated and started.

In most of the cases, the code generated when you create a new project do not need to be changed. It depends of the type of application you want to create.

For a Single form application:

@Override
protected void execOpened() throws ProcessingException {
  // dektop form
  DesktopForm desktopForm = new DesktopForm();
  desktopForm.startView();
}

For an Outline based application:

@Override
protected void execOpened() throws ProcessingException {
  // outline tree
  DefaultOutlineTreeForm treeForm = new DefaultOutlineTreeForm();
  treeForm.startView();
 
  //outline table
  DefaultOutlineTableForm tableForm = new DefaultOutlineTableForm();
  tableForm.startView();
 
  if (getAvailableOutlines().length > 0) {
    setOutline(getAvailableOutlines()[0]);
  }
}

• Closed: occures before the application quit.
• OutlineChanged: the active outline changed.

Events to handle GUI

• GUIAttached
• GUIDetached

See Also

• Outline
• Client Plug-In