Advanced Document, Sheet, Staff etc. properties. More...

#include <propertiesdialog.h>

Inheritance diagram for CAPropertiesDialog:

Public Slots
void	on_uiDocumentTree_currentItemChanged (QTreeWidgetItem cur, QTreeWidgetItem prev)

void	on_uiButtonBox_clicked (QAbstractButton *)

void	on_uiUp_clicked (bool)

void	on_uiDown_clicked (bool)

Public Member Functions
	CAPropertiesDialog (CADocument doc, QWidget parent=0)

virtual	~CAPropertiesDialog ()

CADocument *	document ()

QTreeWidgetItem *	documentItem ()

QHash< QTreeWidgetItem , CASheet > &	sheetItem ()

QHash< QTreeWidgetItem , CAContext > &	contextItem ()

QHash< QTreeWidgetItem , CAVoice > &	voiceItem ()

Static Public Member Functions
static void	documentProperties (CADocument doc, QWidget parent)

static void	sheetProperties (CASheet sheet, QWidget parent)

static void	contextProperties (CAContext context, QWidget parent)

static void	voiceProperties (CAVoice voice, QWidget parent)

Private Member Functions
void	buildTree ()

void	applyProperties ()

void	createDocumentFromTree ()

void	updateDocumentProperties (CADocument *)

void	updateSheetProperties (CASheet *)

void	updateStaffProperties (CAStaff *)

void	updateVoiceProperties (CAVoice *)

void	updateLyricsContextProperties (CALyricsContext *)

void	updateFunctionMarkContextProperties (CAFunctionMarkContext *)

Private Attributes
CADocument *	_document

QTreeWidgetItem *	_documentItem

QWidget *	_documentPropertiesWidget

QHash< CASheet , QWidget >	_sheetPropertiesWidget

QHash< QTreeWidgetItem , CASheet >	_sheetItem

QHash< CAContext , QWidget >	_contextPropertiesWidget

QHash< QTreeWidgetItem , CAContext >	_contextItem

QHash< CAVoice , QWidget >	_voicePropertiesWidget

QHash< QTreeWidgetItem , CAVoice >	_voiceItem

Detailed Description

Advanced Document, Sheet, Staff etc. properties.

Licensed under the GNU GENERAL PUBLIC LICENSE. See COPYING for details.

This dialog offers changing all the settings for Canorus objects. It is similar to CASettingsDialog. On the left it shows you a tree widget view of the current document and allows you to select one of the objects and sub-objects. On the right, the object properties are shown. Changes are managed using Ok, Apply and Cancel buttons.

To use this dialog, call one of the static methods documentProperties(), sheetProperties(), contextProperties() or voiceProperties() and pass the current document, sheet, context or voice. Methods will generate and show the dialog and delete it in the end.

Actual objects properties widgets (properties widget for document, sheet etc.) are stored inside *.ui files.

Constructor & Destructor Documentation

◆ CAPropertiesDialog()

CAPropertiesDialog::CAPropertiesDialog	(	CADocument *	doc,
		QWidget *	parent = `0`
	)

References _document, and buildTree().

Here is the call graph for this function:

◆ ~CAPropertiesDialog()

CAPropertiesDialog::~CAPropertiesDialog ( )

virtual

Member Function Documentation

◆ applyProperties()

void CAPropertiesDialog::applyProperties ( )

private

Called when "Apply" button is clicked.

References _contextPropertiesWidget, _document, _documentPropertiesWidget, _voicePropertiesWidget, buildTree(), CAContext::contextType(), createDocumentFromTree(), CAUndo::createUndoCommand(), CAContext::FiguredBassContext, CAContext::FunctionMarkContext, CAContext::LyricsContext, CAUndo::pushUndoCommand(), CACanorus::rebuildUI(), CADocument::setArranger(), CADocument::setComments(), CADocument::setComposer(), CADocument::setCopyright(), CADocument::setDedication(), CAVoice::setMidiChannel(), CAVoice::setMidiPitchOffset(), CAStaff::setNumberOfLines(), CADocument::setPoet(), CADocument::setSubtitle(), CADocument::setTextTranslator(), CADocument::setTitle(), CAContext::Staff, and CACanorus::undo().

Referenced by on_uiButtonBox_clicked().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildTree()

void CAPropertiesDialog::buildTree ( )

private

Fills the content of the document tree on the left. Tree always shows the whole Document structure.

References _contextItem, _contextPropertiesWidget, _document, _documentItem, _documentPropertiesWidget, _sheetItem, _sheetPropertiesWidget, _voiceItem, _voicePropertiesWidget, contextItem(), sheetItem(), CADocument::sheetList(), updateDocumentProperties(), updateFunctionMarkContextProperties(), updateLyricsContextProperties(), updateSheetProperties(), updateStaffProperties(), updateVoiceProperties(), voiceItem(), and CAStaff::voiceList().

