Packagecom.adobe.portfolio.cards
Classpublic class PreviewCard
InheritancePreviewCard Inheritance SimpleCard Inheritance NavSkinnableComponent Inheritance spark.components.supportClasses.SkinnableComponent
Implements IPreviewCard

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

The PreviewCard class extends SimpleCard to show large thumbnails corresponding to an IAttachment. It implements IListItemRenderer, so it can be used as an item renderer for relevant containers. The skin is not required to provide all the relevant controls, which allows this object to act as the core for both simple (mini-nav) and complex (basic click-through card) rendering.



Public Properties
 PropertyDefined By
 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
 Inheriteddata : Object
The data object to be renderered.
SimpleCard
 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] Enable double clicking events.
SimpleCard
 InheriteddownSampleOK : Boolean
true if it is OK to scale down the image; otherwise false.
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
 InheritedmaintainAspectRatio : Boolean
Is true if the aspect ratio of the card should be maintained by setLayoutBoundsSize; otherwise it is false.
SimpleCard
 InheritedmodDate : Date
The modification date of this card's underlying attachment.
SimpleCard
 InheritednumAttachments : int
The number of attachments in a folder
SimpleCard
 Inheritedpadding : Point
[read-only] Get the horizontal and vertical padding for this UI component.
SimpleCard
  pageNavigationEnabled : Boolean
Whether page navigation is enabled (via keyboard, mousewheel)
PreviewCard
 Inheritedpreview : Preview
[write-only]
SimpleCard
 InheritedpreviewComponent : IPreview
[read-only] Returns the preview component for this card.
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
The current skin state
NavSkinnableComponent
 Inheritedvisible : Boolean
[override] [write-only]
SimpleCard
Protected Properties
 PropertyDefined By
  allowMultiPage : Boolean
[override] [read-only] Specifies whether or not this card should use a multi-page preview state.
PreviewCard
 Inheritedattachment : IAttachment = null
The IAttachment data object being rendered by this component.
SimpleCard
 InheritedautoListen : AutoListen
NavSkinnableComponent
 InheritedautoWatch : AutoWatch
NavSkinnableComponent
 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
  preferredPreviewState : String
[override] [read-only] Returns the preferred PreviewState.
PreviewCard
  prefersMediaPreview : Boolean
[override] [read-only] Returns true if this card supports in-place multimedia playback for it's current attachment; false otherwise.
PreviewCard
 InheritedpreviewMultiPageModel : IPreviewMultiPageModel
[read-only] Get a preview model that supports multipage preview of attachments, or null if multipage preview is not supported by the current preview model.
SimpleCard
Public Methods
 MethodDefined By
  
Constructor
PreviewCard
 Inherited
Creates autoListen and autoWatch for automatically tracking listeners and watchers.
NavSkinnableComponent
 Inherited
invalidatePreview(invalidateModel:Boolean = false, generateThumb:Boolean = true):void
Invalidate the current preview state for the card
SimpleCard
 Inherited
Uses autoListen and autoWatch to remove all listeners and watchers.
NavSkinnableComponent
  
setCurrentState(stateName:String, playTransition:Boolean = true):void
[override] Set the current state of the previewCard
PreviewCard
 Inherited
setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void
[override] Sets the layout size of the card.
SimpleCard
 Inherited
toString():String
[override] The String to display in the item renderer.
SimpleCard
 Inherited
updateRenderer(oldRenderer:ISimpleCard):void
Update the renderer to use for the card
SimpleCard
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]
SimpleCard
 Inherited
detachSkin():void
[override]
NavSkinnableComponent
 Inherited
Returns the file extension for the attachment.
SimpleCard
  
[override] Generate a thumbnail image for the underlying attachment.
PreviewCard
 Inherited
Get the aspect ratio of the thumbnail for the attachment.
SimpleCard
  
[override]
PreviewCard
  
[override] Get the size of the preview image
PreviewCard
 Inherited
