termprops_changed


Description:

[ Version ( since = "0.78" ) ]
public virtual signal bool termprops_changed (int[] props)

Emitted when termprops have changed.

props is an array containing the IDs of the terminal properties that may have changed since the last emission of this signal, in an undefined order. Note that emission of this signal is delayed from the receipt of the OSC sequences, and a termprop may have been changed more than once inbetween signal emissions, but only the value set last is retrievable.

The default handler for this signal emits the "termprop-changed" signal for each changed property. Returning true from a handler running before the default will prevent this.

The handler may use the vte_terminal_get_termprop_*() functions (and their by-ID variants), to retrieve the value of any termprop, as well as call reset_termprop (and its by-ID variant) to reset any termprop, or emit the VteTerminal:VteTerminal:termprop-changed signal; but it must *not* call *any* other API on terminal, including API of its parent classes.

Parameters:

props

an array of termprop IDs

n_props

the length of the keys array

Returns:

true to stop further handlers being invoked for this signal, or false to continue signal emission