Packagecom.adobe.portfolio.cards
Classpublic class FolderCard
InheritanceFolderCard Inheritance BasicCard Inheritance SimpleCard Inheritance NavSkinnableComponent Inheritance spark.components.supportClasses.SkinnableComponent

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

The class of cards for representing folders in a Navigator



Public Properties
 PropertyDefined By
 InheritedadjustAspectRatio : Boolean
Is true if the aspect ratio of the simple card can be changed; otherwise it is false.
SimpleCard
 InheritedcolorPalette : ColorPalette
The color palette being used by this object.
SimpleCard
 InheritedcompressedSize : uint
The size of this card's underlying attachment as it is currently compressed in the Navigator file.
SimpleCard
 InheritedcreationDate : Date
The creation date of this card's underlying attachment.
SimpleCard
  data : Object
[override] Set the data for a folder card and reset the event listeners for the children
FolderCard
 InheriteddelayThumbnailGeneration : Boolean
Indicates whether generation of the thumbnail image should be delayed or not.
SimpleCard
 Inheriteddescription : String
The description of this card's underlying attachment.
SimpleCard
 InheriteddoubleClickEnabled : Boolean
[override] [write-only] Enables and disables double click events for this card.
SimpleCard
 InheriteddownSampleOK : Boolean
Indicates whether it is OK to reduce the size of the image.
SimpleCard
 Inheriteddragging : Boolean
Is true if the item renderer is being dragged; otherwise false.
SimpleCard
 InheriteddropShadowPreference : String
The drop shadow effect preference.
SimpleCard
 InheritedenableThumbnailGeneration : Boolean
Indicates whether generation of the thumbnail image is enabled or not.
SimpleCard
 InheritedfileName : String
The file name of this card's underlying attachment.
SimpleCard
 InheritedgenerateThumb : Boolean
Indicates whether or not to generate a thumbnail image for the card
SimpleCard
 InheritedisOpen : Boolean
Is true if the attachment is open in a native editor; otherwise false.
SimpleCard
 InheriteditemIndex : int
The index of the item in the data set that this renderer is visualizing.
SimpleCard
 Inheritedlabel : String
The String to display in the item renderer.
SimpleCard
 InheritedmediumPreviewHasGlow : Boolean
[read-only] A boolean specifying if the skin should apply a glow to the mid-level preview
SimpleCard
 InheritedmodDate : Date
The modification date of this card's underlying attachment.
SimpleCard
  numAttachments : int
The number of attachnments to a folder
FolderCard
 Inheritedpadding : Point
[read-only] Get the horizontal and vertical padding for this UI component.
SimpleCard
 InheritedpreviewComponent : IPreview
[read-only] The preview component for the simpleCard
SimpleCard
 InheritedrollOverPreference : String
A string specifying the preferred type of rollover effect on this component.
SimpleCard
 Inheritedselected : Boolean
Is true if the item renderer can show itself as selected; otherwise it is false.
SimpleCard
 InheritedshowsCaret : Boolean
Is true if the item renderer can show itself as focused; otherwise it is false.
SimpleCard
 Inheritedsize : uint
The size of this card's underlying attachment, if it were to be uncompressed.
SimpleCard
 InheritedskinState : String
NavSkinnableComponent
 Inheritedvisible : Boolean
[override] [write-only] Set the visibility of the card
SimpleCard
Protected Properties
 PropertyDefined By
 InheritedallowMultiPage : Boolean
[override] [read-only] Determines if the attachement supports calculating the number of pages it contains.
BasicCard
 Inheritedattachment : IAttachment = null
The IAttachment data object being rendered by this component.
SimpleCard
 InheritedautoListen : AutoListen
NavSkinnableComponent
 InheritedautoWatch : AutoWatch
NavSkinnableComponent
 InheritedinfoMap : Dictionary
[static] The dictionary for the BasicCard's info state
BasicCard
 InheritedinvalidPreview : Boolean
If true the preview for this card is invalid.
SimpleCard
 InheritedmouseIsOver : Boolean
Returns true if the mouse is over the card; returns false otherwise.
SimpleCard
 InheritedpreferredPreviewState : String
[override] [read-only] Returns the preferred PreviewState.
BasicCard
 InheritedprefersMediaPreview : Boolean
