Manager: Dialog Manager


Carbon supports the majority of the Dialog Manager. However, your application must access Dialog Manager data structures only through the supplied accessor functions. Furthermore, your application must use the functions provided for creating and disposing of Dialog Manager data structures.

Supported  Alert

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  AppendDialogItemList

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  AppendDITL

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  AutoSizeDialog

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  CautionAlert

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  CloseDialog

The CloseDialog function is not supported because developers do not allocate their own memory for dialog boxes in Carbon. Use the DisposeDialog function to dismiss a dialog box instead. Not available in CarbonLib. Not available in Mac OS X.

Supported  CloseStandardSheet

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

Unsupported  CouldAlert

CouldAlert does nothing; unsupported since System 7, it used to make an alert color table unpurgeable.

Unsupported  CouldDialog

CouldDialog does nothing; unsupported since System 7, it used to make a dialog color table unpurgeable.

Supported  CountDITL

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  CreateStandardAlert

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

Supported  CreateStandardSheet

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

Supported  DialogCopy

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  DialogCut

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  DialogDelete

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  DialogPaste

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  DialogSelect

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  DisposeDialog

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  DisposeModalFilterUPP

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

Supported  DisposeModalFilterYDUPP

This function is supported in Carbon because several QuickTime routines require it. Available in CarbonLib 1.0.2 and later. Available in Mac OS X 10.0 and later.

Unsupported  DisposeSoundUPP

Using custom sounds in dialog boxes is not supported in Carbon.

Supported  DisposeUserItemUPP

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

Supported  DrawDialog

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  ErrorSound

Using custom sounds in dialog boxes is not supported in Carbon. Not available in CarbonLib. Not available in Mac OS X.

Supported  FindDialogItem

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  finddialogitem

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

Unsupported  FreeAlert

FreeAlert does nothing; unsupported since System 7, it used to make a dialog color table purgeable after making it unpurgeable by calling CouldAlert.

Unsupported  FreeDialog

FreeDialog does nothing; unsupported since System 7, it used to make a dialog color table purgeable after making it unpurgeable by calling CouldDialog.

Supported  GetAlertStage

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  GetDialogCancelItem

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

Unsupported  GetDialogControlNotificationProc

QuickTime dialog notification functions are not supported in Carbon.

Supported  GetDialogDefaultItem

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

Supported  GetDialogFromWindow

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

Supported  GetDialogItem

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  GetDialogItemAsControl

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  GetDialogItemText

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  getdialogitemtext

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

Supported  GetDialogKeyboardFocusItem

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

Unsupported  GetDialogParent

This QuickTime function for manipulating dialog boxes is not supported in Carbon.

Supported  GetDialogPort

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

Unsupported  GetDialogRefCon

Use GetWindowProperty instead.

Supported  GetDialogTextEditHandle

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

Supported  GetDialogTimeout

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  GetDialogWindow

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

Supported  GetModalDialogEventMask

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  GetNewDialog

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  GetParamText

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

Supported  GetStandardAlertDefaultParams

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

Supported  GetStdFilterProc

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  HideDialogItem

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  InitDialogs

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

Supported  InsertDialogItem

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

Supported  InvokeModalFilterUPP

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

Supported  InvokeModalFilterYDUPP

This function is supported in Carbon because several QuickTime routines require it. Available in CarbonLib 1.0.2 and later. Available in Mac OS X 10.0 and later.

Unsupported  InvokeSoundUPP

Using custom sounds in dialog boxes is not supported in Carbon.

Supported  InvokeUserItemUPP

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

Supported  IsDialogEvent

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  ModalDialog

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  MoveDialogItem

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  NewColorDialog

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  newcolordialog

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

Supported  NewDialog

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  newdialog

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

Supported  NewFeaturesDialog

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  NewModalFilterUPP

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

Supported  NewModalFilterYDUPP

This function is supported in Carbon because several QuickTime routines require it.

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

Unsupported  NewSoundUPP

Using custom sounds in dialog boxes is not supported in Carbon.

Supported  NewUserItemUPP

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

Supported  NoteAlert

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  ParamText

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  paramtext

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

Supported  RemoveDialogItems

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

Supported  ResetAlertStage

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  RunStandardAlert

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

Supported  SelectDialogItemText

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  SetDialogCancelItem

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  SetDialogDefaultItem

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  SetDialogFont

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  SetDialogItem

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  SetDialogItemText

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  setdialogitemtext

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

Unsupported  SetDialogMovableModal

This QuickTime function for manipulating dialog boxes is not supported in Carbon.

Supported  SetDialogTimeout

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  SetDialogTracksCursor

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  SetModalDialogEventMask

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  SetModelessDialogCallbackProc

Supported  SetPortDialogPort

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

Supported  ShortenDITL

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  ShowDialogItem

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  SizeDialogItem

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  StandardAlert

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  StdFilterProc

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  StopAlert

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  UpdateDialog

Available in CarbonLib 1.0 and later when running Mac OS 8.1 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.