February 29, 1996 inherits from Box; inherits from InfoTopic
Class CategoryBox is a subclass of box used to display a particular kind of object on the first page of the Magic Hat.
Instantiate: rarely Subclass: rarely Call its methods: never
You probably won't ever create an object or a subclass of class CategoryBox. The information in this chapter is provided for debugging and curiosity only.
Class CategoryBox defines the following methods:
| Method | Description |
|---|---|
CategoryContents |
Get the list of objects in this category. |
| SetCategoryContents | Set the list of objects in this category. |
| CanAccept | Overridden to accept objects of different categories. |
| CanAcceptCoupon | Overridden to accept text style coupons. |
| Swallow | Overridden to swallow objects of this category. |
| ConstrainToolTarget | Overridden to allow access to object in the category box. |
| Touch | Overridden to handle user touches. |
| Tap | Overridden to treat taps as touches. |
Class CategoryBox defines the following fields:
| Field | Type | Description |
|---|---|---|
| Inherited from SingleLinkable | ||
| next | Object | Next item in view list |
| Inherited from Linkable | ||
| previous | Object | Previous item in view list |
| Inherited from Viewable | ||
| superview | Viewable | Container for this object |
| subview | Viewable | Object contained by this object |
| relativeOrigin | Dot | Origin relative to superview |
| contentSize | Dot | Size of content rectangle |
| viewFlags | Flags | Property settings |
| labelStyle | TextStyle | Text style of object's label |
| color | Color | Color of object's content |
| shadow | Shadow | Shadow drawn with object |
| sound | Sound | Sound associated with object |
| Inherited from HasBorder | ||
| border | Border | Framed border drawn around object |
| Inherited from InfoTopic | ||
| info | Object | |
| Defined by CategoryBox | ||
| categoryContents | ObjectList | Viewables to display when user touches |
| container | Viewable | reserved for future use by Magic Cap |
| categoryType | ClassID |
attribute CategoryContents: ObjectList // operation CategoryContents():ObjectList // operation SetCategoryContents(newValue:ObjectList) Call: rarely Override: rarely
Magic Cap uses attribute CategoryContents to maintain a list of the contents of the category represented by the CategoryBox.
overrides CanAccept Call: rarely Override: sometimes
Class CategoryBox overrides CanAccept to accept objects that are not members of its category.
overrides CanAcceptCoupon Call: rarely Override: sometimes
Class CategoryBox overrides CanAcceptCoupon to accept text style coupons to change the text style of labels.
overrides Swallow Call: rarely Override: sometimes
Class CategoryBox overrides Swallow to swallow objects that fit into the category they represent.
overrides ConstrainToolTarget Call: rarely Override: sometimes
Class CategoryBox overrides ConstrainToolTarget to allow the user to work directly with the object in the category box by holding down the option button.
overrides Touch Call: rarely Override: sometimes
Class CategoryBox overrides touch to handle user touches appropriately.
overrides Tap Call: rarely Override: sometimes
Class CategoryBox overrides Tap to treat user taps as touches.