[override] [read-only] Does this card's attachment have a preferredPreviewState of AUDIO or VIDEO
BasicCard
 InheritedpreviewMultiPageModel : IPreviewMultiPageModel
[read-only] Get a preview model that supports multipage preview of attachments
SimpleCard
 Inherited_skinState : String
NavSkinnableComponent
 InheritedthumbnailMgr : ThumbnailManager
[static] The navigator's thumbnailManager instance.
SimpleCard
 InheritedzoomLarge : IEffect
The Flex effect to run when zooming to a large card size
BasicCard
 InheritedzoomNormal : IEffect
The Flex effect to run when zooming to a medium card size
BasicCard
 InheritedzoomToLarge : Boolean = false
Boolean switch indicating whether to run a large or normal zoom effect.
BasicCard
Public Methods
 MethodDefined By
  
Constructor
FolderCard
  
[override] Function to setup the event listeners required by folder cards.
FolderCard
  
getDimensionsUsingPreview(fitWidth:Number, fitHeight:Number):Point
[override] Returns the width and height dimensions to use for the folder card.
FolderCard
 Inherited
invalidatePreview(invalidateModel:Boolean = false, generateThumb:Boolean = true):void
Invalidate the current preview state for the card
SimpleCard
 Inherited
[override] Mark the SkinState as invalid.
BasicCard
  
[override] Function to cleanup the event listeners required by folder cards.
FolderCard
 Inherited
setCurrentState(stateName:String, playTransition:Boolean = true):void
[override] Sets the state of the skin as well as the state of this instance.
BasicCard
  
setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void
[override] Sets the layout size (width and height) of the folder card.
FolderCard
 Inherited
toString():String
[override] The String to display in the item renderer.
SimpleCard
 Inherited
updateRenderer(oldRenderer:ISimpleCard):void
[override] Update the renderer to use for the basicCard
BasicCard
Protected Methods
 MethodDefined By
 Inherited
addListener(listener:IEventDispatcher, type:String, handler:Function, useCapture:Boolean = false, priority:int = 0):void
NavSkinnableComponent
 Inherited
addWatcher(watcher:ChangeWatcher):void
NavSkinnableComponent
 Inherited
[override] Save the current properties of this card.
SimpleCard
 Inherited
detachSkin():void
[override]
NavSkinnableComponent
 Inherited
Returns the file extension for the attachment.
SimpleCard
 Inherited
Generate a thumbnail image for the underlying attachment.
SimpleCard
 Inherited
Get the aspect ratio of the thumbnail for the attachment.
SimpleCard
  
[override] Returns the current skin state
FolderCard
 Inherited
Get the size of the preview image
SimpleCard
 Inherited
Have the collectionManager handle the preview for the underlying attachment.
SimpleCard
 Inherited
hostPageCountChanged(val:uint):void
This function is called if the page count of the multipage model has changed
SimpleCard
 Inherited
Initialize the page count for the preview multipage model to the page count of the underlying attachement.
SimpleCard
 Inherited
initStates():void
NavSkinnableComponent
 Inherited
initZoom():void
Initialize zoom effects and set up event listener for such events.
BasicCard
 Inherited
Invalidate the preview because a new data object to be rendered has been set
SimpleCard
 Inherited
Returns the MIME type for the attachment.
SimpleCard
 Inherited
onAspectRatioChanged(event:PropertyChangeEvent):void
The event handler for changes in aspect ratio of the thumbnail.
SimpleCard
 Inherited
onAttachmentChange(evt:Event):void
Handles changes in the underlying attachement events
SimpleCard
  
onCollectionEvent(event:CollectionEvent):void
The event handler that handles collection events.
FolderCard
 Inherited
onDeleteClick(evt:Event):void
The event handler for the clicking the delete button events.
BasicCard
 Inherited
onEnableDynamicThumbnails(value:Boolean):void
Handle the enabling of dynamic thumbnails.
SimpleCard
 Inherited
onExtractClick(evt:Event):void
The event handler for clicking the extract button events.
BasicCard
 Inherited
onExtractOrDeleteClick(event:Event):void
The event handler for the handling either clicking the delete button events.
BasicCard
 Inherited