Have the collectionManager handle modal previe experience 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
  
invalidatePreviewFromSetData(invalidateModel:Boolean = false, generateThumb:Boolean = true):void
[override] Invalidate the preview because a new data object to be rendered has been set
PreviewCard
 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 attachment events
SimpleCard
 Inherited
onChildrenChanged(event:CollectionEvent):void
An event listener that's called when this attachments children dispatches a collectionChange event.
SimpleCard
  
onCloseClick(evt:Event):void
Dispatches a closeButton event
PreviewCard
 Inherited
onEnableDynamicThumbnails(value:Boolean):void
Handle the enabling of dynamic thumbnails.
SimpleCard
 Inherited
onHostPropertyChange(event:PropertyChangeEvent):void
A listener for PropertyChangeEvents on the collectionManager.
SimpleCard
 Inherited
onIconChange(event:Event):void
Handle icon change events from the underlying attachment
SimpleCard
  
onInfoCloseClick(evt:Event):void
The event handler for closing the previewCard's info state.
PreviewCard
  
partAdded(partName:String, instance:Object):void
[override]
PreviewCard
  
partRemoved(partName:String, instance:Object):void
[override]
PreviewCard
 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
updatePreview(oldRenderer:ISimpleCard):void
Update the preview for this card.
SimpleCard
 Inherited
updatePreviewModelListeners(adding:Boolean):void
Update the listeners for preview model events.
SimpleCard
Events
 Event Summary Defined By
  Dispatched when the user clicks the close button for this component.PreviewCard
Styles
 Style Description Defined By
 InheritedType: Class
Name of the skin class to use for this component when its data is set to a folder attachment.
SimpleCard
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
  
closeButton:spark.components.Button
Required: false Part Type: Static
closeButton is the button control to close the preview card. It is an optional skin part, so it is not necessarily implemented for all skins.
PreviewCard
 Inherited
icon:spark.primitives.BitmapImage
Required: false Part Type: Static
The icon image for the card
SimpleCard
  
infoCloseButton:spark.components.Button
Required: false Part Type: Static
infoCloseButton is the button control to close the info card. It is an optional skin part, so not necessarily implemented for all skins.
PreviewCard
 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.

See also

SimpleCard
 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
 InheritedSimpleCard
 InheritedSimpleCard
 InheritedSimpleCard
  
previewInfo
PreviewCard
  
previewNormal
PreviewCard
 InheritedSimpleCard
Public Constants
 ConstantDefined By
 InheritedASPECT_RATIO_FIELD : String = adobe:AspectRatio
[static] A string literal representing the name for the aspect ratio field
SimpleCard
 InheritedPART_ICON : String = icon
[static] A string literal used to represent the icon skin part exposed by SimpleCard
SimpleCard
 InheritedPART_PREVIEW : String = preview
[static] A string literal used to represent the preview skin part exposed by SimpleCard
SimpleCard
 InheritedPART_RIBBON : String = ribbon
[static] A string literal used to represent the ribbon skin part exposed by SimpleCard
SimpleCard
 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
  SKIN_STATE_PREVIEW_INFO : String = previewInfo
[static] A string literal used to represent the info state of a PreviewCard skin.
PreviewCard
  SKIN_STATE_PREVIEW_NORMAL : String = previewNormal
[static] A string literal used to represent the preview state of a PreviewCard skin.
PreviewCard
 InheritedSKIN_STATE_SELECTED : String = selected
[static] A string literal used to represent the selected skin state of the SimpleCard
SimpleCard
 InheritedSTATE_DISABLED : String = disabled
[static]
NavSkinnableComponent
  STATE_INFO : String = info
[static] A string literal used to represent the info state of a previewCard.
PreviewCard
 InheritedSTATE_NORMAL : String = normal
[static]
NavSkinnableComponent
  STATE_PREVIEW : String = preview
[static] A string literal used to represent the preview state of a previewCard.
PreviewCard
Protected Constants
 ConstantDefined By
 InheritedcollectionManager : CollectionManager
