9.4 DUIM-Frames Module

start-frame

Generic function

Summary

Starts the specified frame.

Signature

start-frame frame #key owner mode => status-code

Arguments

frame: An instance of type <frame>.
owner: An instance of type false-or(<frame>). Default value: #f.
mode: An instance of type one-of("modal", #"modeless", #"system-modal"). Default value: #f.

Values

status-code: An instance of type <integer>.

Library

duim-frames

Module

duim-frames

Description

Starts frame, optionally setting the owner of the frame and the mode in which it will run.

The function start-frame dynamically binds an <abort> restart around the event loop for the frame that is started. The restart allows the event loop to be re-entered, and enables any callbacks run from the frame to signal an <abort> (via the abort function, for instance), in order to terminate execution of the current callback and return to event processing. This facility is useful for implementing operations that cancel gestures and for debugging DUIM applications from Dylan debuggers.

Example

The following example creates a simple frame, then displays it. You should run this code in the interactor, pressing the RETURN key at the points indicated.

define variable *frame* = 
   make(<simple-frame>, title: "A frame", 
        layout: make(<button>));RETURN

start-frame(*frame*);RETURN