ftp.nice.ch/peanuts/GeneralData/Documents/openstep/OpenStepSpec_rtf.tar.gz#/OpenStepSpec_rtf/ApplicationKit/Classes/NSPageLayout.rtf

This is NSPageLayout.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 NSPageLayout 
pard s11 li2872 fi-2771 ri1007 ql tx2872 f1 b0 fs28 fs48 
fs28 f0 b fs24 Inherits From:tab b0 fs28 f1 NSPanel : NSWindow : 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/NSPageLayout.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 NSPageLayout is a type of NSPanel that queries the user for information such as paper type and orientation. This information is stored in an NSPrintInfo object, and is later used when printing. The NSPageLayout panel is created, displayed, and run (in a modal loop) when a b runPageLayout:b0  message is sent to the NSApplication object. By default, this message is sent up the responder chain when the user clicks the Page Layout menu item.
fs16 
fs28 Typically, you access an NSPageLayout panel by invoking the b pageLayoutb0  method. When the class receives a b pageLayoutb0  message, it tries to reuse an existing panel rather than create a new one. If a panel is reused, its attributes are reset to the default values so that the effect is the same as receiving a new panel. Because Page Layout panels may be reused, you shouldn'27t modify the instance returned by b pageLayoutb0 , except through the methods listed below. If you must modify the Page Layout panel in other ways than those allowed by its methods, create and manage your own instance using the b alloc...b0  and b init...b0  methods rather than the b pageLayoutb0  method.
fs16 
fs28 You can add your own controls to the Page Layout panel through the b setAccessoryView:b0  method. The panel is automatically resized to accommodate the NSView that you'27ve added. Note that you can'27t retrieve the NSPageLayout'27s settings through messages to the page layout panel object'd0NSPageLayout does not have accessor methods to obtain the state of its controls. If controls you add through an accessory view need to know the values of the existing controls in the page layout panel (or vice versa), access NSPageLayout'27s controls using the tags defined in fs28 AppKit/NSPageLayout.hfs28  as arguments to b viewWithTag:b0  messages to the page layout panel object. Controls thus returned can then be queried for their state.
fs16 
fs28 pard s16 li100 fi0 ri1007 ql f0 b fs24 
fs28 Creating an NSPageLayout Instance 
fs14 
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2 
fs28 fi-6552 + (NSPageLayout *)b pageLayoutb0 tab Returns a default NSPageLayout object.
pard s16 li100 fi0 ri1007 ql f0 b fs48 
fs28 Running the Panel 
fs14 
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2 
fs28 fi-6552 {f3 -} (int)b runModalb0 tab Displays the panel and begins its event loop. The panel'27s values are recorded in the shared NSPrintInfo object.
fi-6552 fs16 
fs28 fi-6552 {f3 -} (int)b runModalWithPrintInfo:b0 (NSPrintInfo *)i pInfotab 
s9 li7030 fi-6553 fi-5796 i0 tab Displays the panel and begins its event loopi . i0 The panel'27s values are recorded in the i pInfoi0 , the supplied NSPrintInfo object.
pard s16 li100 fi0 ri1007 ql f0 b fs48 
fs28 Customizing the Panel 
fs14 
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2 
fs28 fi-6552 {f3 -} (NSView *)b accessoryViewb0 tab Returns the NSPageLayout'27s accessory View.
fi-6552 fs16 
fs28 fi-6552 {f3 -} (void)b setAccessoryView:b0 (NSView *)i aViewi0 tab Adds a View to the panel.
pard s16 li100 fi0 ri1007 ql f0 b fs48 
fs28 Updating the Panel'27s Display 
fs14 
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2 
fs28 fi-6552 {f3 -} (void)b convertOldFactor:b0 (float *)i oldi0 tab  Returns by reference the ratio between a point and the
s9 li7030 fi-6553 fi-5796 b newFactor:b0 (float *)i newi0 tab  tab currently chosen unit of measurement. If invoked within the b pickedUnits:b0  method, i oldi0  refers to the ratio before the user'27s choice and i newi0  refers to the new ratio.
s8 li7029 fi-5794 fi-6552 fs16 
fs28 fi-6552 {f3 -} (void)b pickedButton:b0 (id)i senderi0 tab Stops the event loop.
fi-6552 fs16 
fs28 fi-6552 {f3 -} (void)b pickedOrientation:b0 (id)i senderi0 tab Updates the panel with the selected orientation.
fi-6552 fs16 
fs28 fi-6552 {f3 -} (void)b pickedPaperSize:b0 (id)i senderi0 tab Updates the panel when a paper size is selected.
fi-6552 fs16 
fs28 fi-6552 {f3 -} (void)b pickedUnits:b0 (id)i senderi0 tab Updates the panel when a new unit is selected.
pard s16 li100 fi0 ri1007 ql f0 b fs48 
fs28 Communicating with the NSPrintInfo Object 
fs14 
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2 
fs28 fi-6552 {f3 -} (NSPrintInfo *)b printInfotab b0 Returns the NSPrintInfo object that used when the panel is run.
fi-6552 fs16 
fs28 fi-6552 {f3 -} (void)b readPrintInfob0 tab Reads the NSPageLayout'27s values from the NSPrintInfo object.
fi-6552 fs16 
fs28 fi-6552 {f3 -} (void)b writePrintInfob0 tab Writes the NSPageLayout'27s values to the NSPrintInfo object.
}

These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.