Packageorg.aswing
Classpublic class JMenu
InheritanceJMenu Inheritance JMenuItem Inheritance AbstractButton Inheritance Component Inheritance AWSprite Inheritance flash.display.Sprite
ImplementsMenuElement

An implementation of a menu -- a popup window containing JMenuItems that is displayed when the user selects an item on the JMenuBar. In addition to JMenuItems, a JMenu can also contain JSeparators.

In essence, a menu is a button with an associated JPopupMenu. When the "button" is pressed, the JPopupMenu appears. If the "button" is on the JMenuBar, the menu is a top-level window. If the "button" is another menu item, then the JPopupMenu is "pull-right" menu.



Public Properties
 PropertyDefined by
 InheritedcacheAsBitmap : Boolean
AWSprite
 Inheritedcontainer : Container
Component
 Inheritedfilters : Array
AWSprite
 Inheritedheight : Number
Component
 Inheritedmask : DisplayObject
AWSprite
 InheritednumChildren : int
AWSprite
 Inheritedvisible : Boolean
Component
 Inheritedwidth : Number
Component
 Inheritedx : Number
Component
 Inheritedy : Number
Component
Protected Properties
 PropertyDefined by
 Inheritedaccelerator : KeyType
JMenuItem
 Inheritedbounds : IntRectangle
Component
  delay : int
JMenu
 Inheritedd_numChildren : int
AWSprite
 InheriteddrawTransparentTrigger : Boolean = true
Component
 Inheritedd_visible : Boolean
Returns the DisplayObject.visible directly.
Component
 Inheritedd_x : Number
Returns DisplayObject.x directly.
Component
 Inheritedd_y : Number
Returns DisplayObject.y directly.
Component
 InheritedmenuInUse : Boolean
JMenuItem
  popupMenu : JPopupMenu
JMenu
 InheritedreadyToPaint : Boolean
Component
 Inheritedui : ComponentUI
Component
 Inheritedvalid : Boolean
Component
Public Methods
 MethodDefined by
  
JMenu(text:String = "", icon:Icon = null)
JMenu
 Inherited
addActionListener(listener:Function, priority:int = 0, useWeakReference:Boolean = false):void
Adds a action listener to this button.
AbstractButton
 Inherited
addChild(dis:DisplayObject):DisplayObject
Adds a child DisplayObject instance to this DisplayObjectContainer instance.
AWSprite
 Inherited
addChildAt(child:DisplayObject, index:int):DisplayObject
AWSprite
 Inherited
Adds a component to be the acceptable drag initiator to this component.
Component
  
Creates a new menu item with the specified text and appends it to the end of this menu.
JMenu
 Inherited
addSelectionListener(listener:Function, priority:int = 0, useWeakReference:Boolean = false):void
Add a listener to listen the button's selection change event.
AbstractButton
 Inherited
addStateListener(listener:Function, priority:int = 0, useWeakReference:Boolean = false):void
Adds a listener to listen the button's state change event.
AbstractButton
  
append(c:Component):void
Adds a component(generally JMenuItem or JSeparator) to this menu.
JMenu
 Inherited
bringToBottom(child:DisplayObject):void
Brings a child to bottom.
AWSprite
 Inherited
bringToTop(child:DisplayObject):void
Brings a child to top.
AWSprite
 Inherited
Component
 Inherited
containsChild(child:DisplayObject):Boolean
Returns whether child is directly child of this sprite, true only if getChildIndex(child) >= 0.
AWSprite
 Inherited
doClick():void
Programmatically perform a "click".
AbstractButton
 Inherited
fireFocusKeyDownEvent(e:KeyboardEvent):void
Component
 Inherited
fireFocusKeyUpEvent(e:KeyboardEvent):void
Component
 Inherited
Returns the KeyType which serves as an accelerator for the menu item.
JMenuItem
 Inherited
getAlignmentX():Number
Returns the alignment along the x axis.
Component
 Inherited
getAlignmentY():Number
Returns the alignment along the y axis.
Component
 Inherited
getAlpha():Number
Returns the alpha of this component.
Component
 Inherited
getAwmlID():String
Returns ID used to identify components created from AWML.
Component
 Inherited
getAwmlIndex():Number
Returns position index of the component inside its AWML container.
Component
 Inherited
Returns namespace name used to identify components created from AWML.
Component
 Inherited
Gets the background color of this component.
Component
 Inherited
Returns the background decorator of this component.
Component
 Inherited
