9.4 DUIM-Frames Module
<frame>
Open abstract class
Summary
The base class of all frames.
Library
duim-frames
Module
duim-frames
Superclasses
<object>
Init-keywords
owner:- An instance of type
false-or(<frame>). Default value:#f. mode:- An instance of type
one-of(#"modeless", #"modal", #"system-modal").Default value:#"modeless". default-button:-
An instance of type
false-or(<button>). Default value:#f. x:- An instance of type
<integer>. y:- An instance of type
<integer>. width:- An instance of type
<integer>. height:- An instance of type
<integer>. disabled-commands:-
An instance of type
<sequence>. top-level-sheet:-
An instance of type
false-or(<sheet>). Default value:#f. layout:- An instance of type
<layout>. icon:- An instance of type
false-or(<image>). title:- An instance of type
false-or(<string>). Default value:#f. calling-frame:- An instance of type
<frame>. state:- An instance of type
one-of(#"detached", #"unmapped", #"mapped", #"iconified"). Default value:#"detached". thread:- An instance of type
false-or(<thread>). Default value:#f. event-queue:- An instance of type
false-or(<event-queue>). Default value:#f. input-focus:- An instance of type
false-or(<sheet>). Default value:#f. foreground:- An instance of type
false-or(<ink>). background:- An instance of type
false-or(<ink>). text-style:- An instance of type
false-or(<text-style>). palette:- An instance of type
false-or(<palette>). Default value:#f. document:- An instance of type An instance of type
false-or(<object>). Default value:#f. resource-id:- An instance of type
false-or(<integer>). resizable?:- An instance of type
<boolean>. Default value:#t. fixed-width?:- An instance of type
<boolean>. Default value:#f. fixed-height?:- An instance of type
<boolean>. Default value:#f.
Description
The class of all frames.
The owner: init-keyword is the parent of the frame.
The mode: init-keyword lets you specify the mode for the frame. By default, frames are modeless, that is, they do not take over control of the whole application when they are mapped, and the user can interact with other frames in the application normally. Modal frames, on the other hand, behave like a <dialog-frame>, restricting the user's interaction with other frames in the application until the modal frame has been dismissed.
The default-button: init-keyword is used to specify which button is the default action for the frame. The default button is usually the one whose callback is invoked by pressing the RETURN key.
The x:, y:, width: and height: init-keywords lets you specify the initial size and position of the frame. The position is specified using x: and y:, which represent the number of pixels from the top left corner of the screen, and the width: and height: init-keywords specify the initial size of the frame.
The title: init-keyword is used to specify a title for the frame.
The state: init-keyword is used to specify the initial state of the frame. This describes whether the frame is mapped, whether it is iconified, and so on. By default, new frames are detached.
By default, new frames run in their own thread. If desired, a frame can be run in an existing thread by setting the thread: init-keyword to the thread object concerned. For more information about threads, see the manual Library Reference: Core Features.
As with threads, new frame run in their own event-queue by default. To run the frame in an existing event-queue, use the event-queue: init-keyword.
You can specify which sheet in the frame initially has the input-focus using the input-focus: init-keyword. The input-focus dictates where information can be typed by default.
The foreground,: background:, and text-style: init-keywords describes the colors and fonts used in the frame.
Specify a palette for the frame using the palette: init-keyword.
Specify a resource-id for the frame using the resource-id: init-keyword. This is a platform-specific ID or determining which resource to use to fill in a frame.
The resizable?:, fixed-width?:, and fixed-height?: init-keywords let you specify whether or not the user can resize the frame. If resizable?: is #t, then the frame can be resized in either direction; if it is #f, then it cannot be resized at all. In addition, if resizable?: is #t, and one of fixed-width?: or fixed-height?: is also #t, then the frame is resizable, but is fixed in the appropriate direction. For example, if resizable?: is #t and fixed-height?: is also #t, then only the width of the frame can be resized.
Operations
The following operations are exported from the DUIM-Frames module.
apply-in-frame call-in-frame command-enabled? command-enabled?-setter deiconify-frame destroy-frame execute-command exit-frame frame? frame-accelerators frame-accelerators-setter frame-can-exit? frame-default-button frame-default-button-setter frame-event-queue frame-icon frame-icon-setter frame-input-focus frame-input-focus-setter frame-mapped? frame-mapped?-setter frame-mode frame-owner frame-palette frame-palette-setter frame-position frame-size frame-state frame-thread frame-title frame-title-setter iconify-frame lower-frame layout-frame raise-frame redo-command set-frame-position set-frame-size layout-frame undo-command
The following operations are exported from the DUIM-Sheets module.
beep display force-display frame-manager handle-event
The following operations are exported from the DUIM-DCs module.
default-background default-foreground default-text-style find-color port queue-event synchronize-display top-level-sheet