Description
Specify or inquire as to the order in which event clients will receive events.
-
Return Type
-
A Long value.
The notify priority on entry, or zero if the NotifyClient is not an event notify client for either event interface. The notify priority is 1 for the first client notified for either event interface.
-
Syntax
-
object.SetNotifyPriority (NotifyClient, Priority)
The SetNotifyPriority Method syntax has these parts: |
| object | An expression evaluating to an object of type McView. | | NotifyClient | Required. An Unknown object. An object that has previously registered as an event notify client for one of the two event interfaces. The custom _IMcBasicViewEvents is search for this client first, then the late binding _IMcViewEvents interface.
| | Priority | Required. A Long value. The desired new notify order priority. Any negative number implies the largest priority order (i.e., the last to be notified), while 1 specifies that the desired priority is the first to be notified. If 0 is supplied, then no priority change will be made, but the existing priority is returned.
|
Remarks
All clients of the custom events interface _IMcBasicViewEvents receive notifications before any clients of the late binding _IMcViewEvents events interface (this is the one that VB will reference when “With Events” is used).
However, within each group of clients, the order in which each client is notified may be set. The order is important for two reasons --- (1) many event methods supply a “bHandled” argument which the client may set to prevent any subsequent clients from being notified, and (2) clients which draw onto the view's device context during a PostPaint event will do their drawing in the order they receive this event. Thus clients that wish to be sure to be the only one allowed to handle some event (e.g., a MouseDown event) will want to be notified first, while clients that want to make sure that their drawings appear on top of all others will want to be notified last (see Example).
Overlays drawn by McGraphOverlay instances are clients of the custom interface and thus will display their drawings underneath any drawings done by VB late binding event clients that draw during the PostPaint event.
Notes
There is also a corresponding Display method mirroring this one; either may be used with identical results.
|
SetNotifyPriority Method (McView)
