Événement Application.MustFlushScopeBeginning (Visio)

  • Article

Cet événement se produit lorsque l’instance de Microsoft Visio est forcée de vider sa file d’attente d’événements.

Syntaxe

expression. MustFlushScopeBeginning (application)

expressionUne variable qui représente un objetApplication.

Paramètres

Nom Requis/Facultatif Type de données Description
Application Requis [IVAPPLICATION] Instance de Visio contrainte à vider sa file d'attente d'événements.

Remarques

Cet événement, comme l'événement MustFlushScopeEnded, peut être utilisé pour déterminer si un événement est déclenché parce que Visio est forcé de vider sa file d'attente d'événements.

Visio comporte une file d'attente d'événements en attente qu'il déclenche à des moments isolés lorsqu'il est en mesure de générer des requêtes arbitraires (rappels) à partir de gestionnaires d'événement.

Il arrive que Visio soit forcé de vider sa file d'attente d'événements alors qu'il n'est pas prêt à gérer des requêtes arbitraires. Dans ce cas, il déclenche un événement MustFlushScopeBeginning, puis les événements présents dans sa file d'attente. Une fois tous les événements en attente déclenchés, Visio déclenche l'événement MustFlushScopeEnded.

Une fois l'événement MustFlushScopeBeginning déclenché par Visio, les programmes clients ne doivent pas appeler les méthodes Visio ayant des effets secondaires tant que l'événement MustFlushScopeEnded n'est pas réceptionné. Un client peut effectuer des requêtes arbitraires d'objets Visio lorsque Visio se trouve entre les événements MustFlushScopeBeginning et MustFlushScopeEnded, mais les opérations comportant des effets secondaires sont susceptibles d'échouer.

Visio procède au vidage forcé de la file d'attente d'événements juste avant de déclencher un événement « antérieur » à une opération, tel que BeforeDocumentClose ou BeforeShapeDelete, car les événements en file d'attente peuvent s'appliquer à des objets sur le point d'être fermés ou supprimés. Si l'on prend l'exemple de l'événement BeforeDocumentClose, certains événements en file d'attente peuvent concerner un objet Shape se trouvant dans le document qui va être fermé. Visio déclenche donc tous les événements de sa file d'attente avant de fermer le document.

Lorsqu'une forme est supprimée, les événements sont déclenchés dans l'ordre suivant :

  1. Événement MustFlushScopeBeginning : le client ne doit pas appeler les méthodes qui ont des effets secondaires.

  2. La file d'attente d'événements contient zéro (0) ou plusieurs événements.

  3. Événement BeforeShapeDelete : la forme est viable, mais Visio va la supprimer.

  4. Événement MustFlushScopeEnded : le client peut reprendre l’appel des méthodes qui ont des effets secondaires.

  5. Événement ShapesDeleted : la forme a été supprimée.

  6. Événement NoEventsPending : aucun événement ne doit toujours être déclenché.

Un événement est déclenché avant (BeforeShapeDeleted) et après (ShapesDeleted) la suppression de la forme. Si un programme surveillant ces événements nécessite la suppression de formes supplémentaires en réponse à la première suppression de forme, il doit utiliser le gestionnaire d'événement ShapesDeleted plutôt que BeforeShapeDeleted. L'événement BeforeShapeDeleted est inclus dans l'étendue des événements MustFlushScopeBeginning et MustFlushScopeEnded, alors que l'événement ShapesDeleted ne l'est pas.

Le numéro séquentiel d'un événement MustFlushScopeBeginning peut être plus élevé que celui des événements vus par le client après réception de l'événement MustFlushScopeBeginning car Visio affecte les numéros séquentiels aux événements lorsqu'ils se produisent. Les événements présents en file d'attente lors du vidage forcé ont un numéro séquentiel inférieur à celui de l'événement MustFlushScopeBeginning, même si l'événement MustFlushScopeBeginning est déclenché en premier.

Si vous utilisez Microsoft Visual Basic ou Visual Basic pour Applications (VBA), la syntaxe de cette rubrique décrit un moyen générique pour gérer efficacement les événements.

Si vous souhaitez créer vos propres objets Event , utilisez la méthode Add ou AddAdvise .

Pour créer un objet Event qui exécute un module complémentaire, utilisez la méthode Add applicable à la collection EventList.

Pour créer un objet Event qui reçoit des notifications, utilisez la méthode AddAdvise.

Pour rechercher le code de l’événement à créer, voir Codes d’événement.

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.