Control.Dispatch Method (Typed) |  |
Provide the prototype dispatcher for events within the system when the control has focus; routing various events to their appropriate event handlers.
Namespace: XSharp.VO.SDK
Assembly: XSharp.VOGUIClasses (in XSharp.VOGUIClasses.dll) Version: 2.21
SyntaxRequest Example
View Source
A numeric value representing the event handler to handle the event.
Parameters
- oEvent
- Type: Event
The event to be handled.
Return Value
Type: UsualA numeric value representing the event handler to handle the event.
Remarks Tip |
|---|
| Important! This is a callback method used by X#. Normally, it should not be called in your application code. |
| Tip |
|---|
|
If you want to set a specific return value for the underlying window procedure, you have to change the EventReturnValue variable for the control object.
If you want to handle other events (for example, timer events), you need to write your own Dispatch() method.
The following guidelines should be followed when writing a customized Dispatch() method:
1. Subclass an event type appropriate to the type of operation for which it is being used.
2. Add an event handler function to your derived object. (This event handler should be called with the event when the event is received.)
3. In general, the implementation of this event handler should call Default(). This keeps the same behavior as the base class, but it also allows other classes to provide useful event handlers for your new type of event, allowing you to provide a framework for other classes to use.
The base class Dispatch() method should be called in those cases where the received event is not handled by the customized dispatcher. For example:
X# 1RETURN SUPER:Dispatch(<paramref name="oEvent" />) |
See Also