Assistant.StartWizard Method
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 |
|---|
|
See also:
- Assistant Object
- Assistant Object Members
- ActivateWizard Method
- Creating and Modifying Balloons
- EndWizard Method
- Making Run-Time Modifications to Balloons
- Overview of the Office Assistant
| PrivateX | Act |
Note