1.185.2 Instance variables

window <- background: [colour]

Background colour of the window.

window-bounding_box: area

Union of graphicals in this window in the coordinate system of the window.

window <- current_event: event*

Event that is currently being processed by this window or @nil if this window is not processing any events. This variable is managed by device->event.

This is not necessarily the same as @event. Consider the case were the window has opened a popup. In this case window<-current_event will point to the event that caused the popup to open (generally an ms_right_down event), while @event will point to the various events that are processed during the opened state of the popup window.

See also

device->event

window <- decoration: window_decorator*

Window displaying me and my decorations. This slot will normally contain an instance of class window_decorator. The window decoration displays a label above the Window and/or adds scrollbars to the window. window->catch_all creates a decorator for methods that are not defined on class window and are defined by class window_decorator. This allows for e.g.,

send(Window, scrollbars, both)

window-displayed_cursor: cursor*

Currently visible cursor. This attribute is computed dynamically. The actually displayed cursor of a window is:

• If there is a focus and a window<->focus_cursor: the window<->focus_cursor
• If there is a focus and the object in focus has a graphical<->cursor the cursor of the object in focus
• If the mouse is a a graphical with a cursor: the cursor of the most local and exposed graphical with a cursor defined.
• In all other cases the graphical<->cursor of the window. @see device->event @see window-focus_cursor @see graphical->cursor @see window->focus

window <- focus: graphical*

Graphical object in focus of events. When not @nil, events will be sent to this graphical. When window<-focus_recogniser too is not @nil the event will be posted to this recogniser only.

Note that keyboard events will be send to the window<-keyboard_focus when this is not @nil.

See also

- device->event
- window-keyboard_focus
- window->focus
- window-focus_recogniser

window <- focus_button: [button_name]*

When a focus is set (window<-focus is not @nil), this focus remains active until a button-up-event is received with this button. When @nil, the focus remains set till it is explicitly cleared.

See also

- device->event
- window->focus

window <- focus_cursor: cursor*

When not @nil and window<-focus is not @nil, this cursor will be displayed.

See also

- window->focus_cursor
- window-displayed_cursor

window <- focus_recogniser: recogniser*

When not @nil and window<-focus is not @nil, events are given to this recogniser object.

See also

- class gesture
- device->event
- window-focus

window-frame: frame*

Frame object of which the window is a frame<-member. If the window has no frame and is not displayed on another graphical and create is @on or @default a default frame is attached to the window which is returned.

See also

- frame<-frame
- window->above

window <-> has_pointer: bool

If @on, pointer (mouse) is in window. The method is invoked from device->event and may be redefined, but should always invoke the primary implementation.

window <- input_focus: bool

When @on, this window is the window receiving keyboard input. See also frame->input_focus. When modified, and the window<-keyboard_focus is not @nil, the method will generate either an activate_keyboard_focus or a deactivate_keyboard_focus event to window<-keyboard_focus.

See also

- frame<-input_focus
- frame->input_focus

window <- keyboard_focus: graphical*

Graphical object in the window to which keyboard events should be posted. When @nil, keyboard events are dispatched the same way as pointer events.

A graphical getting the keyboard focus will be sent an obtain_keyboard_focus event. Graphicals loosing the keyboard focus will be sent a release_keybaord_focus event.

See also

- device->event
- window-focus
- window->keyboard_focus

window <-> popup: popup*

Popup menu associated with this window. It is activated through the global object @_popup_gesture when all other attempts to handle the button-event have failed. See device->event.

See also

- device->event
- class popup

window <- resize_message: code*

The message is executed after the window has been resized by its frame. It allows the programmer to reorganise the contents of the frame such that they better fit the new size. The arguments are:

@receiver	The window
@arg1	The window
@arg2	New size of the window

This message is always sent when the associated frame is created.

Resizing a window may also be specified by redefining the window->geometry method. See also window<-visible and dialog->layout.

See also

frame->set

window-scroll_offset: point

Indicates how much the window is scrolled. The top-left corner of the window is -in the coordinate system of the displayed graphicals- negative the x- and y- parameters of this point.

window<-visible is the proper way to get information on the current location of the visible area of the window.

window <- selection_feedback: {invert,handles,colour}|elevation|colour*

The value of this variable determines how graphicals with graphical<-selected: @on are visualised. Values:

• invert Swap the window<-foreground and window<-background colour.
• handles Paint inverted blobs at positions defined by the graphical.selection_handles. Used (for example) in PceDraw.
• an instance of class elevation Paint the graphical and then elevate the bounding box according the the elevation object. Using a light-grey background is a good choice.
• a colour object Ignore the graphical<-colour attribute, drawing the graphical using the colour specified here. Suitable on colour devices only. Using a light-grey or otherwise coloured window<-background generally improves the result.

  See also

  - graphical->paint_selected
  - graphical.selection_handles.

window <-> sensitive: bool

Determines whether or not the window is sensitive for events. When @off, all events are ignored. Rarely used.

See also

device->event

window-tile: tile*

Tile object associated with this window. The associated tile negotiates the layout of windows in the frame with the frame and finally dictates the size and position of the window. If the window has no tile, a this method creates a tile object for the window and returns the new tile.

See also

- window-display_area
- window->border