This class encapsulates the common task of creating a Window, adding a FlowView (CompositeView with a FlowLayout on it). It also supports the MVC model by registering controllers that are then removed (sent the .remove message) when the Window closes. Additionally it can resize itself to fit the contents.
Create a Window with a FlowView on it. The PageLayout object can be treated like a Window or like a View.
| title |
Window title |
| bounds |
Bounds or nil. Default of nil will size the window to the entire screen size. Use .resizeToFit to shrink the window to the content size. |
| margin |
FlowLayout margin. |
| background |
Background color |
| scroll |
boolean: add scroll bars or not. |
| front |
boolean: whether to immediately display the window, bringing it to the front. default is true. You may choose to first add your views to the window and then front it which is useful for large slow GUIs |
a PageLayout
the Window object
a Window
the top most view on the Window
a View
boolean: has the window been closed ?
boolean
Just as for Window, this method is called when the PageLayout's window is closed. The actual Window's onClose method is used to trigger clean up operations, releasing dependencies and will also call this onClose function.
get/set onClose handler
returns the top view
a View
| bounds |
if bounds are nil then it returns self, as a PageLayout is compatible with FlowView. If bounds are supplied then a child FlowView is placed and returned |
self or a new FlowView
inner bounds of the top level view.
a Rect
Similar to asFlowView, this message converts nil and various other objects to a PageLayout. This is already a PageLayout, so it returns self.
| name |
Ignored. If the receiver had been nil then the name would be the Window name. |
| bounds |
Ignored. Would have been used to size the PageLayout |
self
compatible with FlowView
self
compatible with FlowView
self
isClosed.not
boolean
bring Window to the front
self
Hide window
self
Show the window if it was previously hidden.
self
Close the window, releasing any dependencies and calling the onClose handler.
self
Refresh the top level view
self
set background color of top level view
| c |
color |
self
Register an object, usually a ObjectGui subclass or an Updater so that when the Window closes the .remove message will be sent to it. This will cause the object to release its dependencies on its Model. This means the ObjectGui (or other controller object) will stop getting update messages and will stop trying to update the View which has just been closed along with the Window. It also means that if there is no link to the Model and no longer any Views that held links to the controller object, that the controller is now unreferenced and will be garbage collected.
| dependant |
the object that wishes to be sent .remove on closing the window |
self
Resize the top FlowView to fit its contents and then resize the Window to fit that.=
| reflow |
boolean: FlowView can relay all of its child views in cases where the bounds have changed or views have been removed. This puts them all back in place one by one for the updated bounds. So this may result in smaller over all bounds, after which the window is shrunk. |
| center |
boolean: after resizing, re-center the window in the screen. |
self
see FlowView reflowAll
self
go Full screen
self
end full screen
self
Place a new FlowView on the window
| func |
A handler that recieves the new FlowView as argument |
| bounds |
Bounds fo the FlowView |
(returnvalue)
(describe method here)
| func |
(describe argument here) |
| bounds |
(describe argument here) |
| spacing |
(describe argument here) |
(returnvalue)
(describe method here)
| func |
(describe argument here) |
| bounds |
(describe argument here) |
| spacing |
(describe argument here) |
(returnvalue)
(describe method here)
| func |
(describe argument here) |
| bounds |
(describe argument here) |
(returnvalue)
(describe method here)
| ... args |
(describe argument here) |
(returnvalue)