Referenced by applyProperties(), and CAPropertiesDialog().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ contextItem()

QHash< QTreeWidgetItem*, CAContext* >& CAPropertiesDialog::contextItem ( )

inline

References _contextItem.

Referenced by buildTree(), and contextProperties().

Here is the caller graph for this function:

◆ contextProperties()

void CAPropertiesDialog::contextProperties	(	CAContext *	context,
		QWidget *	parent
	)

static

References contextItem(), CASheet::document(), and CAContext::sheet().

Referenced by CAMainWin::on_uiContextProperties_triggered().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createDocumentFromTree()

void CAPropertiesDialog::createDocumentFromTree ( )

private

Repositiones document structure as placed in the document tree widget. This is used when a user changes the order of document elements and the elements need to be readded to its parent structures. This method is usually called when applying the changes.

References _contextItem, _document, _sheetItem, _voiceItem, CASheet::addContext(), CADocument::addSheet(), CAStaff::addVoice(), CASheet::contextList(), CAContext::contextType(), CASheet::removeContext(), CADocument::removeSheet(), CAStaff::removeVoice(), CADocument::sheetList(), CAContext::Staff, and CAStaff::voiceList().

Referenced by applyProperties().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ document()

CADocument* CAPropertiesDialog::document ( )

inline

References _document.

◆ documentItem()

QTreeWidgetItem* CAPropertiesDialog::documentItem ( )

inline

References _documentItem.

Referenced by documentProperties().

Here is the caller graph for this function:

◆ documentProperties()

void CAPropertiesDialog::documentProperties	(	CADocument *	doc,
		QWidget *	parent
	)

static

References documentItem().

Referenced by CAMainWin::on_uiDocumentProperties_triggered().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ on_uiButtonBox_clicked

void CAPropertiesDialog::on_uiButtonBox_clicked ( QAbstractButton * button )

slot

References applyProperties().

Here is the call graph for this function:

◆ on_uiDocumentTree_currentItemChanged

void CAPropertiesDialog::on_uiDocumentTree_currentItemChanged	(	QTreeWidgetItem *	cur,
		QTreeWidgetItem *	prev
	)

slot

References _contextItem, _document, _documentItem, _sheetItem, _voiceItem, CAContext::FiguredBassContext, CAContext::FunctionMarkContext, CAContext::LyricsContext, CAContext::Staff, updateDocumentProperties(), updateFunctionMarkContextProperties(), updateLyricsContextProperties(), updateSheetProperties(), updateStaffProperties(), and updateVoiceProperties().

Here is the call graph for this function:

◆ on_uiDown_clicked

void CAPropertiesDialog::on_uiDown_clicked ( bool down )

slot

◆ on_uiUp_clicked

void CAPropertiesDialog::on_uiUp_clicked ( bool down )

slot

◆ sheetItem()

QHash< QTreeWidgetItem*, CASheet* >& CAPropertiesDialog::sheetItem ( )

inline

References _sheetItem.

Referenced by buildTree(), and sheetProperties().

Here is the caller graph for this function:

◆ sheetProperties()

void CAPropertiesDialog::sheetProperties	(	CASheet *	sheet,
		QWidget *	parent
	)

static

References CASheet::document(), and sheetItem().

Referenced by CAMainWin::on_uiSheetProperties_triggered().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ updateDocumentProperties()

void CAPropertiesDialog::updateDocumentProperties ( CADocument * doc )

private

References _documentPropertiesWidget, CADocument::arranger(), CADocument::comments(), CADocument::composer(), CADocument::copyright(), CADocument::dedication(), CADocumentProperties::on_uiComposer_editingFinished(), CADocument::poet(), CADocument::subtitle(), CADocument::textTranslator(), and CADocument::title().

Referenced by buildTree(), and on_uiDocumentTree_currentItemChanged().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ updateFunctionMarkContextProperties()

void CAPropertiesDialog::updateFunctionMarkContextProperties ( CAFunctionMarkContext * fmc )

private

References _contextPropertiesWidget.

Referenced by buildTree(), and on_uiDocumentTree_currentItemChanged().

Here is the caller graph for this function:

◆ updateLyricsContextProperties()

void CAPropertiesDialog::updateLyricsContextProperties ( CALyricsContext * lc )

private

References _contextPropertiesWidget.

Referenced by buildTree(), and on_uiDocumentTree_currentItemChanged().

Here is the caller graph for this function:

◆ updateSheetProperties()

void CAPropertiesDialog::updateSheetProperties ( CASheet * sheet )

private

References _sheetPropertiesWidget.

