NotifyContext Property

Description

When a notify is in progress, gives the notify depth and indicates if the notify was caused by some user action.

Property type

A mcGraphOverlayNotifyContext enumeration.

Syntax

object.NotifyContext [= value]

The NotifyContext Property syntax has these parts:

Part	Description
object	An expression evaluating to an object of type McGraphOverlay.
value	A mcGraphOverlayNotifyContext enumeration, as described in settings.

Settings

The settings for value are:

Constant		Value	Description
	mcgoncNone	0	no context flags and zero notify depth
	mcgoncNotifyDepthMask	255	Mask for the notify depth portion of the property. The notify depth count portion of the NotifyContext property is set automatically and cannot be changed by assignment.
	mcgoncFromTool	4096	the notify event came from use of a tool. This flag will be set automatically for some notifications. It cannot be set on assignment
	mcgoncFromUser	8192	The notify event came from use of some UI element such as a menu or toolbar. This flag is never set automatically. It must be assigned to the NotifyContext property before the call that initiates the event. This is is the only bit of the NotifyContext property that can be set by assignment, all other bits are read-only.
	mcgoncFromUserMask	12288	mask for the notify flags that indicate that the notify was caused by some user-initiated action (as opposed to a macro call).

Remarks

The low order bits of the NotifyContext property are a numeric count of the notify depth (which will be zero if no notify is in progress). The other values are bit flags that indicate if the notify currently in progress was caused by some user action. One of these flags (mcgoncFromTool) is set automatically. The other flag (mcgoncFromUser) must be set by assignment before calling a method (e.g., EditPaste) that will produce a notify and that you want to flag as being user intiated.