The navigator's CollectionManager instance.
SimpleCard
 Inheritedlogger : ILogger
A logger that can be used by this instance to log warnings, errors, or additional information.
SimpleCard
 InheritedthumbnailMgr : ThumbnailManager
[static] The navigator's thumbnailManager instance.
SimpleCard
Property Detail
allowMultiPageproperty
allowMultiPage:Boolean  [read-only] [override]

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

Specifies whether or not this card should use a multi-page preview state. Calculating the page count is expensive, so only allow multi-page at all if the current attachment supports it.


Implementation
    protected function get allowMultiPage():Boolean
pageNavigationEnabledproperty 
pageNavigationEnabled:Boolean

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

Whether page navigation is enabled (via keyboard, mousewheel)

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


Implementation
    public function get pageNavigationEnabled():Boolean
    public function set pageNavigationEnabled(value:Boolean):void
preferredPreviewStateproperty 
preferredPreviewState:String  [read-only] [override]

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

Returns the preferred PreviewState. This is based on the MIME type of the associated attachement if supported. The preferred preview state for this card


Implementation
    protected function get preferredPreviewState():String

See also

Preview.AUDIO
Preview.PAGING_THUMBNAIL
Preview.THUMBNAIL
Preview.VIDEO
prefersMediaPreviewproperty 
prefersMediaPreview:Boolean  [read-only] [override]

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

Returns true if this card supports in-place multimedia playback for it's current attachment; false otherwise.


Implementation
    protected function get prefersMediaPreview():Boolean
Constructor Detail
PreviewCard()Constructor
public function PreviewCard()

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

Constructor

Method Detail
generateThumbnail()method
override protected function generateThumbnail():void

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

Generate a thumbnail image for the underlying attachment.

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
String
getPreviewSize()method 
override protected function getPreviewSize():Point

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

Get the size of the preview image

Returns
Point — the width and height of the preview image as an (x,y) pair.
invalidatePreviewFromSetData()method 
override protected function invalidatePreviewFromSetData(invalidateModel:Boolean = false, generateThumb:Boolean = true):void

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

Invalidate the preview because a new data object to be rendered has been set

Parameters

invalidateModel:Boolean (default = false)
 
generateThumb:Boolean (default = true)

onCloseClick()method 
protected function onCloseClick(evt:Event):void

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

Dispatches a closeButton event

Parameters

evt:Event — The triggering event

onInfoCloseClick()method 
protected function onInfoCloseClick(evt: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 closing the previewCard's info state.

Parameters

evt:Event

partAdded()method 
override protected function partAdded(partName:String, instance:Object):void

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

Parameters

partName:String
 
instance:Object

partRemoved()method 
override protected function partRemoved(partName:String, instance:Object):void

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

Parameters

partName:String
 
instance:Object

setCurrentState()method 
override public function setCurrentState(stateName:String, playTransition:Boolean = true):void

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

Set the current state of the previewCard

Parameters

stateName:String — The name of the new current state
 
playTransition:Boolean (default = true) — If true then play the state transition effect.

Event Detail
closeButton Event
Event Object Type: flash.events.Event

Dispatched when the user clicks the close button for this component.

Constant Detail
SKIN_STATE_PREVIEW_INFOConstant
public static const SKIN_STATE_PREVIEW_INFO:String = previewInfo

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

A string literal used to represent the info state of a PreviewCard skin.

SKIN_STATE_PREVIEW_NORMALConstant 
public static const SKIN_STATE_PREVIEW_NORMAL:String = previewNormal

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

A string literal used to represent the preview state of a PreviewCard skin.

STATE_INFOConstant 
public static const STATE_INFO:String = info

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

A string literal used to represent the info state of a previewCard.

STATE_PREVIEWConstant 
public static const STATE_PREVIEW:String = preview

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

A string literal used to represent the preview state of a previewCard.