This is NSView.rtf in view mode; [Download] [Up]
paperh18648 margl-907 margr0 margt0 margb0 fi0 ri0 ql sb0 f1 fs24 Copyright f3 'e3f1 1994 by NeXT Computer, Inc. All Rights Reserved.
s4 li100 fi0 ri1007 ql f0 b fs36 fs100
fs36 NSView
pard s11 li2872 fi-2771 ri1007 ql tx2872 f1 b0 fs28 fs48
fs28 f0 b fs24 Inherits From:tab b0 fs28 f1 NSResponder : NSObject
fs20
fs28 s6 f0 b fs24 Conforms To:tab b0 fs28 f1 NSCoding (NSResponder)
fi0 NSObject (NSObject)
fs20
fs28 s7 fi-2771 f0 b fs24 Declared In:tab b0 fs28 f1 AppKit/NSView.h
fi0 AppKit/NSClipView.h
fs20
fs28 pard s16 li100 fi0 ri1007 ql f0 b fs28 fs20
fs28 Class Description
fs14
fs28 pard s1 li477 fi0 ri1007 ql tx2494 tx2872 tx3250 f1 b0 fs2
fs28 NSView is an abstract class that provides its subclasses with a structure for drawing and for handling events. Any application that needs to display, print, or receive events must use NSView objects.
fs16
fs28 To be displayed, a view must be placed in a window (represented by an NSWindow object). All the views within a window are arranged in a hierarchy, with each view having a single i superviewi0 and zero or more i subviewsi0 . Each view has its own area to draw in and its own coordinate system, expressed as a transformation of its superview'27s coordinate system. An NSView object can scale, translate, or rotate its coordinates, or flip the polarity of its y-axis.
fs16
fs28 An NSView keeps track of its size and location in two ways: as a frame rectangle (expressed in its superview'27s coordinate system) and as a bounds rectangle (expressed in its own coordinate system). Both are represented by NSRect structures.
fs16
fs28 Subclasses of NSView typically override b drawRect:b0 to implement an object'27s distinctive appearance. They also frequently override one or more of NSView'27s or NSResponder'27s event-handling methods, to react to the user'27s manipulations of the mouse and keyboard.
fs16
fs28 pard s16 li100 fi0 ri1007 ql f0 b fs24
fs28 Initializing NSView Objects
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (id)b initWithFrame:b0 (NSRect)i frameRecti0 tab Initializes a new NSView object to the location and dimensions of i frameRecti0 .
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Managing the NSView Hierarchy
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (void)b addSubview:b0 (NSView *)i aViewi0 tab Makes i aViewi0 a subview of the receiving view object.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b addSubview:b0 (NSView *)i aViewi0 tab Makes i aViewi0 a subview of the receiving view object.
s9 li7030 fi-6553 fi-5796 b positioned:b0 (NSWindowOrderingMode)i placei0 tab tab It is positioned relative to i otherViewi0 according to
b relativeTo:b0 (NSView *)i otherViewi0 tab tab i placei0 .
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (NSView *)b ancestorSharedWithView:b0 (NSView *)i aViewi0 tab
s9 li7030 fi-6553 fi-5796 tab Returns the ancestor view shared by i aViewi0 and the receiver; b selfb0 if i aViewi0 is the receiving view or if the receiving view is the ancestor of i aViewi0 ; i aViewi0 if it is the superview of the receiving view; or b nilb0 in any other case.
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b isDescendantOf:b0 (NSView *)i aViewi0 tab Returns whether i aViewi0 is an ancestor of the receiver.
fi-6552 fs16
fs28 fi-6552 {f3 -} (NSView *)b opaqueAncestorb0 tab Returns the receiver'27s nearest opaque ancestor.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b removeFromSuperviewb0 tab Removes the receiver from the view hierarchy.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b replaceSubview:b0 (NSView *)i oldViewi0 tab Replaces i oldViewi0 with i newViewi0 .
s9 li7030 fi-6553 fi-5796 b with:b0 (NSView *)i newViewi0 tab
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b sortSubviewsUsingFunction:b0 (int (*)(id ,id ,void *))i comparei0
s9 li7030 fi-6553 fi-5796 b context:b0 (void *)i contexttab i0 Sorts the receiving view'27s subviews using the sorting function i comparei0 and the context i contexti0 . The first two arguments of the function are the views to be compared.
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (NSArray *)b subviewsb0 tab Returns a mutable array of the receiving view object'27s subviews.
fi-6552 fs16
fs28 fi-6552 {f3 -} (NSView *)b superviewb0 tab Returns the receiving view object'27s superview.
fi-6552 fs16
fs28 fi-6552 {f3 -} (NSWindow *)b windowb0 tab Returns the window in which the view is displayed.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b viewWillMoveToWindow:b0 (NSWindow *)i newWindowtab
s9 li7030 fi-6553 fi-5796 i0 tab Notifies the view that it will move to a new windowi .
pard s16 li100 fi0 ri1007 ql f0 b i0 fs48
fs28 Modifying the Frame Rectangle
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (float)b frameRotationb0 tab Returns the angle of the frame rectangle'27s rotation.
fi-6552 fs16
fs28 fi-6552 {f3 -} (NSRect)b frameb0 tab Gets the view'27s frame rectangle.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b rotateByAngle:b0 (float)i anglei0 tab Rotates the view'27s frame rectangle by i angli0 e. This method posts the NSViewFocusChangedNotification notification with the receiving object to the default notification center.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setFrame:b0 (NSRect)i frameRecti0 tab Assigns the view a new frame rectangle.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setFrameOriginb0 :(NSPoint)i newOrigini0 tab Sets the origin of the view'27s frame to i newOrigini0 . This method posts the NSViewFrameChangedNotification and NSViewFocusChangedNotification notifications with the receiving object to the default notification center.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setFrameRotation:b0 (float)i anglei0 tab Rotates the view'27s frame to i anglei0 . This method posts the NSViewFocusChangedNotification notification with the receiving object to the default notification center.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setFrameSize:b0 (NSSize)i newSizei0 tab Resizes the view'27s frame to i newSize.i0 This method posts the NSViewFrameChangedNotification and NSViewFocusChangedNotification notifications with the receiving object to the default notification center.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Modifying the Coordinate System
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (float)b boundsRotationb0 tab Returns the rotation of the view'27s coordinate system.
fi-6552 fs16
fs28 fi-6552 {f3 -} (NSRect)b boundsb0 tab Gets the view'27s bounds rectangle.
fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b isFlippedb0 tab Returns whether the view is flipped.
fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b isRotatedFromBaseb0 tab Returns whether the view is rotated.
fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b isRotatedOrScaledFromBaseb0 tab Returns whether the view is rotated or scaled.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b scaleUnitSquareToSize:b0 (NSSize)i newSizei0 tab Scales the NSView'27s coordinate system unit size to i newSize.i0 This method posts the notification NSViewFocusChangedNotification with the receiving object to the default notification center.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setBounds:b0 (NSRect)i aRecttab i0 Sets the NSView'27s bounds rectangle to i aRecti0 .
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setBoundsOrigin:b0 (NSPoint)i newOrigini0 tab Sets the NSView'27s drawing origin to i newOrigini0 . This method posts the NSViewFocusChangedNotification notification with the receiving object to the default notification center.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setBoundsRotation:b0 (float)i anglei0 tab Rotates the NSView'27s coordinate system to i anglei0 . This method posts the NSViewFocusChangedNotification notification with the receiving object to the default notification center.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setBoundsSize:b0 (NSSize)i newSizei0 tab Resizes the NSView'27s coordinate system to i newSize.i0 This method posts the NSViewFocusChangedNotification notification with the receiving object to the default notification center.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b translateOriginToPoint:b0 (NSPoint)i pointi0 tab Shifts the NSView'27s coordinate system to i pointi0 . This method posts the NSViewFocusChangedNotification notification with the receiving object to the default notification center.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Converting Coordinates
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (NSRect)b centerScanRect:b0 (NSRect)i aRecti0 tab Converts the rectangle i aRecti0 to lie on centers of pixels.
fi-6552 fs16
fs28 fi-6552 {f3 -} (NSPoint)b convertPoint:b0 (NSPoint)i aPointi0 tab Converts i aPointi0 in i aViewi0 to the receiver'27s coordinates.
s9 li7030 fi-6553 fi-5796 b fromView:b0 (NSView *)i aViewi0 tab
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (NSPoint)b convertPoint:b0 (NSPoint)i aPointi0 tab Converts i aPointi0 in the receiver to i aViewi0 '27s coordinates.
s9 li7030 fi-6553 fi-5796 b toView:b0 (NSView *)i aViewi0 tab
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (NSRect)b convertRect:b0 (NSRect)i aRecti0 tab Converts the rectangle i aRecti0 in i aViewi0 to the receiver'27s
s9 li7030 fi-6553 fi-5796 b fromView:b0 (NSView *)i aViewi0 tab tab coordinates.
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (NSRect)b convertRect:b0 (NSRect)i aRecti0 tab Converts the rectangle i aRecti0 in the receiver to i aViewi0 '27s
s9 li7030 fi-6553 fi-5796 b toView:b0 (NSView *)i aViewi0 tab tab coordinates.
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (NSSize)b convertSize:b0 (NSSize)i aSizei0 tab Converts i aSizei0 in i aViewi0 to the receiver'27s coordinates.
s9 li7030 fi-6553 fi-5796 b fromView:b0 (NSView *)i aViewi0 tab
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (NSSize)b convertSize:b0 (NSSize)i aSizei0 tab Converts i aSizei0 in the receiver to i aViewi0 '27s coordinates.
s9 li7030 fi-6553 fi-5796 b toView:b0 (NSView *)i aViewi0 tab
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Notifying Ancestor Views
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (BOOL)b postsFrameChangedNotificationsb0 tab Returns whether notifications of frame changes to ancestors are activated.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setPostsFrameChangedNotifications:b0 (BOOL)i flagi0 tab
s9 li7030 fi-6553 fi-5796 tab Sets whether to activate ancestor notifications.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Resizing Subviews
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (void)b resizeSubviewsWithOldSize:b0 (NSSize)i oldSizei0 tab
s9 li7030 fi-6553 fi-5796 tab Initiates b superviewSizeChanged:b0 messages to subviews.
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setAutoresizesSubviews:b0 (BOOL)i flagi0 tab Sets whether to notify subviews of resizing.
fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b autoresizesSubviewsb0 tab Returns whether the NSView notifies subviews of resizing.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setAutoresizingMask:b0 (unsigned int)i maski0 tab Determines automatic resizing behavior.
fi-6552 fs16
fs28 fi-6552 {f3 -} (unsigned int)b autoresizingMaskb0 tab Returns the NSView'27s autosizing mask.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b resizeWithOldSuperviewSize:b0 (NSSize)i oldSizei0 tab
s9 li7030 fi-6553 fi-5796 tab Notifies subviews that the superview changed size.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Graphics State Objects
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (void)b allocateGStateb0 tab Allocates a graphics state object.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b releaseGStateb0 tab Release the NSView'27s graphics state object.
fi-6552 fs16
fs28 fi-6552 {f3 -} (int)b gStateb0 tab Returns the NSView'27s graphics state object.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b renewGStateb0 tab Marks the NSView'27s graphics state object as needing initialization.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setUpGStatetab b0 Sets up the NSView'27s graphics state object.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Focusing
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 + (NSView *)b focusViewtab b0 Returns the currently focused view.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b lockFocusb0 tab Brings the receiving view into focus.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b unlockFocusb0 tab Unfocuses the receiving view.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Displaying
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (BOOL)b canDrawb0 tab Returns whether the view object can draw.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b displayb0 tab Displays the receiving view and its subviews.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b displayIfNeededb0 tab Conditionally displays the receiving view and its subviews (if opaque).
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b displayIfNeededIgnoringOpacityb0 tab Conditionally displays the receiving view and its subviews, regardless of opacity.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b displayRect:b0 (NSRect)i aRecti0 tab Displays the receiving view and its subviews (if opaque) within i aRecti0 .
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b displayRectIgnoringOpacity:b0 (NSRect)i aRecti0 tab Displays the receiving view and its subviews (regardless of opacity) within i aRecti0 .
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b drawRect:b0 (NSRect)i recti0 tab Implemented by subclasses to supply drawing instructions.
fi-6552 fs16
fs28 fi-6552 {f3 -} (NSRect)b visibleRectb0 tab Gets the receiving view'27s visible portion.
fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b isOpaqueb0 tab Returns whether the view is opaque.
fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b needsDisplayb0 tab Returns whether the view needs to be redisplayed.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setNeedsDisplay:b0 (BOOL)i flagi0 tab If i flagi0 is YES, marks the view as changed, needing redisplay.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setNeedsDisplayInRect:b0 (NSRect)i invalidRecti0 tab Marks the view as changed, needing redisplay in rectangle i invalidRecti0 .
fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b shouldDrawColorb0 tab Returns whether the view should be drawn in color.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Scrolling
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (NSRect)b adjustScroll:b0 (NSRect)i newVisiblei0 tab Lets the view object adjust the visible rectangle.
fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b autoscroll:b0 (NSEvent *)i theEventi0 tab Scrolls in response to a mouse-dragged event.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b reflectScrolledClipViewb0 :(NSClipView *)i aClipViewtab
s9 li7030 fi-6553 fi-5796 i0 tab Reflects scrolling withini i0 clip viewi aClipView.
s8 li7029 fi-5794 fi-6552 i0 fs16
fs28 fi-6552 {f3 -} (void)b scrollClipView:b0 (NSClipView *)i aClipViewi0 tab Scrolls the clip view i aClipViewi0 to i aPoint.
s9 li7030 fi-6553 fi-5796 i0 b toPoint:b0 (NSPoint)i aPointtab
s8 li7029 fi-5794 fi-6552 i0 fs16
fs28 fi-6552 {f3 -} (void)b scrollPoint:b0 (NSPoint)i aPointi0 tab Aligns i aPointi0 with the content view'27s origin.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b scrollRect:b0 (NSRect)i aRecti0 tab Shifts the rectangle i aRecti0 by i deltai0 .
s9 li7030 fi-6553 fi-5796 b by:b0 (NSSize)i deltai0 tab
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b scrollRectToVisible:b0 (NSRect)i aRecti0 tab Scrolls the view so the rectangle i aRecti0 is visible.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Managing the Cursor
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (void)b addCursorRect:b0 (NSRect)i aRecti0 tab Adds a cursor rectangle i aRecti0 for cursor i anObjecti0 to the
s9 li7030 fi-6553 fi-5796 b cursor:b0 (NSCursor *)i anObjecti0 tab tab NSView.
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b discardCursorRectsb0 tab Removes all cursor rectangles in the view.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b removeCursorRect:b0 (NSRect)i aRecti0 tab Removes cursor rectangle i aRecti0 for cursor i anObjecti0 from
s9 li7030 fi-6553 fi-5796 b cursor:b0 (NSCursor *)i anObjecti0 tab tab the view.
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b resetCursorRectsb0 tab Implemented by subclasses to reset their cursor rectangles.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Assigning a Tag
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (int)b tagb0 tab Returns the view object'27s tag.
fi-6552 fs16
fs28 fi-6552 {f3 -} (id)b viewWithTag:b0 (int)i aTagi0 tab Returns the subview object with i aTagi0 as its tag.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Aiding Event Handling
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (BOOL)b acceptsFirstMouse:b0 (NSEvent *)i theEventi0 tab Returns whether the view object accepts first mouse-down events.
fi-6552 fs16
fs28 fi-6552 {f3 -} (NSView *)b hitTest:b0 (NSPoint)i aPointi0 tab Returns the lowest subview containing the point i aPointi0 .
fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b mouse:b0 (NSPoint)i aPointi0 tab Returns whether the point i aPointi0 lies inside the i aRecti0 .
s9 li7030 fi-6553 fi-5796 b inRect:b0 (NSRect)i aRecti0 tab
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b performKeyEquivalent:b0 (NSEvent *)i theEvent
s9 li7030 fi-6553 fi-5796 i0 tab Implemented by subclasses to perform key-equivalent commands. Returns whether a subview handled i theEventi0 .
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 - (void)b removeTrackingRect:b0 (NSTrackingRectTag)i tag
s9 li7030 fi-6553 fi-5796 i0 tab Removes the tracking rectangle identified by i tagi0 from the view. (i tagi0 is an unique identifier returned from the b addTractingRect:owner:assumeInside:b0 method.)
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b shouldDelayWindowOrderingForEvent:b0 (NSEvent *)i anEvent
s9 li7030 fi-6553 fi-5796 i0 tab Returns whether the view'27s window is brought forward normally (mouse-down) or delayed (mouse-up).
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (NSTrackingRectTag)b addTrackingRect:b0 (NSRect)i aRecti0
s9 li7030 fi-6553 fi-5796 b owner:b0 (id)i anObjecti0 tab Adds a tracking rectangle (i aRecti0 ) owned by i anObjecti0 to
b userData:b0 (void *)i datab i0 tab tab b0 the receiving NSView.
b assumeInside:b0 (BOOL)i flagi0 tab tab i flagi0 indicates whether the tracking rectangle will be only inside the NSView. Returns a unique tag that identifies the tracking rectangle.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Dragging
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (BOOL)b dragFile:b0 (NSString *)i filenametab i0 Initiates a file-dragging session, dragging file indicated
s9 li7030 fi-6553 fi-5796 b fromRect:b0 (NSRect)i recti0 tab tab by path i filenamei0 . i recti0 describes the position of the icon
b slideBack:b0 (BOOL)i slideFlagb i0 tab tab b0 in the View's coordinatesb . b0 i slideFlagi0 determines
b event:b0 (NSEvent *)i eventi0 tab tab whether the NSImage should slide back if rejected
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b dragImage:b0 (NSImage *)i anImagei0 tab Initiates an image-dragging session, dragging i anImage
s9 li7030 fi-6553 fi-5796 i0 b at:b0 (NSPoint)i viewLocationi0 tab tab from i viewLocationi0 . i initialOffseti0 is the difference in
b offset:b0 (NSSize)i initialOffseti0 tab tab the mouse location from the mouse-down.
b event:b0 (NSEvent *)i eventi0 tab tab i pboardi0 is the pasteboard holding the data.
b pasteboard:b0 (NSPasteboard *)i pboardi0 tab tab i sourceObjecti0 is the object receiving
b source:b0 (id)i sourceObjecti0 tab tab NSDraggingSource messages.i slideFlagi0 determines
b slideBack:b0 (BOOL)i slideFlagi0 tab tab whether the NSImage should slide back if rejected.
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b registerForDraggedTypes:b0 (NSArray *)i newTypesi0 tab
s9 li7030 fi-6553 fi-5796 tab Registers the pasteboard types that the window will accept in an image-dragging session.
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b unregisterDraggedTypesb0 tab Unregisters the window as a recipient of dragged images.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Printing
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (NSData *)b dataWithEPSInsideRect:b0 (NSRect)i aRect
s9 li7030 fi-6553 fi-5796 i0 tab Returns a data object initialized with the EPS data within i aRecti0 in the receiving view.
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b fax:b0 (id)i senderi0 tab Faxes the view and its subviews.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b print:b0 (id)i sendertab i0 Prints the view and its subviewsi .
fi-6552 i0 fs16
fs28 fi-6552 {f3 -} (void)b writeEPSInsideRect:b0 (NSRect)i recti0 tab Places PostScript code for the rectangle i recti0 on the
s9 li7030 fi-6553 fi-5796 b toPasteboard:b0 (NSPasteboard *)i pasteboardi0 tab i tab pasteboardi0 .
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Pagination
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (void)b adjustPageHeightNew:b0 (float *)i newBottomi0 tab Assists automatic pagination of the view object.
s9 li7030 fi-6553 fi-5796 b top:b0 (float)i oldTopi0 tab
b bottom:b0 (float)i oldBottomi0 tab
b limit:b0 (float)i bottomLimiti0 tab
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b adjustPageWidthNew:b0 (float *)i newRighti0 tab Assists automatic pagination of the view object.
s9 li7030 fi-6553 fi-5796 b left:b0 (float)i oldLefti0 tab
b right:b0 (float)i oldRighti0 tab
b limit:b0 (float)i rightLimiti0 tab
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (float)b heightAdjustLimitb0 tab Returns how much of a page can go on the next page.
fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b knowsPagesFirst:b0 (int *)i firstPageNumi0 tab Returns whether the view paginates itself.
s9 li7030 fi-6553 fi-5796 b last:b0 (int *)i lastPageNumi0 tab
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (NSPoint)b locationOfPrintRect:b0 (NSRect)i aRecti0 tab Locates the printing rectangle on the page.
fi-6552 fs16
fs28 fi-6552 {f3 -} (NSRect)b rectForPage:b0 (int)i pagei0 tab Provides how much of the view will print on page.
fi-6552 fs16
fs28 fi-6552 {f3 -} (float)b widthAdjustLimitb0 tab Returns how much of a page can go on the next page.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Writing Conforming PostScript
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (void)b addToPageSetupb0 tab Allows you to adjust for differences in the graphics state between the screen and the printer.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b beginPage:b0 (int)i ordinalNumtab i0 Writes a page separator.
s9 li7030 fi-6553 fi-5796 b label:b0 (NSString *)i aString
i0 b bBox:b0 (NSRect)i pageRect
i0 b fonts:b0 (NSString *)i fontNamesi0 tab
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b beginPageSetupRect:b0 (NSRect)i aRecti0 tab Writes the beginning of a page setup section.
s9 li7030 fi-6553 fi-5796 b placement:b0 (NSPoint)i locationi0 tab
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b beginPrologueBBox:b0 (NSRect)i boundingBoxtab i0 Writes the header for a print job.
s9 li7030 fi-6553 fi-5796 b creationDate:b0 (NSString *)i dateCreated
i0 b createdBy:b0 (NSString *)i anApplication
i0 b fonts:b0 (NSString *)i fontNames
i0 b forWhom:b0 (NSString *)i user
i0 b pages:b0 (int)i numPages
i0 b title:b0 (NSString *)i aTitlei0 tab
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b beginSetupb0 tab Writes the beginning of the job setup section.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b beginTrailerb0 tab Writes the beginning of the trailer for the print job.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b drawPageBorderWithSize:b0 (NSSize)i borderSizei0 tab
s9 li7030 fi-6553 fi-5796 tab Implemented by subclasses to draw in margins (e.g., borders, numbering). i borderSizei0 is the size of the border.
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b drawSheetBorderWithSize:b0 (NSSize)i borderSizei0 tab
s9 li7030 fi-6553 fi-5796 tab Implemented by subclasses to draw in margins (e.g., borders, numbering). i borderSizei0 is the size of the border.
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b endHeaderCommentsb0 tab Writes the end of the header.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b endPrologueb0 tab Writes the end of the prologue.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b endSetupb0 tab Writes the end of the job setup section.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b endPageSetupb0 tab Writes the end of a page setup section.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b endPageb0 tab Writes the end of a page.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b endTrailerb0 tab Writes the end of the trailer.
fi-6552 fs16
fs28 fi-6552
}These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.