Packagecom.adobe.portfolio.properties
Classpublic class ThemeFilteredList
InheritanceThemeFilteredList Inheritance PropertyListValue Inheritance PropertyValue Inheritance flash.events.EventDispatcher

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

This class handles property values that are theme filtered lists. Theme filtered lists are property lists that filter out subvalues whose names match those of themes that are not currently active.

See also

CommonProperties.skinList


Public Properties
 PropertyDefined By
 InheritedactiveValue : PropertyValue
The currently active value.
PropertyListValue
 Inheriteddescription : String
A localized description string suitable for display in the user interface.
PropertyValue
 Inheriteddirty : Boolean
Returns true if the property has been modified and needs to be saved, false otherwise.
PropertyValue
 Inheritedenabled : Boolean
Returns a value of true if the control(s) representing this property should be enabled in the user interface.
PropertyValue
 InheritedhasMinMax : Boolean
[read-only] Returns a value of true if this property has relevant minimum or maximum values.
PropertyValue
 Inheritedlabel : String
A localized label string suitable for display in the user interface.
PropertyValue
 InheritedmaxValue : Number
[read-only] The maximum value of this numeric property.
PropertyValue
 InheritedminValue : Number
[read-only] The minimum value of this numeric property.
PropertyValue
 Inheritedname : String
The name for this IProperty.
PropertyValue
 Inheritedsubvalues : Array
[override] [read-only] The array of possible values for a PropertyList
PropertyListValue
 InheritedsubvaluesLocked : Boolean
[override] [read-only] Returns true if elements of subvalues for this property cannot be added or removed.
PropertyListValue
 InheritedsubvaluesType : String
[override] [read-only] Identifies the data type of the IProperty elements found in the subvalues array.
PropertyListValue
 Inheritedtype : String
[override] [read-only] Identifies the data type of this IProperty.
PropertyListValue
 Inheritedvalue : Object
The value for this IProperty.
PropertyValue
 Inheritedvisible : Boolean
Returns a value of true if the control(s) representing this property should be displayed in the user interface.
PropertyValue
Protected Properties
 PropertyDefined By
  completeSubvalues : Array
The complete (unfiltered) list of subvalues
ThemeFilteredList
  currentThemeName : String
The name of the current active theme
ThemeFilteredList
 InheriteddescriptionDefault : String
The default description string to be used when the localized description is unavailable.
PropertyValue
 InheriteddescriptionKey : String
The string used as a key to request a localized description string.
PropertyValue
 InheriteddontPlayEffectsCounter : uint = 0
A counter used to keep track of when to run the side effects.
PropertyValue
  filteredSubvalues : Array
The filtered list of subvalues; subvalues whose name matches a non-active theme have been removed.
ThemeFilteredList
 Inheritedinitializing : Boolean
Returns true if the property is in an initializing state, false otherwise.
PropertyValue
 InheritedlabelDefault : String
The default label string to be used when the localized label is unavailable.
PropertyValue
 InheritedlabelKey : String
The string used as a key to request a localized label string.
PropertyValue
 InheritedloadAndSaveValues : Boolean
[read-only] Returns false if loading and saving values to and from XML should be skipped.
PropertyListValue
 Inheritedparent : Object
The parent object of this property.
PropertyValue
 InheritedshouldOutputSubvalues : Boolean
[read-only] Returns true.
PropertyListValue
 Inherited_subvalues : Array
The array of possible values for a PropertyList
PropertyListValue
  themedSubvalues : ArrayCollection
An array of subvalues whose name matches a theme name
ThemeFilteredList
  themeNames : ArrayCollection
An array of all theme names
ThemeFilteredList
Public Methods
 MethodDefined By
  
ThemeFilteredList(target:IEventDispatcher = null)
Constructor
ThemeFilteredList
 Inherited
createPropertyValue(valueXML:XML, parent:Object):PropertyValue
[static] Create a new PropertyValue instance of the correct type and assign parent as its parent value.
PropertyValue
 Inherited
Create an XML object with all its XML elements for this property.
PropertyValue
  
loadFromXML(valueXML:XML):Boolean
[override] Loads the list of property values from the specified XML value.
ThemeFilteredList
 Inherited
Run all the effects in the selectEffectArray If dontPlayEffectsCounter is false (not 0) playSelectEffects() will not run the effects.
PropertyValue
  
referenceSubvalueResources(referenceType:int):void
[override] References, dereferences, or touches all URL subvalues.
ThemeFilteredList
  
setValueFromString(valueString:String):Boolean
[override] Set the theme filtered list's active subvalue (the value that is being filtered out) equal to the specified string.
ThemeFilteredList
  
updateSubvalues(newSubvalues:Array, newActiveValue:PropertyValue = null):void
[override] Update the subvalues and active value of the theme filtered list to the new filter list and active value
ThemeFilteredList
Protected Methods
 MethodDefined By
  
