CCMenuAdvanced Class Reference
| Inherits from | CCMenu : CCLayerRGBA : CCLayer : CCNode : NSObject |
| Declared in | CCMenuAdvanced.h |
Overview
@class CCMenuAdvanced CCMenu with some aditional features.
1) Selecting and activating CCMenuItems with Keyboard
(by default next/prev bindings aren’t set – set them manually or use one of align methods to bind arrows for this).
2) One of CCMenuItems can be set as escapeDelegate - so it will be activated by pressing escape
3) align left->right, right->left, bottom->top, top->bottom with autosetting self contentSize
4) externalBoundsRect - if it is set then menu items will be scrollable inside these bounds
5) priority property - must be set before onEnter to make it register with that priority
@todo [v0.2] add columns and rows alignment methods
Tasks
-
boundaryRectRectangle in parent’s coordinate system, which menu must fill with it’s boundingBox.
property -
minimumTouchLengthToSlideMinimum length of touch, that will disable selected menu item & start scrolling.
property -
priorityPriority property for touch, mouse & keyboard for menu. Must be set before onEnter called.
property -
isDisabledIf YES – all touches & keyboard events will be ignored. If NO – all events will work, except for disabled items. Default is NO.
property -
debugDrawIf YES – draw rectangle around CCMenuAdvanced.
property -
escapeDelegateproperty -
prevItemButtonBindproperty -
nextItemButtonBindproperty -
– alignItemsHorizontallyWithPadding:AlignH items horizontal from left to right.
-
– alignItemsVerticallyWithPadding:Designated alignVerticall from bottom to top.
-
– alignItemsHorizontallyWithPadding:leftToRight:Designated alignHorizontal Method
-
– alignItemsVerticallyWithPadding:bottomToTop:Designated alignVerticall Method
-
– fixPositionChanges menu position to stay inside of boundaryRect if it is non-null.
-
– selectNextMenuItem -
– selectPrevMenuItem -
– activateSelectedItem -
– cancelSelectedItem
Properties
boundaryRect
Rectangle in parent’s coordinate system, which menu must fill with it’s boundingBox.
@property (readwrite, assign) CGRect boundaryRectDiscussion
Note: boundaryRect must have greater size then menu’s boundingBox to make scrolling possible. Think about boundaryRect like about hole in paper sheet under which you would like to put CCMenuAdvanced and scroll it, but you never want to see the table – hole must be covered with paper.
Declared In
CCMenuAdvanced.hdebugDraw
If YES – draw rectangle around CCMenuAdvanced.
@property (readwrite, assign) BOOL debugDrawDeclared In
CCMenuAdvanced.hisDisabled
If YES – all touches & keyboard events will be ignored. If NO – all events will work, except for disabled items. Default is NO.
@property (readwrite, assign) BOOL isDisabledDeclared In
CCMenuAdvanced.hInstance Methods
alignItemsHorizontallyWithPadding:
AlignH items horizontal from left to right.
- (void)alignItemsHorizontallyWithPadding:(float)paddingParameters
- padding
space between elements.
Declared In
CCMenuAdvanced.halignItemsHorizontallyWithPadding:leftToRight:
Designated alignHorizontal Method
- (void)alignItemsHorizontallyWithPadding:(float)padding leftToRight:(BOOL)leftToRightParameters
- padding
space between elements.
- leftRoRight
If YES – align items from left to right, if NO – right to left.
Declared In
CCMenuAdvanced.halignItemsVerticallyWithPadding:
Designated alignVerticall from bottom to top.
- (void)alignItemsVerticallyWithPadding:(float)paddingParameters
- padding
space between elements.
Declared In
CCMenuAdvanced.halignItemsVerticallyWithPadding:bottomToTop:
Designated alignVerticall Method
- (void)alignItemsVerticallyWithPadding:(float)padding bottomToTop:(BOOL)bottomToTopParameters
- padding
space between elements.
- bottomToTop
If YES – align items from bottom to top, if NO – top to bottom.
Declared In
CCMenuAdvanced.h