Invalidate

This method enables encoding a QRC frame that is used to set all Named Controls / Name Components to "Dirty" state.

Syntax

METHOD Invalidate : I_Connect
VAR_INPUT
    sChangeGroupId            : STRING;
END_VAR

VAR_INPUT

sChangeGroupId: Change group ID.

Invalidate 1:

How the change group works internally in Q-SYS

After a new control has been added to a change group, this control is marked as a “Dirty” state, which means that its current properties are not reported. Once its current properties are reported by Poll or AutoPoll methods, its state will change to “Clean”. Only the control which has the "Dirty" state will be reported by polling method, and the control that has the “Clean” state will not be reported. The control state will be switched from “Clean” to “Dirty” only if the properties of this control are changed.

This method enables to set each control within a change group into “Dirty” state. It forces all controls to report their current state information by next Poll or AutoPoll method.