Packagefeathers.controls.popups
Classpublic class VerticalCenteredPopUpContentManager
InheritanceVerticalCenteredPopUpContentManager Inheritance EventDispatcher Inheritance Object
Implements IPopUpContentManager

Product Version : Feathers 1.0.0

Displays a pop-up at the center of the stage, filling the vertical space. The content will be sized horizontally so that it is no larger than the the width or height of the stage (whichever is smaller).



Public Properties
 PropertyDefined By
  isOpen : Boolean
[read-only] Indicates if the pop-up content is open or not.
VerticalCenteredPopUpContentManager
  margin : Number
Quickly sets all margin properties to the same value.
VerticalCenteredPopUpContentManager
  marginBottom : Number = 0
The minimum space, in pixels, between the bottom edge of the content and the bottom edge of the stage.
VerticalCenteredPopUpContentManager
  marginLeft : Number = 0
The minimum space, in pixels, between the left edge of the content and the left edge of the stage.
VerticalCenteredPopUpContentManager
  marginRight : Number = 0
The minimum space, in pixels, between the right edge of the content and the right edge of the stage.
VerticalCenteredPopUpContentManager
  marginTop : Number = 0
The minimum space, in pixels, between the top edge of the content and the top edge of the stage.
VerticalCenteredPopUpContentManager
  overlayFactory : Function
This function may be used to customize the modal overlay displayed by the pop-up manager.
VerticalCenteredPopUpContentManager
Public Methods
 MethodDefined By
  
Constructor.
VerticalCenteredPopUpContentManager
 Inherited
addEventListener(type:String, listener:Function):void
Registers an event listener at a certain object.
EventDispatcher
  
close():void
Closes the pop-up content.
VerticalCenteredPopUpContentManager
 Inherited
dispatchEvent(event:Event):void
Dispatches an event to all objects that have registered listeners for its type.
EventDispatcher
 Inherited
dispatchEventWith(type:String, bubbles:Boolean = false, data:Object = null):void
Dispatches an event with the given parameters to all objects that have registered listeners for the given type.
EventDispatcher
  
dispose():void
Cleans up the manager.
VerticalCenteredPopUpContentManager
 Inherited
hasEventListener(type:String, listener:Function = null):Boolean
If called with one argument, figures out if there are any listeners registered for the given event type.
EventDispatcher
  
open(content:DisplayObject, source:DisplayObject):void
Displays the pop-up content.
VerticalCenteredPopUpContentManager
 Inherited
removeEventListener(type:String, listener:Function):void
Removes an event listener from the object.
EventDispatcher
 Inherited
removeEventListeners(type:String = null):void
Removes all event listeners with a certain type, or all of them if type is null.
EventDispatcher
Events
 Event Summary Defined By
  Dispatched when the pop-up content closes.VerticalCenteredPopUpContentManager
  Dispatched when the pop-up content opens.VerticalCenteredPopUpContentManager
Property Detail
isOpenproperty
isOpen:Boolean  [read-only]

Indicates if the pop-up content is open or not.


Implementation
    public function get isOpen():Boolean
marginproperty 
margin:Number

Quickly sets all margin properties to the same value. The margin getter always returns the value of marginTop, but the other padding values may be different.

The following example gives the pop-up a minimum of 20 pixels of margin on all sides:

    manager.margin = 20;

The default value is 0.


Implementation
    public function get margin():Number
    public function set margin(value:Number):void

See also

marginBottomproperty 
public var marginBottom:Number = 0

The minimum space, in pixels, between the bottom edge of the content and the bottom edge of the stage.

The following example gives the pop-up a minimum of 20 pixels of margin on the bottom:

    manager.marginBottom = 20;

The default value is 0.

See also

marginLeftproperty 
public var marginLeft:Number = 0

The minimum space, in pixels, between the left edge of the content and the left edge of the stage.

The following example gives the pop-up a minimum of 20 pixels of margin on the left:

    manager.marginLeft = 20;

The default value is 0.

See also

marginRightproperty 
public var marginRight:Number = 0

The minimum space, in pixels, between the right edge of the content and the right edge of the stage.

The following example gives the pop-up a minimum of 20 pixels of margin on the right:

    manager.marginRight = 20;

The default value is 0.

See also

marginTopproperty 
public var marginTop:Number = 0

The minimum space, in pixels, between the top edge of the content and the top edge of the stage.

The following example gives the pop-up a minimum of 20 pixels of margin on the top:

    manager.marginTop = 20;

The default value is 0.

See also

overlayFactoryproperty 
overlayFactory:Function

This function may be used to customize the modal overlay displayed by the pop-up manager. If the value of overlayFactory is null, the pop-up manager's default overlay factory will be used instead.

This function is expected to have the following signature:

function():DisplayObject

In the following example, the overlay is customized:

    manager.overlayFactory = function():DisplayObject
    {
        var quad:Quad = new Quad(1, 1, 0xff00ff);
        quad.alpha = 0;
        return quad;
    };

The default value is null.


Implementation
    public function get overlayFactory():Function
    public function set overlayFactory(value:Function):void

See also

Constructor Detail
VerticalCenteredPopUpContentManager()Constructor
public function VerticalCenteredPopUpContentManager()

Constructor.

Method Detail
close()method
public function close():void

Closes the pop-up content. If it is not opened, nothing happens.

dispose()method 
public function dispose():void

Cleans up the manager.

open()method 
public function open(content:DisplayObject, source:DisplayObject):void

Displays the pop-up content.

Parameters

content:DisplayObject — The content for the pop-up content manager to display.
 
source:DisplayObject — The source of the pop-up. May be used to position and/or size the pop-up. May be completely ignored instead.

Event Detail
close Event
Event Object Type: starling.events.Event
Event.type property = starling.events.Event.CLOSE

Dispatched when the pop-up content closes.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
currentTargetThe Object that defines the event listener that handles the event. For example, if you use myButton.addEventListener() to register an event listener, myButton is the value of the currentTarget.
datanull
targetThe Object that dispatched the event; it is not always the Object listening for the event. Use the currentTarget property to always access the Object listening for the event.

An event type to be utilized in custom events. Not used by Starling right now.
open Event  
Event Object Type: starling.events.Event
Event.type property = starling.events.Event.OPEN

Dispatched when the pop-up content opens.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
currentTargetThe Object that defines the event listener that handles the event. For example, if you use myButton.addEventListener() to register an event listener, myButton is the value of the currentTarget.
datanull
targetThe Object that dispatched the event; it is not always the Object listening for the event. Use the currentTarget property to always access the Object listening for the event.

An event type to be utilized in custom events. Not used by Starling right now.