Event.GetFilterCommands-Methode (Visio)

  • Artikel

Gibt ein Array von Befehlsbereichen und den Wert True oder False zurück, um anzuzeigen, wie Ereignisse für diesen Befehlsbereich gefiltert werden sollen.

Syntax

Ausdruck. GetFilterCommands

Ausdruck Eine Variable, die ein Event-Objekt darstellt.

Rückgabewert

Long()

HinwBemerkungeneise

Die Ereignisfilter, die im Array, das von der GetFilterCommands-Methode zurückgegeben wird, beschrieben sind, bieten Entwicklern die Möglichkeit, angegebene Ereignisse basierend auf der Befehls-ID zu ignorieren. Das zurückgegebene Array ist jenes Array, das an die SetFilterCommands-Methode für dieses Event-Objekt übergeben wird.

Das von der GetFilterCommands-Methode zurückgegebene Array kann folgendermaßen interpretiert werden:

Die Anzahl von Elementen im Array ist ein Vielfaches von 3:

  • Das erste Element enthält die Anfangsbefehls-ID des Bereichs (beliebiges Mitglied von VisUICmds).

  • Das zweite Element enthält die Endbefehls-ID des Bereichs (ein beliebiges Mitglied von VisUICmds).

  • Das dritte Element enthält den Wert True oder False, der anzeigt, ob Sie Ereignisse für diesen Befehlsbereich überwachen (True zum Überwachen der Ereignisse. False zum Ausschließen der Ereignisse).

Ein Ereignis muss die folgenden Kriterien erfüllen, damit es erfolgreich über einen Befehlsfilter übergeben wird:

  • Das Ereignis muss eine gültige Befehls-ID aufweisen.

  • Wenn alle Filter True sind, muss das Ereignis mindestens mit einem Filter übereinstimmen.

  • Wenn alle Filter False sind, muss das Ereignis mit keinem Filter übereinstimmen.

  • Wenn die Filter eine Mischung aus True und False sind, muss das Ereignis mit mindestens einem True-Filter und mit keinem False-Filter übereinstimmen.

Wenn in dem Array keine True-Bereiche definiert sind, werden die Ereignisse als True betrachtet.

Weitere Informationen zur Verwendung von Befehls-IDs zum Definieren von Ereignisfiltern finden Sie unter der SetFilterCommands-Methode.

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.