Compartilhar via


Evento Documents.QueryCancelGroup (Visio)

Ocorre antes que o aplicativo agrupe uma seleção de formas em resposta a uma ação do usuário na interface. Se algum manipulador de eventos retornar True, a operação será cancelada.

Sintaxe

expressão. QueryCancelGroup (Seleção)

Expressão Uma variável que representa um objeto Documents .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Selection Obrigatório [IVSELECTION] A seleção de formas que será agrupada.

Comentários

Uma instância do Microsoft Visio dispara QueryCancelGroup após o usuário ter direcionado a instância para agrupar uma seleção de formas.

  • Se algum manipulador de eventos retornar True (cancelar), a instância disparará GroupCanceled e não agrupará as formas.

  • Se todos os manipuladores retornarem False (não cancelar), o agrupamento será executado.

Enquanto uma instância do Visio está disparando um evento de consulta ou cancelamento, ela responde a perguntas do código do cliente, mas se recusa a executar operações. O código do cliente pode exibir formas ou caixas de mensagem enquanto responde a um evento de consulta ou cancelamento.

Se você usa o Microsoft Visual Basic ou o Visual Basic for Applications (VBA), a sintaxe deste tópico descreverá uma maneira comum e eficiente de lidar com eventos.

Se você quiser criar seus próprios objetos Event , use o método Add ou AddAdvise .

Para criar um objeto Event que execute um complemento, use o método Add, uma vez que ele aplica-se à coleção EventList.

Para criar um objeto Event que receba notificação, use o método AddAdvise.

Para localizar um código de evento que você deseja criar, consulte Códigos de eventos.

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.