Mode Property

Some of the content in this topic may not be applicable to some languages.

Returns or sets the modal behavior of the Office Assistant balloon. When you create a Balloon object, this property is initially set to msoModeModal. Read/write MsoModeType.

Remarks

If the Mode property for a balloon is set to msoModeModeless, the user can work in the application while the balloon is visible. If the property is set to msoModeModal, the user must dismiss the balloon before continuing to work in the application. If the property is set to msoModeAutoDown, the balloon is dismissed when the user clicks anywhere on the screen.

If the Mode property for a balloon is set to msoModeModeless and a value for the Callback property is not supplied, an error occurs. The Close method can only be used in the procedure specified by the Callback property when the Mode property is set to msoModeModeless.

Example

This example creates a balloon with an alert icon that instructs the user to select a printer. Because the balloon is modeless, the user has access to printer commands while the balloon is visible. When the user clicks the OK button, the procedure specified in the Callback property is run.

With Assistant.NewBalloon
    .Heading = "Select A Printer"
    .Text = "You must select a printer before printing."
    .Icon = msoIconAlert
    .CheckBoxes(1).Text = "Local printer"
    .CheckBoxes(2).Text = "Network printer"
    .Mode = msoModeModeless
    .Callback = "ProcessPrinter"
    .Show
End With