Session Manager

The MicroStation user interface focuses on one design file and one model within that file at a time. More...

Classes
struct	SessionMonitor
	Create a subclass of this class to monitor significant session-related events. More...
struct	ISessionMgr
	The Session Manager manages the Master DGN. More...

Enumerations
enum	ChooseMasterFileStatus { CHOOSEMASTERFILE_STATUS_Invalid = 0, CHOOSEMASTERFILE_STATUS_Handled = 1, CHOOSEMASTERFILE_STATUS_Canceled = 2 }
enum	UIItemStateType { None = 0, Visible = (1 << 0), Enabled = (1 << 1), Checked = (1 << 2) }
	The state types that match up with the different expression type in an XCommad definiton. More...

Detailed Description

The MicroStation user interface focuses on one design file and one model within that file at a time.

The design file whose views are displayed is called the "MasterFile" and the model is called the "Active Model". A new session begins when a file becomes the MasterFile. When a session begins, the session manager does the following:

• Loads the selected model of the new file into memory.
• Loads models referenced by the new file (if not carried over).
• Opens and displays the default views
• Sets default symbology and reinitializes the rest of the system. Sets the workmode, based on the file format.
• Attaches default cell libraries
• Loads DGNAPPs
• Calls SessionMonitor::_OnMasterFileStart and SYSTEM_NEWFILE_COMPLETE hooks

A session ends when the Master DGN is closed, a new file is to become the master, or when MicroStation shuts down. When ending a session, the session manager does the following:

• Closes views associated with the current Master DGN.
• Closes and unloads the current master DGN.
• Unloads models referenced by the file (unless they carry over to the new file). May close referenced files.
• Calls SessionMonitor::_OnMasterFileStop and SYSTEM_NEWFILE_CLOSE hooks

Enumeration Type Documentation

enum ChooseMasterFileStatus

Enumerator
CHOOSEMASTERFILE_STATUS_Invalid
CHOOSEMASTERFILE_STATUS_Handled
CHOOSEMASTERFILE_STATUS_Canceled

enum UIItemStateType

strong

The state types that match up with the different expression type in an XCommad definiton.

Enumerator
None	None can be used to trigger sync message without changing state value.
Visible	For use with Show/Hide expression.
Enabled	For use with Enable/Disable expression.
Checked	For use with Toggle expression.