This is NSScreen.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 NSScreen
pard s11 li2872 fi-2771 ri1007 ql tx2872 f1 b0 fs28 fs48
fs28 f0 b fs24 Inherits From:tab b0 fs28 f1 NSObject
fs20
fs28 s6 f0 b fs24 Conforms To:tab b0 fs28 f1 NSObject (NSObject)
fs20
fs28 s7 f0 b fs24 Declared In:tab b0 fs28 f1 AppKit/NSScreen.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 An NSScreen object describes the attributes of a computer'27s monitor, or screen. An application may use an NSScreen object to retrieve information about a screen and use this information to decide what to display upon that screen. For example, an application may use the b deepestScreenb0 method to find out which of the available screens can best represent color and then may choose to display all of its windows on that screen.
fs16
fs28 The two main attributes of a screen are its depth and its dimensions. The b depthb0 method describes the screen depth (such as two-bit, eight-bit, or twelve-bit) and tells you if the screen can display color. The b frameb0 method gives the screen'27s dimensions and location as an NSRect.
fs16
fs28 The device description dictionary contains more complete information about the screen. Use NSScreen'27s b deviceDescriptionb0 method to access the dictionary, and use these keys to retrieve information about a screen:
fs16
fs28 pard s19 li854 fi0 ri1007 ql tx4509 tx10180 f0 b fs24 Dictionary Keytab Returns
fs6
fs24 s17 f1 b0 fs28 NSDeviceResolutiontab An NSValue describing the screen'27s resolution in dots per inch (dpi).
fs6
fs28 NSDeviceColorSpaceNametab The screen'27s color space name. See NSGraphics.h for a list of possible values.
fs6
fs28 NSDeviceBitsPerSampletab The bit depth of screen images (2-bit, 8-bit, etc.).
fs6
fs28 NSDeviceIsScreentab YES, indicating the device is a screen.
fs6
fs28 NSDeviceSizetab An NSValue describing the screen'27s size in points.
fs6
fs28 pard s1 li477 fi0 ri1007 ql tx2494 tx2872 tx3250 fs10
fs28 The device description dictionary contains information about not only screens, but all other system devices such as printers and windows. There are other keys into the dictionary that you would use to obtain information about these other devices. For a complete list of device dictionary keys, see NSGraphics.h.
fs16
fs28 pard s16 li100 fi0 ri1007 ql f0 b fs24
fs28 Creating NSScreen Instances
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 + (NSScreen *)b mainScreenb0 tab Returns an NSScreen object representing the main screen. The main screen is the screen with the key window.
fi-6552 fs16
fs28 fi-6552 + (NSScreen *)b deepestScreenb0 tab Returns an NSScreen object representing the screen that can best represent color. This method always returns an object, even if there is only one screen and it is not a color screen.
fi-6552 fs16
fs28 fi-6552 + (NSArray *)b screensb0 tab Returns an array of NSScreen objects representing all of the screens available on the system. Raises NSWindowServerCommunicationException if the screens information can'27t be obtained from the window system.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Reading Screen Information
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (NSWindowDepth)b depthtab b0 Returns the screen'27s depth, including whether the screen can display color.
fi-6552 fs16
fs28 fi-6552 {f3 -} (NSRect)b frameb0 tab Returns the dimensions and location of the screen in an NSRect.
fi-6552 fs16
fs28 fi-6552 {f3 -} (NSDictionary *)b deviceDescriptionb0 tab Returns the device dictionary as described in the class description.
}These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.