InvisibleApp. MustFlushScopeBeginning-Ereignis (Visio)InvisibleApp.MustFlushScopeBeginning event (Visio)

Tritt ein, bevor die Instanz von Microsoft Visio zum Leeren der Ereigniswarteschlange gezwungen ist.Occurs before the Microsoft Visio instance is forced to flush its event queue.

SyntaxSyntax

Ausdruck. MustFlushScopeBeginning (App)expression.MustFlushScopeBeginning (app)

Ausdruck Eine Variable, die ein InvisibleApp -Objekt darstellt.expression A variable that represents an InvisibleApp object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
Appapp ErforderlichRequired [IVAPPLICATION][IVAPPLICATION] Die Visio-Instanz, die zum Leeren der Ereigniswarteschlange gezwungen ist.The instance of Visio that is forced to flush its event queue.

BemerkungenRemarks

Mithilfe dieses Ereignisses kann in Verbindung mit dem MustFlushScopeEnded-Ereignis festgestellt werden, ob ein Ereignis ausgelöst wird, weil Visio zum Leeren seiner Ereigniswarteschlange gezwungen ist.This event, along with the MustFlushScopeEnded event, can be used to identify whether an event is being fired because Visio is forced to flush its event queue.

Visio verwaltet eine Warteschlange mit ausstehenden Ereignissen. Der Versuch, diese Ereignisse auszulösen, erfolgt zu separaten Zeiten, wenn willkürliche Anforderungen (Callbacks) von Ereignishandlern verarbeitet werden können.Visio maintains a queue of pending events that it attempts to fire at discrete moments when it is able to process arbitrary requests (callbacks) from event handlers.

Gelegentlich ist Visio gezwungen, seine Ereigniswarteschlange zu leeren, wenn keine Möglichkeit zum Verarbeiten der willkürlichen Anforderungen besteht.Occasionally, Visio is forced to flush its event queue when it is not prepared to handle arbitrary requests. In diesem Fall löst Visio zuerst ein MustFlushScopeBeginning-Ereignis aus, anschließend löst es alle Ereignisse aus, die sich gerade in der Ereigniswarteschlange befinden.When this occurs, Visio first fires a MustFlushScopeBeginning event, and then it fires the events that are presently in its event queue. Nach dem Auslösen aller ausstehenden Ereignisse, löst Visio das MustFlushScopeEnded-Ereignis aus.After firing all pending events, Visio fires the MustFlushScopeEnded event.

Nachdem Visio das MustFlushScopeBeginning-Ereignis ausgelöst hat, sollten Clientprogramme bis zum Erhalt des MustFlushScopeEnded-Ereignisses keine Visio-Methoden mit Nebeneffekten aufrufen.After Visio has fired the MustFlushScopeBeginning event, client programs should not call Visio methods that have side effects until the MustFlushScopeEnded event is received. Ein Client kann zwischen den von Visio ausgelösten Ereignissen MustFlushScopeBeginning und MustFlushScopeEnded willkürliche Abfragen von Visio-Objekten ausführen, jedoch schlagen Operationen möglicherweise fehl, die Nebeneffekte verursachen.A client can perform arbitrary queries of Visio objects when Visio is between the MustFlushScopeBeginning event and MustFlushScopeEnded event, but operations that cause side effects may fail.

Visio führt eine erzwungene Bereinigung seiner Ereigniswarteschlange unmittelbar vor dem Auslösen eines "Before"-Ereignisses wie BeforeDocumentClose oder BeforeShapeDelete aus, da Warteschlangenereignisse möglicherweise auf Objekte zutreffen, die gerade geschlossen oder gelöscht werden sollen.Visio performs a forced flush of its event queue immediately prior to firing a "before" event such as BeforeDocumentClose or BeforeShapeDelete because queued events may apply to objects that are about to close or be deleted. Mit dem BeforeDocumentClose -Ereignis als Beispiel kann es in der Warteschlange Ereignisse geben, die für ein Shape-Objekt in dem Dokument gelten, das geschlossen wird.Using the BeforeDocumentClose event as an example, there can be queued events that apply to a shape object in the document that is being closed. Bevor das Dokument geschlossen wird, löst Visio alle Ereignisse in seiner Ereigniswarteschlange aus.So, before the document closes, Visio fires all the events in its event queue.

