Documentation of BanghamLab utilities

From BanghamLab
Jump to navigation Jump to search

[Return to Software]

In preparation

GuiDemo for rapidly creating user interfaces from simple dialogues to full applications

Whilst the Matlab guide is very useful for rapidly creating graphical user interfaces (GUIs) with an arbitrary layout, we find that it is even quicker to base a GUI on GuiDemo.
Why? Because we find it easier to delete things we don't want, and modify those that we do want, rather than starting with a blank screen. Our applications often output graphics and images. This system creates a separate Figure for graphical/image output. This makes it easy to resize, print and annotate without altering the GUI itself.

Creating a GUI based on GuiDemo

Description of how the ConnectedSets Gui was created.

  1. Copy the contents of \DArT_Toolshed\ToolBag\Demo of JRK GUI to your working directory.
  2. Rename, e.g. GuiDemo.m to ConnectedSets.m and GuiDemoLayout.txt to ConnectedSetsLayout.txt
  3. Within ConnectedSets.m replace all strings GuiDemo by ConnectedSets. We now have a working template.
Working template created by GuiDemo.

It has names (GuiDemo), menus, buttons and a graphics window. All of which can readily be changed or deleted.
Closing either window closes both.
Having selected a menu item or pressed a button, the callback is displayed in the command window. This makes it easier to edit/add the required functions.

  1. Text and the left hand, GUI, panel is specified by the text file ConnectedSetsLayout.txt. A small fragment is shown here
  2. figure { string "GuiDemo" tag figure_GuiDemo callback GuiDemo inherit callback menu { string "File" size "0 0" menu { string "New Project" } menu { string "Open Project..." } menu { string "Save Project As..." } menu { string "Close Project" } menu { string "Show Project On Desktop" } } Full listing of template

    Once again replace all strings GuiDemo by ConnectedSets within ConnectedSetsLayout.txt.
  3. Notice all the buttons and menu items are specifed in ConnectedSetsLayout.txt. The layout is automatically created from the structure of ConnectedSetsLayout.txt. Callback names etc. tags etc. are created automatically.
  4. For the new ConnectedSet application we will probably need the main menus. For the moment we can change the View menu, modify the buttons and add a couple of dropdown lists (to select images, and to select what we want to display. For working examples, in addition to ConnectedSetLayout.txt also look at MTtboxLayout.txt
  5. Having removed unwanted buttons etc. remove the corresponding callback functions in ConnectedSets.m. Notice that their names are based on the GUI name, e.g. 'pushbutton Restart' callback is to function pushbutton_restart (note lower case) and menu item 'View:Refresh plot' is to menu_refresh_plot
  6. Re-run ConnectedSets
    Working template created by ConnectedSets.

    The elements of the GUI are a 'sketch' of what I want to achieve. Things will be changed as it is made operational

    On the command line is output a list of all the missing callback functions, e.g.

    function data=ReportLine1(data)
    function data=ReportLine2(data)

    The next step is to copy the lot into the end of ConnectedSet.m
    Full list of missing ConnectedSet callbacks


    A small fragment of the revised ConnectedSetsLayout.txt is shown here

    figure {
       string "ConnectedSets"
       tag figure_ConnectedSets
       callback ConnectedSets
       inherit callback
       menu { string "File" size "0 0"

    Full listing of ConnectedSetsLayout.txt at this stage

  7. Note: a couple of listboxes have been included (they might be useful for listing images etc.
  8. The next step is to fill in (instantiate) the callbacks - i.e. program the application