wiki:designer

Morphic Designer

The Morphic Designer is an application for creating Morphic user interfaces with ease. It follows basic ideas of the QtDesigner from the Nokia Qt Framework.

New user interfaces are created via simple drag&drop operations and do not involve writing much source code explicitely. A code generator creates valid Smalltalk code for your design. Designs can be loaded and modified at any time. Even some manual modifications of the generated code are possible, as the load process just executes that code and instantiates the design.

Several people already worked with the designer and created reviews, blogposts, and screencasts.

YouTube

How to Install

Using Metacello, just run the following code in your workspace:

(Installer mc http: 'http://www.hpi.uni-potsdam.de/hirschfeld/squeaksource/')
   project: 'MetacelloRepository';
   install: 'ConfigurationOfDesigner'.
(Smalltalk at: #ConfigurationOfDesigner) load.

If you want to try the latest snapshot (may be unstable), run this:

ConfigurationOfDesigner loadSnapshot.

If you later want to get the latest development version, run this:

ConfigurationOfDesigner loadDevelopment.

Configuration groups

default ... just the Morphic Designer

Version 1.1 Highlights

  • uses Widgets 1.1
  • user interface templates
  • code generation improved

If you want to install this application into a Pharo image, here are some hints to to so: Installing Morphic UI Designer in Pharo 1.1.

How to Use

Watch the screencast showing a small demo user interface: screencast (MP4, 6:25, 1024x768).

First Steps

Open your workspace and execute: UiDesigner open. Then choose a recently edited design, a template or an empty design:

Then begin to drag the widget you want and drop it into the center area which is your user interface:

The right part offers a property table that enables you to change all necessary properties of the currently selected morph. The selection is indicated by halos. The halos work as expected: move, copy, clone, resize, delete:

While in the Designer, every morph that is dropped into a widget container will behave differently on mouse input as the surrounding container will get all clicks and handle the UI editing.

Save & Load

A user interface will be saved as subclass of UserInterface which comes from the Widgets project. That class is just a small common code base for all UIs that understands #setupUi:.

Using a User Interface

If you created a UI class named MyDialogUi, follow these steps to use it in a SystemWindow.

Create a class:

Morph subclass: #MyDialog
	instanceVariableNames: 'ui'
	classVariableNames: ''
	poolDictionaries: ''
	category: 'MyProject-Dialogs'

Add an accessor for lazy UI creation:

MyDialog>>ui
  ^ ui ifNil: [ui := MyDialogUi new]

The initialization of the dialog must use the ui instance to configure itself:

MyDialog>>initialize
   super initialize.
   self ui setupUi: self.

Now all UI elements can be accessed as named in the designer:

self ui myButton
   checkable: true;
   checked: true.

Finally, you can implement a message to open a SystemWindow with this Morph:

MyDialog>>open
   self openInSystemWindowNamed: 'My Dialog'.

The window will get the same size as the UI in the designer as well as background color.

How to Extend

  • code generation
  • property table, caching

Acknowledgments

The Morphic Designer was inspired by the QtDesigner in the Nokia Qt Framework.

To date the following people contributed to this project:

  • Marcel Taeumel
Last modified 20 months ago Last modified on 08/21/12 15:55:10

Attachments (4)