7.3 DUIM-Layouts Module

define pane

Definition macro

Summary

Defines a new class of DUIM pane.

Macro call

define pane name ({supers},*) {slots-and-panes} end

Arguments

name: A Dylan name_bnf.
supers: A Dylan name_bnf.
slots-and-panes: A Dylan body_bnf.

Values

None.

Library

duim-layouts

Module

duim-layouts

Description

This macro lets you define a new class of DUIM pane.

The name argument represents the name of the new class of pane, and supers is a list of zero or more superclasses for the new class. Multiple superclass names are separated by commas.

The slots-and-panes argument represents the slot information for the new class, together with any init-keywords and default values that the slots should take.

Panes are sheets which represent a "useful unit" in a GUI. There is no protocol class called <pane>.

In most cases (such as when defining a frame using define frame), a pane class groups existing gadgets (or panes) to form effectively a new gadget, without actually creating a new class of <gadget>.
Sometimes, a pane class implements some complex output-only sheet.
Sometimes, a pane class implements the <sheet> part of a <gadget>.

In general, a pane is best described as a concrete sheet.

Example

define pane <my-pane> ()
  slot my-layout,
    init-keyword: layout:;
  slot my-exit-buttons,
    init-keyword: exit-buttons:;
end pane <my-pane>;