| Inherits from | |
| Conforms to | |
| Framework | /System/Library/Frameworks/UIKit.framework |
| Availability | Available in iPhone OS 3.0 and later. |
| Declared in | UIMenuController.h |
| Related sample code |
The singleton UIMenuController instance presents the menu interface for the Cut, Copy, Paste, and Select commands.
This menu is referred to as the editing menu. When you make this menu visible, UIMenuController positions it relative to a target rectangle on the screen; this rectangle usually defines a selection. The menu appears above the target rectangle or, if there is not enough space for it, below it. The menu’s pointer is placed at the center of the top or bottom of the target rectangle, as appropriate. Be sure to set the tracking rectangle before you make the menu visible. You are also responsible for detecting, tracking, and displaying selections.
The UIResponderStandardEditActions informal protocol declares methods that are invoked when the user taps a menu command. The canPerformAction:withSender: method of UIResponder is also related to the editing menu. A responder implements this method to enable and disable commands of the editing menu just before the menu is displayed. You can force this updating of menu commands’ enabled state by calling the update method.
menuVisible property
– setMenuVisible:animated:
– setTargetRect:inView:
menuFrame property
For more about Objective-C properties, see “Properties” in The Objective-C Programming Language.
Returns the frame of the editing menu. (read-only)
@property(nonatomic, readonly) CGRect menuFrame
The property value is the bounding rectangle of the menu in screen coordinates. The property holds a value even if the menu is not visible. You can use this property to adjust any user-interface objects away from the menu.
UIMenuController.hThe visibility of the editing menu.
@property(nonatomic, getter=isMenuVisible) BOOL menuVisible
Setting this property displays or hides the menu immediately, without animation. For animating the showing or hiding of the menu, use the setMenuVisible:animated: method. Before showing the menu, be sure to position it relative to the selection.
UIMenuController.hReturns the menu controller.
+ (UIMenuController *)sharedMenuController
The shared NSMenuController instance.
UIMenuController.hShows or hides the editing menu, optionally animating the action.
- (void)setMenuVisible:(BOOL)menuVisibleanimated:(BOOL)animated
YES if the menu should be shown, NO if it should be hidden.
YES if the showing or hiding of the menu should be animated, otherwise NO.
Before showing the menu, be sure to position it relative to the selection. See setTargetRect:inView: for details. If you do not set the target rect before displaying the menu, it appears at screen coordinates (0.0, 0.0).
UIMenuController.hSets the area in a view above or below which the editing menu is positioned.
- (void)setTargetRect:(CGRect)targetRect inView:(UIView *)targetView
A rectangle that defines the area that is to be the target of the menu commands.
The view in which targetRect appears.
This target rectangle (targetRect) is usually the bounding rectangle of a selection. UIMenuController positions the editing menu above this rectangle; if there is not enough space for the menu there, it positions it below the rectangle. The menu’s pointer is placed at the center of the top or bottom of the target rectangle as appropriate. Note that if you make the width or height of the target rectangle zero, UIMenuController treats the target area as a line or point for positioning (for example, an insertion caret or a single point).
Once it is set, the target rectangle does not track the view; if the view moves (such as would happen in a scroll view), you must update the target rectangle accordingly.
UIMenuController.hUpdates the enabled state of menu commands
- (void)update
By default, UIMenuController calls this method just before the editing menu is made visible and when touches occur in the menu. As a result, a responder object in the application enables or disables menu commands depending on the context; for example, if the pasteboard holds no data of a compatible type, the Paste command would be disabled. You can call this method to force an update of the editing menu. You may also override this method to add any custom behavior.
UIMenuController.hPosted by the menu controller just before it shows the menu.
There is no userInfo dictionary.
UIMenuController.hPosted by the menu controller just after it shows the menu.
There is no userInfo dictionary.
UIMenuController.hPosted by the menu controller just before it hides the menu.
There is no userInfo dictionary.
UIMenuController.hPosted by the menu controller just after it hides the menu.
There is no userInfo dictionary.
UIMenuController.hPosted when the frame of a visible menu changes.
There is no userInfo dictionary.
UIMenuController.hLast updated: 2009-05-19
iPhone OS Reference Library Data Management: Event Handling UIMenuController Class Reference