onHostPropertyChange(event:PropertyChangeEvent):void
[override] A listener for PropertyChangeEvents on the collectionManager.
BasicCard
 Inherited
onIconChange(event:Event):void
Handle icon change events
SimpleCard
 Inherited
onInfoClick(evt:Event):void
The event handler for clicking the info button events.
BasicCard
 Inherited
onInfoCloseClick(evt:Event):void
The event handler for closing the BasicCard's info state.
BasicCard
  
onOpenFolder(event:Event):void
The event handler for open folder events.
FolderCard
 Inherited
onPreviewClick(evt:Event):void
The event handler for clicking the preview button events.
BasicCard
 Inherited
partAdded(partName:String, instance:Object):void
[override] Called when a skin has added a skin part for this instance.
BasicCard
 Inherited
partRemoved(partName:String, instance:Object):void
[override] Called when a skin has removed a skin part for this instance.
BasicCard
 Inherited
setAspectRatio(value:Number, mediaValue:Boolean = false):void
Set the aspect ratio of the thumbnail for the attachment.
SimpleCard
 Inherited
setAspectRatioField(value:Number):void
Set the aspect ratio of the appropriate field for the attachment
SimpleCard
 Inherited
For an extractOrDelete button control set the label to either delete (file or folder, depending on the attachment type) or extract, depending on the authoring mode.
BasicCard
 Inherited
updatePreview(oldRenderer:ISimpleCard):void
Update the preview for this card.
SimpleCard
 Inherited
updatePreviewModelListeners(adding:Boolean):void
Update the listeners for preview model events.
SimpleCard
 Inherited
zoomCard(zoomToLarge:Boolean):void
Set the zoomToLarge Boolean switch for the BasicCard and play the relevant zoom effect (zoomLarge or zoomNormal)
BasicCard
Skin Parts

This component uses skins made up of skin parts. Do not set the skin parts directly. The component's skin sets the skin parts.


 Skin Part Description Defined By
 Inherited
deleteButton:spark.components.Button
Required: false Part Type: Static
deleteButton is the button control to delete the attachment represented by a card. It is an optional skin part, so not necessarily implemented for all skins.
BasicCard
 Inherited
extractButton:spark.components.Button
Required: false Part Type: Static
extractButton is the button control to initiate save an attachment to a user-specified location. It is an optional skin part, so not necessarily implemented for all skins.
BasicCard
 Inherited
extractOrDeleteButton:spark.components.Button
Required: false Part Type: Static
extractOrDeleteButton behave like deleteButton when in authoring mode, and extractButton otherwise.
BasicCard
 Inherited
icon:mx.controls.Image
Required: false Part Type: Static
The icon image for the card
SimpleCard
 Inherited
infoButton:spark.components.Button
Required: false Part Type: Static
infoButton is the button control to toggle the info state of a card. When in the info state, the thumbnail is replaced with additional metadata. It is an optional skin part, so not necessarily implemented for all skins.
BasicCard
 Inherited
infoCloseButton:spark.components.Button
Required: false Part Type: Static
infoCloseButton is the button control for closing the Info state (information on the card) for a card.
BasicCard
 Inherited
paddingGroup:mx.core.UIComponent
Required: false Part Type: Static
A UI Component whose left/right/top/bottom values can be adjusted to fit card UI to a particular aspect ratio without affecting the bounds of the card.
SimpleCard
 Inherited
previewButton:spark.components.Button
Required: false Part Type: Static
previewButton is the button control to initiate a full preview in the viewing application. It is an optional skin part, so not necessarily implemented for all skins.
BasicCard
 Inherited
ribbon:spark.components.Group
Required: false Part Type: Static
A skin part representing the ribbon component that should be visible when the user is editing the attament in an external application.
SimpleCard
Skin States

To skin the component, implement a skin that defines the following states. Although you must implement all skin states, a skin state can be empty. An empty skin state specifies no changes to the default skin state.


 Skin State Description Defined By
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
 InheritedBasicCard
Public Constants
 ConstantDefined By
 InheritedASPECT_RATIO_FIELD : String = adobe:AspectRatio
[static] A string literal representing the name for the aspect ratio field
SimpleCard
 InheritedDEFAULT_SMALL_DIMENSION : Number = 152
