Packagepotomac.ui
Classpublic dynamic class PartInput
InheritancePartInput Inheritance Object

A PartInput is a lightweight argument passed to a part. For most parts, the input is typically null, but when multiple instances of a given part are required an input should be used. Inputs differentiate the different instances. For example, if a part works on an 'Employee' object, the input might contain the employee ID.

Inputs should not contain full model elements. Instead they should maintain as little information as possible to allow the model to be retrieved. This typically means the input should contain primary key information only. Inputs will be serialized and stored between application sessions. They will be deserialized and recreated in order to the user to shown the same parts that were shown during his last application session.

PartInput is a dynamic object. Developers are encouraged to write their own subclasses of PartInput but it isn't required. Dynamic properties can be attached to a PartInput. Integer and String dynamic properties will be automatically serialized and checked during #equals. Subclasses must re-implement #equals().


Public Properties
 PropertyDefined By
  icon : Class
The icon of the input.
PartInput
  title : String
The title of the input.
PartInput
Public Methods
 MethodDefined By
  
PartInput()
Creates an empty part input.
PartInput
  
equals(otherInput:PartInput):Boolean
Returns true if the given input matches this input.
PartInput
Property Detail
iconproperty
icon:Class

The icon of the input. Setting this icon will override the icon set in the part's declared extension.


Implementation
    public function get icon():Class
    public function set icon(value:Class):void
titleproperty 
title:String

The title of the input. Setting this title will override the title set in the part's declared extension. This is useful when you have multiple instances of a part and need to allow the user to differentiate between them.


Implementation
    public function get title():String
    public function set title(value:String):void
Constructor Detail
PartInput()Constructor
public function PartInput()

Creates an empty part input.

Method Detail
equals()method
public function equals(otherInput:PartInput):Boolean

Returns true if the given input matches this input. This method is used to prevent duplicate parts in the same folder from opening. If a part with same id and matching input is already open, an attempt to open a the new page will result in the existing part being made visible (ex. its tab will be selected).

Parameters

otherInput:PartInput — input to check for equality.

Returns
Boolean — true if the inputs are matching.




Fri Sep 10 2010, 10:44 AM -04:00