Método StartWizard

Microsoft Office Objects

Método StartWizard

       

Es posible que algunas partes de este tema no sean aplicables a algunos idiomas.

Inicia el Ayudante de Office y devuelve un valor Long que identifica la sesión. Sólo puede utilizar este método para iniciar el Ayudante de Office en un asistente personalizado.

Nota   El número devuelto por el método StartWizard lo utilizan los métodos ActivateWizard y EndWizard.

expresión.StartWizard(On, Callback, PrivateX, Animation, CustomTeaser, Top, Left, Bottom, Right)

expresión    Requerida. Expresión que devuelve un objeto Assistant.

On   Boolean requerido. True para mostrar el globo de Office. El globo de Office pregunta al usuario si desea ayuda para el asistente personalizado activo. No es necesario utilizar la propiedad Visible para mostrar el Ayudante de Office Assistant si se ha especificado True para este argumento.

Callback   String requerida. El nombre del procedimiento de devolución de llamada iniciado por el globo de Office y el globo secundario. El globo secundario permite al usuario a elegir entre la ayuda personalizada que proporciona el asistente y la ayuda estándar de Office.

PrivateX   Long requerido. Un número que identifica el globo que ha iniciado el procedimiento de devolución de llamada.

Animation   Variant opcional. La animación del Ayudante de Office cuando se utiliza este método. El valor predeterminado es msoAnimationGetWizardy.

CustomTeaser   Variant opcional. False para mostrar el globo de Office.

Top, Left, Bottom, Right   Variant opcional. La posición de las esquinas, en puntos y con relación a la pantalla, del asistente personalizado desde el Ayudante de Office determinará cuándo aparece el Ayudante de Office.

Comentarios

A diferencia de los procedimientos de devolución de llamada utilizados por los globos estándar sin modo, el procedimiento de devolución llamado por el globo de Office y el globo secundario que aparece durante una sesión del asistente para el Ayudante de Office, sólo lleva dos argumentos: una constante MsoWizardMsgType y el único valor especificado por el argumento PrivateX del método StartWizard.

Si el usuario hace clic con el botón secundario en el globo de Office o en el globo secundario, la constante msoWizardMsgShowHelp pasa al primer argumento del procedimiento de devolución de llamada. Si el usuario hace clic en el botón secundario, pasa la constante msoWizardLocalStateOff. Las demás constantes MsoWizardMsgType pasan por el método ActivateWizard si se ha especificado msoWizardActResume o msoWizardActSuspend para el argumento Act. En el caso de msoWizardMsgShowHelp, el procedimiento de devolución de llamada debe mostrar el globo adecuado para el panel actual del asistente personalizado. Además, en el caso de msoWizardLocalStateOff, el procedimiento de devolución de llamada debe ocultar el globo visible.

Ejemplo

Este ejemplo inicia el Ayudante de Office como parte del proceso que proporciona información mientras se ejecuta un asistente personalizado. La variable IHelpForWiz se ha establecido en el valor devuelto por el método StartWizard, que es Long.

lHelpForWiz = Assistant.StartWizard(On:=True, _
    Callback:="myCallback", PrivateX:=23)