ROWS

RISC OS Widget Set

Rather crappy documentation

This file documents the current state of my proposal for the widget tree structure of ROWS. The widgets given here are the base widgets, from which useful widgets can be derived.

ROWS_Widget
  |
  +--ROWS_Box
  |   |
  |   +--ROWS_EventBox
  |       |
  |       +--ROWS_Drawable
  |           |
  |           +--ROWS_Container
  |           |   |
  |           |   +--ROWS_FreeFormContainer
  |           |   |
  |           |   +--ROWS_Window
  |           |   |   |
  |           |   |   +--ROWS_Dialogue, etc
  |           |   |
  |   	      |   +--ROWS_PlacedContainer
  |           |   |
  |           |   +--ROWS_AlignedContainer
  |           |       |
  |           |       +--ROWS_HAlignedContainer
  |           |       |
  |           |       +--ROWS_VAlignedContainer
  |           |
  |           +--ROWS_ContainedBox
  |               |
  |               +--ROWS_BorderedBox
  |                   |
  |                   +--ROWS_Button, etc
  |
  +--ROWS_Brush

• ROWS_Widget - The base widget. Doesn't really do anything except exist
• ROWS_Box - A widget that has a bounding box
• ROWS_EventBox - A box on which X events occur
• ROWS_Drawable - An area which can be drawn on (and the methods to go with it)
• ROWS_Brush - Something to draw with (corresponds to an X GC)
• ROWS_Container - A widget designed to contain other widgets
• ROWS_FreeFormContainer - Contains ROWS_PlacedContainers
• ROWS_PlacedContainer - Contains a widget (eg a button) and can be placed anywhere in a FreeFormContainer.
• ROWS_AlignedContainer - meta-widget, superclass of all automatically aligned containers (which themselves contain containers)
• ROWS_HAligned/VAlignedContainer - Horzontally/Vertically aligned boxes
• ROWS_Window - the window superclass
• ROWS_ContainedBox - A box managed by a container
• ROWS_BorderedBox - A box with a drawn border (superclass of most visible ROWS widgets)