Public Member Functions
void	beginChange (const SettingGroup &group, const Messaging::Char *details) noexcept override
void	endChange () noexcept override

Static Public Member Functions
static SettingChangeController &	self () noexcept

Detailed Description

Both controller callbacks are no-ops. Use self() to obtain the shared instance used by settings that have no explicit controller.

Definition at line 59 of file SettingGroup.h.

Member Function Documentation

void beginChange	(	const SettingGroup &	group,
		const Messaging::Char *	details )

inlineoverridevirtualnoexcept

Starts a guarded setting change.

Parameters

group	Group containing the setting being changed.
details	Human-readable description of the change; may be null.

Exceptions

Any	exception used by the implementation to reject or defer the change.

Definition at line 62 of file SettingGroup.h.

void endChange ( )

inlineoverridevirtualnoexcept

Completes the current guarded setting change.

Note: Call this exactly once after a successful beginChange() and before starting another change through the same controller.; Implementations must not throw. This function is called from the noexcept SettingChangeGuard destructor; an escaping exception terminates the process.

Definition at line 65 of file SettingGroup.h.

SettingChangeController & self ( )

staticnoexcept

Obtains the shared controller that accepts every change.