Manager: Window Manager


Carbon supports the Window Manager. Be aware, however, that if you use custom window definition procedures (also known as WDEFs), you must compile them as PowerPC-native code. In addition:

Supported  ActivateWindow

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Supported  ActiveNonFloatingWindow

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Supported  AreFloatingWindowsVisible

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  BeginUpdate

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  BeginWindowProxyDrag

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  BringToFront

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Not Recommended  CalcVis

If you are using this function to redraw your own floating windows, you should just use the standard floating window class instead. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Not Recommended  CalcVisBehind

If you are using this function to redraw your own floating windows, you should just use the standard floating window class instead. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  ChangeWindowAttributes

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  ChangeWindowGroupAttributes

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  ChangeWindowPropertyAttributes

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  CheckUpdate

Generally not required. If you need to check for an update event, you can call the Carbon Event Manager function IsEventInQueue or FindSpecificEventInQueue. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Not Recommended  ClipAbove

If you are using this function to redraw your own floating windows, you should just use the standard floating window class instead. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  CloneWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Unsupported  CloseWindow

The CloseWindow function is not supported because developers do not allocate their own memory for windows in Carbon. Use the DisposeWindow function to remove a window instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  CollapseAllWindows

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  CollapseWindow

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  ConstrainWindowToScreen

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  CopyWindowAlternateTitle

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  CopyWindowGroupName

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  CopyWindowTitleAsCFString

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  CountWindowGroupContents

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Supported  CreateCustomWindow

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  CreateNewWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  CreateQDContextForCollapsedWindowDockTile

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  CreateStandardWindowMenu

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  CreateWindowFromCollection

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  CreateWindowFromResource

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  CreateWindowGroup

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  DebugPrintAllWindowGroups

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  DebugPrintWindowGroup

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  DisableScreenUpdates

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Unsupported  DisposeDeskHookUPP

You cannot access the DeskHook global variable in Carbon. Therefore, Carbon does not support application-defined functions for drawing the desktop.

Supported  DisposeWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  DisposeWindowDefUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  DisposeWindowPaintUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  DragGrayRgn

Can't be used for live dragging. If you are implementing your own window dragging, use DragWindow instead. If you need to override window positioning during a drag, register a Carbon event handler for kEventWindowBoundsChanging. Okay to use if you're dragging objects within a window. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  draggrayrgn

Use DragGrayRgn instead. Not available in CarbonLib. Not available in Mac OS X.

Not Recommended  DragTheRgn

Can't be used for live dragging. If you are implementing your own window dragging, use DragWindow instead. If you need to override window positioning during a drag, register a Carbon event handler for kEventWindowBoundsChanging. Okay to use if you're dragging objects within a window. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  DragWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  dragwindow

Use DragWindow instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  DrawGrowIcon

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  DrawNew

DrawNew is not available in Carbon. Use ReshapeCustomWindow instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  EnableScreenUpdates

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  EndUpdate

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  EndWindowProxyDrag

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  FindWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  findwindow

Use FindWindow instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  FindWindowOfClass

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  FrontNonFloatingWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  FrontWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  GetAuxWin

Remove application reliance on AuxWinRec data structures; in the future, the information in these structures may be invalid or unavailable to applications.

Supported  GetAvailableWindowAttributes

Available in CarbonLib 1.5 and later. Available in Mac OS X 10.1 and later.

Supported  GetAvailableWindowPositioningBounds

Available in CarbonLib 1.3 and later. Available in Mac OS X 10.0 and later.

Unsupported  GetCWMgrPort

Carbon does not support accessing the Window Manager port. You should draw into your own graphics port instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  GetFrontWindowOfClass

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  GetGrayRgn

Use GetAvailableWindowPositioningBounds if you want to determine where you can position your windows. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  GetIndexedWindow

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Not Recommended  GetNewCWindow

If you must get your window definition from a resource, use CreateWindowFromResource. Otherwise use CreateWindowFromNib. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Not Recommended  GetNewWindow

