Evento Documents.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 Documents .
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.