EntityDetailDialog Class Reference

Shared detail dialog for viewing and editing party and counterparty records. More...

#include <EntityDetailDialog.hpp>

Inheritance diagram for EntityDetailDialog:

Collaboration diagram for EntityDetailDialog:

Signals
void	entitySaved (const QString &code)
void	entityDeleted (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
	EntityDetailDialog (std::shared_ptr< entity_detail_operations > ops, QWidget *parent=nullptr)
void	setClientManager (ClientManager *clientManager)
void	setImageCache (ImageCache *imageCache)
void	setUsername (const std::string &username)
void	setEntityData (const entity_data &data)
void	setCreateMode (bool createMode)
void	setReadOnly (bool readOnly)
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

Shared detail dialog for viewing and editing party and counterparty records.

This dialog is parameterised via an entity_detail_operations implementation to handle the protocol-level differences between parties and counterparties. All UI code (tabs, sub-tables, hierarchy, metadata) is shared.

Member Function Documentation

tabWidget()

QTabWidget * tabWidget ( ) const

overrideprotectedvirtual

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

Implements DetailDialogBase.

provenanceTab()

QWidget * provenanceTab ( ) const

overrideprotectedvirtual

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

Implements DetailDialogBase.

provenanceWidget()

ProvenanceWidget * provenanceWidget ( ) const

overrideprotectedvirtual

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

Implements DetailDialogBase.

hasUnsavedChanges()

bool hasUnsavedChanges ( ) const

overrideprotectedvirtual

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

Reimplemented from DetailDialogBase.