Returns the border.
Component
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Same to DisplayObject.getBounds(), just add a explaination here that if you want to get the component bounds, see {
Component
 Inherited
getChildAt(index:int):DisplayObject
AWSprite
 Inherited
getChildByName(name:String):DisplayObject
AWSprite
 Inherited
getChildIndex(child:DisplayObject):int
AWSprite
 Inherited
Returns the value of the property with the specified key.
Component
 Inherited
Returns the clip bounds.
Component
 Inherited

Stores the bounds value of this component into "return value" rv and returns rv.

Component
  
getComponent(index:int):Component
Returns the component at position index.
JMenu
  
Returns the number of components on the menu.
JMenu
 Inherited
getConstraints():Object
Gets cpmponent's constraints.
Component
  
JMenu
  
getDelay():int
Returns the suggested delay, in milliseconds, before submenus are popped up or down.
JMenu
 Inherited
Returns the icon used by the button when it's disabled.
AbstractButton
 Inherited
Returns the icon used by the button when it's disabled and selected.
AbstractButton
 Inherited
getDisplayText():String
Returns the text to be displayed, it is a text that removed the "&"(mnemonic modifier char).
AbstractButton
 Inherited
Returns the focus manager for this component's stage, or null if this component is not on stage.
Component
 Inherited
Gets the font of this component.
Component
 Inherited
Gets the foreground color of this component.
Component
 Inherited
Returns the foreground decorator of this component.
Component
 Inherited
Stores the global location value of this component into "return value" p and returns p.
Component
 Inherited
getHeight():int
Returns the current height of this component
Component
 Inherited
Returns the current top index for a new child(none forground child).
AWSprite
 Inherited
Returns the horizontal alignment of the icon and text.
AbstractButton
 Inherited
Returns the horizontal position of the text relative to the icon.
AbstractButton
 Inherited
AbstractButton
 Inherited
Returns the amount of space between the text and the icon displayed in this button.
AbstractButton
 Inherited
If a border has been set on this component, returns the border's insets; otherwise returns an empty insets.
Component
 Inherited
getInternalFocusObject():InteractiveObject
Returns the object to receive the focus for this component.
Component
 Inherited
Returns the keyboard manager of this component's JRootPane ancestor.
Component
 Inherited
Stores the location value of this component into "return value" rv and returns rv.
Component
 Inherited
Returns the current bottom index for none background child.
AWSprite
 Inherited
AbstractButton
 Inherited
Returns getMaximumSize().height
Component
 Inherited
Component
 Inherited
Returns getMaximumSize().width
Component
  
JMenu
 Inherited
Returns the ui for this frame with MenuElementUI instance
JMenuItem
 Inherited
Returns getMinimumSize().height
Component
 Inherited
Component
 Inherited
Returns getMinimumSize().width
Component
 Inherited
Returns the keyboard mnemonic for this button, -1 means no mnemonic.
AbstractButton
 Inherited
Returns the mnemonic char index in the display text, -1 means no mnemonic.
AbstractButton
 Inherited
Returns the model that this button represents.
AbstractButton
 Inherited
Returns the coordinate of the mouse position, in pixels, in the component scope.
Component
 Inherited
getName():String
Returns the name of the component
Component
 Inherited
Returns the bounds that component should paint in.
Component
 Inherited
Returns the Container parent, if it parent is not a Container, null will be returned.
Component
  
Returns the popupMenu for the Menu
JMenu
 Inherited
Returns getPreferredSize().height
Component
 Inherited
Component
 Inherited
Returns getPreferredSize().width
Component
 Inherited
Returns the pressed icon for the button.
AbstractButton
 Inherited
Returns the rollover icon for the button.
AbstractButton
 Inherited
Returns the rollover selection icon for the button.
AbstractButton
 Inherited
Returns the first JRootPane ancestor of this component.
Component
 Inherited
Returns the window that owned this menu.
JMenuItem
 Inherited
Returns the selected icon for the button.
AbstractButton
 Inherited
Returns the shift offset when mouse press.
AbstractButton
 Inherited
Stores the size value of this component into "return value" rv and returns rv.
Component
  
JMenu
 Inherited
getText():String
Returns the text include the "&"(mnemonic modifier char).
AbstractButton
 Inherited
AbstractButton
 Inherited
getToolTipText():String
Returns the tooltip string that has been set with setToolTipText.
Component
 Inherited
Component
  
getUIClassID():String
JMenu
 Inherited
Returns the vertical alignment of the text and icon.
AbstractButton
 Inherited
Returns the vertical position of the text relative to the icon.
AbstractButton
 Inherited
getWidth():int
Returns the current width of this component
Component
 Inherited
getX():int
Returns the current x coordinate of the components.
Component
 Inherited
getY():int
Returns the current y coordinate of the components.
Component
 Inherited
Component
 Inherited
hitTestMouse():Boolean
Returns whether the component hit the mouse.
Component
 Inherited
hitTestObject(obj:DisplayObject):Boolean
AWSprite
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
AWSprite
  
insert(i:int, c:Component):void
Inserts a component(generally JMenuItem or JSeparator) to this menu.
JMenu
 Inherited
invalidate():void
Invalidates this component.
Component
 Inherited
Clears this component and all parents above it's preferred size caches.
Component
 Inherited
Returns whether or not the preferred size, minimum size and max size cache is turned on.
Component
 Inherited
isClipMasked():Boolean
Returns whether the component clip should be masked by its bounds.
AWSprite
 Inherited
Returns whether the component is acceptable drag initiator for this component.
Component
 Inherited
isDragEnabled():Boolean
Returns whether this component can fire ON_DRAG_RECOGNIZED event.
Component
 Inherited
isDropTrigger():Boolean
Returns whether this component can trigger dragging component to fire drag events when dragging over to this component.(Default value is false)
Component
 Inherited
isEnabled():Boolean
Returns whether the component is enabled.
Component
 Inherited
isFocusable():Boolean
Returns whether this Component can be focused.
Component
 Inherited
isFocusableSet():Boolean
Returns whether or not the opaque property is set by user.
Component
 Inherited
isFocusOwner():Boolean
Returns true if this Component is the focus owner.
Component
 Inherited
isFontValidated():Boolean
Returns whether the new font are applied and taked effect.
Component
 Inherited
isInUse():Boolean
JMenuItem
  
Returns true if the specified component exists in the submenu hierarchy.
JMenu
 Inherited
isOnStage():Boolean
Determines whether or not this component is on stage(on the display list).
Component
 Inherited
isOpaque():Boolean
Returns true if this component is completely opaque.
Component
 Inherited
isOpaqueSet():Boolean
Returns whether or not the opaque property is set by user.
Component
  
Returns true if the menu's popup window is visible.
JMenu
 Inherited
Gets the rolloverEnabled property.
AbstractButton
 Inherited
isSelected():Boolean
Returns the state of the button.
AbstractButton
 Inherited
isShiftOffsetSet():Boolean
Return whether or not the shiftOffset has set by user.
AbstractButton
 Inherited
isShowing():Boolean
Determines whether this component is showing on screen.
Component
  
isTopLevelMenu():Boolean
Returns true if the menu is a 'top-level menu', that is, if it is the direct child of a menubar.
JMenu
 Inherited
isUIElement():Boolean
Returns true if this component is just a ui element component, false means this component is a regular use created component.
Component
 Inherited
isValid():Boolean
Determines whether this component is valid.
Component
 Inherited
isValidateRoot():Boolean
If this method returns true, revalidate calls by descendants of this component will cause the entire tree beginning with this root to be validated.
Component
 Inherited
isVisible():Boolean
Component
 Inherited
makeFocus():void
Makes this component's internal focus object to be the stage focus directly, without any judgement.
Component
  
menuSelectionChanged(isIncluded:Boolean):void
JMenu
 Inherited
pack():void
Causes this component to be sized to fit the preferred size.
Component
 Inherited
paintFocusRect(force:Boolean = false):void
Paints the focus rect if need.
Component
 Inherited
Redraw the component UI face immediately if it is visible and ready to paint.
Component
 Inherited
Calls parent reAppendChildren if parent is a container.
Component
 Inherited
processKeyEvent(code:uint):void
JMenuItem
 Inherited
putClientProperty(key:*, value:*):void
Adds an arbitrary key/value "client property" to this component.
Component
 Inherited
reAppendToParent(constraints:Object = null):void
Removes this component from its parent and then append it with specified constraints.
Component
  
Remove the specified component.
JMenu
 Inherited
removeActionListener(listener:Function):void
Removes a action listener.
AbstractButton
  
removeAll():void
Remove all components in the menu.
JMenu
  
Remove the specified index component.
JMenu
 Inherited
removeChild(child:DisplayObject):DisplayObject
AWSprite
 Inherited
removeChildAt(index:int):DisplayObject
AWSprite
 Inherited
Removes a component to be the acceptable drag initiator to this component.
Component
 Inherited
Removes this component from its parent, whatever it is as a component child or only a display object child, or it's parent is just a display object container.
Component
 Inherited
removeSelectionListener(listener:Function):void
Removes a selection listener.
AbstractButton
 Inherited
removeStateListener(listener:Function):void
Removes a state listener.
AbstractButton
 Inherited
repaint():void
Redraws the component face next RENDER event.This method can be called often, so it needs to execute quickly.
Component
 Inherited
Component
 Inherited
requestFocus():Boolean
Requests that this Component get the input focus, and that this Component's top-level ancestor become the focused Window.
Component
 Inherited
revalidate():void
Supports deferred automatic layout.
Component
 Inherited
Component
 Inherited
Sets the key combination which invokes the menu item's action listeners without navigating the menu hierarchy.
JMenuItem
 Inherited
setAlignmentX(ax:Number):void
Component
 Inherited
setAlignmentY(ay:Number):void
Component
 Inherited
setAlpha(alpha:Number):void
Indicates the alpha transparency value of the component.
Component
 Inherited
setAwmlID(id:String):void
Sets ID used to identify components created from AWML.
Component
 Inherited
setAwmlIndex(index:Number):void
Sets ID used to identify components created from AWML.
Component
 Inherited
setAwmlNamespace(theNamespace:String):void
Sets namespace used to identify components created from AWML.
Component
 Inherited
Sets the background color of this component.
Component
 Inherited
Sets a decorator to be the component background, it will represent the component background with a DisplayObject.
Component
 Inherited
setBorder(b:Border):void
Sets the border for the component, null to remove border.
Component
 Inherited
This method will call setComBounds()
Component
 Inherited
setCachePreferSizes(b:Boolean):void
Sets whether or not turn on the preferred size, minimum size and max size cache.
Component
 Inherited
setChildIndex(child:DisplayObject, index:int):void
AWSprite
 Inherited
Sets the clip bounds, a rectangle mask to make specified bounds visible.
Component
 Inherited
setClipMasked(m:Boolean):void
Sets whether the component clip should be masked by its bounds.
AWSprite
 Inherited
Sets the clip size, a rectangle mask to make specified bounds visible.
Component
 Inherited
Moves and resizes this component.
Component
 Inherited
setComBoundsXYWH(x:int, y:int, w:int, h:int):void
Moves and resizes this component.
Component
 Inherited
setConstraints(constraints:Object):void
Sets component's constraints.
Component
  
setDelay(d:int):void
Sets the suggested delay before the menu's PopupMenu is popped up or down.
JMenu
 Inherited
setDisabledIcon(disabledIcon:Icon):void
Sets the disabled icon for the button.
AbstractButton
 Inherited
setDisabledSelectedIcon(disabledSelectedIcon:Icon):void
Sets the disabled selection icon for the button.
AbstractButton
 Inherited
Sets a function to judge whether a component is acceptable drag initiator.
Component
 Inherited
setDragEnabled(b:Boolean):void
Sets whether this component can fire ON_DRAG_RECOGNIZED event.
Component
 Inherited
setDropTrigger(b:Boolean):void
Sets whether this component can trigger dragging component to fire drag events when dragging over to this component.
Component
 Inherited
setEnabled(b:Boolean):void
Enabled (or disabled) the button.
AbstractButton
 Inherited
setFocusable(b:Boolean):void
Sets the focusable state of this Component to the specified value.
Component
 Inherited
setFocusableSet(b:Boolean):void
Indicate that the focusable property is set by user or not.
Component
 Inherited
setFont(newFont:ASFont):void
Sets the text font for this component.
this method will cause a repaint and revalidate method call.
Component
 Inherited
setFontValidated(b:Boolean):void
Sets whether the new font are applied and taked effect.
Component
 Inherited
Sets the foreground color of this component.
Component
 Inherited
Sets a decorator to be the component foreground, it will represent the component foreground with a DisplayObject on top of other children of this component.
Component
 Inherited
Set the component's location in global coordinate.
Component
 Inherited
setGlobalLocationXY(x:int, y:int):void
Set the component's location in global coordinate.
Component
 Inherited
setHeight(height:Number):void
Sets the component's height.
Component
 Inherited
setHorizontalAlignment(alignment:int):void
Sets the horizontal alignment of the icon and text.
AbstractButton
 Inherited
setHorizontalTextPosition(textPosition:int):void
Sets the horizontal position of the text relative to the icon.
AbstractButton
 Inherited
setIcon(defaultIcon:Icon):void
Sets the default icon for the button.