|Visio Automation Reference|
Version Added: Visio 2000
Private Sub expression_EnterScope(ByVal app As [IVAPPLICATION], ByVal nScopeID As Long, ByVal bstrDescription As String)
expression A variable that represents an InvisibleApp object.
|app||Required||[IVAPPLICATION]||The instance of Microsoft Office Visio that contains the scope.|
|nScopeID||Required||Long||A language-independent number that describes the operation that just ended, or the scope ID returned by the BeginUndoScope method.|
|bstrDescription||Required||String||A textual description of the operation that changes in different language versions. Contains the user interface description of a Visio operation or the description passed to the BeginUndoScope method.|
The nScopeID value returned in the case of a Visio operation is the equivalent of the command-related constants that begin with visCmd*.
If you are using Microsoft Visual Basic or Visual Basic for Applications (VBA), the syntax in this topic describes a common, efficient way to handle events.
If you want to create your own Event objects, use the Add or AddAdvise method. To create an Event object that runs an add-on, use the Add method as it applies to the EventList collection. To create an Event object that receives notification, use the AddAdvise method. To find an event code for the event you want to create, see Event codes.
If you are handling this event from a program that receives a notification over a connection created by using the AddAdvise method, the EnterScope event is one of a group of selected events that record extra information in the EventInfo property of the Application object.
The EventInfo property returns bstrDescription, as described above. In addition, the varMoreInfo argument to VisEventProc contains a string formatted as follows: [<nScopeID>;<bErrOrCancelled>;<bstrDescription>;<nHwndContext>], where nHwndContext is the window handle (HWND) of the window that is the context for the command. nHwndContext could be 0.
For EnterScope, bErrOrCancelled always equals zero.
This example shows how to use the EnterScope event. The example determines whether a call to a procedure that handles the CellChanged event is in a particular scope—that is, whether the call occurs between the EnterScope and ExitScope events for that scope.
|Visual Basic for Applications|