Instance Property

depthLimit

The depth limit of the window.

Declaration

@property NSWindowDepth depthLimit;

Discussion

The value of this property can be examined with the Application Kit functions NSPlanarFromDepth, NSColorSpaceFromDepth, NSBitsPerSampleFromDepth, and NSBitsPerPixelFromDepth. In addition, the NSBestDepth function provides the best depth limit based on a set of parameters.

Setting this property to 0 sets the depth limit to the window’s default depth limit. A depth limit of 0 can be useful for reverting a window object to its initial depth. You can also use one of the explicit bit depths defined in Explicit Window Depth Limits (NSWindowDepthTwentyfourBitRGB is the default).

See Also

Accessing Window Information

defaultDepthLimit

Returns the default depth limit for instances of NSWindow.

windowNumber

The window number of the window’s window device.

+ windowNumbersWithOptions:

Returns the window numbers for all visible windows satisfying the specified options.

- gState

Returns the window’s graphics state object.

Deprecated
- canStoreColor

Indicates whether the window has a depth limit that allows it to store color values.

Deprecated
deviceDescription

A dictionary containing information about the window’s resolution, such as color, depth, and so on.

NSDeviceDescriptionKey

These constants are the keys for device description dictionaries used by deviceDescription.

canBecomeVisibleWithoutLogin

A Boolean value that indicates whether the window can be displayed at the login window.

sharingType

A Boolean value that indicates the level of access other processes have to the window’s content.

backingType

The window’s backing store type.

backingLocation

The location of the window’s backing store.

Deprecated
preferredBackingLocation

A Boolean value that indicates the preferred location for the window’s backing store.

Deprecated
oneShot

A Boolean value that indicates whether the window device the window manages is freed when it’s removed from the screen list.

Deprecated
hasDynamicDepthLimit

A Boolean value that indicates whether the window’s depth limit can change to match the depth of the screen it’s on.