Public Member Functions
virtual void	beginChange (const SettingGroup &group, const Messaging::Char *details)=0
virtual void	endChange ()=0

Detailed Description

A controller may reject a change in beginChange(). After beginChange() succeeds, the caller must invoke endChange() exactly once.

Definition at line 37 of file SettingGroup.h.

Member Function Documentation

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

pure virtual

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.

virtual void endChange ( )

pure virtual

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.