Partilhar via


Evento Shape.QueryCancelUngroup (Visio)

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

Sintaxe

expressão. QueryCancelUngroup (Seleção)

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

Parâmetros

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

Comentários

Uma instância do Microsoft Visio dispara QueryCancelUngroup após o usuário ter direcionado a instância para desagrupar uma ou mais formas.

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

  • Se todos os manipuladores retornarem False (não cancelar), a instância disparará ShapeParentChanged, BeforeSelectionDelete e BeforeShapeDelete e desagrupará as formas.

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 estiver usando 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.