Entfernt alle Melderereignisse, die älter als angegeben sind, aus den Ereignis-Queues. Wenn die Ereignis-Queue, aus der Sie Ereignisse entfernen möchten, Filterereignisse enthält, stoppt die Funktion am ersten Filterereignis in der Queue und entfernt nur die vor dem Stoppen angetroffenen Elemente.


icon

Ein-/Ausgänge

  • cu32.png Zeitpunkt des ältesten Ereignisses —

    Zeitpunkt des ältesten Ereignisses gibt in Millisekunden an, ab welchem Zeitpunkt die Ereignisse beibehalten werden sollen. Die Funktion entfernt alle vorher aufgetretenen Ereignisse aus der Queue. Der Millisekunden-Timer akzeptiert den Wert, der von der Funktion Timer-Wert (ms) ausgegeben wird.

  • ceventregrn.png Ereignisregistrierung (Referenz) —

    Ereignisregistrierung (Referenz) ist eine Referenz auf eine Ereignisregisterungsreferenz der Queue, aus der Elemente entfernt werden sollen. Sie können auch einen Cluster aus Ereignisregistrierungsreferenzen verbinden, um mehr als eine Queue zu leeren. Dieser Eingang ist erforderlich, es sei denn, die Funktion "Ereignis-Queue leeren" befindet sich in einem Ereignis-Case einer Ereignisstruktur. In diesem Fall leert sie die statische Ereignis-Queue der umgebenden Ereignisstruktur. Wenn dieser Eingang verbunden ist, sich die Funktion Ereignis-Queue leeren in einem Ereignis-Case einer Ereignisstruktur befindet und statische Ereignisse einschließen? unverbunden oder TRUE ist, leert die Funktion sowohl die dynamische(n) Ereignis-Queue(s) für die verbundene(n) Referenz(en) als auch die statische Queue der Ereignisstruktur.

  • cbool.png Statische Ereignisse einschließen? (T) —

    Statische Ereignisse einschließen? gibt an, ob die statischen Ereignisse in der Queue der Ereignisstruktur ebenfalls entfernt werden sollen. Beim Einfügen der Funktion "Ereignis-Queue leeren" in einen Ereignis-Case einer Ereignisstruktur lautet die Standardeinstellung TRUE. Andernfalls lautet die Standardeinstellung FALSE.

    Hinweis Wenn Sie Statische Ereignisse einschließen? verbinden, muss diese Funktion in die Ereignisstruktur eingefügt werden, in der die statischen Ereignisse verarbeitet werden, die entfernt werden sollen.
  • cenum.png Ereignistyp oder -objekt —

    Ereignistyp oder -objekt gibt an, welche Melderereignisse entsprechend den Kriterien Zeitpunkt des ältesten Ereignisses und Neueste beibehalten entfernt werden sollen.

    Refer to the Details section for more information about how to specify which events you want to discard.
  • cerrcodeclst.png Fehler (Eingang, kein Fehler) —

    Fehler (Eingang) beschreibt Fehlerbedingungen, die vor der Ausführung des Knotens auftreten. An Fehler (Eingang) werden Standardfehlerdaten übergeben.

  • ci32.png Neuestes beibehalten —

    Neueste beibehalten gibt die Anzahl der neuesten Ereignisse an, die in der Ereignis-Queue beibehalten werden sollen. Wenn Sie Ereignistyp oder -objekt angeben, gilt Neueste beibehalten nur für die Ereignisse des angegebenen Typs. Wenn Elemente aus mehreren Ereignis-Queues entfernt werden sollen, gibt Neueste beibehalten die Gesamtanzahl der Elemente an, die in allen angegebenen Queues beibehalten werden sollen.

    Hinweis Wenn Sie sowohl Zeitpunkt des ältesten Ereignisses als auch Neueste beibehalten unverbunden lassen, entfernt die Funktion alle Ereignisse aus allen Queues, welche die Bedingungen von Ereignistyp oder -objekt erfüllen. Wenn Sie sowohl Zeitpunkt des ältesten Ereignisses als auch Neueste beibehalten verbinden, behält die Funktion alle Ereignisse bei, die zum angegebenen Zeitpunkt und danach aufgetreten sind, und alle Ereignisse, die innerhalb der Anzahl beizubehaltender Ereignisse liegen.
  • ieventregrn.png Ereignisregistrierung (Referenz, Ausgang) —

    Ereignisregistrierung (Referenz, Ausgang) gibt die Ereignisregistrierungsreferenz auf die Queue aus, aus der Ereignisse entfernt wurden.

  • iu32.png Anz. verworfener Ereignisse —

    Anz. verworfener Ereignisse gibt die Gesamtanzahl verworfener Ereignisse aus.

  • ierrcodeclst.png Fehler (Ausgang) —

    Fehler (Ausgang) enthält Angaben zum Fehler. Dieser Ausgang ist ein Standardausgang zur Fehlerausgabe.

    • In Anwendungen, in denen Ereignisse in schneller Folge vorkommen, aber nur die aktuellen Ereignisse benötigt werden, z. B. die Ereignisse "Mausbewegung" und "Panel-Größe ändern" können ältere Ereignisse verworfen werden, so dass die Anwendung schneller auf neuere Ereignisdaten reagieren kann.

    Die folgenden Beispiele demonstrieren, wie Daten mit dem Parameter Ereignistyp oder -objekt verbunden werden, um die Art und Weise festzulegen, mit der die Funktion "Ereignis-Queue leeren" Ereignisse entfernt. Beachten Sie, dass in den Beispielen die Verwendung des Ereignisregistrierungsreferenzparameters nicht angezeigt wird. Sie müssen diesen Code daher in einen Ereignis-Case einer Ereignisstruktur einfügen oder diesen Eingang mit einer entsprechenden Ereignisregistrierungsreferenz verbinden, damit er ordnungsgemäß funktioniert.

    Beispiel 1: Entfernen von mehreren Ereignistypen

    Wenn Sie mehrere Ereignistypen entfernen möchten, z. B. "Mouse Down" und "Mouse Up", können Sie ein Array oder einen Cluster aus Ereignistyp-Enums mit dem Eingang Ereignistyp oder -objekt verbinden (vgl. folgende Abbildung).

    Die Funktion "Ereignis-Queue leeren" entfernt sowohl das Ereignis "Mouse Down" als auch das Ereignis "Mouse Up" unabhängig von der Ereignisquelle. Da jedoch ein konstanter Wert von 1 mit dem Parameter Neuestes beibehalten verbunden ist, speichert die Funktion eines der aktuellen Ereignisse des Typs "Mouse Down" oder "Mouse Up" in der Ereignisqueue. Die Funktion speichert insgesamt nur ein Ereignis und nicht ein Ereignis für jeden Ereignistyp.

    Beispiel 2: Entfernen von Ereignissen, die von bestimmten Objekten erzeugt wurden

    Um nur Ereignisse zu entfernen, die von bestimmten Objekten erzeugt wurden, können Sie eine VI-Server-Referenz auf ein Objekt, das ein Ereignis erzeugt, eine Benutzerereignisreferenz oder jede beliebige Referenz für Ereignisse mit dem Eingang Ereignistyp oder -objekt verbinden. Zum Entfernen von Ereignissen von mehreren Objekten verwenden Sie ein Array oder einen Cluster aus Referenzen (vgl. folgende Abbildung).

    Die Funktion "Ereignis-Queue leeren" entfernt alle Arten von Ereignissen, die von Objekten erzeugt wurden, die mit den im Cluster gebündelten Referenzen verbunden sind.

    Beispiel 3: Entfernen von bestimmten Ereignissen, die von bestimmten Objekten erzeugt wurden

    Wenn Sie ein Ereignis nur entfernen möchten, wenn das Ereignis von einem bestimmten Objekt ausgelöst wurde, können Sie eine Enum mit dem Ereignistyp, der entfernt werden soll, mit einer Referenz auf das Objekt bündeln, welches das Ereignis auslöst. Zum Entfernen mehrerer Ereignisse für mehrere Objekte können Sie auch einen Cluster oder ein Array aus Ereignistyp-Enum/Objekt-Paaren erstellen (vgl. folgende Abbildung).

  • —Die Funktion entfernt die Ereignisse "Mouse Up" und "Mouse Down" nur, wenn das boolesche Element diese Ereignisse auslöst.
  • —Die Funktion entfernt das Ereignis "Mouse Move" nur, wenn das 2D-Bildelement das Ereignis auslöst.
  • — Da das Ereignis nicht zu einem bestimmten Objekt gehört, entfernt die Funktion das Ereignis "Key Up", wenn das Ereignis von einer beliebigen Ereignisquelle erzeugt wurde.