Packageimpression.persistence
Classpublic class Storyboard
InheritanceStoryboard Inheritance Object

The Storyboard object is the basic block of data for a screen. In addition to some standard properties (title, etc.), a Storyboard object contains a PersistedPropertiesCollection object for holding the basic data items and a ChildElementCollection object for storing more complex data items.



Public Properties
 PropertyDefined By
  children : ChildElementCollection
[read-only] The object's ChildElementCollection.
Storyboard
  classification : String
The classification level of the object.
Storyboard
  identifier : String
The human-readable identification code for the object.
Storyboard
  properties : PersistedPropertiesCollection
[read-only] The object's persisted properties collection.
Storyboard
  sbid : String
[read-only] The unique identifier of the object.
Storyboard
  sbType : String
The storyboard type.
Storyboard
  shortID : Number = -1
The object's unique position within its parent collection's original XML file.
Storyboard
  title : String = New Storyboard
The title of the storyboard.
Storyboard
Public Methods
 MethodDefined By
  
Storyboard(sbid:String = null, title:String = null, identifier:String = null, sbType:String = null, shortID:Number = -1)
Creates a new instance of the Storyboard class.
Storyboard
  
clone(sbid:String = null):Storyboard
Returns a copy of the object.
Storyboard
  
fromXML(source:XML):Storyboard
[static] Returns a new instance of the Storyboard class based on the data contained in the XML object.
Storyboard
  
toString():String
Returns the string representation of the specified object.
Storyboard
  
toXML():XML
Returns an Impression-format XML object containing all the data from the object.
Storyboard
Property Detail
childrenproperty
children:ChildElementCollection  [read-only]

The object's ChildElementCollection.

The object itself is read-only; the data contained in the collection is read-write.


Implementation
    public function get children():ChildElementCollection
classificationproperty 
public var classification:String

The classification level of the object.

The default value is the empty string ("").

identifierproperty 
public var identifier:String

The human-readable identification code for the object.

Unlike sbid, identifier is typically used as human-readable code to uniquely identify a storyboard object within a lesson when the title property is not sufficiently unique.

The default value is the empty string ("").

propertiesproperty 
properties:PersistedPropertiesCollection  [read-only]

The object's persisted properties collection.

The object itself is read-only; the data contained in the collection is read-write.


Implementation
    public function get properties():PersistedPropertiesCollection
sbidproperty 
sbid:String  [read-only]

The unique identifier of the object.

sbid is an abbreviation of "StoryboardID". This value is typically a GUID string but can be any value.

The Storyboard class does not enforce the uniqueness of the sbid property.

The default value is A String generated by the newGUID method of the impression.utilities.GUID class.


Implementation
    public function get sbid():String

See also

sbTypeproperty 
public var sbType:String

The storyboard type.

The default value is the empty string ("").

shortIDproperty 
public var shortID:Number = -1

The object's unique position within its parent collection's original XML file.

shortID values are useful when the user needs storyboard references storage but has limited storage space. The value usually comes from the storyboard XML.

The Impression CCT regenerates shortID values each time a storyboard collection is exported. This means that shortID values are guaranteed to be consistent across multiple playback sessions of the same content only. The same lesson content re-exported from the CCT will most likely have different shortID values for each storyboard.

To ensure that you are working with the same document between sessions, you should store and compare the lesson object's documentID property.

The Storyboard class does not enforce the uniqueness of the shortID property.

The default value is -1.

titleproperty 
public var title:String = New Storyboard

The title of the storyboard.

Constructor Detail
Storyboard()Constructor
public function Storyboard(sbid:String = null, title:String = null, identifier:String = null, sbType:String = null, shortID:Number = -1)

Creates a new instance of the Storyboard class.

The constructor does not ensure the uniqueness of either the sbid or shortID parameters. If any parameter value is null, the default value will be used.

Parameters
sbid:String (default = null) — A String specifying a unique identifier for the object.
 
title:String (default = null) — A String specifying the title of the object.
 
identifier:String (default = null) — A String specifying the human-readable identification code of the object.
 
sbType:String (default = null) — A String specifying the storyboard type of the object.
 
shortID:Number (default = -1) — A Number specifying the object's unique position within its parent collection's original XML file.
Method Detail
clone()method
public function clone(sbid:String = null):Storyboard

Returns a copy of the object.

If the sbid parameter is null, the current sbid property value is used. If the sbid parameter is not null, the parameter value is used.

The storyboard's children are copied by invoking the internal ChildElementCollection object's clone method with the deep parameter set to true.

Parameters

sbid:String (default = null) — The value of the sbid property of the copied object.

Returns
Storyboard — A copy of the object.

See also

fromXML()method 
public static function fromXML(source:XML):Storyboard

Returns a new instance of the Storyboard class based on the data contained in the XML object.

If source is null, an empty Storyboard object is returned. If the source.name property is not "storyboard", an error is thrown.

The XML format of a Storyboard object is:

If a matching properties or children XML node is not found, the returned storyboard will have an empty properties or children collection. Additional XML nodes are ignored.

Parameters

source:XML — The object containing the data to use.

Returns
Storyboard — A Storyboard object containing the data from the source XML object.

Throws
ArgumentError — node is not a <storyboard> element (ArgumentError).

See also

toString()method 
public function toString():String

Returns the string representation of the specified object.

Returns
String — The string representation of the specified object.
toXML()method 
public function toXML():XML

Returns an Impression-format XML object containing all the data from the object.

Returns
XML — An XML object containing all the data from the object.

See also