Windows
← Chapter 2. Windows and Geometry Manager →

Windows

Introduction
Canvas, Text, Panedwindow
Actors

Introduction

In Graphical User Interface s a window is a region with content, mostly of rectangular shape. Drawing operations outside the defined window region are invisible –clipped .

In Tk a window appears in the window hierarchy and has a unique identifier. This identifier is called the window pathname in Tcl/Tk.

Example 2.1. Tcl/Tk pathnames

button .b
label .b.l
entry .b.l.e
...

The pathname is a list of window names separated by the dot (.) character. The last term is the name of the window and the terms before its ancestors.

Tk contains a special window without a name: dot (.), the root window. The root window is automatically created by Tk whenever a new window hierarchy is established. In Example 2.1, “Tcl/Tk pathnames” ».b« is a child of the root window.

A Tk window can be implemented in either »C« Jeszra does not yet generate C-source code.

The used programming language is irrelevant for the Graphical User Interface performance. Graphical User Interface performance is defined as how quick an application respond to a request –event–, either initiated by the user or through the application. How fast an application should respond is defined by its user. A human being requires time for seeing, deciding and acting. In detail: a normal human being perceives a succession of pictures as continues when they follow within 70ms –motion pictures have 41ms. Deciding and acting require roughly the same time as seeing. Thus a Graphical User Interface is perceived without interruption, when every user initiated action is completed within 3x70ms = 210ms.

Humans adapt easily to a certain speed, but not to speed changes. The solution for an unresponsive action can be to increase the processing time of all other actions.

Hence the performance of an application shall be independent from its data. The related measurement for responsiveness is called complexity . Complexity defines how much the processing time increases with contents. The desired complexity, for all windows, is constant ; which means that the response is independent from contents.

The responsivness of a software is determined by the author of that software and not by the used programming language. For example: the hugelist window, written in Tcl/Tk, has a constant complexity. The Tk listbox window, written in C, has linear complexity on n–were n is the number of all listbox entries.

7 Rules for a well crafted Window

Canvas, Text, Panedwindow

Figure 2.1. Built-In Managers in Hierarchy View


Each of this classes features a built-in geometry manager. Figure 2.1, “Built-In Managers in Hierarchy View” displays the window hierarchy for all three built-in geometry managers.

General purpose geometry managers (pack, grid, place) are recessive to built-in geometry managers in Jeszra.

The canvas built-in geometry manager is called »canvas« and operates similar to »place«.

Figure 2.2. Window embedded in a Canvas


The text built-in geometry manager is called »text«, its geometry has no similarity to any stand-alone manager. The text geometry manager treats windows like glyphs(tokens). Windows float in paragraphs. The closest resemblance, to the text geometry manager, is a wrapped menu bar.

Figure 2.3. Text Managed Window


Paned windows provide a grid like built-in geometry manager. The internal geometry manager features grips, sash for interactive resize operations.

Figure 2.4. Paned Managed Window


Jeszra keeps built-in geometry management and the window structure synchronized. A window, managed by a built-in manager, must be a child of the managing window.

Scalable Vector Graphics cannot be generated from the paned window. The internal decoration is excluded from Scalable Vector Graphics output. The paned decoration would be located between the red and black frame in Figure 2.5, “The Built-In Layout”.

Figure 2.5. The Built-In Layout


The Canvas Items palette contains graphical objects available in the Tk canvas window.

Figure 2.6. Tk Canvas Palette


Canvas Items are almost identical to windows, they have properties, react to events, feature »states« (may interact in predefined ways). The main difference to a window: Canvas Items can only being created and used inside of a »canvas« window.

Jeszra combines vector graphics and application design. The Tk canvas is only a very small part of Jeszra´s abilities. Vector graphics are dealt with in great detail later on in Chapter 6, Vector Graphics.

A text tag is a format description for floating text in a text window.

All text window features are supported by Jeszra, including direct editing and text formatting.

Figure 2.7. Tags, formatted Text


Text formats are organized as »tags«. Tags appear inside the hierarchy view underneath the window node, The hierarchy view resembles Figure 2.7, “Tags, formatted Text” . A tag is selectable and through the Inspector edit able. The Inspector »Geometry« page allows to extend the range of the given tag or to modify existing ranges.

