Starts the Office Assistant and returns a Long value that identifies the session.

Note
The Microsoft Office Assistant and AnswerWizard have been depreciated in the release of the Microsoft Office system.
Note
The number returned by StartWizard method is used by the ActivateWizard and EndWizard methods.

Syntax

expression.StartWizard(On, Callback, PrivateX, Animation, CustomTeaser, Top, Left, Bottom, Right)

expression A variable that represents an Assistant object.

Parameters

Name Required/Optional Data Type Description
On Required Boolean True to display the Office decision balloon. The Office decision balloon asks the user whether he or she wants help with the active custom wizard. It isn't necessary to use the Visible property to display the Office Assistant if you specify True for this argument.
Callback Required String The name of the callback procedure run by the Office decision balloon and the branch balloon. The branch balloon allows the user to choose between custom Help you've provided for the wizard and standard Office Help.
PrivateX Required Long A number that identifies the balloon that initiated the callback procedure.
Animation Optional Variant The animation the Office Assistant performs when this method is used. The default value is msoAnimationGetWizardy.
CustomTeaser Optional Variant False to display the Office decision balloon.
Top Optional Variant The position of the corners (in points and relative to the screen) at the top of the custom wizard form the Office Assistant will avoid when the Office Assistant appears.
Left Optional Variant The position of the corners (in points and relative to the screen) to the left of the custom wizard form the Office Assistant will avoid when the Office Assistant appears.
Bottom Optional Variant The position of the corners (in points and relative to the screen) at the bottom of the custom wizard form the Office Assistant will avoid when the Office Assistant appears.
Right Optional Variant The position of the corners (in points and relative to the screen) to the right of the custom wizard form the Office Assistant will avoid when the Office Assistant appears.

Return Value
Long

Remarks

Unlike callback procedures used by standard modeless balloons, the callback procedure called by the modeless decision and branch balloons displayed during an Office Assistant wizard session takes only two arguments: an MsoWizardMsgType constant, and the unique value specified by theargument of the StartWizardmethod.

If the user clicks the left button in the decision or branch balloon, the constant msoWizardMsgShowHelp is passed to the first argument of the callback procedure. If the user clicks the right button, the constant msoWizardLocalStateOff is passed. (The other MsoWizardMsgType constants are passed by the ActivateWizard method if you've specified msoWizardActResume or msoWizardActSuspend for theargument). In the case of msoWizardMsgShowHelp, the callback procedure should display the appropriate balloon for the current panel of the custom wizard. And in the case of msoWizardLocalStateOff, the callback procedure should hide the visible balloon.

Example

This example starts the Office Assistant as part of a proces to provide information while a custom wizard is running. The variable lHelpForWiz is set to the return value of the StartWizard method, which is Long.

Visual Basic for Applications
lHelpForWiz = Assistant.StartWizard(On:=True, _ Callback:="myCallback", PrivateX:=23)
activate help wizard display help assistant initiate help assistance ofv start start the office assistant start wizard Start Wizard Method StartWizard startwizard method use online help

See also:

PrivateX Act