Pane

Pane Class

Pane is the superclass of all classes that handle graphical displays.

Subclasses need to provide their own constructor and destructor methods for extra object construction and cleanup. Pane subclasses need to provide at least a paneBuffer (below) allocated during object creation and freed during object deletion, unless the subclass is very simple.

Instance Variables

children

A List of child panes.

cursor

A Point object that contains the X and Y coordinates within the pane where text writes will occur.

mapped

An Integer. If TRUE, display the pane when it, or its parent pane, receives a refresh message.

origin

A Point object that contains the X and Y coordinates of the upper left-hand corner of the pane within the parent pane, or the terminal window or display if the pane is the parent pane.

paneBackingStore

A Symbol object that contains the memory address of the pane’s backing store buffer. Subclasses should provide constructors that allocate this memory, using the __ctalkCreateWinBuffer library function. The methods map or unmap handle the task of saving and restoring window contents, by calling functions like __ctalkANSITerminalPaneMapWindow and __ctalkANSITerminalPaneUnMapWindow. Classes that re-implement map and unmap need to handle these tasks also.

paneBuffer

A Symbol object that contains the memory address of the pane’s display buffer. Subclasses should provide constructors that allocate this memory, using the __ctalkCreateWinBuffer library function.

size

A Point object that contains the width and height of the pane.

Instance Methods

attach (Pane childPane)

Attach childPane to the receiver. If mapped, then the child pane is displayed the next time the parent pane and its children are updated. If childPane is an ANSITerminalPane object, the child pane inherits the parent’s input and output stream handles.

deletePaneBuffer

Deletes the paneBuffer backing store memory that constructors should allocate when creating subclass objects. Subclasses should also use this message in destructor or cleanup methods.