The coordinates from the built-in »sel« tag are re-used, when creating a new tag.

Figure 2.8. Inspector: Tag Ranges


Preferences Page General

Figure 2.9. General Preferences


Use the »Show Insert Dialog« from the »General« preferences page to predefine the name of a new tag.

SVG and the Text-Window

The text window can only partialy converted to Scalable Vector Graphics 1.1. The text window lacks introspection. Although, it might be possible to use »dlineinfo« to gather some additional information about the visual aspects. »dlineinfo« is still insufficient to generate proper Scalable Vector Graphics 1.1.

The flowRoot item in Scalable Vector Graphics 1.2 may close this conversion gap between Tk and Scalable Vector Graphics.

There is a wide family of actors.

First amongst the actor family are the button-type controls. In Tk (and AQUA®, Motif®), there are buttons, button groups, checkbutton groups, radiobutton groups, checkbuttons with indicator, radiobuttons with indicator, menu commands, menu radiobuttons and menu checkbuttons.

Figure 2.10. Striped Button Family


Figure 2.10, “Striped Button Family” displays the button-style controls, as seen under Gstripes. On the left is the normal form and to the right the white space variation shown.

The white space variant of checkbutton and radiobutton have so-called indicators. An indicator is an icon representing the normal form from the left. This allows for multi-line captions without risking visual disintegration.

Microsoft® Windows 95® Checkentry

Microsoft® Windows 95® only featured the white space variant. These controls were termed »checkentry« and »radioentry«. This design is acceptable, as long as there is no normal form available.

The menubutton, at the bottom, is somewhat out of the ordinary. This control displays an indicator to the right, but does not fade into white space. Here, the indicator hints toward the popup menu, which appears when activating the menubutton. The right-sided button inside of a combobox uses the same visual concept.

Unacceptible Window Relations

Menubuttons are container windows for menus. In Jeszra any window can be inserted to a menubutton. The connection line between the menubutton and an »unacceptible« window is red coloured, as shown in Figure 2.11, “Red-coloured Window Relations”.

To correct this error: Select the child window, in the hierarchy view, and drag them one level up –to the parent window of the menubutton.

The dragged window is still invisible, to be precise: they are »unmapped« ! Every window is by default unmapped (hidden), until it gets managed by a geometry manager.

Use the »Information« region from the »Inspector« to map hidden windows. The »Geometry« option menu provides direct access to the three general purpose geometry managers: »Grid«, »Pack« and »Place«. Choose one geometry manager from the menu and »map« the window on-screen.

Figure 2.11. Red-coloured Window Relations


Figure 2.12. Menu Palette


Menus can be seen as dynamic dialogs, containing only a very limited set of controls. In Tk, controls inside of menus, are called »menu entries«.

Cascade is the equivalent to a menubutton. An cascade entry features a »menu« property, referring to another menu. The referenced menu is automatically opened (posted) whenever selecting a cascade entry.

Command is the equivalent to a button.

There is no normal form for menu entries! Menu entries have a close resemblance to the white space variation of their dialog counterparts. A menu can be seen as a single white space area wherein controls are being swallowed.

The separator is an inert entry. Separators are used for grouping entries.

The »Command«, »Radiobutton«, »Checkbutton« and »Separator« entries in Figure 2.12, “Menu Palette” are disabled. These entries are activated when selecting a »menu« window.

Menu screen-shots appear frequently inside of this document. A good example is shown in Options Menu. The »Options« menu features a radiobutton-group, a command entry and three checkbuttons.

AQUA® HCI Guidelines

The AQUA® HCI Guidelines recommends to use the caption of a checkbutton entry to communicate its state. This is used everywhere inside of Jeszra’s own menus. There is no direct support for this checkbutton type in Tk. Jeszra uses »commands« to achieve this design and implements the state handling explicitly.

The »-postcommand« Jeszra uses the postcommand property to create its diverse menus on-demand.

The postcommand property contains a tcl-script, which gets called right before displaying the menu on-screen.

← ↖ →
Chapter 2. Windows and Geometry Manager ↑ The Tk Palette
SourceForge Logo

Copyright © 2009–2010 Arndt Roger Schneider