inherits from StorageBoxScene;
Magic Cap defines class PackageScene for showing the list of objects in a package. The user can touch any object to select it. Magic Cap uses members of this class when the user looks inside a package in the storeroom.
Instantiate: rarely Subclass: rarely Call its methods: never
You probably won't ever create an object or a subclass of class MagicWindow. The information in this chapter is provided for debugging and curiosity only.
Class PackageScene defines the following methods:
| Method | Description |
|---|---|
Package |
Returns package represented by this scene. |
| SetPackage | Sets package represented by this scene. |
| AboutToHide | Overridden to stop observing contents list of data package. |
| AboutToShow | Overridden to begin observing contents list of data package. |
| CanDeleteSelection | Overridden to return false if package is on locked PC card. |
| CanGoToSelection | Overridden to return false if package is on locked PC card. |
| IsValid | Overridden to return false if package is not valid. |
| MakeActive | Overridden to go to storeroom if package is removed. |
| MakeContentProxyChoices | Overridden to add package to choices for mailing and beaming. |
| MakeValid | Overridden to add package to MakeActive list if appropriate. |
| Notice | Overridden to update list view if data package contents change. |
| PlaceName | Overridden to use package name or default name. |
| Update | Overridden to set up viewables with package information. |
Class PackageScene 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 | Unsigned | Various 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 | Border drawn around object |
| Inherited from Scene: | ||
| sceneFlags | Unsigned | Various scene settings |
| stepBackScene | Scene | Scene to step back to (at right of name bar) |
| stepBackSpot | Viewable | Place to zoom to on step back |
| image | Image | Image for scene's snapshots |
| additions | SceneAdditions | First in list of scene-specific commands |
| screen | Buffer | Cached bits to draw scene |
| Inherited from BrowsingListViewScene | ||
| listView | CheckboxListView | List view associated with this scene |
| Inherited from StorageBoxScene | ||
| fieldList | ObjectList | |
| inStepBack | Boolean | |
| Defined by PackageScene | ||
| package | PackageContext | Package associated with this scene |
attribute Package: PackageContext // operation Package():PackageContext // operation SetPackage(newValue) Call: rarely Override: rarely
The attribute Package refers to the package represented by this package scene.
overrides AboutToHide Call: rarely Override: sometimes
Class PackageScene overrides AboutToHide to stop observing the contents list if the package is a data package.
overrides AboutToShoe Call: rarely Override: sometimes
Class PackageScene overrides AboutToShow to begin observing the contents list if the package is a data package.
overrides CanDeleteSelection Call: rarely Override: sometimes
Class PackageScene overrides CanDeleteSelection to return false if the package is on a locked PC card. Otherwise, CanDeleteSelection calls its inherited implementation.
overrides CanGoToSelection Call: rarely Override: sometimes
Class PackageScene overrides CanGoToSelection to return false if the package is on a locked PC card. Otherwise, CanGoToSelection calls its inherited implementation.
overrides IsValid Call: rarely Override: sometimes
Class PackageScene overrides IsValid to return false if the package is not valid. This usually happens because the package is on a PC card that has been removed.
overrides MakeActive Call: rarely Override: sometimes
Class PackageScene overrides MakeActive to go to the storeroom if the responder was the current scene but the package is no longer available.
overrides MakeContentProxyChoices Call: rarely Override: sometimes
Class PackageScene overrides MakeContentProxyChoices to add the package as a choice for mailing and beaming. If the package is a data package, it also adds filing choices for the current selection and for the entire list.
overrides MakeValid Call: rarely Override: sometimes
Class PackageScene overrides MakeValid to add the responder to the MakeActive list if it is the current scene and contains a data package.
overrides Notice Call: rarely Override: sometimes
Class PackageScene overrides Notice to update the package scene's list view if there is any change in the contents list of the associated data package.
overrides PlaceName Call: rarely Override: sometimes
Class PackageScene overrides PlaceName to return the name of the associated packags, or to call its inherited implementation if the package is unnamed.
overrides Update Call: rarely Override: sometimes
Class PackageScene overrides Update to set up various viewables with information about the current package.