Compartilhar via


Método Application.OnComponentEnterState (Visio)

Informa uma instância do Microsoft Visio que o código do cliente está fazendo a instância entrar ou sair de um determinado estado.

Sintaxe

expressão. OnComponentEnterState (uStateID, bEnter)

expressão Uma variável que representa um Aplicativo objeto.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
uStateID Obrigatório VisOnComponentEnterCodes Descreve o estado no qual se está entrando ou saindo junto com os sinalizadores que influenciam o comportamento enquanto no estado indicado.
bEnter Obrigatório Boolean True para indicar que se está entrando em um estado; False para indicar que se está saindo de um estado.

Valor de retorno

Nada

Comentários

O argumento uStateID indica o estado que está sendo inserido ou saído. O código que chama esse método deve fazê-lo ao entrar e sair do estado.

No momento, a única alteração de estado com suporte do método OnComponentEnterState é visComponentStateModal, indicando que o cliente está executando uma ação que faz o Visio entrar ou sair de um estado modal.

A maioria do código do cliente não precisa chamar o método OnComponentEnterState ao fazer o Visio entrar ou sair do estado de ser modal, por exemplo, ao mostrar caixas de diálogo modais. Normalmente, esse método é usado por código do cliente que mostra caixas de diálogo diferentes de formulários do Microsoft Visual Basic for Applications (VBA) e exige comportamento diferente do comportamento padrão do Visio.

A seguir estão constantes e valores de uStateID, que são declarados pela biblioteca de tipos do Visio em VisOnComponentEnterCodes. Qualquer uma das constantes a seguir prefixadas com visModal pode ser combinada com visComponentStateModal para influenciar o comportamento do Visio durante a transição para ou de um estado modal.

Constant Valor Descrição
visComponentStateModal 1 O estado que está sendo identificado é um estado modal.
visModalDeferEvents &H10000 Faz o Visio tentar adiar eventos de acionamento enquanto modal. Por padrão, o Visio adia eventos de acionamento ao exibir suas próprias caixas de diálogo, mas não adia eventos de acionamento quando o código do cliente fez uma caixa de diálogo aparecer.No caso de vários escopos modais aninhados, se algum escopo estiver adiando eventos, todos os escopos dentro do escopo mais externo que está adiando eventos adiarão eventos.Este sinalizador tem efeito apenas quando o Visio está entrando em um escopo modal. Ao sair de um escopo modal, o Visio se comporta da mesma maneira que antes de entrar no escopo.
visModalNoBeforeAfter &H20000 Impede o Visio de acionar um evento BeforeModal ao entrar em um escopo modal ou um evento AfterModal ao sair de um escopo modal.Por padrão, o Visio aciona esses eventos ao exibir suas próprias caixas de diálogo ou ao exibir caixas de diálogo implementadas pelo VBA, mas não os aciona quando o código do cliente exibe uma caixa de diálogo.Chamar o método OnComponentEnterState fará esses eventos serem acionados, a menos que visModalNoBeforeAfter seja especificado.
visModalDontBlockMessages &H40000 Impede o Visio de rejeitar chamadas de fora de seu thread principal enquanto modal. Por padrão, o Visio rejeita chamadas de fora de seu thread enquanto modal.No caso de vários escopos modais aninhados, se algum escopo estiver adiando eventos, todos os escopos dentro do escopo mais externo que está adiando eventos adiarão eventos.Este sinalizador tem efeito apenas quando o Visio está entrando em um escopo modal. Ao sair de um escopo modal, o Visio se comporta da mesma maneira que antes de entrar no escopo.
visModalDisableVisiosFrame &H80000 Faz o Visio desativar sua janela de quadro enquanto modal. Por padrão, o Visio desativará sua janela de quadro ao mostrar suas próprias caixas de diálogo ou ao mostrar caixas de diálogo implementadas pelo VBA, mas não quando o código do cliente em outro processo mostrar uma caixa de diálogo.Se o código em outro processo desejar mostrar uma caixa de diálogo e que a janela de quadro do Visio se comporte como se fosse o processo do Visio mostrando a caixa de diálogo, ele poderá definir este sinalizador.Este sinalizador tem efeito apenas quando o Visio está entrando em um escopo modal. Ao sair de um escopo modal, o Visio se comporta da mesma maneira que antes de entrar no escopo.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.