CPMenu Class Reference

#import <CPMenu.h>

Inheritance diagram for CPMenu:

Instance Methods
(void)	- addItem:
(CPMenuItem)	- addItemWithTitle:action:keyEquivalent:
(BOOL)	- autoenablesItems
(void)	- awakeFromCib
(void)	- cancelTracking
(CPUInteger)	- countOfItems
(id)	- delegate
(void)	- encodeWithCoder:
(CPFont)	- font
(CPMenuItem)	- highlightedItem
(int)	- indexOfItem:
(int)	- indexOfItemWithRepresentedObject:
(int)	- indexOfItemWithSubmenu:
(int)	- indexOfItemWithTag:
(int)	- indexOfItemWithTarget:andAction:
(int)	- indexOfItemWithTitle:
(id)	- init
(id)	- initWithCoder:
(id)	- initWithTitle:
(void)	- insertItem:atIndex:
(CPMenuItem)	- insertItemWithTitle:action:keyEquivalent:atIndex:
(void)	- insertObject:inItemsAtIndex:
(BOOL)	- isTornOff
(CPArray)	- itemArray
(CPMenuItem)	- itemAtIndex:
(void)	- itemChanged:
(CPArray)	- itemsAtIndexes:
(CPMenuItem)	- itemWithTag:
(CPMenuItem)	- itemWithTitle:
(float)	- menuBarHeight
(float)	- minimumWidth
(unsigned)	- numberOfItems
(CPMenuItem)	- objectInItemsAtIndex:
(void)	- performActionForItemAtIndex:
(BOOL)	- performKeyEquivalent:
(void)	- popUpMenuPositioningItem:atLocation:inView:callback:
(void)	- removeAllItems
(void)	- removeItem:
(void)	- removeItemAtIndex:
(void)	- removeObjectFromItemsAtIndex:
(void)	- setAutoenablesItems:
(void)	- setDelegate:
(void)	- setFont:
(void)	- setMinimumWidth:
(void)	- setShowsStateColumn:
(void)	- setSubmenu:forItem:
(void)	- setSupermenu:
(void)	- setTitle:
(BOOL)	- showsStateColumn
(void)	- submenuAction:
(CPMenu)	- supermenu
(CPString)	- title
(void)	- update
Instance Methods inherited from CPObject
(void)	- addObserver:forKeyPath:options:context:
(void)	- applyChange:toKeyPath:
(id)	- autorelease
(id)	- awakeAfterUsingCoder:
(void)	- bind:toObject:withKeyPath:options:
(Class)	- classForCoder
(Class)	- classForKeyedArchiver
(CPString)	- className
(id)	- copy
(void)	- dealloc
(CPString)	- description
(CPDictionary)	- dictionaryWithValuesForKeys:
(void)	- didChange:valuesAtIndexes:forKey:
(void)	- didChangeValueForKey:
(void)	- didChangeValueForKey:withSetMutation:usingObjects:
(void)	- doesNotRecognizeSelector:
(CPArray)	- exposedBindings
(id)	- forwardingTargetForSelector:
(void)	- forwardInvocation:
(unsigned)	- hash
(BOOL)	- implementsSelector:
(CPDictionary)	- infoForBinding:
(BOOL)	- isEqual:
(BOOL)	- isKindOfClass:
(BOOL)	- isMemberOfClass:
(BOOL)	- isProxy
(IMP)	- methodForSelector:
(CPMethodSignature)	- methodSignatureForSelector:
(id)	- mutableArrayValueForKey:
(id)	- mutableArrayValueForKeyPath:
(id)	- mutableCopy
(id)	- mutableSetValueForKey:
(id)	- mutableSetValueForKeyPath:
(id)	- performSelector:
(id)	- performSelector:withObject:
(id)	- performSelector:withObject:withObject:
(id)	- performSelector:withObjects:
(void)	- release
(void)	- removeObserver:forKeyPath:
(id)	- replacementObjectForArchiver:
(id)	- replacementObjectForCoder:
(id)	- replacementObjectForKeyedArchiver:
(BOOL)	- respondsToSelector:
(id)	- retain
(id)	- self
(void)	- setValue:forKey:
(void)	- setValue:forKeyPath:
(void)	- setValue:forUndefinedKey:
(void)	- setValuesForKeysWithDictionary:
(CPString)	- UID
(void)	- unbind:
(Class)	- valueClassForBinding:
(id)	- valueForKey:
(id)	- valueForKeyPath:
(id)	- valueForUndefinedKey:
(void)	- willChange:valuesAtIndexes:forKey:
(void)	- willChangeValueForKey:
(void)	- willChangeValueForKey:withSetMutation:usingObjects:

Class Methods
(void)	+ initialize
(CPDictionary)	+ menuBarAttributes
(CPImage)	+ menuBarIconImage
(CPString)	+ menuBarTitle
(BOOL)	+ menuBarVisible
(void)	+ popUpContextMenu:withEvent:forView:
(void)	+ popUpContextMenu:withEvent:forView:withFont:
(void)	+ setMenuBarAttributes:
(void)	+ setMenuBarIconImage:
(void)	+ setMenuBarTitle:
(void)	+ setMenuBarVisible:
(Function)	+ trackingCallbackWithCallback:
Class Methods inherited from CPObject
(BOOL)	+ accessInstanceVariablesDirectly
(id)	+ alloc
(id)	+ allocWithCoder:
(BOOL)	+ automaticallyNotifiesObserversForKey:
(Class)	+ class
(void)	+ exposeBinding:
(IMP)	+ instanceMethodForSelector:
(BOOL)	+ instancesRespondToSelector:
(BOOL)	+ isSubclassOfClass:
(CPSet)	+ keyPathsForValuesAffectingValueForKey:
(void)	+ load
(id)	+ new
(void)	+ setVersion:
(Class)	+ superclass
(int)	+ version

Additional Inherited Members
Instance Variables inherited from CPObject
Class	isa

Detailed Description

Menus provide the user with a list of actions and/or submenus. Submenus themselves are full fledged menus and so a hierarchical structure appears.

Definition at line 2 of file CPMenu.h.

Method Documentation

- (void) addItem: (CPMenuItem)  aMenuItem

implementation

Adds a menu item at the end of the menu.

Parameters

aMenuItem

the menu item to add

Definition at line 295 of file CPMenu.j.

- (CPMenuItem) addItemWithTitle: (CPString)  aTitle action: (SEL)  anAction keyEquivalent: (CPString)  aKeyEquivalent

implementation

Creates and adds a menu item with the specified attributes at the end of the menu.

Parameters

aTitle	the title of the new menu item
anAction	the action initiated when the user selects the item
aKeyEquivalent	the keyboard shortcut for the menu item

Returns

the new menu item

Definition at line 308 of file CPMenu.j.

- (BOOL) autoenablesItems

implementation

Returns YES if the menu auto enables items.

Definition at line 594 of file CPMenu.j.

- (void) awakeFromCib

implementation

Reimplemented from CPObject.

Definition at line 1040 of file CPMenu.j.

- (void) cancelTracking

implementation

Cancels tracking.

Definition at line 910 of file CPMenu.j.

- (CPUInteger) countOfItems

implementation

Provided by category CPMenu(CPKeyValueCoding).

Definition at line 1069 of file CPMenu.j.

- (id) delegate

implementation

Definition at line 885 of file CPMenu.j.

- (void) encodeWithCoder: (CPCoder)  aCoder

implementation

Encodes the data of the menu into a coder

Parameters

aCoder

the coder to which the data will be written

Provided by category CPMenu(CPCoding).

Definition at line 1160 of file CPMenu.j.

- (CPFont) font

implementation

Definition at line 947 of file CPMenu.j.

- (CPMenuItem) highlightedItem

implementation

Returns the currently highlighted menu item.

Returns

the highlighted menu item or nil if no item is currently highlighted

Definition at line 865 of file CPMenu.j.

- (int) indexOfItem: (CPMenuItem)  aMenuItem

implementation

Returns the index of the specified menu item

Parameters

aMenuItem

the item to find the index for

Returns

the item index or CPNotFound

Definition at line 433 of file CPMenu.j.

- (int) indexOfItemWithRepresentedObject: (id)  anObject

implementation

Returns the index of the menu item with the specified represented object.

Parameters

anObject

the represented object of the desired item

Returns

the index of the item or CPNotFound

Definition at line 502 of file CPMenu.j.

- (int) indexOfItemWithSubmenu: (CPMenu)  aMenu

implementation

Returns the index of the item with the specified submenu.

Parameters

the	submenu of the desired menu item

Returns

the index of the item or CPNotFound

Definition at line 519 of file CPMenu.j.

- (int) indexOfItemWithTag: (int)  aTag

implementation

Returns the index of the item with the specified tag

Parameters

aTag	the desired tag to match

Returns

the index of the item or CPNotFound

Definition at line 463 of file CPMenu.j.

- (int) indexOfItemWithTarget: (id)  aTarget andAction: (SEL)  anAction

implementation

Returns the index of the item with the specified target and action.

Parameters

aTarget	the target of the desired menu item
anAction	the action of the desired menu item

Returns

the index of the item or CPNotFound

Definition at line 481 of file CPMenu.j.

- (int) indexOfItemWithTitle: (CPString)  aTitle

implementation

Returns the index of the item with the specified title.

