Événement document. QueryCancelConvertToGroup (Visio)Document.QueryCancelConvertToGroup event (Visio)

Cet événement se produit avant que l’application convertisse une sélection de formes en un groupe en réponse à une action de l’utilisateur dans l’interface.Occurs before the application converts a selection of shapes to a group in response to a user action in the interface. Si un gestionnaire d’événements renvoie la valeur true, l’opération est annulée.If any event handler returns True, the operation is canceled.

SyntaxeSyntax

expression. QueryCancelConvertToGroup (Sélection)expression.QueryCancelConvertToGroup (Selection)

expression Variable qui représente un objet document .expression A variable that represents a Document object.

ParamètresParameters

NomName Requis/FacultatifRequired/Optional Type de donnéesData type DescriptionDescription
SelectionSelection ObligatoireRequired IVSELECTION[IVSELECTION] Sélection de formes qui doit être convertie en groupe.The selection of shapes that is going to be converted to a group.

RemarquesRemarks

Une instance de Microsoft Visio déclenche l’événement QueryCancelConvertToGroup une fois que l’utilisateur a demandé à l’instance de convertir une ou plusieurs formes en groupes.A Microsoft Visio instance fires QueryCancelConvertToGroup after the user has directed the instance to convert one or more shapes into groups.

  • Si un gestionnaire d’événement renvoie la valeur True (annuler), l’instance déclenche l’événement ConvertToGroupCanceled et ne convertit pas les formes.If any event handler returns True (cancel), the instance fires ConvertToGroupCanceled and does not convert the shapes.

  • Si tous les gestionnaires renvoient la valeur False (ne pas annuler), la conversion est effectuée.If all handlers return False (don't cancel), the conversion is performed.

Dans certains cas, par exemple lorsqu’une forme dont la propriété ForeignType a la valeur visTypeMetafile est convertie en groupe, la forme initiale est supprimée et remplacée par de nouvelles formes.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. Dans ce cas, l’instance de Visio déclenche les événements BeforeSelectionDelete et BeforeShapeDelete avant de convertir les formes.In such cases, the Visio instance subsequently fires BeforeSelectionDelete and BeforeShapeDelete events before converting the shapes.

Lorsqu'une instance de Visio déclenche un événement de requête ou d'annulation, elle répond aux demandes du code client mais refuse d'exécuter des opérations.While a Visio instance is firing a query or cancel event, it responds to inquiries from client code but refuses to perform operations. Le code client peut afficher des formulaires ou des messages lors de la réponse à un événement de requête ou d'annulation.Client code can show forms or message boxes while responding to a query or cancel event.

Si vous utilisez Microsoft Visual Basic ou Visual Basic pour Applications (VBA), la syntaxe de cette rubrique décrit un moyen générique pour gérer efficacement les événements.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.

Si vous souhaitez créer vos propres objets Event , utilisez la méthode Add ou AddAdvise .If you want to create your own Event objects, use the Add or AddAdvise method.

Pour créer un objet Event qui exécute un module complémentaire, utilisez la méthode Add applicable à la collection EventList.To create an Event object that runs an add-on, use the Add method as it applies to the EventList collection.

Pour créer un objet Event qui reçoit des notifications, utilisez la méthode AddAdvise.To create an Event object that receives notification, use the AddAdvise method.

Pour rechercher le code de l’événement à créer, voir Codes d’événement.To find an event code for the event that you want to create, see Event codes.

Assistance et commentairesSupport and feedback

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ?Have questions or feedback about Office VBA or this documentation? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.