Inside Macintosh: QuickTime Components /

Chapter 7 - Sequence Grabber Panel Components / Sequence Grabber Panel Components Reference

Functions / Processing Your Panel's Events

SGPanelEvent

Your SGPanelEvent function allows your component to receive and process dialog events. This function is similar to a modal-dialog filter function.

pascal ComponentResult SGPanelEvent (SeqGrabPanelComponent s,
                                     SGChannel c, DialogPtr d,
                                     short itemOffset,
                                     EventRecord *theEvent, 
                                     short *itemHit,
                                     Boolean *handled);

s

Identifies the sequence grabber component's connection to your panel component.

c

Identifies a connection to the sequence grabber channel associated with your panel component.

d

Contains a dialog pointer identifying the settings dialog box.

itemOffset

Specifies the offset to your panel's first item in the dialog box.

theEvent

Contains a pointer to an event structure. This event structure contains information identifying the nature of the event.

itemHit

Contains a pointer to a field that is to receive the item number in cases where your component handles the event. The number returned is an absolute, not a relative number, so it must be offset by the itemOffset parameter.

handled

Contains a pointer to a Boolean value. Set this Boolean value to indicate whether your component handles the event: set it to true if you handle the event; set it to false if you do not.

DESCRIPTION

A sequence grabber component calls your SGPanelEvent function whenever an event occurs in the settings dialog box. Your SGPanelEvent function is similar to a modal- dialog filter function. The main difference is that, rather than returning a Boolean value to indicate whether you handled the event, your SGPanelEvent function sets a Boolean value that is provided by the calling function. If you handle the event, be sure to update the field referred to by the itemHit parameter.

SEE ALSO

Your component can process mouse clicks with your SGPanelItem function. This function is discussed on page 7-21.