If you must get your window definition from a resource, use CreateWindowFromResource. Otherwise use CreateWindowFromNib. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  GetNextWindow

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetNextWindowOfClass

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetSheetWindowParent

Available in CarbonLib 1.3 and later. Available in Mac OS X 10.0 and later.

Supported  GetWindowActivationScope

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Supported  GetWindowAttributes

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  GetWindowBounds

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  GetWindowClass

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  GetWindowContentColor

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  GetWindowContentPattern

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Unsupported  GetWindowContentRgn

Use the GetWindowRegion function with the kWindowContentRgn selector instead.

Unsupported  GetWindowControlList

Accessing the window control list is not supported in Carbon. Use the Control Manager's control embedding hierarchy functions (CreateRootControl, GetRootControl, EmbedControl, AutoEmbedControl, GetSuperControl, GetIndexedSubControl, and SetControlSupervisor) to determine control ordering instead.

Unsupported  GetWindowDataHandle

Supported  GetWindowFeatures

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetWindowFromPort

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  GetWindowGoAwayFlag

Use GetWindowAttributes instead. Available in CarbonLib 1.0 and later. Not available in Mac OS X.

Supported  GetWindowGreatestAreaDevice

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  GetWindowGroup

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Supported  GetWindowGroupAttributes

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  GetWindowGroupContents

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Supported  GetWindowGroupLevel

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  GetWindowGroupOfClass

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Supported  GetWindowGroupOwner

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  GetWindowGroupParent

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  GetWindowGroupRetainCount

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.1 and later.

Supported  GetWindowGroupSibling

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  GetWindowIdealUserState

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  GetWindowIndex

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Supported  GetWindowKind

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetWindowList

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetWindowModality

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  GetWindowOwnerCount

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  GetWindowPic

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  GetWindowPort

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetWindowPortBounds

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetWindowProperty

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  GetWindowPropertyAttributes

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetWindowPropertySize

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  GetWindowProxyAlias

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Not Recommended  GetWindowProxyFSSpec

Use of file specifications is no longer recommended. An alternate API that uses FSRef types is preferred. Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  GetWindowProxyIcon

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  GetWindowRegion

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  GetWindowRetainCount

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Unsupported  GetWindowSpareFlag

Use GetWindowAttributes instead. Available in CarbonLib 1.0 and later. Not available in Mac OS X.

Supported  GetWindowStandardState

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetWindowStructurePort

Available in CarbonLib 1.5 and later. Available in Mac OS X 10.1 and later.

Unsupported  GetWindowStructureRgn

Use the GetWindowRegion function with the kWindowStructureRgn selector instead.

Supported  GetWindowStructureWidths

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Unsupported  GetWindowTitleWidth

Unsupported  GetWindowUpdateRgn

Use the GetWindowRegion function with the kWindowUpdateRgn selector instead.

Supported  GetWindowUserState

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  GetWindowWidgetHilite

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Unsupported  GetWindowZoomFlag

You should instead call the function GetWindowAttributes and check the kWindowHorizontalZoomAttribute or kWindowVerticalZoomAttribute attributes.

Unsupported  GetWMgrPort

Carbon does not support accessing the Window Manager port. You should draw into your own graphics port instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  GetWRefCon

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Not Recommended  GetWTitle

Use CopyWindowTitleAsCFString instead. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  getwtitle

Use CopyWindowTitleAsCFString instead. Not available in CarbonLib. Not available in Mac OS X.

Not Recommended  GetWVariant

Use GetWindowAttributes instead. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Not Recommended  GrowWindow

Use ResizeWindow instead. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  growwindow

Use ResizeWindow instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  HideFloatingWindows

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  HideSheetWindow

Available in CarbonLib 1.3 and later. Available in Mac OS X 10.0 and later.

Supported  HideWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Not Recommended  HiliteWindow

If available, use the ActivateWindow function instead. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  HiliteWindowFrameForDrag

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Unsupported  InitFloatingWindows

There is no need to initialize this Window Manager functionality because the shared library is loaded as needed. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  InitWindows

InitWindows is not supported in Carbon. There is no need to initialize the Window Manager because the shared library is loaded as needed. Not available in CarbonLib. Not available in Mac OS X.

