Busy Developer's Guide to CPIA Blocks
Here is a list of the commonly used blocks, in alphabetical order. Each table entry lists the block's Kind, a brief description, and some notes about instantiating it, and where it's used in Chandler. Then the bulk of the entry is a list of attributes, their type, and what it's used for. Most attribute descriptions tell you if it's required or optional.
| Kind | Attributes | Description | Card | Type | Initial |
| AEBlock (BoxContainer) -- Allows displaying and editing an attribute value in a format determined by the attirbute's type. |
| | changeEvent | Optional event to send when the attribute changes. | single | BlockEvent | N/A |
| | characterStyle | Optional style to use when drawing text characters. | single | CharacterStyle | N/A |
| | presentationStyle | Optional style to use for presentation of this block. | single | PresentationStyle | N/A |
| | readOnly | Optional flag to prevent editing the attribute's value. | single | Boolean | False |
| Block (Item) -- An abstract chunk of UI to display. |
| | blockName | Required identifier used to locate the block at runtime. | single | Text | N/A |
| | childrenBlocks | Optional list of contained blocks. | list | Block | [ ] |
| | contents | Optional reference to an item whose value is displayed by this block. | single | ContentItem | N/A |
| | eventBoundary | Optional flag to contain events within this block and its children. | single | Boolean | False |
| | eventsForNamedLookup | Optional list of events this block publishes for external access, including scripting. | list | BlockEvent | N/A |
| | isShown | Optional ability to keep a block from being visible. | single | Boolean | True |
| | minimumSize | Optional size constraint to prevent shrinking beyond some minimum size. | single | SizeType | SizeType(-1, -1) |
| | size | Optional fixed size to set for this block. Use with stretchFactor = 0. | single | SizeType | SizeType(1040, 620) |
| | stretchFactor | Optional ability to resize this block when its parent is resized, but the given factor. | single | Float | 1.0 |
| | viewAttribute | Optionally specifies which attribute of the selected Item should be associated with this block, for AEBlocks only. | single | Text | '' |
| BoxContainer (RectangularChild) -- A container block whose children are automatically arranged linearly. |
| | orientationEnum | Optional ability to layout vertically instead of horizontally. | single | orientationEnumType | Horizontal |