Dialog widget for creating and editing change reasons. More...

Inheritance diagram for ChangeReasonDetailDialog:

Collaboration diagram for ChangeReasonDetailDialog:

Signals
void	isDirtyChanged (bool dirty)

void	changeReasonSaved (const QString &code)

void	changeReasonDeleted (const QString &code)

Signals inherited from DetailDialogBase
void	closeRequested ()
	Emitted when the dialog wants to close its container window.

void	statusMessage (const QString &message)
	Emitted to show a status message in the status bar.

void	errorMessage (const QString &message)
	Emitted when an error occurs that should be shown to the user.

Public Member Functions
	ChangeReasonDetailDialog (QWidget *parent=nullptr)

void	setClientManager (ClientManager *clientManager)

void	setUsername (const std::string &username)

void	setChangeReason (const dq::domain::change_reason &reason)

dq::domain::change_reason	getChangeReason () const

void	setCreateMode (bool createMode)

void	setReadOnly (bool readOnly, int versionNumber=0)

void	setHistory (const std::vector< dq::domain::change_reason > &history, int versionNumber)

void	clearDialog ()

void	save ()

void	setCategories (const std::vector< dq::domain::change_reason_category > &categories)

QString	changeReasonCode () const

bool	isDirty () const

bool	isReadOnly () const

Public Member Functions inherited from DetailDialogBase
bool	isCloseConfirmed () const
	Returns true if the user has already confirmed closing this dialog.

void	setChangeReasonCache (ChangeReasonCache *cache)
	Inject the shared change reason cache.

Protected Member Functions
QTabWidget *	tabWidget () const override
	Returns the dialog's QTabWidget (named "tabWidget" in .ui).

QWidget *	provenanceTab () const override
	Returns the Provenance tab widget (named "provenanceTab" in .ui).

ProvenanceWidget *	provenanceWidget () const override
	Returns the promoted ProvenanceWidget (named "provenanceWidget" in .ui).

bool	hasUnsavedChanges () const override

Protected Member Functions inherited from DetailDialogBase
void	requestClose ()
	Request closure of the container window.

void	notifySaveSuccess (const QString &message)
	Notify that a save operation completed successfully.

void	setProvenanceEnabled (bool enabled)
	Enable or disable the Provenance tab.

void	populateProvenance (int version, const std::string &modified_by, const std::string &performed_by, std::chrono::system_clock::time_point recorded_at, const std::string &change_reason_code, const std::string &change_commentary)
	Populate the embedded ProvenanceWidget with entity data.

void	clearProvenance ()
	Clear all fields in the embedded ProvenanceWidget.

std::optional< change_reason_selection >	promptChangeReason (ChangeReasonDialog::OperationType opType, bool isDirty, std::string_view category="system")
	Show the change reason dialog and return the user's selection.

Additional Inherited Members
Protected Slots inherited from DetailDialogBase
void	onCloseClicked ()
	Called when the Close button is clicked.

Static Protected Member Functions inherited from DetailDialogBase
template<typename T >
static std::optional< T >	nulloptIfZero (T v)
	Return std::optional(v) when v is non-zero, std::nullopt otherwise.

Detailed Description

Dialog widget for creating and editing change reasons.

This widget provides a form for entering change reason details, with save and delete capabilities.

Member Function Documentation

QTabWidget * tabWidget ( ) const

overrideprotectedvirtual

Returns the dialog's QTabWidget (named "tabWidget" in .ui).

QWidget * provenanceTab ( ) const

overrideprotectedvirtual

Returns the Provenance tab widget (named "provenanceTab" in .ui).

ProvenanceWidget * provenanceWidget ( ) const

overrideprotectedvirtual

Returns the promoted ProvenanceWidget (named "provenanceWidget" in .ui).

bool hasUnsavedChanges ( ) const

overrideprotectedvirtual

Returns true if the dialog has unsaved changes. Subclasses override.

Reimplemented from DetailDialogBase.