EVENT_COMMIT
Description
When a user actually commits to an operation, such as selecting a menu or typing in a number and pressing <Enter>, LabWindows/CVI generates an EVENT_COMMIT event and sends the event to the callback function associated with the control. LabWindows/CVI also places commit events in the GetUserEvent queue, unless you swallow the event.
Applies To
Binary switches, color numerics, command buttons, graphs, LEDs, list boxes, menus, numeric slides, numerics, picture buttons, picture rings, radio buttons, ring slides, rings, strings, tables, text boxes, text buttons, toggle buttons, and trees
Event Data Parameters
| User Interface Object | Action | Event Data Values |
|---|---|---|
| Menus (menu selection events calling the main callback) | Selecting items from a menu | eventData1 = Panel for menu selections eventData2 = callbackData for menu item (cast to an integer) |
| Tables (table events calling the control callback) | All table commit actions | eventData1 = Row of cell where event was generated. If the event affected multiple cells,
such as when you sort or paste a range of cells, eventData1 is set to 0. eventData2 = Column of cell where event was generated. If the event affected multiple cells, such as when you sort or paste a range of cells, eventData2 is set to 0. |
| Trees (tree events calling the control callback) | Changing the state of a tree item | eventData1 = MARK_STATE_CHANGE eventData2 = Not used |
| Finishing label changes | eventData1 = LABEL_CHANGE eventData2 = itemIndex | |
| Double-clicking | eventData1 = LEFT_DOUBLE_CLICK eventData2 = itemIndex | |
| Pressing the <Enter> key | eventData1 = ENTER_KEY eventData2 = itemIndex | |
| Clicking a column label | eventData1 = COLUMN_LABEL_CLICK eventData2 = Index of the column where the event was generated |
|
| Graphs | All graph commit actions | eventData1 = The index of the cursor or the annotation, depending on which one the user moved eventData2 = VAL_CURSOR or VAL_ANNOTATION, as appropriate to eventData1 |
LabWindows/CVI Compatibility
LabWindows/CVI 3.0 and later