set_on_tp_progress

This function is used to register the callback function to check the information of the execution step when the tp_progress command is used in DRL. It is useful when functions that should be executed automatically are made.

Definition
DRFLEx.h within class CDRFLEx, public section (line 643)

void set_on_tp_progress(TOnTpProgressCB pCallbackFunc) {
    _set_on_tp_progress(_rbtCtrl, pCallbackFunc);
};

Parameter

Parameter Name	Data Type	Default Value	Description
pCallbackFunc	TOnTpProgressCB		Refer to definition of callback function

Return
None

Example

// Callback function for TP progress updates
void OnTpProgress(LPMESSAGE_PROGRESS tProgress)
{
    printf("-------------------------------------------\n");
    printf("[TP PROGRESS UPDATE]\n");
    printf("Current Step : %d / %d\n", tProgress->_iCurrentCount, tProgress->_iTotalCount);
    printf("Progress (%%) : %d%%\n", tProgress->_iPercent);
    printf("Description  : %s\n", tProgress->_szDesc);
    printf("-------------------------------------------\n");

    // Example: stop process when 100% complete
    if (tProgress->_iPercent >= 100)
        printf("[Host] Operation completed successfully.\n");
}

// Register the progress callback
drfl.set_on_tp_progress(OnTpProgress);

printf("Monitoring TP progress updates...\n");
while (true)
{
    this_thread::sleep_for(chrono::seconds(1));
}

When registered, this callback function executes automatically when a progress message is reported from the Teach Pendant (TP). It helps track execution steps, percentage, and status messages to provide live task progress monitoring.