Freigeben über

Document.QueryCancelConvertToGroup-Ereignis (Visio)

  • Artikel

Tritt ein, bevor die Anwendung eine Auswahl von Shapes als Reaktion auf eine Benutzeraktion in der Benutzeroberfläche in eine Gruppe konvertiert. Wenn ein Ereignishandler True zurückgibt, wird der Vorgang abgebrochen.

Syntax

Ausdruck. QueryCancelConvertToGroup (Auswahl)

Ausdruck Eine Variable, die ein Document-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
Selection Erforderlich [IVSELECTION] Die Auswahl von Shapes, die in eine Gruppe konvertiert werden.

Hinweise

Eine Instanz von Microsoft Visio löst QueryCancelConvertToGroup aus, nachdem der Benutzer die Instanz veranlasst hat, ein oder mehrere Shapes in Gruppen zu konvertieren.

  • Wenn ein Ereignishandler True (Abbrechen) zurückgibt, löst die Instanz ConvertToGroupCanceled aus und konvertiert die Shapes nicht.

  • Wenn alle Handler False (kein Abbrechen) zurückgeben, wird die Konvertierung ausgeführt.

Gelegentlich wird das ursprüngliche Shape gelöscht und durch ein neues Shape ersetzt, z. B. wenn ein Shape, das eine ForeignType-Eigenschaft visTypeMetafile besitzt, in eine Gruppe konvertiert wird. Daraufhin löst Visio in diesen Fällen die BeforeSelectionDelete- und BeforeShapeDelete-Ereignisse aus, bevor die Shapes konvertiert werden.

Während eine Visio-Instanz ein Abfrage- oder ein Abbruchereignis auslöst, beantwortet die Instanz Anfragen von Clientcode, führt jedoch keine Vorgänge aus. Clientcode kann Formulare oder Meldungsfelder anzeigen und gleichzeitig Abfrage- oder Abbruchereignisse beantworten.

Wenn Sie Microsoft Visual Basic oder Visual Basic für Applikationen (VBA) verwenden, beschreibt die Syntax in diesem Thema eine gängige und effiziente Methode zum Verarbeiten von Ereignissen.

Wenn Sie eigene Event-Objekte erstellen möchten, verwenden Sie die Add- oder AddAdvise-Methode .

Verwenden Sie zum Erstellen eines Event-Objekts, das ein Add-On ausführt, die Add-Methode der EventList-Auflistung.

Verwenden Sie zum Erstellen eines Event-Objekts, das eine Benachrichtigung empfängt, die AddAdvise-Methode.

Informationen zum Suchen eines Ereigniscodes für das Ereignis, das Sie erstellen möchten, finden Sie unter Ereigniscodes.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.