Документ взят из кэша поисковой машины. Адрес оригинального документа : http://xmm.vilspa.esa.es/sas/5.4.1/doc/sas/node25.html
Дата изменения: Mon Jan 13 16:54:05 2003
Дата индексирования: Sat Dec 22 07:11:52 2007
Кодировка:
Поисковые слова: space shuttle atlantis

XMM-Newton Science Analysis System


sas (gui-1.37.5) [???]

Meta Index / Home Page / Developer's notes

Layout file

The SAS GUI generates parameter dialogs on-the-fly, from the information in the task's parameter file. Each parameter type gives rise to a corresponding type of parameter widget.

An optional layout file may be provided to customize the layout of the parameter dialog. If no layout file is found, a simple default layout is used. The layout file allows complex parameter dialogs to be structured by grouping and labeling sets of related parameters. Optional parameters (see documentation of param package) may be disabled (e.g. grayed-out) when they are not applicable.

The layout file normally resides in the config directory with the parameter file (although it can be in any config directory in the SAS_PATH). The name of the layout file should be the task name, with the suffix .lyt.

The layout description has a hierarchical structure which matches the hierarchical layout of the GUI. Nested constructs in the file should be indented for clarity.

The layout file has the following syntax:

# comment
LayoutContainer [name]
  Parameter name
    :

  # another comment
  LayoutContainer [name]
    :
  end
end

The GUI distincts the following constructs:

• Cards
  Breaks the parameters up in so called tab cards. Every card is represented by a Page,

• Column
  Children are presented column wise,

• Choice parametername
  Like Frame, but the contents consists of one or more Pages,

• Enable parametername
  Like Frame, but the contents can be enabled or disabled,

• Frame name
  Groups a number of LayoutContainers and/or Parameters in a (optionally named) box,

• Page name
  A Page can only be used as child of Cards or Choice.
  One of the Pages in the parent container is shown,

• Row
  Children are presented row wise,

• Parameter parametername
  Single parameter entry, preceded with parametername.

Blank lines are ignored. Comments start with the character # and extend to the end of the line. Names (e.g. page names and frame labels) may be enclosed in double quotes to allow embedded spaces.

Parameters are arranged in the order given in the layout file, which is not necessarily the same as the order in the parameter file.

The following layout constructs may be used to structure a parameter dialog: