이벤트 큐 비우기 함수
- 업데이트 날짜:2025-07-30
- 5분 (읽기 시간)
한 개 이상의 큐에서 가장 오래된 알림 이벤트를 버립니다. 버리고자 하는 이벤트 큐가 필터 이벤트를 포함하는 경우, 이 함수는 큐의 첫번째 필터 이벤트에서 정지하고 정지 이전에 발생한 이벤트만 버립니다.
입력/출력
가장 오래된 이벤트 시간
—
가장 오래된 이벤트 시간은 이벤트를 유지하기 시작하려는 시점의 이벤트 타임스탬프로, 밀리초 단위로 표시됩니다. 이 함수는 지정한 이벤트 시간 이전의 이벤트를 모두 버립니다. ms 타이머는 [Tick 카운트(ms)] 함수가 반환하는 값을 받을 수 있습니다. 
이벤트 등록 참조 번호
—
이벤트 등록 참조 번호는 비우고자 하는 큐와 연관된 이벤트 등록 참조 번호에 대한 참조입니다. 또한 이벤트 등록 참조 번호의 클러스터를 연결하여 하나 이상의 큐를 비울 수 있습니다. [이벤트 큐 비우기] 함수가 이벤트 구조의 이벤트 케이스에 있지 않으면 이 입력은 필수입니다. 이 경우에는 포함하는 이벤트 구조의 정적 이벤트 큐를 비웁니다. 이 입력이 연결된 경우, [이벤트 큐 비우기] 함수가 이벤트 구조의 이벤트 케이스에 있고, 정적 이벤트 포함?이 연결되어 있지 않거나 참인 경우, 함수는 연결된 참조 번호와 이벤트 구조의 정적 큐와 연관된 다이나믹 이벤트 큐를 모두 비웁니다. 
정적 이벤트 포함? (참)
—
정적 이벤트 포함?은 이벤트 구조와 연관된 정적 이벤트 큐를 비우기 작업에 포함시킬지 여부를 지정합니다. 이벤트 구조의 이벤트 케이스에 [이벤트 큐 비우기] 함수를 놓는 경우 기본은 참입니다. 그렇지 않으면, 기본은 거짓입니다. 노트 정적 이벤트 포함?을 연결하는 경우, 비우기 작업에 포함 또는 제외시킬 정적 이벤트를 처리하는 이벤트 구조 안에 이 함수를 놓아야 합니다.
이벤트 타입 또는 객체
—
에러 입력(에러 없음)
—
에러 입력은 이 노드의 실행 전에 발생한 에러 조건을 설명합니다. 이 입력은 표준 에러 입력 기능을 제공합니다. 
가장 최근 값 유지
—
가장 최근 값 유지는 이벤트 큐에서 가장 최근 이벤트를 몇 개 보관할 것인지 지정합니다. 이벤트 타입 또는 객체 파라미터를 연결하는 경우, 가장 최근 값 유지는 지정하는 타입의 이벤트에만 영향을 미칩니다. 한 개보다 많은 개수의 이벤트 큐를 비우려는 경우, 가장 최근 값 유지는 지정한 모든 이벤트 큐에서 보관할 이벤트의 총 개수를 포함합니다. 노트 가장 오래된 이벤트 시간과 가장 최근 값 유지를 모두 연결하지 않으면, 함수는 이벤트 타입 또는 객체가 설정한 기준에 부합하는 모든 큐에서 이벤트를 모두 버립니다. 가장 오래된 이벤트 시간과 가장 최근 값 유지를 모두 연결하면, 이 함수는 지정한 이벤트 시간에 시작하는 모든 이벤트 그리고 가장 최근 이벤트 중 보관하기로 지정한 이벤트 개수 내의 이벤트를 모두 보관합니다.
이벤트 등록 참조 번호 출력
—
이벤트 등록 참조 번호 출력은 비운 이벤트 큐와 연관된 이벤트 등록 참조 번호를 반환합니다. 
버린 이벤트 개수
—
버린 이벤트 개수는 버린 이벤트의 전체 개수를 반환합니다. 
에러 출력
—
에러 출력은 에러 정보를 포함합니다. 이 출력은 표준 에러 출력 기능을 제공합니다. |
마우스 이동 또는 패널 크기 조정 이벤트와 같이 이벤트가 빠르게 연속적으로 발생하지만 어플리케이션이 가장 최근의 이벤트만 필요로 하는 어플리케이션의 경우, 오래된 이벤트를 버리면 어플리케이션이 새로운 이벤트 데이터에 보다 신속하게 응답할 수 있게 됩니다.
다음 예제들은 이벤트 타입 또는 객체 파라미터에 데이터를 연결하여 [이벤트 큐 비우기] 함수의 이벤트 버리기 방식을 지정하는 방법을 보여줍니다. 예제는 이벤트 등록 참조 번호 파라미터의 사용을 보여주지 않기 때문에, 올바르게 작동하려면 이 코드를 이벤트 구조의 이벤트 케이스에 놓거나 이 입력을 적절한 이벤트 등록 참조 번호에 연결해야 합니다.
예제 1: 한 개 이상의 이벤트 타입 버리기
마우스 다운 및 마우스 업과 같은 이벤트 타입을 한 개 이상 버리고자 하는 경우, 다음 예제와 같이 이벤트 타입 열거형의 배열 또는 클러스터를 이벤트 타입 또는 객체 입력에 연결하면 됩니다.
[이벤트 큐 비우기]는 이벤트 소스와 상관없이 마우스 다운 및 마우스 업 이벤트를 모두 버립니다. 그러나, 상수값 1이 가장 최근 값 유지 파라미터에 연결되어 있기 때문에, 이 함수는 가장 최근에 발생한 마우스 다운 또는 마우스 업 이벤트 중 하나를 이벤트 큐에 보관합니다. 또한 이 함수는 각 이벤트 타입당 한 개의 이벤트를 유지하는 것이 아니라 전체에서 한 개의 이벤트만 유지합니다.
예제 2: 특정 객체가 생성한 이벤트 버리기
이벤트 생성 객체를 가리키는 VI 서버 참조, 사용자 이벤트 참조 번호, 관련 이벤트의 모든 참조 번호를 이벤트 타입 또는 객체 입력에 연결하면 특정 객체가 생성한 이벤트만 버릴 수 있습니다. 여러 객체에서 이벤트를 버리려면, 다음 예제와 같이 참조 번호의 배열 또는 클러스터를 사용합니다.
[이벤트 큐 비우기]는 클러스터에 묶인 참조에 링크되어 있는 객체에 의해 생성된 모든 타입의 이벤트를 버립니다.
예제 3: 특정 객체가 생성한 특정 이벤트 버리기
특정 객체가 생성하는 이벤트만 버리려는 경우, 버리고자 하는 이벤트 타입이 포함된 열거형과 해당 이벤트 생성 객체를 가리키는 참조 번호를 묶으면 됩니다. 또한 이벤트 타입 열거형과 객체의 쌍으로 이루어진 클러스터 또는 배열을 생성하여 다음 예제와 같이 여러 객체와 연관된 여러 이벤트를 버릴 수도 있습니다.
—이 함수는 불리언이 마우스 업 또는 마우스 다운 이벤트를 생성할 때에만 이들 이벤트를 버립니다. 
—이 함수는 2D 그림 컨트롤이 마우스 이동 이벤트를 생성할 때에만 이 이벤트를 버립니다. 
— 이벤트가 특정 객체와 쌍을 이루지 않기 때문에, 이 함수는 어떤 이벤트 소스가 해당 이벤트를 생성할 때 키 업 이벤트를 버립니다.