Carbon


Notification Messages

Header: Displays.h

enum {
    kDMNotifyRequestConnectionProbe = ,
    kDMNotifyInstalled = 1,
    kDMNotifyEvent = 2,
    kDMNotifyRemoved = 3,
    kDMNotifyPrep = 4,
    kDMNotifyExtendEvent = 5,
    kDMNotifyDependents = 6,
    kDMNotifySuspendConfigure = 7,
    kDMNotifyResumeConfigure = 8,
    kDMNotifyRequestDisplayProbe = 9,
    kExtendedNotificationProc = 65536
};

Constant descriptions

kDMNotifyRequestConnectionProbe
kDMNotifyInstalled

The Display Manager provides this message during a callback function to if your application has installed an extended notification procedure pointer for the first time. The Display Manager provides this message in the notifyData parameter of DMExtendedNotificationProcPtr .

kDMNotifyEvent

The Display Manager provides this message when an Apple event update occurs, after a display configuration change is made. This is the only time non-extended notifications are called.

kDMNotifyRemoved

The Display Manager provides this message when the function DMRemoveExtendedNotifyProc is called on your function.

kDMNotifyPrep

Before passing kDMSNotifyRemoved, the Display Manager provides this message to indicate that it is about to begin to configure. Calling DMBeginConfigureDisplays tells the Display Manager to send this message.

kDMNotifyExtendEvent
kDMNotifyDependents

The Display Manager provides this message to DMSendDependentNotification.

kDMNotifySuspendConfigure

The Display Manager passes this selector to notify your UPP that configuration is temporarily suspended. For instance, if a video game makes a temporary change to the display configuration, the game is expected to resume configuration and restore video before allowing other applications to access the screen.

kDMNotifyResumeConfigure

The Display Manager passes this selector to notify your application when previously suspended configuration is resumed. Your application can then replace windows and icons, and change depth mode if necessary.

kDMNotifyRequestDisplayProbe
kExtendedNotificationProc

Display Manager functions needed for dependency notification and event processing use the notification message selectors in extended application-defined functions. DMRegisterExtendedNotifyProc gets all these messages. Applications should update all information about the display configurations at this point.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)