[static] String literal used to represent the default dimensions for the small state of BasicCard.
BasicCard
 InheritedPART_DELETE_BUTTON : String = deleteButton
[static] String literal used to represent the deleteButton skin part exposed by BasicCard to its skins.
BasicCard
 InheritedPART_EXTRACT_BUTTON : String = extractButton
[static] String literal used to represent the extractButton skin part exposed by BasicCard to its skins.
BasicCard
 InheritedPART_EXTRACT_OR_DELETE_BUTTON : String = extractOrDeleteButton
[static] String literal used to represent the extractOrDeleteButton skin part exposed by BasicCard to its skins.
BasicCard
 InheritedPART_ICON : String = icon
[static] A string literal used to represent the icon skin part exposed by SimpleCard
SimpleCard
 InheritedPART_INFO_BUTTON : String = infoButton
[static] String literal used to represent the infoButton skin part exposed by BasicCard to its skins.
BasicCard
 InheritedPART_INFO_CLOSE_BUTTON : String = infoCloseButton
[static] String literal used to represent the infoCloseButton skin part exposed by BasicCard to its skins.
BasicCard
 InheritedPART_PREVIEW : String = preview
[static] A string literal used to represent the preview skin part exposed by SimpleCard
SimpleCard
 InheritedPART_PREVIEW_BUTTON : String = previewButton
[static] String literal used to represent the previewButton skin part exposed by BasicCard to its skins.
BasicCard
 InheritedPART_RIBBON : String = ribbon
[static] A string literal used to represent the ribbon skin part exposed by SimpleCard
SimpleCard
 InheritedSKIN_STATE_INFO_NORMAL : String = infoNormal
[static] String literals used to represent the normal "info" state of BasicCard.
BasicCard
 InheritedSKIN_STATE_INFO_OVER : String = infoOver
[static] String literals used to represent the over "info" state of BasicCard.
BasicCard
 InheritedSKIN_STATE_INFO_OVER_AND_SELECTED : String = infoOverAndSelected
[static] String literals used to represent the over and selected "info" state of BasicCard.
BasicCard
 InheritedSKIN_STATE_INFO_SELECTED : String = infoSelected
[static] String literals used to represent the selected "info" state of BasicCard.
BasicCard
 InheritedSKIN_STATE_LARGE_NORMAL : String = largeNormal
[static] String literal used to represent the large card normal state of a BasicCard skin.
BasicCard
 InheritedSKIN_STATE_LARGE_OVER : String = largeOver
[static] String literal used to represent the large card over state of a BasicCard skin.
BasicCard
 InheritedSKIN_STATE_LARGE_OVER_AND_SELECTED : String = largeOverAndSelected
[static] String literal used to represent the large card over and selected state of a BasicCard skin.
BasicCard
 InheritedSKIN_STATE_LARGE_SELECTED : String = largeSelected
[static] String literal used to represent the large card selected state of a BasicCard skin.
BasicCard
 InheritedSKIN_STATE_MEDIUM_NORMAL : String = mediumNormal
[static] String literal used to represent the medium card normal state of a BasicCard skin.
BasicCard
 InheritedSKIN_STATE_MEDIUM_OVER : String = mediumOver
[static] String literal used to represent the medium card over state of a BasicCard skin.
BasicCard
 InheritedSKIN_STATE_MEDIUM_OVER_AND_SELECTED : String = mediumOverAndSelected
[static] String literal used to represent the medium card over and selected state of a BasicCard skin.
BasicCard
 InheritedSKIN_STATE_MEDIUM_SELECTED : String = mediumSelected
[static] String literal used to represent the medium card selected state of a BasicCard skin.
BasicCard
 InheritedSKIN_STATE_NORMAL : String = normal
[static] A string literal used to represent the normal skin state of the SimpleCard
SimpleCard
 InheritedSKIN_STATE_OVER : String = over
[static] A string literal used to represent the "over" skin state of the SimpleCard
SimpleCard
 InheritedSKIN_STATE_OVER_AND_SELECTED : String = overAndSelected
[static] A string literal used to represent the over and selected skin state of the SimpleCard
SimpleCard
 InheritedSKIN_STATE_SELECTED : String = selected
