1.63.4 Get methods

frame <-frame: -> frame

Returns itself. Provided so the same selector resolves on a frame, on its member windows and on the graphicals displayed within.

frame <-contained_in: -> display

Equivalent to frame<-display.

frame <-contains: -> chain

Chain with all member windows; equivalent to frame<-members.

frame <-members: -> chain

New chain holding the (undecorated) member windows.

frame <-member: name -> window

First member window with that name. Looks through the window_decorator wrappers automatically.

frame <-catch_all: window_name=name -> window

Maps <window_name>_member to the corresponding member window:

?- new(@f, frame),
   send(@f, append, new(V, view)),
   send(new(D, dialog), below, V),
   send(V, open).

?- send(@f?view_member, format, 'Hello World\n').

frame <-convert: window -> frame

Convert a window to its containing frame.

frame <-tile: -> tile

Root of the tile hierarchy that lays out this frame.

See also

class tile

frame <-area: -> area

Client-area rectangle of the frame on the display.

frame <-size: -> size

Size of frame<-area.

frame <-position: -> point

Top-left position of frame<-area on the display.

frame <-geometry: -> name

Geometry specification for the current state of the frame, suitable for storing and re-applying via frame->geometry.

frame <-show: -> bool

@on when frame<-status is open; @off otherwise.

frame <-closed: -> bool

@on when the frame is iconified, @off when it is open.

frame <-image: [{bitmap,pixmap}] -> image

Image holding the pixels currently shown by the frame.

frame <-keyboard_focus: -> window

Window currently designated to receive keyboard input.

frame <-confirm: position=[point], display=[display], grab=[bool] -> return_value=any

Open the frame (if not yet opened) and block until frame->return is invoked. Used to implement modal prompts.

When grab is @on the frame grabs the pointer. If the frame is freed while the confirmer is blocking, the call fails.

Typical use:

ask_name(Name) :-
        new(D, dialog('Name Prompter')),
        send(D, append, new(N, text_item(name, ''))),
        send(D, append,
             button(ok, message(D, return, N?selection))),
        send(D, append,
                 button(cancel, message(D, return, @nil))),
        send(D, default_button, ok),
        get(D, confirm, Answer),
        send(D, destroy),
        Answer \== @nil,
        Name = Answer.

See also

- frame->return
- frame-return_value
- frame<-confirm_centered
- window<-confirm

frame <-confirm_centered: center=[point|frame], display=[display], grab=[bool] -> return_value=any

Like frame<-confirm but centres on center (or on the screen if omitted) rather than placing the top-left there.

frame <-open_file: filters=[chain], default=[char_array], allow_many=[bool] -> name|chain

Use the OS file-open dialog to prompt for a file. Arguments:

• filters — chain of tuple objects, each tuple(Name, Extensions) where Extensions is a ;-separated list or a chain of char_array. Example:

  chain(tuple('Prolog', chain(pl,prolog))).

• default — absolute file name used as initial selection.
• allow_many — if @on, allow multi-select and return a chain of file names; otherwise return a single name.

frame <-save_file: filters=[chain], default=[char_array] -> name

Use the OS file-save dialog. Arguments as for frame<-open_file minus allow_many.