This is NSPanel.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 NSPanel
pard s11 li2872 fi-2771 ri1007 ql tx2872 f1 b0 fs28 fs48
fs28 f0 b fs24 Inherits From:tab b0 fs28 f1 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/NSPanel.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 The NSPanel class defines objects that manage the panels of the OpenStep user interface. A panel is a window that serves an auxiliary function within an application. It generally displays controls that the user can act on to give instructions to the application or to modify the contents of a standard window.
fs16
fs28 Panels behave differently from standard windows in only a small number of ways, but the ways are important to the user interface:
fs16
fs28 pard s3 li1231 fi-376 ri1007 ql tx1231 tx2872 tx3250 'b7tab Panels can assume key window'd0but not main window'd0status. (The key window receives keyboard events. The main window is the primary focus of user actions; it might contain the document the user is working on, for example.)
fs16
fs28 'b7tab On-screen panels are normally removed from the screen list when the user begins to work in another application, and are restored to the screen when the user returns to the panel'27s application.
fs16
fs28 pard s1 li477 fi0 ri1007 ql tx2494 tx2872 tx3250 To aid in their auxiliary role, panels can be assigned special behaviors:
fs16
fs28 pard s3 li1231 fi-376 ri1007 ql tx1231 tx2872 tx3250 'b7tab A panel can be precluded from becoming the key window until the user makes a selection (makes some view in the panel the first responder) indicating an intention to begin typing. This prevents key window status from shifting to the panel unnecessarily.
fs16
fs28 'b7tab Palettes and similar panels can be made to float above standard windows and other panels. This prevents them from being covered and keeps them readily available to the user.
fs16
fs28 'b7tab A panel can be made to work'd0to receive mouse and keyboard events'd0even when there'27s an attention panel on-screen. This permits actions within the panel to affect the attention panel.
fs16
fs28 pard s16 li100 fi0 ri1007 ql f0 b fs24
fs28 Determining the Panel Behavior
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (BOOL)b becomesKeyOnlyIfNeededb0 tab Returns whether the receiver waits to become key window.
fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b isFloatingPanelb0 tab Returns whether the receiver floats above other windows.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setBecomesKeyOnlyIfNeeded:b0 (BOOL)i flagi0 tab Sets whether the receiver waits to become key window.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setFloatingPanel:b0 (BOOL)i flagi0 tab Sets whether the receiver floats above other windows.
fi-6552 fs16
fs28 fi-6552 {f3 -} (void)b setWorksWhenModal:b0 (BOOL)i flagi0 tab Sets whether the receiver can operate even when an attention panel is on-screen.
fi-6552 fs16
fs28 fi-6552 {f3 -} (BOOL)b worksWhenModalb0 tab Returns whether the receiver can operate even when an attention panel is on-screen. The default is NO.
}These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.