Events and updates

Introduction

This page lists the "events" that are defined in Rave that cause some object(s) on the workspace or data sets to need to be updated. If you are using Rave, you generally don't need to worry about these... they will be happening in the background whenever you interact with your data. If you are coding Rave plugins, you need to understand when to alert other objects that an event has occurred.

In the lists below, events are named according to their Rave keywords, which correspond to the information being updated (for analysis updates) or the way in which the data set has changed (for data set updates).

Analysis Events

• isselected - A change to which rows are currently selected.
• visiblerows - A change to which rows are currently visible.
• rowcolors - A change to the row colors.
• xdials - A change to a variable's current value. This event can take an optional parameter defining which variable's value has changed.
• isfitlered - A change to the filter values.
• preferences - A change to the preferences.

Data Set Events

• targets - A change to the targets.
• addrows - Rows have been added to the data set.
• replaceall - The data set has been replaced completely, or otherwise changed so drastically that it should be treated as entirely new.
• datachanged - Data values have changed, but the number of rows (and their "identity") has not changed.
• removerows - Rows have been removed from the data set.