Mindwrapper API

Presentation Layer

Contents

Presenter
Subpanel
Panel
Frame
Dialog
RadioGroup
Notebook

MenuItem
Menu
StatusBar
Calendar
Chart
Table
ListBox

Chooser
Choice
ChoiceBox
ComboBox
RadioBox
CheckBox
RadioButton

Adjuster
Slider
SpinButton
SpinControl
TextField
NumberField
DatetimeField

Button
StaticText
DynamicText
HLine
VLine
Spacer
Filler

Preface
- The Presentation Layer is ...

Presenter(Item):
- specifiers
  - Class attributes are specifiers.
  - refs = []
    - .... .
  - model
    - .... .
  - text = ''
    - .... .
  - tip = ''
    - .... .
  - font_weight
    - .... .
  - style
    - .... .
  - pos
    - .... .
  - size
    - .... .
  - proportion
    - .... .
  - grow
    - .... .
  - align
    - .... .
  - margin
    - .... .
  - cell
    - .... .
  - span
    - .... .
Subpanel(Presenter):
- class attributes
  - These true class attributes are not specifiers. They cannot be overridden with keyword arguments in __init__() via add(). This is because these parameters only make sense in the context of a design-time definition.
  - text = None
    - .... .
  - cols = 1
    - .... .
  - rows = 0
    - .... .
  - vgap = 0
    - .... .
  - hgap = 0
    - .... .
  - growRows = []
    - .... .
  - growCols = []
    - .... .
- add (self, name='', item=None, *references, **specifiers)
  - A concrete implementation of the abstract method found in Item. Thus a subpanel is a composite presenter (item) to which other presenters are added either at runtime or, more typically, at design-time.
  - name
    - ...
  - item
    - ... .
  - *references
    - Positional arguments other than name and item are references to external items needed by the added item. These arguments are typically item instances.
  - **specifiers
    - Keyword arguments are specifiers for the added item instance.
- remove (self, name)
  - ....
Panel(Subpanel):
Frame(Subpanel):
Dialog(Frame):
Notebook(Presenter):
Listbook(Notebook):

Key
- Version 0.3 is an "unstable" version, meaning that the API is subject to change. Once version 0.4 is released, the public terms and their semantics are guaranteed not to change for any 0.4.n micro-version. Many public terms are not needed by the user-developer, but are made public for testing purposed. Public terms commonly invoked by the user-developer are considered keywords, some of which are abstract to be defined at design-time. Keywords also include properties. Named parameters that are more typically supplied as ~~positional~~ arguments are currently considered public terms but may not be in the future.