Holder.setValue

Sets the value within the holder. If holder is an alias for another holder, then the value is also set for that other holder.

On success, the action of any call to gda.holder.Holder.forceInvalid is cancelled as soon as this method is called (even if holder's value does not actually change)

If the value is not different from the one already contained within holder, then holder is not changed and no signal is emitted.

Note1: the value argument is treated the same way if it is null or if it is a #GDA_TYPE_NULL value

Note2: if holder can't accept the value value, then this method returns FALSE, and holder will be left in an invalid state.

Note3: before the change is accepted by holder, the "validate-change" signal will be emitted (the value of which can prevent the change from happening) which can be connected to to have a greater control of which values holder can have, or implement some business rules.

class Holder
bool
setValue

Parameters

value gobject.value.Value

a value to set the holder to, or null

Return Value

Type: bool

TRUE if value has been set

Throws