-- Richard Frith-Macdonald
+
Authors
+
+- Richard Frith-Macdonald
-
- James Dessart
-
+
- Nicola Pero
+
-
-Version: 0.2
-Date: 8 April, 2000
-
-
-Declared in: Gui/NSView.h
-Inherits from: NSResponder
-Conforms to: NSCoding
+
Version: 0.3
+Date: 24 November, 2000
+
+
+Declared in: Gui/NSView.h
+Inherits from: NSResponder
+Conforms to: NSCoding
@@ -40,179 +42,184 @@ Subclasses can override drawRect: in order to implement their
user generated events.
+Instance Variables
-
-
-+ (NSMenu*) defaultMenu
+Methods
+
+
Class Methods
+
++ (NSMenu*) defaultMenu;
As of yet, unimplemented.
-
-
-+ (NSView*) focusView
+
+
++ (NSView*) focusView;
Returns the view which currently has the focus.
-
-
-- (BOOL) acceptsFirstMouse: (NSEvent*)theEvent
+
+
Instances Methods
+
+- (BOOL) acceptsFirstMouse: (NSEvent*)theEvent;
Returns YES if the view object will accept the first click
received when in an inactive window, and NO otherwise.
-
-
-- (void) addCursorRect: (NSRect)aRect cursor: (NSCursor*)aCursor
+
+
+- (void) addCursorRect: (NSRect)aRect cursor: (NSCursor*)aCursor;
-
-
-- (void) addSubview: (NSView*)aView
+
+
+- (void) addSubview: (NSView*)aView;
@@ -220,44 +227,44 @@ Returns YES if the view object will accept the first click
-
-
-- (void) addSubview: (NSView*)aView positioned: (NSWindowOrderingMode)place relativeTo: (NSView*)otherView
+
+
+- (void) addSubview: (NSView*)aView positioned: (NSWindowOrderingMode)place relativeTo: (NSView*)otherView;
-
-
-- (void) addToPageSetup
+
+
+- (void) addToPageSetup;
-
-
-- (NSTrackingRectTag) addTrackingRect: (NSRect)aRect owner: (id)anObject userData: (void*)userData assumeInside: (BOOL)flag
+
+
+- (NSTrackingRectTag) addTrackingRect: (NSRect)aRect owner: (id)anObject userData: (void*)userData assumeInside: (BOOL)flag;
-
-
-- (void) adjustPageHeightNew: (float*)newBottom top: (float)top bottom: (float)proposedBottom
+
+
+- (void) adjustPageHeightNew: (float*)newBottom top: (float)top bottom: (float)proposedBottom;
-
-
-- (void) adjustPageWidthNew: (float*)newRight left: (float)left right: (float)proposedRight
+
+
+- (void) adjustPageWidthNew: (float*)newRight left: (float)left right: (float)proposedRight;
-
-
-- (NSRect) adjustScroll: (NSRect)proposedVisibleRect
+
+
+- (NSRect) adjustScroll: (NSRect)proposedVisibleRect;
-
-
-- (void) allocateGState
+
+
+- (void) allocateGState;
-
-
-- (NSView*) ancestorSharedWithView: (NSView*)aView
+
+
+- (NSView*) ancestorSharedWithView: (NSView*)aView;
@@ -268,248 +275,266 @@ Returns YES if the view object will accept the first click
-
-
-- (BOOL) autoresizesSubviews
+
+
+- (BOOL) autoresizesSubviews;
-
-
-- (unsigned int) autoresizingMask
+
+
+- (unsigned int) autoresizingMask;
-
-
-- (BOOL) autoscroll: (NSEvent*)theEvent
+
+
+- (BOOL) autoscroll: (NSEvent*)theEvent;
-
-
-- (void) beginPage: (int)ordinalNum label: (NSString *)aString bBox: (NSRect)pageRect
+
+
+- (void) beginPage: (int)ordinalNum label: (NSString *)aString bBox: (NSRect)pageRect;
-
-
-- (void) beginPageSetupRect: (NSRect)aRect placement: (NSPoint)location
+
+
+- (void) beginPageSetupRect: (NSRect)aRect placement: (NSPoint)location;
-
-
-- (void) beginPrologueBBox: (NSRect)boundingBox creationDate: (NSString*)dateCreated createdBy: (NSString *)anApplication fonts: (NSString*)fontNames forWhom: (NSString *)user pages: (int)numPages
+
+
+- (void) beginPrologueBBox: (NSRect)boundingBox creationDate: (NSString*)dateCreated createdBy: (NSString *)anApplication fonts: (NSString*)fontNames forWhom: (NSString *)user pages: (int)numPages;
-
-
-- (void) beginSetup
+
+
+- (void) beginSetup;
-
-
-- (void) beginTrailer
+
+
+- (void) beginTrailer;
-
-
-- (NSRect) bounds
+
+
+- (NSRect) bounds;
-
-
-- (float) boundsRotation
+
+
+- (float) boundsRotation;
-
-
-- (BOOL) canDraw
+
+
+- (BOOL) canDraw;
-
-
-- (NSRect) centerScanRect: (NSRect)aRect
+
+
+- (NSRect) centerScanRect: (NSRect)aRect;
-
-
-- (NSPoint) convertPoint: (NSPoint)aPoint fromView: (NSView*)aView
+
+
+- (NSPoint) convertPoint: (NSPoint)aPoint fromView: (NSView*)aView;
-
-
-- (NSPoint) convertPoint: (NSPoint)aPoint
+
+
+- (NSPoint) convertPoint: (NSPoint)aPoint;
-
-
-- (NSRect) convertRect: (NSRect)aRect fromView: (NSView*)aView
+
+
+- (NSRect) convertRect: (NSRect)aRect fromView: (NSView*)aView;
-
-
-- (NSRect) convertRect: (NSRect)aRect toView: (NSView*)aView
+
+
+- (NSRect) convertRect: (NSRect)aRect toView: (NSView*)aView;
-
-
-- (NSSize) convertSize: (NSSize)aSize fromView: (NSView*)aView
+
+
+- (NSSize) convertSize: (NSSize)aSize fromView: (NSView*)aView;
-
-
-- (NSSize) convertSize: (NSSize)aSize toView: (NSView*)aView
+
+
+- (NSSize) convertSize: (NSSize)aSize toView: (NSView*)aView;
-
-
-- (NSData*) dataWithEPSInsideRect: (NSRect)aRect
+
+
+- (NSData*) dataWithEPSInsideRect: (NSRect)aRect;
-
-
-- (void) discardCursorRects
+
+
+- (void) discardCursorRects;
-
-
-- (void) display
+
+
+- (void) display;
-
-
-- (void) displayIfNeeded
+
+
+- (void) displayIfNeeded;
-
-
-- (void) displayIfNeededIgnoringOpacity
+
+
+- (void) displayIfNeededIgnoringOpacity;
-
-
-- (void) displayIfNeededInRect: (NSRect)aRect
+
+
+- (void) displayIfNeededInRect: (NSRect)aRect;
-
-
-- (void) displayIfNeededInRectIgnoringOpacity: (NSRect)aRect
+
+
+- (void) displayIfNeededInRectIgnoringOpacity: (NSRect)aRect;
-
-
-- (void) displayRect: (NSRect)aRect
+
+
+- (void) displayRect: (NSRect)aRect;
-
-
-- (void) displayRectIgnoringOpacity: (NSRect)aRect
+
+
+- (void) displayRectIgnoringOpacity: (NSRect)aRect;
-
-
-- (BOOL) dragFile: (NSString*)fullPath fromRect: (NSRect)aRect slideBack: (BOOL)slideBack
+
+
+- (BOOL) dragFile: (NSString*)fullPath fromRect: (NSRect)aRect slideBack: (BOOL)slideBack;
-
-
-- (void) dragImage: (NSImage*)anImage at: (NSPoint)imageLoc offset: (NSSize)mouseOffset event: (NSEvent *)theEvent pasteboard: (NSPasteboard*)pboard source: (id)sourceObject slideBack: (BOOL)slideBack
+
+
+- (void) dragImage: (NSImage*)anImage at: (NSPoint)imageLoc offset: (NSSize)mouseOffset event: (NSEvent *)theEvent pasteboard: (NSPasteboard*)pboard source: (id)sourceObject slideBack: (BOOL)slideBack;
-
-
-- (void) drawPageBorderWithSize: (NSSize)borderSize
+
+
+- (void) drawPageBorderWithSize: (NSSize)borderSize;
-
-
-- (void) drawRect: (NSRect)aRect
+
+
+- (void) drawRect: (NSRect)aRect;
+
+ This method is invoked to handle drawing inside the view.
+ The default NSView's implementation does nothing;
+ subclasses might override it to draw something inside the
+ view. Since NSView's implementation is guaranteed to be
+ empty, you should not call super's implementation when you
+ override it in subclasses. drawRect: is invoked when the
+ focus has already been locked on the view; you can use
+ arbitrary postscript functions in drawRect: to draw inside
+ your view; the coordinate system in which you draw is the
+ view's own coordinate system (this means for example that
+ you should refer to the rectangle covered by the view
+ using its bounds, and not its frame). The argument of
+ drawRect: is the rectangle which needs to be redrawn. In
+ a lossy implementation, you can ignore the argument and
+ redraw the whole view; if you are aiming at performance,
+ you may want to redraw only what is inside the rectangle
+ which needs to be redrawn; this usually improves drawing
+ performance considerably.
+
+
+
+- (void) drawSheetBorderWithSize: (NSSize)borderSize;
-
-
-- (void) drawSheetBorderWithSize: (NSSize)borderSize
+
+
+- (NSScrollView*) enclosingScrollView;
-
-
-- (NSScrollView*) enclosingScrollView
+
+
+- (void) endHeaderComments;
-
-
-- (void) endHeaderComments
+
+
+- (void) endPage;
-
-
-- (void) endPage
+
+
+- (void) endPageSetup;
-
-
-- (void) endPageSetup
+
+
+- (void) endPrologue;
-
-
-- (void) endPrologue
+
+
+- (void) endSetup;
-
-
-- (void) endSetup
+
+
+- (void) endTrailer;
-
-
-- (void) endTrailer
+
+
+- (void) fax: (id)sender;
-
-
-- (void) fax: (id)sender
+
+
+- (NSRect) frame;
-
-
-- (NSRect) frame
+
+
+- (float) frameRotation;
-
-
-- (float) frameRotation
+
+
+- (int) gState;
-
-
-- (int) gState
+
+
+- (float) heightAdjustLimit;
-
-
-- (float) heightAdjustLimit
-
-
-
-
-- (NSView*) hitTest: (NSPoint)aPoint
+
+
+- (NSView*) hitTest: (NSPoint)aPoint;
Returns the subview, lowest in the receiver's hierarchy, which contains
aPoint
-
-
-- (id) initWithFrame: (NSRect)frameRect
+
+
+- (id) initWithFrame: (NSRect)frameRect;
-
-
-- (NSInterfaceStyle) interfaceStyle
+
+
+- (NSInterfaceStyle) interfaceStyle;
-
-
-- (BOOL) isDescendantOf: (NSView*)aView
+
+
+- (BOOL) isDescendantOf: (NSView*)aView;
@@ -517,150 +542,150 @@ Returns the subview, lowest in the receiver's hierarchy, which contains
-
-
-- (BOOL) isFlipped
+
+
+- (BOOL) isFlipped;
-
-
-- (BOOL) isOpaque
+
+
+- (BOOL) isOpaque;
-
-
-- (BOOL) isRotatedFromBase
+
+
+- (BOOL) isRotatedFromBase;
-
-
-- (BOOL) isRotatedOrScaledFromBase
+
+
+- (BOOL) isRotatedOrScaledFromBase;
-
-
-- (BOOL) knowsPageRange: (NSRangePointer)range
+
+
+- (BOOL) knowsPageRange: (NSRangePointer)range;
-
-
-- (BOOL) knowsPagesFirst: (int*)firstPageNum
+
+
+- (BOOL) knowsPagesFirst: (int*)firstPageNum;
-
-
-- (NSPoint) locationOfPrintRect: (NSRect)aRect
+
+
+- (NSPoint) locationOfPrintRect: (NSRect)aRect;
-
-
-- (void) lockFocus
+
+
+- (void) lockFocus;
-
-
-- (NSMenu*) menuForEvent: (NSEvent*)theEvent
+
+
+- (NSMenu*) menuForEvent: (NSEvent*)theEvent;
As of yet, unimplemented.
-
-
-- (BOOL) mouse: (NSPoint)aPoint inRect: (NSRect)aRect
+
+
+- (BOOL) mouse: (NSPoint)aPoint inRect: (NSRect)aRect;
Returns whether or not aPoint lies within aRect.
-
-
-- (BOOL) needsDisplay
+
+
+- (BOOL) needsDisplay;
-
-
-- (BOOL) needsPanelToBecomeKey
+
+
+- (BOOL) needsPanelToBecomeKey;
-
-
-- (NSView*) nextKeyView
+
+
+- (NSView*) nextKeyView;
-
-
-- (NSView*) nextValidKeyView
+
+
+- (NSView*) nextValidKeyView;
-
-
-- (NSView*) opaqueAncestor
+
+
+- (NSView*) opaqueAncestor;
-
-
-- (BOOL) performKeyEquivalent: (NSEvent*)theEvent
+
+
+- (BOOL) performKeyEquivalent: (NSEvent*)theEvent;
-
-
-- (BOOL) performMnemonic: (NSString*)aString
+
+
+- (BOOL) performMnemonic: (NSString*)aString;
-
-
-- (BOOL) postsBoundsChangedNotifications
+
+
+- (BOOL) postsBoundsChangedNotifications;
-
-
-- (BOOL) postsFrameChangedNotifications
+
+
+- (BOOL) postsFrameChangedNotifications;
-
-
-- (NSView*) previousKeyView
+
+
+- (NSView*) previousKeyView;
-
-
-- (NSView*) previousValidKeyView
+
+
+- (NSView*) previousValidKeyView;
-
-
-- (void) print: (id)sender
+
+
+- (void) print: (id)sender;
-
-
-- (NSRect) rectForPage: (int)pageNumber
+
+
+- (NSRect) rectForPage: (int)pageNumber;
-
-
-- (void) reflectScrolledClipView: (NSClipView*)aClipView
+
+
+- (void) reflectScrolledClipView: (NSClipView*)aClipView;
-
-
-- (void) registerForDraggedTypes: (NSArray*)pboardTypes
+
+
+- (void) registerForDraggedTypes: (NSArray*)pboardTypes;
-
-
-- (void) releaseGState
+
+
+- (void) releaseGState;
-
-
-- (void) removeCursorRect: (NSRect)aRect cursor: (NSCursor*)aCursor
+
+
+- (void) removeCursorRect: (NSRect)aRect cursor: (NSCursor*)aCursor;
-
-
-- (void) removeFromSuperview
+
+
+- (void) removeFromSuperview;
@@ -677,9 +702,9 @@ Returns whether or not aPoint lies within aRect.
-
-
-- (void) removeFromSuperviewWithoutNeedingDisplay
+
+
+- (void) removeFromSuperviewWithoutNeedingDisplay;
@@ -688,10 +713,10 @@ Returns whether or not aPoint lies within aRect.
-
-
-- (void) removeSubview: (NSView*)aView
-Standards: NotMacOS-X NotOpenStep
+
+
+- (void) removeSubview: (NSView*)aView;
+Standards: NotMacOS-X NotOpenStep
@@ -707,19 +732,19 @@ Standards: NotMacOS-X NotOpenStep
-
-
-- (void) removeTrackingRect: (NSTrackingRectTag)aTag
+
+
+- (void) removeTrackingRect: (NSTrackingRectTag)aTag;
-
-
-- (void) renewGState
+
+
+- (void) renewGState;
-
-
-- (void) replaceSubview: (NSView*)oldView with: (NSView*)newView
+
+
+- (void) replaceSubview: (NSView*)oldView with: (NSView*)newView;
@@ -727,226 +752,226 @@ Standards: NotMacOS-X NotOpenStep
-
-
-- (void) resetCursorRects
+
+
+- (void) resetCursorRects;
-
-
-- (void) resizeSubviewsWithOldSize: (NSSize)oldFrameSize
+
+
+- (void) resizeSubviewsWithOldSize: (NSSize)oldFrameSize;
-
-
-- (void) resizeWithOldSuperviewSize: (NSSize)oldFrameSize
+
+
+- (void) resizeWithOldSuperviewSize: (NSSize)oldFrameSize;
-
-
-- (void) rotateByAngle: (float)angle
+
+
+- (void) rotateByAngle: (float)angle;
-
-
-- (void) scaleUnitSquareToSize: (NSSize)newUnitSize
+
+
+- (void) scaleUnitSquareToSize: (NSSize)newUnitSize;
-
-
-- (void) scrollClipView: (NSClipView*)aClipView
+
+
+- (void) scrollClipView: (NSClipView*)aClipView;
-
-
-- (void) scrollPoint: (NSPoint)aPoint
+
+
+- (void) scrollPoint: (NSPoint)aPoint;
-
-
-- (void) scrollRect: (NSRect)aRect
+
+
+- (void) scrollRect: (NSRect)aRect;
-
-
-- (BOOL) scrollRectToVisible: (NSRect)aRect
+
+
+- (BOOL) scrollRectToVisible: (NSRect)aRect;
-
-
-- (void) setAutoresizesSubviews: (BOOL)flag
+
+
+- (void) setAutoresizesSubviews: (BOOL)flag;
-
-
-- (void) setAutoresizingMask: (unsigned int)mask
+
+
+- (void) setAutoresizingMask: (unsigned int)mask;
-
-
-- (void) setBounds: (NSRect)boundsRect
+
+
+- (void) setBounds: (NSRect)boundsRect;
-
-
-- (void) setBoundsOrigin: (NSPoint)newOrigin
+
+
+- (void) setBoundsOrigin: (NSPoint)newOrigin;
-
-
-- (void) setBoundsRotation: (float)angle
+
+
+- (void) setBoundsRotation: (float)angle;
-
-
-- (void) setBoundsSize: (NSSize)newSize
+
+
+- (void) setBoundsSize: (NSSize)newSize;
-
-
-- (void) setFrame: (NSRect)frameRect
+
+
+- (void) setFrame: (NSRect)frameRect;
-
-
-- (void) setFrameOrigin: (NSPoint)newOrigin
+
+
+- (void) setFrameOrigin: (NSPoint)newOrigin;
-
-
-- (void) setFrameRotation: (float)angle
+
+
+- (void) setFrameRotation: (float)angle;
-
-
-- (void) setFrameSize: (NSSize)newSize
+
+
+- (void) setFrameSize: (NSSize)newSize;
-
-
-- (void) setInterfaceStyle: (NSInterfaceStyle)interfaceStyle
+
+
+- (void) setInterfaceStyle: (NSInterfaceStyle)interfaceStyle;
-
-
-- (void) setNeedsDisplay: (BOOL)flag
+
+
+- (void) setNeedsDisplay: (BOOL)flag;
-
-
-- (void) setNeedsDisplayInRect: (NSRect)invalidRect
+
+
+- (void) setNeedsDisplayInRect: (NSRect)invalidRect;
-
-
-- (void) setNextKeyView: (NSView*)aView
+
+
+- (void) setNextKeyView: (NSView*)aView;
-
-
-- (void) setPostsBoundsChangedNotifications: (BOOL)flag
+
+
+- (void) setPostsBoundsChangedNotifications: (BOOL)flag;
-
-
-- (void) setPostsFrameChangedNotifications: (BOOL)flag
+
+
+- (void) setPostsFrameChangedNotifications: (BOOL)flag;
-
-
-- (void) setToolTip: (NSString*)string
+
+
+- (void) setToolTip: (NSString*)string;
-
-
-- (void) setUpGState
+
+
+- (void) setUpGState;
-
-
-- (BOOL) shouldDelayWindowOrderingForEvent: (NSEvent*)theEvent
+
+
+- (BOOL) shouldDelayWindowOrderingForEvent: (NSEvent*)theEvent;
-
-
-- (BOOL) shouldDrawColor
+
+
+- (BOOL) shouldDrawColor;
-
-
-- (void) sortSubviewsUsingFunction: (int (*)(id,id,void*))compare context: (void*)context
+
+
+- (void) sortSubviewsUsingFunction: (int (*)(id,id,void*))compare context: (void*)context;
-
-
-- (NSArray*) subviews
+
+
+- (NSArray*) subviews;
-
-
-- (NSView*) superview
+
+
+- (NSView*) superview;
-
-
-- (int) tag
+
+
+- (int) tag;
-
-
-- (NSString*) toolTip
+
+
+- (NSString*) toolTip;
-
-
-- (void) translateOriginToPoint: (NSPoint)newOrigin
+
+
+- (void) translateOriginToPoint: (NSPoint)newOrigin;
-
-
-- (void) unlockFocus
+
+
+- (void) unlockFocus;
-
-
-- (void) unregisterDraggedTypes
+
+
+- (void) unregisterDraggedTypes;
-
-
-- (void) viewWillMoveToSuperview: (NSView*)newSuperview
+
+
+- (void) viewWillMoveToSuperview: (NSView*)newSuperview;
Notifies the receiver that its superview is being changed to
newSuperview.
-
-
-- (void) viewWillMoveToWindow: (NSWindow*)newWindow
+
+
+- (void) viewWillMoveToWindow: (NSWindow*)newWindow;
Notifies the receiver that it will now be a view of newWindow.
-
-
-- (id) viewWithTag: (int)aTag
+
+
+- (id) viewWithTag: (int)aTag;
-
-
-- (NSRect) visibleRect
+
+
+- (NSRect) visibleRect;
-
-
-- (float) widthAdjustLimit
+
+
+- (float) widthAdjustLimit;
-
-
-- (NSWindow*) window
+
+
+- (NSWindow*) window;
@@ -954,12 +979,12 @@ Notifies the receiver that it will now be a view of newWindow.
-
-
-- (void) writeEPSInsideRect: (NSRect)aRect toPasteboard: (NSPasteboard*)pboard
+
+
+- (void) writeEPSInsideRect: (NSRect)aRect toPasteboard: (NSPasteboard*)pboard;
-
+
-
+