Supported  InstallWindowContentPaintProc

Available in CarbonLib 1.0 and later when running Mac OS 9 or later. Available in Mac OS X 10.0 and later.

Unsupported  InvalRect

Calls InvalWindowRect, which takes a window pointer as an additional parameter.

Invalidation works on windows, not ports, and because windows are not ports in Carbon, this change is necessary. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  InvalRgn

Calls InvalWindowRgn, which takes a window pointer as an additional parameter. Invalidation works on windows, not ports, and because windows are not ports in Carbon, this change is necessary. Not available in CarbonLib. Not available in Mac OS X.

Supported  InvalWindowRect

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  InvalWindowRgn

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Unsupported  InvokeDeskHookUPP

You cannot access the DeskHook global variable in Carbon. Therefore, Carbon does not support application-defined functions for drawing the desktop.

Supported  InvokeWindowDefUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  InvokeWindowPaintUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  IsValidWindowClass

Available in CarbonLib 1.5 and later. Available in Mac OS X 10.1 and later.

Supported  IsValidWindowPtr

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  IsWindowActive

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Supported  IsWindowCollapsable

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  IsWindowCollapsed

Available in CarbonLib 1.0 and later when Appearance 1.0 or later is present. Available in Mac OS X 10.0 and later.

Supported  IsWindowContainedInGroup

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Supported  IsWindowHilited

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  IsWindowInStandardState

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  IsWindowLatentVisible

Available in CarbonLib 1.5 and later. Available in Mac OS X 10.1 and later.

Supported  IsWindowModified

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  IsWindowPathSelectClick

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  IsWindowPathSelectEvent

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  IsWindowUpdatePending

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  IsWindowVisible

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  MoveWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  MoveWindowStructure

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Not Recommended  NewCWindow

You should use CreateNewWindow instead.

However, if you are still using the NewCWindow function in Carbon, note that you cannot pass your own storage in to the wStorage parameter.

Carbon does not support custom window definitions stored in 'WDEF' resources. If you want to specify a custom window definition for NewCWindow, you must compile your definition function directly in your application and then register the function by calling RegisterWindowDefinition. When NewCWindow gets a procID value that doesn't recognize, it checks a special mapping table to find the pointer that's registered for the resource ID embedded in the procID parameter. It then calls that function to implement your window. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  newcwindow

Use NewCWindow instead. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  NewDeskHookUPP

You cannot access the DeskHook global variable in Carbon. Therefore, Carbon does not support application-defined functions for drawing the desktop.

Not Recommended  NewWindow

Use CreateNewWindow instead.

In Carbon, you cannot pass your own storage in to the wStorage parameter.

In Carbon, NewWindow is functionally equivalent to the NewCWindow, in that NewWindow returns a color window instead of a monochrome window.

Carbon does not support custom window definitions stored in 'WDEF' resources. If you want to specify a custom window definition for NewWindow, you must compile your definition function directly in your application and then register the function by calling RegisterWindowDefinition. When NewWindow gets a procID value that doesn't recognize, it checks a special mapping table to find the pointer that's registered for the resource ID embedded in the procID parameter. It then calls that function to implement your window. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  newwindow

Use NewCWindow instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  NewWindowDefUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  NewWindowPaintUPP

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Not Recommended  PaintBehind

If you are using this function to redraw your own floating windows, you should just use the standard floating window class instead. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Not Recommended  PaintOne

If you are using this function to redraw your own floating windows, you should just use the standard floating window class instead. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  PinRect

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  pinrect

Use PinRect instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  RegisterWindowDefinition

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  ReleaseQDContextForCollapsedWindowDockTile

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  ReleaseWindow

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  ReleaseWindowGroup

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Supported  RemoveWindowProperty

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  RemoveWindowProxy

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  RepositionWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  ReshapeCustomWindow

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  ResizeWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  RetainWindow

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  RetainWindowGroup

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Unsupported  SaveOld