[static] A string literal used to represent the selected skin state of the SimpleCard
SimpleCard
 InheritedSKIN_STATE_SMALL_NORMAL : String = smallNormal
[static] String literal used to represent the small card normal state of a BasicCard skin.
BasicCard
 InheritedSKIN_STATE_SMALL_OVER : String = smallOver
[static] String literal used to represent the small card over state of a BasicCard skin.
BasicCard
 InheritedSKIN_STATE_SMALL_OVER_AND_SELECTED : String = smallOverAndSelected
[static] String literal used to represent the small card over and selected state of a BasicCard skin.
BasicCard
 InheritedSKIN_STATE_SMALL_SELECTED : String = smallSelected
[static] String literal used to represent the small card selected state of a BasicCard skin.
BasicCard
 InheritedSTATE_DISABLED : String = disabled
[static]
NavSkinnableComponent
 InheritedSTATE_INFO : String = info
[static] String literal used to represent the "info" state of BasicCard.
BasicCard
 InheritedSTATE_LARGE : String = large
[static] String literal used to represent the "large" state of BasicCard.
BasicCard
 InheritedSTATE_MEDIUM : String = medium
[static] String literal used to represent the "medium" state of BasicCard.
BasicCard
 InheritedSTATE_NORMAL : String = normal
[static]
NavSkinnableComponent
  STATE_SIMPLE : String = simple
[static] The string litteral used to specify a simple state.
FolderCard
 InheritedSTATE_SMALL : String = small
[static] String literal used to represent the "small" state of BasicCard.
BasicCard
Protected Constants
 ConstantDefined By
 InheritedcollectionManager : CollectionManager
The navigator's CollectionManager instance.
SimpleCard
Property Detail
dataproperty
data:Object[override]

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

Set the data for a folder card and reset the event listeners for the children


Implementation
    public function get data():Object
    public function set data(value:Object):void
numAttachmentsproperty 
numAttachments:int

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

The number of attachnments to a folder

This property can be used as the source for data binding.


Implementation
    public function get numAttachments():int
    public function set numAttachments(value:int):void
Constructor Detail
FolderCard()Constructor
public function FolderCard()

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

Constructor

Method Detail
addListenAndWatch()method
override public function addListenAndWatch():void

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

Function to setup the event listeners required by folder cards.

getCurrentSkinState()method 
override protected function getCurrentSkinState():String

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

Returns the current skin state

Returns
String
getDimensionsUsingPreview()method 
override public function getDimensionsUsingPreview(fitWidth:Number, fitHeight:Number):Point

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

Returns the width and height dimensions to use for the folder card. This will be based on the preview image, but is constrained by the fitWidth and fitHeight parameters.

Parameters

fitWidth:Number — The maximum width to allow
 
fitHeight:Number — The maximum height to allow

Returns
Point — The width and height to the image returns as an (x,y) pair
onCollectionEvent()method 
protected function onCollectionEvent(event:CollectionEvent):void

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

The event handler that handles collection events.

Parameters

event:CollectionEvent — The type of collection event: add, delete, update

onOpenFolder()method 
protected function onOpenFolder(event:Event):void

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

The event handler for open folder events.

Parameters

event:Event — The open folder event

removeListenAndWatch()method 
override public function removeListenAndWatch():void

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

Function to cleanup the event listeners required by folder cards. This should be called when the component is no longer needed, to prevent memory leaks.

setLayoutBoundsSize()method 
override public function setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void

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

Sets the layout size (width and height) of the folder card. This is the size used to draw the card on the screen.

If the width and/or height parameters are left unspecified, Flex sets the folder card's layout size to its preferred width and/or preferred height.

Note that calls to the setLayoutBoundSize() method can affect the layout position, so call setLayoutBoundPosition() after calling setLayoutBoundSize().

Parameters

width:Number — The desired width for the folder card
 
height:Number — The desired height for the folder card
 
postLayoutTransform:Boolean (default = true) — When postLayoutTransform is true, the specified sizes are those of the folder card's bounding box. The bounding box is in folder card's parent coordinate space and is calculated from the folder card's layout size, layout position, and layout transform matrix.

Constant Detail
STATE_SIMPLEConstant
public static const STATE_SIMPLE:String = simple

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

The string litteral used to specify a simple state.