Redispatch

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODDispatcher

Redispatch
The Redispatch method redispatches the specified event to the appropriate part.
ODBoolean Redispatch (inout ODEventData eventData,
                      inout ODEventInfo eventInfo);
eventData
A platform-specific structure representing an event. On return, the fields of the structure may have been modified. On the Mac OS platform, the structure is defined as a Mac OS event record.
eventInfo
A platform-specific structure that contains additional event information. On return, the relevant fields of the structure are filled in if the event was handled.
return value
kODTrue if the event was handled by a part, or kODFalse if the event is not associated with an existing part (or if the event was not handled).

DISCUSSION
The eventInfo structure contains the following information:

a reference to an embedded frame and an embedded facet of the part (for event types kODEvtMouseDownEmbedded, kODEvtMouseUpEmbedded, or kODEvtMouseDownBorder)
an ODPoint value describing the location of the event, expressed in frame coordinates
a Boolean value that indicates whether an embedded part propagated an event to its containing part

OpenDoc calls this method when it translates an event. For example, when the standard dispatch module transforms a mouse-down event in the menu bar to a menu event, the dispatch module redispatches the event so that monitors and patches can intercept the new event.

SEE ALSO
The ODEventData type (page 890).
The ODEventInfo type (page 891).
The ODDispatcher::Dispatch method (page 115).
The ODDispatchModule::Dispatch method (page 129).
"Creating a Dispatch Module" on page 447 in OpenDoc Programmer's Guide.