SaveOld is not available in Carbon. Use ReshapeCustomWindow instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  ScrollWindowRect

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  ScrollWindowRegion

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  SelectWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  SendBehind

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  SendWindowGroupBehind

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Unsupported  SetDeskCPat

You can no longer affect the desktop under Carbon, so SetDeskCPat has been removed from Carbon. There is no replacement function. Not available in CarbonLib. Not available in Mac OS X.

Supported  SetPortWindowPort

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Unsupported  SetWinColor

Use SetWindowContentColor. Not available in CarbonLib. Not available in Mac OS X.

Supported  SetWindowActivationScope

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Supported  SetWindowAlternateTitle

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  SetWindowBounds

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  SetWindowClass

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  SetWindowContentColor

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  SetWindowContentPattern

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Unsupported  SetWindowControlList

Accessing the window control list is not supported in Carbon. Use the Control Manager's control embedding hierarchy functions (CreateRootControl, GetRootControl, EmbedControl, AutoEmbedControl, GetSuperControl, GetIndexedSubControl, and SetControlSupervisor) to determine control ordering instead.

Unsupported  SetWindowDataHandle

Supported  SetWindowGroup

Available in CarbonLib 1.4 and later. Available in Mac OS X 10.0 and later.

Supported  SetWindowGroupLevel

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  SetWindowGroupName

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  SetWindowGroupOwner

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  SetWindowGroupParent

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Supported  SetWindowIdealUserState

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  SetWindowKind

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  SetWindowModality

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  SetWindowModified

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  SetWindowPic

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  SetWindowProperty

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  SetWindowProxyAlias

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  SetWindowProxyCreatorAndType

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Not Recommended  SetWindowProxyFSSpec

Use of file specifications is no longer recommended. An alternate API that uses FSRef types is preferred. Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  SetWindowProxyIcon

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  SetWindowStandardState

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  SetWindowTitleWithCFString

Available in CarbonLib 1.1 and later. Available in Mac OS X 10.0 and later.

Supported  SetWindowUserState

Available in CarbonLib 1.0 and later. Available in Mac OS X 10.0 and later.

Supported  SetWRefCon

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Not Recommended  SetWTitle

Use SetWindowTitleWithCFString instead. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  setwtitle

Use SetWTitle instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  ShowFloatingWindows

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Not Recommended  ShowHide

Use ShowWindow or HideWindow instead. Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  ShowSheetWindow

Available in CarbonLib 1.3 and later. Available in Mac OS X 10.0 and later.

Supported  ShowWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  SizeWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  StoreWindowIntoCollection

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  TrackBox

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  trackbox

Use TrackBox instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  TrackGoAway

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Unsupported  trackgoaway

Use TrackGoAway instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  TrackWindowProxyDrag

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  TrackWindowProxyFromExistingDrag

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  TransitionWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  TransitionWindowAndParent

Available in CarbonLib 1.5 and later. Available in Mac OS X 10.0 and later.

Supported  UpdateCollapsedWindowDockTile

Not available in CarbonLib. Available in Mac OS X 10.0 and later.

Unsupported  ValidRect

Calls ValidWindowRect, which takes a window pointer as an additional parameter. Validation works on windows, not ports, and because windows are not ports in Carbon, this change is necessary. Not available in CarbonLib. Not available in Mac OS X.

Unsupported  ValidRgn

Calls ValidWindowRgn, which takes a window pointer as an additional parameter. Validation works on windows, not ports, and because windows are not ports in Carbon, this change is necessary. Not available in CarbonLib. Not available in Mac OS X.

Supported  ValidWindowRect

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  ValidWindowRgn

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  WindowPathSelect

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

Supported  ZoomWindow

Available in CarbonLib 1.0 and later when running Mac OS 8.1 or later. Available in Mac OS X 10.0 and later.

Supported  ZoomWindowIdeal

Available in CarbonLib 1.0 and later when running Mac OS 8.5 or later. Available in Mac OS X 10.0 and later.

[Table of Contents] [Manager Index] [Function Index]

Generated on: 12/12/2001. Copyright © 1999-2001 Apple Computer, Inc. All rights reserved.