Auf Englisch lesen

Freigeben über


Event.SetFilterSRC-Methode (Visio)

Gibt ein Array von Zellbereichen und einen True - oder False-Wert an, der angibt, wie Ereignisse für jeden Zellbereich gefiltert werden.

Syntax

Ausdruck. SetFilterSRC( _SRCStream()_ )

Ausdruck Eine Variable, die ein Event-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
SRCStream() Erforderlich Integer Ein Array von Zellbereichen und der Wert True oder False, wodurch angegeben wird, wie Ereignisse für den jeweiligen Bereich gefiltert werden sollen.

Rückgabewert

Nichts

Bemerkungen

Wenn ein Event-Objekt, das mit der AddAdvise-Methode erstellt wurde, der EventList-Auflistung eines Quellobjekts hinzugefügt wird, werden standardmäßig alle Vorkommen dieses Ereignisses an die Ereignissenke übergeben. Die SetFilterSRC-Methode bietet die Möglichkeit, auf Basis eines Zellbereichs ausgewählte Ereignisse zu ignorieren.

Der an SetFilterSRC übergebene SRCStream()-Parameter ist ein folgendermaßen definiertes Array:

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

  • Die ersten drei Elemente beschreiben den Abschnitt, die Zeile und die Zelle der Anfangszelle des Bereichs.

  • Die nächsten drei Elemente beschreiben den Abschnitt, die Zeile und die Zelle der Endzelle des Bereichs.

  • Das letzte Element enthält den Wert True oder False, der angibt, wie Ereignisse für den Zellbereich gefiltert werden (True zum Überwachen von Ereignissen für einen Zellbereich, False zum Ausschließen von Ereignissen für einen Zellbereich).

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

  • Das Ereignis muss einen gültigen Abschnitt, eine gültige Zeile und einen gültigen Zellbezug 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.

Verwenden Sie z. B. folgenden Code, wenn Sie in der zweiten Zeile im Abschnitt Shape-Daten Änderungen in der Zelle Wert überwachen möchten:

 
 Dim aFilterSRC(1 To (1 * 7)) As Integer 
 aFilterSRC(1) = visSectionProp 
 aFilterSRC(2) = visRowProp + 1 
 aFilterSRC(3) = visCustPropsValue 
 aFilterSRC(4) = visSectionProp 
 aFilterSRC(5) = visRowProp + 1 
 aFilterSRC(6) = visCustPropsValue 
 aFilterSRC(7) = True 

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.