Compartilhar via


Evento Shape.QueryCancelConvertToGroup (Visio)

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

Sintaxe

expressão. QueryCancelConvertToGroup (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á convertida em um grupo.

Comentários

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

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

  • Se todos os manipuladores retornarem False (não cancelar), a conversão será executada.

Em alguns casos, como quando uma forma com uma propriedade ForeignType de visTypeMetafile é convertida em um grupo, a forma inicial é excluída e substituída por novas formas. Em tais casos, a instância do Visio disparará eventos BeforeSelectionDelete e BeforeShapeDelete subsequentemente, antes de converter 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.