Referenced by buildTree(), and on_uiDocumentTree_currentItemChanged().

Here is the caller graph for this function:

◆ updateStaffProperties()

void CAPropertiesDialog::updateStaffProperties ( CAStaff * staff )

private

References _contextPropertiesWidget, and CAStaff::numberOfLines().

Referenced by buildTree(), and on_uiDocumentTree_currentItemChanged().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ updateVoiceProperties()

void CAPropertiesDialog::updateVoiceProperties ( CAVoice * voice )

private

References _voicePropertiesWidget, CAVoice::midiChannel(), and CAVoice::midiPitchOffset().

Referenced by buildTree(), and on_uiDocumentTree_currentItemChanged().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ voiceItem()

QHash< QTreeWidgetItem*, CAVoice* >& CAPropertiesDialog::voiceItem ( )

inline

References _voiceItem.

Referenced by buildTree(), and voiceProperties().

Here is the caller graph for this function:

◆ voiceProperties()

void CAPropertiesDialog::voiceProperties	(	CAVoice *	voice,
		QWidget *	parent
	)

static

References CASheet::document(), CAContext::sheet(), CAVoice::staff(), and voiceItem().

Referenced by CAMainWin::on_uiVoiceProperties_triggered().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

◆ _contextItem

QHash< QTreeWidgetItem*, CAContext* > CAPropertiesDialog::_contextItem

private

Referenced by buildTree(), contextItem(), createDocumentFromTree(), and on_uiDocumentTree_currentItemChanged().

◆ _contextPropertiesWidget

QHash< CAContext*, QWidget* > CAPropertiesDialog::_contextPropertiesWidget

private

Referenced by applyProperties(), buildTree(), updateFunctionMarkContextProperties(), updateLyricsContextProperties(), and updateStaffProperties().

◆ _document

CADocument* CAPropertiesDialog::_document

private

Referenced by applyProperties(), buildTree(), CAPropertiesDialog(), createDocumentFromTree(), document(), and on_uiDocumentTree_currentItemChanged().

◆ _documentItem

QTreeWidgetItem* CAPropertiesDialog::_documentItem

private

Referenced by buildTree(), documentItem(), and on_uiDocumentTree_currentItemChanged().

◆ _documentPropertiesWidget

QWidget* CAPropertiesDialog::_documentPropertiesWidget

private

Referenced by applyProperties(), buildTree(), and updateDocumentProperties().

◆ _sheetItem

QHash< QTreeWidgetItem*, CASheet* > CAPropertiesDialog::_sheetItem

private

Referenced by buildTree(), createDocumentFromTree(), on_uiDocumentTree_currentItemChanged(), and sheetItem().

◆ _sheetPropertiesWidget

QHash< CASheet*, QWidget* > CAPropertiesDialog::_sheetPropertiesWidget

private

Referenced by buildTree(), and updateSheetProperties().

◆ _voiceItem

QHash< QTreeWidgetItem*, CAVoice* > CAPropertiesDialog::_voiceItem

private

Referenced by buildTree(), createDocumentFromTree(), on_uiDocumentTree_currentItemChanged(), and voiceItem().

◆ _voicePropertiesWidget

QHash< CAVoice*, QWidget* > CAPropertiesDialog::_voicePropertiesWidget

private

Referenced by applyProperties(), buildTree(), and updateVoiceProperties().

The documentation for this class was generated from the following files:

/home/iurt/rpmbuild/BUILD/canorus-0.7.3svn20190422/src/ui/propertiesdialog.h
/home/iurt/rpmbuild/BUILD/canorus-0.7.3svn20190422/src/ui/propertiesdialog.cpp

Public Slots

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ CAPropertiesDialog()

◆ ~CAPropertiesDialog()

Member Function Documentation

◆ applyProperties()

◆ buildTree()

◆ contextItem()

◆ contextProperties()

◆ createDocumentFromTree()

◆ document()

◆ documentItem()

◆ documentProperties()

◆ on_uiButtonBox_clicked

◆ on_uiDocumentTree_currentItemChanged

◆ on_uiDown_clicked

◆ on_uiUp_clicked

◆ sheetItem()

◆ sheetProperties()

◆ updateDocumentProperties()

◆ updateFunctionMarkContextProperties()

◆ updateLyricsContextProperties()

◆ updateSheetProperties()

◆ updateStaffProperties()

◆ updateVoiceProperties()

◆ voiceItem()

◆ voiceProperties()

Member Data Documentation

◆ _contextItem

◆ _contextPropertiesWidget

◆ _document

◆ _documentItem

◆ _documentPropertiesWidget

◆ _sheetItem

◆ _sheetPropertiesWidget

◆ _voiceItem

◆ _voicePropertiesWidget