buildThemedSubvalues(valueArray:Array, forceRebuild:Boolean = false):Boolean
Create the list of themed subvalues from the valueArray passed.
ThemeFilteredList
  
[override] Returns the XML element name for this property.
ThemeFilteredList
  
Sets the theme list to use for filtering and updates the current theme watcher.
ThemeFilteredList
  
setXMLElements(propertyXML:XML):void
[override] Sets all the XML elements for this property, such as enabled, visible, label, and description.
ThemeFilteredList
  
updateFilteredValues(newSubvalues:Array, newActiveValue:PropertyValue):PropertyValue
Update the list of filtered subvalues based on the full list of subvalues and the currently active theme.
ThemeFilteredList
Public Constants
 ConstantDefined By
  XML_ELEMENT_NAME : String = ThemeFilteredList
[static] The XML element name for theme filtered lists
ThemeFilteredList
Property Detail
completeSubvaluesproperty
protected var completeSubvalues:Array

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

The complete (unfiltered) list of subvalues

currentThemeNameproperty 
protected var currentThemeName:String

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

The name of the current active theme

filteredSubvaluesproperty 
protected var filteredSubvalues:Array

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

The filtered list of subvalues; subvalues whose name matches a non-active theme have been removed.

themedSubvaluesproperty 
protected var themedSubvalues:ArrayCollection

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

An array of subvalues whose name matches a theme name

themeNamesproperty 
protected var themeNames:ArrayCollection

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

An array of all theme names

Constructor Detail
ThemeFilteredList()Constructor
public function ThemeFilteredList(target:IEventDispatcher = null)

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

Constructor

Parameters
target:IEventDispatcher (default = null)
Method Detail
buildThemedSubvalues()method
protected function buildThemedSubvalues(valueArray:Array, forceRebuild:Boolean = false):Boolean

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

Create the list of themed subvalues from the valueArray passed.

Parameters

valueArray:Array — The new list of value to
 
forceRebuild:Boolean (default = false) — If forceRebuild is false (the default), the themedSubvalues array with not be rebuilt if it already exists. If forceRebuild is true the current themedSubvalues array will be replaced with the new list.

Returns
Booleantrue if the list of themed values could be built, otherwise false.
getXMLElementName()method 
override protected function getXMLElementName():String

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

Returns the XML element name for this property.

Returns
String
loadFromXML()method 
override public function loadFromXML(valueXML:XML):Boolean

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

Loads the list of property values from the specified XML value.

Parameters

valueXML:XML — The XML object to load that contains the list of property values as its elements.

Returns
Boolean
referenceSubvalueResources()method 
override public function referenceSubvalueResources(referenceType:int):void

References, dereferences, or touches all URL subvalues.

Parameters

referenceType:int — If greater than zero, referenceResource is called on all URL subvalues; if less than zero, dereferenceResource is called; if equal to zero, touchResource is called.

setThemeList()method 
protected function setThemeList(value:PropertyListValue):void

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

Sets the theme list to use for filtering and updates the current theme watcher.

Parameters

value:PropertyListValue — The list of themes on which to filter

setValueFromString()method 
override public function setValueFromString(valueString:String):Boolean

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

Set the theme filtered list's active subvalue (the value that is being filtered out) equal to the specified string.

Parameters

valueString:String — The desired value to filter out, expressed as a string.

Returns
Boolean — Returns true if the specified value is being filterd out, otherwise it returns false
setXMLElements()method 
override protected function setXMLElements(propertyXML:XML):void

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

Sets all the XML elements for this property, such as enabled, visible, label, and description. Also, set any SelectEffect XML objects in the SelectEffectsArray.

Parameters

propertyXML:XML — XML object representing the desired property

updateFilteredValues()method 
protected function updateFilteredValues(newSubvalues:Array, newActiveValue:PropertyValue):PropertyValue

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

Update the list of filtered subvalues based on the full list of subvalues and the currently active theme.

Parameters

newSubvalues:Array — The new list of theme values to use for filtering
 
newActiveValue:PropertyValue — The value to use as the new active value

Returns
PropertyValue — Returns the currentTheme if that is part of the newSubvalues list. Otherwise it returns the newActiveValue.
updateSubvalues()method 
override public function updateSubvalues(newSubvalues:Array, newActiveValue:PropertyValue = null):void

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

Update the subvalues and active value of the theme filtered list to the new filter list and active value

Parameters

newSubvalues:Array — The new list of theme values to use for filtering
 
newActiveValue:PropertyValue (default = null) — The value to use as the new active value

Constant Detail
XML_ELEMENT_NAMEConstant
public static const XML_ELEMENT_NAME:String = ThemeFilteredList

Language Version : ActionScript 3.0
Product Version : Portfolio 10.0
Runtime Versions : Flash Player 10.1, AIR 2.0

The XML element name for theme filtered lists