Propriété InvisibleApp.EventInfo (Visio)

Récupère des informations complémentaires associées à un événement, si elles existent. En lecture seule.

Syntaxe

expression. EventInfo (eventSeqNum)

Expression Variable qui représente un objet InvisibleApp .

Parameters

Nom Requis/Facultatif Type de données Description
eventSeqNum Obligatoire Long visEvtIDMostRecent (0) pour plus d’informations sur l’événement le plus récent déclenché ou le numéro de séquence de l’événement à examiner (voir VisEventCodes).

Valeur renvoyée

Chaîne

Remarques

Lorsque Microsoft Visio déclenche un événement, des informations complémentaires ne sont disponibles que pour un petit nombre d’événements. Ces événements sont BeforeDocumentSaveAs, DocumentSavedAs, EnterScope, ExitScope, MarkerEvent, ShapesDeleted et ShapeChanged. Utilisez la propriété EventInfo de l’application pour obtenir ces informations lorsqu’elles sont disponibles.

La propriété EventInfo renvoie les éléments suivants :

  • une chaîne dont le contenu est spécifique à l'événement en question, si l'événement comporte des informations complémentaires ;

  • une chaîne vide si un événement ne comporte pas d'informations complémentaires ;

  • une erreur si Microsoft Visio ne détient plus d’informations pour l’événement spécifié.

Pour plus d'informations sur le contenu de la propriété EventInfo pour un événement, reportez-vous à la rubrique consacrée à cet événement.

Si la cible d'un événement lit la propriété EventInfo immédiatement après le déclenchement, l'événement le plus récent et celui dont le numéro séquentiel a été transmis à la cible sont identiques. Toutefois, ce n'est pas toujours le cas, si la cible est un module complémentaire utilisant un fichier exécutable (.exe), car ce fichier et Visio sont des tâches distinctes qui ne sont pas modales l'une par rapport à l'autre.

Remarque

Les gestionnaires d'événement qui utilisent le mot clé WithEvents de Microsoft Visual Basic pour Applications (VBA) n'ont accès qu'à l'événement le plus récent et doivent utiliser visEvtIDMostRecent.

Pour vous assurer que les informations retournées par la propriété EventInfo sont associées <sequence number> au même événement qui a déclenché le module complémentaire, le fichier exécutable peut passer en tant qu’argument à la propriété EventInfo . Vous pouvez obtenir le numéro séquentiel d'un événement grâce à l'une des méthodes suivantes :

  • Si la propriété Action de l’objet Event renvoie visActCodeRunAddon, la chaîne de ligne de commande passée au module complémentaire contient une sous-chaîne au format "/eventid=<sequence number>".

    Même si la sous-chaîne est étiquetée "/eventid", ne confondez pas le <sequence number> passé dans la chaîne de ligne de commande avec la propriété ID de l’objet Event de déclenchement, qui identifie l’objet Event dans sa collection EventList . Le numéro transmis est en fait le numéro séquentiel de déclenchement.

  • Si la propriété Action de l'objet Event renvoie visActCodeAdvise, le numéro séquentiel est transmis en tant qu'argument à la procédure exécutée par l'objet cible VisEventProc.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.