Beim Löschen eines Shapes werden Ereignisse in der folgenden Reihenfolge ausgelöst:When a shape is deleted, events are fired in the following sequence:

  1. MustFlushScopeBeginning -Ereignis-Client sollte keine Methoden mit Nebeneffekten aufrufen.MustFlushScopeBeginning event - Client should not call methods that have side effects.

  2. Es befinden sich Null (0) oder mehr Ereignisse in der Warteschlange.There are zero (0) or more events in the event queue.

  3. BeforeShapeDelete -Ereignis-Shape ist lebensfähig, aber Visio löscht es.BeforeShapeDelete event - Shape is viable, but Visio is going to delete it.

  4. MustFlushScopeEnded -Ereignis-Client kann den Aufruf von Methoden fortsetzen, die Nebeneffekte aufweisen.MustFlushScopeEnded event - Client can resume invoking methods that have side effects.

  5. ShapesDeleted -Ereignis-Shape wurde gelöscht.ShapesDeleted event - Shape has been deleted.

  6. NoEventsPending -Ereignis – es bleiben keine Ereignisse ausgelöst.NoEventsPending event - No events remain to be fired.

Ein Ereignis wird sowohl vor (BeforeShapeDeleted-Ereignis) als auch nach (ShapesDeleted-Ereignis) dem Löschen eines Shapes ausgelöst.An event is fired both before (BeforeShapeDeleted event) and after (ShapesDeleted event) the shape is deleted. Falls ein Programm, das diese Ereignisse überwacht, das Löschen weiterer Shapes als Reaktion auf das erste Löschen eines Shapes erfordert, sollte das Löschen im ShapesDeleted-Ereignishandler und nicht im BeforeShapeDeleted-Ereignishandler erfolgen.If a program monitoring these events requires that additional shapes be deleted in response to the initial shape deletion, it should do so in the ShapesDeleted event handler, not the BeforeShapeDeleted event handler. Das BeforeShapeDeleted-Ereignis liegt innerhalb des Bereichs des MustFlushScopeBeginning-Ereignisses und des MustFlushScopeEnded-Ereignisses, das ShapesDeleted-Ereignis hingegen nicht.The BeforeShapeDeleted event is inside the scope of the MustFlushScopeBeginning event and the MustFlushScopeEnded event, while the ShapesDeleted event is not.

Die Sequenznummer eines MustFlushScopeBeginning -Ereignisses kann höher sein als die Sequenz Anzahl der Ereignisse, die der Client sieht, nachdem das MustFlushScopeBeginning -Ereignis empfangen wurde, da Visio Sequenznummern den Ereignissen zuweist, die auftreten.The sequence number of a MustFlushScopeBeginning event may be higher than the sequence number of events the client sees after it has received the MustFlushScopeBeginning event because Visio assigns sequence numbers to events as they occur. Alle Ereignisse, die in die Warteschlange eingereiht wurden, als die erzwungene Bereinigung begonnen hat, haben eine niedrigere Sequenznummer als das MustFlushScopeBeginning -Ereignis, obwohl das MustFlushScopeBeginning -Ereignis zuerst ausgelöst wird.Any events that were queued when the forced flush began have a lower sequence number than the MustFlushScopeBeginning event, even though the MustFlushScopeBeginning event fires first.

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

Wenn Sie eigene Event -Objekte erstellen möchten, verwenden Sie die Add - oder AddAdvise-Methode.If you want to create your own Event objects, use the Add or AddAdvise method.

Verwenden Sie zum Erstellen eines Event-Objekts, das ein Add-On ausführt, die Add-Methode der EventList-Auflistung.To create an Event object that runs an add-on, use the Add method as it applies to the EventList collection.

Verwenden Sie zum Erstellen eines Event-Objekts, das eine Benachrichtigung empfängt, die AddAdvise-Methode.To create an Event object that receives notification, use the AddAdvise method.

Informationen zum Suchen eines Ereigniscodes für das Ereignis, das Sie erstellen möchten, finden Sie unter Ereigniscodes.To find an event code for the event that you want to create, see Event codes.

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.