User supplied callback procedure for handling selection changes.
typedef GSErrCode APISelectionChangeHandlerProc ( const API_Neig* selElemNeig );
Parameters
- selElemNeig
- [in] This structure identifies the last selected element.
Return Values
NoError
- The function has completed with success.
For other common API errors see the API Errors document.
Remarks
This is the function which will be called when your add-on installed it with ACAPI_Notify_CatchSelectionChange.
Example
// ----------------------------------------------------------------------------- // Selection change handler function // ----------------------------------------------------------------------------- static GSErrCode __ACENV_CALL SelectionChangeHandler (const API_Neig *selElemNeig) { char msgStr[256]; if (selElemNeig->neigID != APINeig_None) { sprintf (msgStr, "Last selected element: NeigID %d; index: %d, inIndex: %d", selElemNeig->neigID, selElemNeig->index, selElemNeig->inIndex); ACAPI_WriteReport (msgStr, false); } else ACAPI_WriteReport ("All elements deselected", false); return NoError; } // SelectionChangeHandler
Requirements
- Version: API 4.1 or later
- Header: APIdefs_Callback.h