---

NSWindow Class Reference

Overview

The NSWindow class defines objects (known as windows) that manage and coordinate the windows an application displays on the screen. A single NSWindow object corresponds to at most one onscreen window. The two principal functions of a window are to provide an area in which views can be placed and to accept and distribute, to the appropriate views, events the user instigates through actions with the mouse and keyboard.

Tasks

Creating Windows

• – initWithContentRect:styleMask:backing:defer:
• – initWithContentRect:styleMask:backing:defer:screen:

Configuring Windows

• – styleMask
• – worksWhenModal
• – alphaValue
• – setAlphaValue:
• – backgroundColor
• – setBackgroundColor:
• – contentView
• – setContentView:
• – canHide
• – setCanHide:
• – hidesOnDeactivate
• – setHidesOnDeactivate:
• – collectionBehavior
• – setCollectionBehavior:
• – isOpaque
• – setOpaque:
• – hasShadow
• – setHasShadow:
• – invalidateShadow
• – autorecalculatesContentBorderThicknessForEdge:
• – setAutorecalculatesContentBorderThickness:forEdge:
• – contentBorderThicknessForEdge:
• – setContentBorderThickness:forEdge:
• – delegate
• – setDelegate:

Accessing Window Information

• + defaultDepthLimit
• – windowNumber
• – gState
• – canStoreColor
• – deviceDescription
• – canBecomeVisibleWithoutLogin
• – setCanBecomeVisibleWithoutLogin:
• – sharingType
• – setSharingType:
• – backingType
• – setBackingType:
• – backingLocation
• – preferredBackingLocation
• – setPreferredBackingLocation:
• – isOneShot
• – setOneShot:
• – depthLimit
• – setDepthLimit:
• – hasDynamicDepthLimit
• – setDynamicDepthLimit:

Getting Layout Information

• + contentRectForFrameRect:styleMask:
• + frameRectForContentRect:styleMask:
• + minFrameWidthWithTitle:styleMask:
• – contentRectForFrameRect:
• – frameRectForContentRect:

Managing Windows

• – drawers
• – windowController
• – setWindowController:

Managing Sheets

• – attachedSheet
• – isSheet
• – window:willPositionSheet:usingRect:  delegate method
• – windowWillBeginSheet:  delegate method
• – windowDidEndSheet:  delegate method

Sizing

• – frame
• – setFrameOrigin:
• – setFrameTopLeftPoint:
• – constrainFrameRect:toScreen:
• – cascadeTopLeftFromPoint:
• – setFrame:display:
• – setFrame:display:animate:
• – animationResizeTime:
• – windowWillUseStandardFrame:defaultFrame:  delegate method
• – aspectRatio
• – setAspectRatio:
• – minSize
• – setMinSize:
• – maxSize
• – setMaxSize:
• – isZoomed
• – performZoom:
• – zoom:
• – windowShouldZoom:toFrame:  delegate method
• – resizeFlags
• – showsResizeIndicator
• – setShowsResizeIndicator:
• – resizeIncrements
• – setResizeIncrements:
• – preservesContentDuringLiveResize
• – setPreservesContentDuringLiveResize:
• – windowWillResize:toSize:  delegate method
• – windowDidResize:  delegate method

Sizing Content

• – contentAspectRatio
• – setContentAspectRatio:
• – contentMinSize
• – setContentMinSize:
• – setContentSize:
• – contentMaxSize
• – setContentMaxSize:
• – contentResizeIncrements
• – setContentResizeIncrements:

Managing Window Layers

• – isVisible
• – orderOut:
• – orderBack:
• – orderFront:
• – orderFrontRegardless
• – orderWindow:relativeTo:
• – level
• – setLevel:

Managing Window Frames in User Defaults

• + removeFrameUsingName:
• – setFrameUsingName:
• – setFrameUsingName:force:
• – saveFrameUsingName:
• – frameAutosaveName
• – setFrameAutosaveName:
• – stringWithSavedFrame
• – setFrameFromString:

Managing Key Status

• – isKeyWindow
• – canBecomeKeyWindow
• – makeKeyWindow
• – makeKeyAndOrderFront:
• – becomeKeyWindow
• – windowDidBecomeKey:  delegate method
• – resignKeyWindow
• – windowDidResignKey:  delegate method

Managing Main Status

• – isMainWindow
• – canBecomeMainWindow
• – makeMainWindow
• – becomeMainWindow
• – windowDidBecomeMain:  delegate method
• – resignMainWindow
• – windowDidResignMain:  delegate method

Managing Toolbars

• – toolbar
• – setToolbar:
• – toggleToolbarShown:
• – runToolbarCustomizationPalette:

Managing Attached Windows

• – childWindows
• – addChildWindow:ordered:
• – removeChildWindow:
• – parentWindow
• – setParentWindow:

Managing Window Buffers

• – isFlushWindowDisabled
• – enableFlushWindow
• – disableFlushWindow
• – flushWindow
• – flushWindowIfNeeded

Managing Default Buttons

• – defaultButtonCell
• – setDefaultButtonCell:
• – enableKeyEquivalentForDefaultButtonCell
• – disableKeyEquivalentForDefaultButtonCell

Managing Field Editors

• – fieldEditor:forObject:
• – windowWillReturnFieldEditor:toObject:  delegate method
• – endEditingFor:

Managing the Window Menu

• – isExcludedFromWindowsMenu
• – setExcludedFromWindowsMenu:

Managing Cursor Rectangles

• – areCursorRectsEnabled
• – enableCursorRects
• – disableCursorRects
• – discardCursorRects
• – invalidateCursorRectsForView:
• – resetCursorRects

Managing Title Bars

• + standardWindowButton:forStyleMask:
• – standardWindowButton:
• – showsToolbarButton
• – setShowsToolbarButton:

Managing Tooltips

• – allowsToolTipsWhenApplicationIsInactive
• – setAllowsToolTipsWhenApplicationIsInactive:

Handling Events

• + menuChanged:
• – currentEvent
• – nextEventMatchingMask:
• – nextEventMatchingMask:untilDate:inMode:dequeue:
• – discardEventsMatchingMask:beforeEvent:
• – postEvent:atStart:
• – sendEvent:
• – tryToPerform:with:

Managing Responders

• – initialFirstResponder
• – firstResponder
• – setInitialFirstResponder:
• – makeFirstResponder:

Managing the Key View Loop

• – selectKeyViewPrecedingView:
• – selectKeyViewFollowingView:
• – selectPreviousKeyView:
• – selectNextKeyView:
• – keyViewSelectionDirection
• – autorecalculatesKeyViewLoop
• – recalculateKeyViewLoop
• – setAutorecalculatesKeyViewLoop:

Handling Keyboard Events

• – keyDown:

Handling Mouse Events

• – acceptsMouseMovedEvents
• – ignoresMouseEvents
• – setIgnoresMouseEvents:
• – mouseLocationOutsideOfEventStream
• – setAcceptsMouseMovedEvents: