Méthode Application.OnComponentEnterState (Visio)

  • Article

Informe une instance Microsoft Visio qu’un code client oblige l’instance à entrer ou à sortir d’un état particulier.

Syntaxe

expression. OnComponentEnterState (uStateID, bEnter)

expressionUne variable qui représente un objetApplication.

Paramètres

Nom Requis/Facultatif Type de données Description
uStateID Obligatoire VisOnComponentEnterCodes Décrit l'état d'entrée et de sortie, ainsi que les indicateurs qui influencent le comportement dans l'état indiqué.
Benter Obligatoire Boolean True pour indiquer l'entrée dans un état ; False pour indiquer la sortie d'un état.

Valeur renvoyée

Aucune

Remarques

L’argument uStateID indique l’état en cours d’entrée ou de sortie. Le code appelant cette méthode doit pouvoir faire de même lors de l'entrée ou de la sortie d'un état.

Actuellement, le seul changement d'état pris en charge par la méthode OnComponentEnterState est visComponentStateModal indiquant que le client effectue une action qui oblige Visio à entrer ou à quitter un état modal.

La plupart des codes client ne requièrent pas d'appeler la méthode OnComponentEnterState en obligeant Visio à entrer ou à quitter l'état modal, par exemple en affichant des boîtes de dialogue modales. Cette méthode est généralement utilisée par un code client qui affiche des boîtes de dialogue autres que les formulaires de Microsoft Visual Basic pour Applications (VBA) et implique un comportement différent de celui de Visio par défaut.

Les constantes et valeurs suivantes pour uIDÉtat sont déclarées par la bibliothèque de types de Visio dans VisOnComponentEnterCodes. L’une des constantes suivantes précédées de visModal peut être combinée avec visComponentStateModal pour influencer le comportement de Visio lors de la transition vers ou à partir d’un état modal.

Constante Valeur Description
visComponentStateModal 1 L'état en cours d'identification est un état modal.
visModalDeferEvents &H10000 Oblige Microsoft Office Visio à tenter de différer le déclenchement des événements tout en étant en état modal. Par défaut, Visio diffère le déclenchement des événements lorsqu'il affiche ses propres boîtes de dialogue, mais il ne le diffère pas lorsqu'un code client a entraîné l'affichage d'une boîte de dialogue.Dans le cas de plusieurs portées modales imbriquées, si une portée quelconque diffère des événements, toutes les portées au sein de la portée la plus éloignée différant les événements diffèreront des événements.Cet indicateur n'a d'effet que lorsque Visio passe à une portée modale. À la sortie d'une portée modale, Visio se comporte comme à l'entrée.
visModalNoBeforeAfter &H20000 Empêche Visio de déclencher un événement BeforeModal en passant à une portée modale ou un événement AfterModal en quittant une portée modale.Par défaut, Visio déclenche ces événements lorsqu'il affiche ses propres boîtes de dialogue ou celles exécutées par VBA, mais n'en déclenche aucun lorsqu'un code client affiche une boîte de dialogue.L'appel de la méthode OnComponentEnterState entraînera le déclenchement de ces événements à moins que visModalNoBeforeAfter ne soit spécifié.
visModalDontBlockMessages &H40000 Empêche Visio de rejeter les appels provenant de l'extérieur de son filetage principal en état modal. Par défaut, Visio rejette les appels extérieurs à son filetage en état modal.Dans le cas de plusieurs portées modales imbriquées, si une portée quelconque diffère des événements, toutes les portées au sein de la portée la plus éloignée différant les événements diffèreront des événements.Cet indicateur n'a d'effet que lorsque Visio passe à une portée modale. À la sortie d'une portée modale, Visio se comporte comme à l'entrée.
visModalDisableVisiosFrame &H80000 Force Visio à désactiver sa fenêtre frame en mode modal. Par défaut, Visio désactive sa fenêtre frame lors de l’affichage de ses propres boîtes de dialogue ou lors de l’affichage des boîtes de dialogue implémentées par VBA, mais pas lorsque le code client dans un autre processus affiche une boîte de dialogue. Si le code d’un autre processus souhaite afficher une boîte de dialogue et que la fenêtre de cadre Visio se comporte comme s’il s’agit du processus Visio affichant la boîte de dialogue, il peut définir cet indicateur. Cet indicateur a un effet uniquement lorsque Visio entre dans une étendue modale. À la sortie d'une portée modale, Visio se comporte comme en y entrant.

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.