Parameters

aTitle

the desired title to match

Returns

the index of the item or CPNotFound

Definition at line 446 of file CPMenu.j.

- (id) init

implementation

Initializes the receiver

Returns

the initialized receiver

Reimplemented from CPObject.

Definition at line 258 of file CPMenu.j.

+ (void) initialize

implementation

Reimplemented from CPObject.

Definition at line 72 of file CPMenu.j.

- (id) initWithCoder: (CPCoder)  aCoder

implementation

Initializes the menu with data from the specified coder.

Parameters

aCoder

the coder from which to read the data

Returns

the initialized menu

Provided by category CPMenu(CPCoding).

Definition at line 1135 of file CPMenu.j.

- (id) initWithTitle: (CPString)  aTitle

implementation

Initializes the menu with a specified title.

Parameters

aTile

the menu title

Returns

the initialized menu

Definition at line 240 of file CPMenu.j.

- (void) insertItem: (CPMenuItem)  aMenuItem atIndex: (unsigned)  anIndex

implementation

Inserts a menu item at the specified index.

Parameters

aMenuItem	the item to insert
anIndex	the index in the menu to insert the item.

Definition at line 269 of file CPMenu.j.

- (CPMenuItem) insertItemWithTitle: (CPString)  aTitle action: (SEL)  anAction keyEquivalent: (CPString)  aKeyEquivalent atIndex: (unsigned)  anIndex

implementation

Creates and inserts a new menu item with the specified attributes.

Parameters

aTitle	the title of the menu item
anAction	the action initiated when the user selects the item
aKeyEquivalent	the keyboard shortcut for the item
anIndex	the index location in the menu for the new item

Returns

the new menu item

Definition at line 282 of file CPMenu.j.

- (void) insertObject: (CPMenuItem)  aMenuItem inItemsAtIndex: (CPUInteger)  anIndex

implementation

Provided by category CPMenu(CPKeyValueObserving).

Definition at line 1088 of file CPMenu.j.

- (BOOL) isTornOff

implementation

If there are two instances of this menu visible, return NO. Otherwise, return YES if we are a detached menu and visible.

Definition at line 576 of file CPMenu.j.

- (CPArray) itemArray

implementation

Returns the array of menu items backing this menu

Definition at line 422 of file CPMenu.j.

- (CPMenuItem) itemAtIndex: (int)  anIndex

implementation

Returns the menu item at the specified index

Parameters

anIndex

the index of the requested item

Definition at line 406 of file CPMenu.j.

- (void) itemChanged: (CPMenuItem)  aMenuItem

implementation

Called when a menu item has visually changed.

Parameters

aMenuItem

the item that changed

Definition at line 358 of file CPMenu.j.

- (CPArray) itemsAtIndexes: (CPIndexSet)  indexes

implementation

Provided by category CPMenu(CPKeyValueCoding).

Definition at line 1079 of file CPMenu.j.

- (CPMenuItem) itemWithTag: (int)  aTag

implementation

Returns the menu item with the specified tag

Parameters

the	tag of the desired menu item

Returns

the menu item or nil if a match was not found

Definition at line 377 of file CPMenu.j.

- (CPMenuItem) itemWithTitle: (CPString)  aTitle

implementation

Returns the menu item with the specified title.

Parameters

aTitle

the title of the menu item

Returns

the menu item or nil if a match was not found

Definition at line 392 of file CPMenu.j.

+ (CPDictionary) menuBarAttributes

implementation

Definition at line 210 of file CPMenu.j.

- (float) menuBarHeight

implementation

Definition at line 221 of file CPMenu.j.

+ (CPImage) menuBarIconImage

implementation

Definition at line 143 of file CPMenu.j.

+ (CPString) menuBarTitle

implementation

Definition at line 132 of file CPMenu.j.

+ (BOOL) menuBarVisible

implementation

Definition at line 80 of file CPMenu.j.

- (float) minimumWidth

implementation

Definition at line 653 of file CPMenu.j.

- (unsigned) numberOfItems

implementation

Returns the number of menu items in the menu

Definition at line 414 of file CPMenu.j.

- (CPMenuItem) objectInItemsAtIndex: (CPUInteger)  anIndex

implementation

Provided by category CPMenu(CPKeyValueCoding).

Definition at line 1074 of file CPMenu.j.

- (void) performActionForItemAtIndex: (unsigned)  anIndex

implementation

Sends the action of the menu item at the specified index.

Parameters

anIndex

the index of the item

Definition at line 996 of file CPMenu.j.

- (BOOL) performKeyEquivalent: (CPEvent)  anEvent

implementation

Initiates the action of the menu item that has a keyboard shortcut equivalent to anEvent

Parameters

anEvent

the keyboard event

