NSWindow Class Reference

Tasks

Creating Windows

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

Configuring Windows

• – styleMask
• – setStyleMask:
• – toggleFullScreen:
• – worksWhenModal
• – alphaValue
• – setAlphaValue:
• – backgroundColor
• – setBackgroundColor:
• – colorSpace
• – setColorSpace:
• – contentView
• – setContentView:
• – canHide
• – setCanHide:
• – isOnActiveSpace
• – hidesOnDeactivate
• – setHidesOnDeactivate:
• – collectionBehavior
• – setCollectionBehavior:
• – isOpaque
• – setOpaque:
• – hasShadow
• – setHasShadow:
• – invalidateShadow
• – autorecalculatesContentBorderThicknessForEdge:
• – setAutorecalculatesContentBorderThickness:forEdge:
• – contentBorderThicknessForEdge:
• – setContentBorderThickness:forEdge:
• – delegate
• – setDelegate:
• – preventsApplicationTerminationWhenModal
• – setPreventsApplicationTerminationWhenModal:
• – canBeVisibleOnAllSpaces Deprecated in OS X v10.5
• – setCanBeVisibleOnAllSpaces: Deprecated in OS X v10.5

Accessing Window Information

• + defaultDepthLimit
• – windowNumber
• + windowNumbersWithOptions:
• – 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

Sizing Windows

• – frame
• – setFrameOrigin:
• – setFrameTopLeftPoint:
• – constrainFrameRect:toScreen:
• – cascadeTopLeftFromPoint:
• – setFrame:display:
• – setFrame:display:animate:
• – animationResizeTime:
• – aspectRatio
• – setAspectRatio:
• – minSize
• – setMinSize:
• – maxSize
• – setMaxSize:
• – isZoomed
• – performZoom:
• – zoom:
• – resizeFlags
• – showsResizeIndicator
• – setShowsResizeIndicator:
• – resizeIncrements
• – setResizeIncrements:
• – preservesContentDuringLiveResize
• – setPreservesContentDuringLiveResize:
• – inLiveResize

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
• – resignKeyWindow

Managing Main Status

• – isMainWindow
• – canBecomeMainWindow
• – makeMainWindow
• – becomeMainWindow
• – resignMainWindow

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:
• – 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:
• + windowNumberAtPoint:belowWindowWithWindowNumber:

Handling Window Restoration

• – setRestorable:
• – isRestorable
• – setRestorationClass:
• – restorationClass
• – disableSnapshotRestoration
• – enableSnapshotRestoration

Bracketing Drawing Operations

• – cacheImageInRect:
• – restoreCachedImage
• – discardCachedImage

Drawing Windows

• – display
• – displayIfNeeded
• – viewsNeedDisplay
• – setViewsNeedDisplay:
• – isAutodisplay
• – setAutodisplay:
• – useOptimizedDrawing:
• – graphicsContext
• – allowsConcurrentViewDrawing
• – setAllowsConcurrentViewDrawing:

Window Animation

• – animationBehavior
• – setAnimationBehavior:

Updating Windows

• – disableScreenUpdatesUntilFlush
• – update

Dragging Items

• – dragImage:at:offset:event:pasteboard:source:slideBack:
• – registerForDraggedTypes:
• – unregisterDraggedTypes

Converting Coordinates

• – backingScaleFactor
• – backingAlignedRect:options:
• – convertRectFromBacking:
• – convertRectToBacking:
• – convertRectToScreen:
• – convertRectFromScreen:
• – convertBaseToScreen:
• – convertScreenToBase:
• – userSpaceScaleFactor

Accessing Edited Status

• – isDocumentEdited
• – setDocumentEdited:

Managing Titles

• – title
• – setTitle:
• – setTitleWithRepresentedFilename:
• – representedFilename
• – setRepresentedFilename:
• – representedURL
• – setRepresentedURL:

Accessing Screen Information

• – screen
• – deepestScreen
• – displaysWhenScreenProfileChanges
• – setDisplaysWhenScreenProfileChanges:

Moving Windows

• – isMovableByWindowBackground
• – setMovableByWindowBackground:
• – isMovable
• – setMovable:
• – center

Closing Windows

• – performClose:
• – close
• – isReleasedWhenClosed
• – setReleasedWhenClosed:

Minimizing Windows

• – isMiniaturized
• – performMiniaturize:
• – miniaturize:
• – deminiaturize:
• – miniwindowImage
• – setMiniwindowImage:
• – miniwindowTitle
• – setMiniwindowTitle:

Getting the Dock Tile

• – dockTile

Printing Windows

• – print:
• – dataWithEPSInsideRect:
• – dataWithPDFInsideRect:

Providing Services

• – validRequestorForSendType:returnType:

Working with Carbon

• – initWithWindowRef:
• – windowRef

Triggering Constraint-Based Layout

• – updateConstraintsIfNeeded
• – layoutIfNeeded

Debugging Constraint-Based Layout

See Cocoa Autolayout Release Notes for more details on debugging constraint-based layout.

• – visualizeConstraints:

Constraint-Based Layouts

• – anchorAttributeForOrientation:
• – setAnchorAttribute:forOrientation:

if ([myWindow makeFirstResponder:myWindow]) {

    /* All fields are now valid; it’s safe to use fieldEditor:forObject:

        to claim the field editor. */

}

else {

    /* Force first responder to resign. */

    [myWindow endEditingFor:nil];

}

[[<window> standardWindowButton:NSWindowDocumentIconButton] setImage:<image>]