Evento Document. QueryCancelConvertToGroup (Visio)Document.QueryCancelConvertToGroup event (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.Occurs before the application converts a selection of shapes to a group in response to a user action in the interface. Se qualquer manipulador de eventos retornar True, a operação será cancelada.If any event handler returns True, the operation is canceled.

SintaxeSyntax

expressão. QueryCancelConvertToGroup (Seleção)expression.QueryCancelConvertToGroup (Selection)

expressão Uma variável que representa um objeto Document .expression A variable that represents a Document object.

ParâmetrosParameters

NomeName Obrigatório/OpcionalRequired/Optional Tipo de dadosData type DescriçãoDescription
SelectionSelection ObrigatórioRequired IVSELECTION[IVSELECTION] A seleção de formas que será convertida em um grupo.The selection of shapes that is going to be converted to a group.

ComentáriosRemarks

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.A Microsoft Visio instance fires QueryCancelConvertToGroup after the user has directed the instance to convert one or more shapes into groups.

  • Se algum manipulador de eventos retornar True (cancelar), a instância disparará ConvertToGroupCanceled e não converterá as formas.If any event handler returns True (cancel), the instance fires ConvertToGroupCanceled and does not convert the shapes.

  • Se todos os manipuladores retornarem False (não cancelar), a conversão será executada.If all handlers return False (don't cancel), the conversion is performed.

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.In some cases, such as when a shape that has a ForeignType property of visTypeMetafile is converted to a group, the initial shape is deleted and replaced with new shapes. Em tais casos, a instância do Visio disparará eventos BeforeSelectionDelete e BeforeShapeDelete subsequentemente, antes de converter as formas.In such cases, the Visio instance subsequently fires BeforeSelectionDelete and BeforeShapeDelete events before converting the shapes.

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.While a Visio instance is firing a query or cancel event, it responds to inquiries from client code but refuses to perform operations. O código do cliente pode exibir formas ou caixas de mensagem enquanto responde a um evento de consulta ou cancelamento.Client code can show forms or message boxes while responding to a query or cancel event.

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.If you are using Microsoft Visual Basic or Visual Basic for Applications (VBA), the syntax in this topic describes a common, efficient way to handle events.

Se você quiser criar seus próprios objetos de evento , use o método Add ou addadvise. If you want to create your own Event objects, use the Add or AddAdvise method.

Para criar um objeto Event que execute um complemento, use o método Add, uma vez que ele aplica-se à coleção EventList.To create an Event object that runs an add-on, use the Add method as it applies to the EventList collection.

Para criar um objeto Event que receba notificação, use o método AddAdvise.To create an Event object that receives notification, use the AddAdvise method.

Para localizar um código de evento que você deseja criar, consulte Códigos de eventos.To find an event code for the event that you want to create, see Event codes.

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.