Returns

YES if it was handled.

Definition at line 958 of file CPMenu.j.

+ (void) popUpContextMenu: (CPMenu)  aMenu withEvent: (CPEvent)  anEvent forView: (CPView)  aView

implementation

Definition at line 790 of file CPMenu.j.

+ (void) popUpContextMenu: (CPMenu)  aMenu withEvent: (CPEvent)  anEvent forView: (CPView)  aView withFont: (CPFont)  aFont

implementation

Definition at line 795 of file CPMenu.j.

- (void) popUpMenuPositioningItem: (CPMenuItem)  anItem atLocation: (CGPoint)  aLocation inView: (CPView)  aView callback: (Function)  aCallback

implementation

Definition at line 681 of file CPMenu.j.

- (void) removeAllItems

implementation

Removes all the menu items in the receiver. This method is more efficient than removing menu items individually.

Unlike the other remove methods, this method does not post CPMenuDidChangeItemNotification notifications.

Definition at line 337 of file CPMenu.j.

- (void) removeItem: (CPMenuItem)  aMenuItem

implementation

Removes the specified item from the menu

Parameters

aMenuItem

the item to remove

Definition at line 317 of file CPMenu.j.

- (void) removeItemAtIndex: (unsigned)  anIndex

implementation

Removes the item at the specified index from the menu

Parameters

anIndex

the index of the item to remove

Definition at line 326 of file CPMenu.j.

- (void) removeObjectFromItemsAtIndex: (CPUInteger)  anIndex

implementation

Provided by category CPMenu(CPKeyValueObserving).

Definition at line 1107 of file CPMenu.j.

- (void) setAutoenablesItems: (BOOL)  aFlag

implementation

Sets whether the menu automatically enables menu items.

Parameters

aFlag

YES sets the menu to automatically enable items.

Definition at line 586 of file CPMenu.j.

- (void) setDelegate: (id)  aDelegate

implementation

Definition at line 880 of file CPMenu.j.

- (void) setFont: (CPFont)  aFont

implementation

Definition at line 942 of file CPMenu.j.

+ (void) setMenuBarAttributes: (CPDictionary)  attributes

implementation

Definition at line 149 of file CPMenu.j.

+ (void) setMenuBarIconImage: (CPImage)  anImage

implementation

Definition at line 137 of file CPMenu.j.

+ (void) setMenuBarTitle: (CPString)  aTitle

implementation

Definition at line 126 of file CPMenu.j.

+ (void) setMenuBarVisible: (BOOL)  menuBarShouldBeVisible

implementation

Definition at line 85 of file CPMenu.j.

- (void) setMinimumWidth: (float)  aMinimumWidth

implementation

Definition at line 648 of file CPMenu.j.

- (void) setShowsStateColumn: (BOOL)  shouldShowStateColumn

implementation

Sets whether to show the state column

Parameters

shouldShowStateColumn

YES shows the state column

Definition at line 847 of file CPMenu.j.

- (void) setSubmenu: (CPMenu)  aMenu forItem: (CPMenuItem)  aMenuItem

implementation

Sets a submenu for a menu item

Parameters

aMenu	the submenu
aMenuItem	the menu item to set the submenu on

Definition at line 537 of file CPMenu.j.

- (void) setSupermenu: (CPMenu)  aMenu

implementation

Sets the super menu.

Parameters

aMenu

the new super menu

Definition at line 567 of file CPMenu.j.

- (void) setTitle: (CPString)  aTitle

implementation

Sets the menu title.

Parameters

the

new title

Definition at line 635 of file CPMenu.j.

- (BOOL) showsStateColumn

implementation

Returns YES if the menu shows the state column

Definition at line 855 of file CPMenu.j.

- (void) submenuAction: (id)  aSender

implementation

The action method of menu items that open submenus. The default implementation does nothing, but it may be subclassed to provide different behavior.

Parameters

aSender

the object that sent the message

Definition at line 551 of file CPMenu.j.

- (CPMenu) supermenu

implementation

Returns the super menu or nil if there is none.

Definition at line 558 of file CPMenu.j.

- (CPString) title

implementation

Returns the menu title

Definition at line 643 of file CPMenu.j.

+ (Function) trackingCallbackWithCallback: (Function)  aCallback

implementation

Definition at line 774 of file CPMenu.j.

- (void) update

implementation

Enables or disables the receiver’s menu items. If the target does not implement the menu item's action method the item is disabled. If the target responsds to selector validateMenuItem: or validateUserInterfaceItem: (in that order) the return value is used.

Definition at line 604 of file CPMenu.j.

---

The documentation for this class was generated from the following files:

• AppKit/CPMenu/CPMenu.h
• AppKit/CPMenu/CPMenu.j