Results of 0 - 1 of about 0 (0.000 sec.)
- NSControl.html
- @digest: 5b8bca7268f5c8275d484c6a4a0e2c71
- @id: 63140
- @mdate: 2001-10-09T15:05:58Z
- @size: 15952
- @type: text/html
- #keywords: nscontrol (106698), nscell (51474), mycellsubclass (49391), acell (34896), setcellclass (32704), cellclass (30804), mystoredcellclass (29523), anotification (29217), nssliders (28429), nscontrols (26885), sendaction (26586), nsslider (20271), nsslidercell (16802), trackmouse (15880), untilmouseup (15272), nsactioncell (11453), initwithframe (11083), nsapplication (10328), subclass (9277), delegate (9018), mousedown (7031), nsnotification (6959), nswindow (6849), nsresponder (6725), responder (6488), cell (4633), sender (4407), control (3008), subclasses (2542), selected (2510), nsobject (2461), notification (2451)
- Return to the Alphabetic Index Return to the Class Browser Return to the Picture Browser Copyright (c) 1994 by NeXT Computer, Inc. All Rights Reserved. NSControl Inherits From: NSView : NSResponder : NSObject Conforms To: NSCoding (NSResponder) NSObject (NSObject) Declared In: AppKit/NSControl.h Class Description NSControl is an abstract superclass that provides three fundamental features for implementing user interface devices. First, as a subclass of NSView, NSControl allows the on-screen representation of the device to be drawn. Second, it receives and responds to user-generated events within its bounds by overriding NSResponder's mouseDown: method and providing a position in the responder chain. Third, it implements the sendAction:to: method to send an action message to the NSControl's target object. Subclasses of NSControl defined in the Application Kit are NSBrowser, NSButton (and its subclass NSPopUpButton), NSColorWell, NSMatrix (and its subclass NSForm), NSScroller, NSSlider, and NSTextField. Target and Action Target objects and action methods provide the mechanism by which NSControls interact with other objects in an application. A target is an object that an NSControl has effect over. The target class defines an action method to enable its instances to respond to user input. An action method takes only one argument: the id of the sender. The sender may be either the NSControl that sends the action message or another object that the target should treat as the sender. When it receives an action message, a target can return messages to the sender requesting additional information about its status. NSControl's sendAction:to: asks the NSApplication object, NSApp, to send an action message to the NSControl's target object. The method used for this is NSApplication's sendAction:to:from: . You can also set the target to nil and allow it to be determined at run time. When the target is nil , the NSApplication object must look for an appropriate receiver. It conducts its search in a prescribed order, by following the responder chain until it finds an object that can respond to the message: . It begins with the first responder in the key window and follows nextResponder links up the responder chain to the NSWindow object. After the NSWindow object, it tries the NSWindow's delegate. . If the main window is different from the key window, it then starts over with the first responder in the main window and works its way up the main window's responder chain to the NSWindow object and its delegate. . Next, it tries to respond itself. If the NSApplication object can't respond, it tries its own delegate. NSApp and its delegate are the receivers of last resort. NSControl provides methods for setting and using the target object and the action method. However, these methods require that an NSControl have an associated subclass of NSCell that provides a target and an action, such as NSActionCell and its subclasses. Target objects and action methods demonstrate the close relationship between NSControls and NSCells. In most cases, a user interface device consists of an instance of an NSControl subclass paired with one or more instances of an NSCell subclass. Each implements specific details of the user interface mechanism. For example, NSControl's mouseDown: method sends a trackMouse:inRect:ofView:untilMouseUp: message to an NSCell, which handles subsequent mouse and keyboard events; an NSCell sends an NSControl a sendAction:to: message in response to particular events. NSControl's drawRect: method is implemented by sending a drawWithFrame:inView: message to the NSCell. As another example, NSControl provides methods for setting and formatting its contents; these methods send corresponding messages to NSCell, which actually owns the contents. See the NSActionCell class specification for more on the implementation of target and action behavior. Changing the NSCell Class Since NSControl uses the NSCell class to implement most of its actual functionality, you can usually implement a unique user interface device by creating a subclass of NSCell rather than NSControl. As an example, let's say you want all your application's NSSliders to have a type of cell other than the generic NSSliderCell. First, you create a subclass of NSCell, NSActionCell, or NSSliderCell. (Let's call it MyCellSubclass.) Then, you can simply invoke NSSlider's setCellClass: class method: [NSSlider setCellClass:[MyCellSubclass class]]; All NSSliders created thereafter will use MyCellSubclass, until you call setCellClass: again. If you want to create generic NSSliders (ones that use NSSliderCell) in the same application as the customized NSSliders that use MyCellSubclass, there are two possible approaches. One is to invoke setCellClass: as above whenever you're about to create a custom NSSlider, resetting the cell class to NSSliderCell afterwards. The other approach is to create a custom subclass of NSSlider that automatically uses MyCellSubclass, as explained below. Creating New NSControls If you create a custom NSControl subclass that uses a custom subclass of NSCell, you should override NSControl 's cellClass method: + (Class) cellClass { return [MyCellSubclass class]; } NSControl's initWithFrame: method will use the return value of cellClass to allocate and initialize an NSCell of the correct type. If you want to be able to change the type of cell that your subclass uses (without changing the type that its superclass uses), override setCellClass: to store the NSCell subclass in a global variable, and modify cellClass to return that variable: static id myStoredCellClass; + setCellClass:classId { myStoredCellClass = classId; } + (Class) cellClass { return (myStoredCellClass ? myStoredCellClass : [MyCellSubclass class]); } An NSControl subclass doesn't have to use an NSCell subclass to implement itself; NSScroller and NSColorWell are examples of NSControls that don't. However, such subclasses have to take care of details that NSCell would otherwise handle. Specifically, they have to override methods designed to work with an NSCell. What's more, the lack of an NSCell means you can't make use of NSMatrixa subclass of NSControl designed specifically for managing multi-cell arrays such as radio buttons. Override the designated initializer ( initWithFrame: ) if you create a subclass of NSControl that performs its own initialization. Initializing an NSControl Object - (id) initWithFrame: (NSRect) frameRect Initializes a new NSControl object in frameRect , and attempts to create a corresponding NSCell. Setting the Control's Cell + (Class) cellClass Returns nil ; overridden by subclasses. + (void) setCellClass: (Class) factoryId Implemented by subclasses to set the NSCell class used. - (id) cell Returns the control's NSCell. - (void) setCell: (NSCell *) aCell Sets the control's NSCell to aCell . Enabling and Disabling the Control - (BOOL) isEnabled Returns whether the control reacts to mouse events. - (void) setEnabled: (BOOL) flag Sets whether the control reacts to mouse events. Identifying the Selected Cell - (id) selectedCell Returns the control's selected NSCell. - (int) selectedTag Returns the tag of the control's selected cell. Setting the Control's Value - (double) doubleValue Returns the value of the control's selected cell as a double . - (float) floatValue Returns the value of the control's selected cell as a float . - (int) intValue Returns the value of the control's selected cell as a int . - (void) setDoubleValue: (double) aDouble Sets the value of the control's selected cell to aDouble . - (void) setFloatValue: (float) aFloat Sets the value of the control's selected cell to aFloat . - (void) setIntValue: (int) anInt Sets the value of the control's selected cell to anInt . - (void) setNeedsDisplay Set the NeedsDisplay flag. - (void) setStringValue: (NSString *) aString Sets the value of the control's selected cell to aString . - (NSString *) stringValue Returns the value of the control's selected cell as an NSString. Interacting with Other Controls - (void) takeDoubleValueFrom: (id) sender Sets the receiving NSControl's selected cell to the value obtained by sending a doubleValue message to sender . - (void) takeFloatValueFrom: (id) sender Sets the receiving NSControl's selected cell to the value obtained by sending a floatValue message to sender . - (void) takeIntValueFrom: (id) sender Sets the receiving NSControl's selected cell to the value obtained by sending a intValue message to sender . - (void) takeStringValueFrom: (id) sender Sets the receiving NSControl's selected cell to the value obtained by sending a stringValue message to sender . Formatting Text - (NSTextAlignment) alignment Returns the alignment of text in the control's cell. - (NSFont *) font Returns the Font used to draw text in the control's cell. - (void) setAlignment: (NSTextAlignment) mode Sets the alignment mode of the text in the control's cell to mode . - (void) setFont: (NSFont *) fontObject Sets the Font used to draw text in the control's cell to fontObject . - (void) setFloatingPointFormat: (BOOL) autoRange Sets the display format for floating point values in the left: (unsigned) leftDigits control's cell right: (unsigned) rightDigits Managing the Field Editor - (BOOL) abortEditing Aborts editing of text displayed by the NSControl. - (NSText *) currentEditor Returns the object used to edit text in the control. - (void) validateEditing Validates the user's changes to editable text. Resizing the Control - (void) calcSize Recalculates internal size information. - (void) sizeToFit Resizes the control to fit its cell. Displaying the Control and Cell - (void) drawCell: (NSCell *) aCell Redraws aCell if it's the control's cell. - (void) drawCellInside: (NSCell *) aCell Redraws aCell 's inside if it's the control's cell. - (void) selectCell: (NSCell *) aCell Selects aCell if it's the control's cell. - (void) updateCell: (NSCell *) aCell Redisplays aCell or marks it for redisplay. - (void) updateCellInside: (NSCell *) aCell Redisplays the inside of aCell or marks it for redisplay. Target and Action - (SEL) action Returns the NSControl's action method. - (BOOL) isContinuous Returns whether the control's NSCell continuously sends its action. - (BOOL) sendAction: (SEL) theAction Has the NSApplication object send theAction to theTarget . to: (id) theTarget - (int) sendActionOn: (int) mask Determines when the action is sent while tracking. - (void) setAction: (SEL) aSelector Sets the NSControl's action method to aSelector . - (void) setContinuous: (BOOL) flag Sets whether the control's NSCell continuously sends its action. - (void) setTarget: (id) anObject Sets the NSControl's target object to anObject . - (id) target Returns the NSControl's target object. Assigning a Tag - (void) setTag: (int) anInt Sets the tag of the control's NSCell to anInt . - (int) tag Returns the tag of the control's NSCell. Tracking the Mouse - (void) mouseDown: (NSEvent *) theEvent Invoked when the mouse button goes down while the cursor is within the bounds of the NSControl. This method highlights the NSControl's NSCell and sends it a trackMouse:inRect:ofView:untilMouseUp: message. Whenever the NSCell finishes tracking the mouse (for example, because the cursor has left the cell's bounds), the cell is unhighlighted. If the mouse button is still down and the cursor reenters the bounds, the cell is again highlighted and a new trackMouse:inRect:ofView:untilMouseUp: message is sent. This behavior repeats until the mouse button goes up. - (BOOL) ignoresMultiClick Indicates whether multiple clicks are ignored. - (void) setIgnoresMultiClick :(BOOL) flag Sets whether multiple clicks are ignored, according to flag . Methods Implemented by the Delegate NSControl itself doesn't have a delegate. These delegate methods are declared in NSControl.h but are intended for subclasses, such as NSTextField and NSMatrix, that do have delegates and that allow text editing. - (BOOL) control: (NSControl *) control Sent directly by control to the delegate; returns YES if the textShouldBeginEditing: (NSText *) fieldEditor NSControl should be allowed to start editing the text. - (BOOL) control: (NSControl *) control Sent directly by control to the delegate; returns YES if the textShouldEndEditing: (NSText *) fieldEditor NSControl should be allowed to end its edit session. - (void) controlTextDidBeginEditing: (NSNotification *) aNotification Sent by the default notification center to the delegate; aNotification is always NSControlTextDidBeginEditingNotification. If the delegate implements this method, it's automatically registered to receive this notification. - (void) controlTextDidEndEditing: (NSNotification *) aNotification Sent by the default notification center to the delegate; aNotification is always NSControlTextDidEndEditingNotification. If the delegate implements this method, it's automatically registered to receive this notification. - (void) controlTextDidChange: (NSNotification *) aNotification Sent by the default notification center to the delegate; aNotification is always NSControlTextDidChangeNotification. If the delegate implements this method, it's automatically registered to receive this notification.
...
-
http://www.gnu.org/savannah-checkouts/gnu/gnustep/resources/OpenStepSpec/ApplicationKit/Classes/NSControl.html
- [detail]
- [similar]
PREV
NEXT