#include <Fireworks/TableWidget/interface/FWTableManagerBase.h>

Inheritance diagram for FWTableManagerBase:

Public Member Functions
virtual void	buttonPressedInRowHeader (Int_t row, Event_t *event, Int_t relX, Int_t relY)
	Called if mouse button pressed in Row Header, defaults is to do nothing. More...

virtual void	buttonReleasedInRowHeader (Int_t row, Event_t *event, Int_t relX, Int_t relY)

virtual bool	cellDataIsSortable () const

virtual unsigned int	cellHeight () const
	require all cells to be the same height More...

virtual FWTableCellRendererBase *	cellRenderer (int iSortedRowNumber, int iCol) const =0

	ClassDefOverride (FWTableManagerBase, 0)

void	dataChanged ()
	Classes which inherit from FWTableManagerBase must call this when their underlying data changes. More...

	FWTableManagerBase ()

virtual std::vector< std::string >	getTitles () const =0
	returns the title names for each column More...

virtual bool	hasLabelHeaders () const

virtual bool	hasRowHeaders () const
	Returns 'true' if this table has row headers. Defaults return value is false. More...

virtual std::vector< unsigned int >	maxWidthForColumns () const
	for each column in the table this returns the present maximum width for that column More...

virtual int	numberOfColumns () const =0
	Number of columns in the table. More...

virtual int	numberOfRows () const =0
	Number of rows in the table. More...

virtual FWTableCellRendererBase *	rowHeader (int iSortedRowNumber) const
	Returns the renderer for the row header for the sorted row number iSortedRowNumber. More...

void	sort (int iCol, bool iSortOrder)
	Call to have table sorted on values in column iCol with the sort order being descending if iSortOrder is 'true'. More...

int	sortColumn (void)
	The current sort column. More...

bool	sortOrder (void)
	The current sort order for the table. More...

virtual int	unsortedRowNumber (int iSortedRowNumber) const =0
	when passed the index to the sorted order of the rows it returns the original row number from the underlying data More...

void	visualPropertiesChanged ()
	Classes which inherit from FWTableManagerBase must call this when how the data is shown (e.g. color) changes. More...

	~FWTableManagerBase () override

Protected Member Functions
virtual void	implSort (int iCol, bool iSortOrder)=0
	Called by 'sort' method to actually handle the sorting of the rows. Arguments are the same as 'sort'. More...

Private Attributes
int	m_sortColumn

bool	m_sortOrder

Detailed Description

Description: Base class for classes that work as interfaces that translate underlying data into a table form

Usage: Classes which inherit from FWTableManagerBase are used as adapters to allow external data to be shown in tabular form via the FWTableWidget. The table is made of three parts 1) The column headers: Each column is described by a 'title' and the title is drawn in the column header 2) The body: the actual data of the table laid out in rows and columns 3) the row headers: optional identifier for a row. If given, the row header will always be visible on the screen if any part of the row is visible

The FWTableWidget actually draws the cells in the table by asking the FWTableManagerBase for a FWTableCellRendererBase for a particular cell. The renderer will then be asked to draw the cell into the appropriate part of the graphics window. Therfore it is the FWTableManagerBase's responsibility to create FWTableCellRendererBases which are appropriate for the data to be shown in each cell of the table. See the documentation of FWTableCellRendererBase for further information.

FWTableManagerBase must also be able to sort the rows of data based on the values in a specified column.

Definition at line 44 of file FWTableManagerBase.h.

Constructor & Destructor Documentation

FWTableManagerBase::FWTableManagerBase ( )

Definition at line 30 of file FWTableManagerBase.cc.

30 : m_sortColumn(-1), m_sortOrder(false) {}

FWTableManagerBase::m_sortColumn

int m_sortColumn

Definition: FWTableManagerBase.h:117

FWTableManagerBase::m_sortOrder

bool m_sortOrder

Definition: FWTableManagerBase.h:118

FWTableManagerBase::~FWTableManagerBase ( )

override

Definition at line 37 of file FWTableManagerBase.cc.

37 {}

Member Function Documentation

void FWTableManagerBase::buttonPressedInRowHeader	(	Int_t	row,
		Event_t *	event,
		Int_t	relX,
		Int_t	relY
	)

virtual

Called if mouse button pressed in Row Header, defaults is to do nothing.

Definition at line 112 of file FWTableManagerBase.cc.

112 {}

void FWTableManagerBase::buttonReleasedInRowHeader	(	Int_t	row,
		Event_t *	event,
		Int_t	relX,
		Int_t	relY
	)

virtual

Reimplemented in FWCollectionSummaryTableManager.

Definition at line 113 of file FWTableManagerBase.cc.

Referenced by FWTableWidget::buttonPressedInRowHeader(), and FWTableWidget::buttonReleasedInRowHeader().

113 {}

virtual bool FWTableManagerBase::cellDataIsSortable ( ) const

inlinevirtual

Reimplemented in FWGeometryTableManagerBase, and FWPSetTableManager.

Definition at line 81 of file FWTableManagerBase.h.

Referenced by FWTableWidget::FWTableWidget().

81 { return true; }

unsigned int FWTableManagerBase::cellHeight ( ) const

virtual

require all cells to be the same height

Definition at line 75 of file FWTableManagerBase.cc.

References cellRenderer(), hasRowHeaders(), FWTableCellRendererBase::height(), and rowHeader().

Referenced by FWTabularWidget::dataChanged(), FWTabularWidget::FWTabularWidget(), FWPSetTableManager::maxWidthForColumns(), and FWPSetTableManager::setSelection().

                                                   {
   FWTableCellRendererBase* cr = cellRenderer(0, 0);
   if (cr) {
     return cr->height();
   }
   if (hasRowHeaders()) {
     cr = rowHeader(0);
     if (cr) {
       return cr->height();
     }
   }
   return 0;
 }

virtual FWTableCellRendererBase* FWTableManagerBase::cellRenderer	(	int	iSortedRowNumber,
		int	iCol
	)		const

pure virtual

Returns the particular renderer used to handle the requested cell. Arguments: iSortedRowNumber: the row number from the present sort (i.e. the cell number of the view) iCol: the column number of the cell. The returned value must be used immediately and not held onto since the same Renderer can be used for subsequent calls

Implemented in DataAdderTableManager, FWPSetTableManager, FWGeometryTableManager, FWOverlapTableManager, FWTableViewTableManager, FWCollectionSummaryTableManager, FWTriggerTableViewTableManager, FWAdapterHeaderTableManager, and FWAdapterRowHeaderTableManager.

Referenced by cellHeight(), FWTabularWidget::DoRedraw(), FWTabularWidget::HandleButton(), and maxWidthForColumns().

FWTableManagerBase::ClassDefOverride	(	FWTableManagerBase	,
		0
	)

void FWTableManagerBase::dataChanged ( void )

Classes which inherit from FWTableManagerBase must call this when their underlying data changes.

Definition at line 63 of file FWTableManagerBase.cc.

References implSort(), m_sortColumn, and m_sortOrder.

Referenced by FWTriggerTableViewTableManager::dataChanged(), FWCollectionSummaryTableManager::dataChanged(), FWTableViewTableManager::dataChanged(), FWGeometryTableManagerBase::firstColumnClicked(), FWCollectionSummaryTableManager::FWCollectionSummaryTableManager(), FWPathsPopup::postEvent(), FWGeoTopNode::ProcessSelection(), FWGeometryTableManagerBase::redrawTable(), DataAdderTableManager::reset(), FWPSetTableManager::setExpanded(), DataAdderTableManager::sortWithFilter(), FWPSetTableManager::updateFilter(), and FWGUIEventDataAdder::updateFilterString().

                                      {
   if (-1 != m_sortColumn) {
     implSort(m_sortColumn, m_sortOrder);
   }
   Emit("dataChanged()");
 }

virtual std::vector<std::string> FWTableManagerBase::getTitles ( ) const

pure virtual

returns the title names for each column

Implemented in FWGeometryTableManagerBase, FWPSetTableManager, DataAdderTableManager, FWOverlapTableManager, FWTableViewTableManager, FWCollectionSummaryTableManager, FWTriggerTableViewTableManager, FWAdapterHeaderTableManager, and FWAdapterRowHeaderTableManager.

Referenced by FWAdapterHeaderTableManager::getTitles().

bool FWTableManagerBase::hasLabelHeaders ( ) const

virtual

Definition at line 107 of file FWTableManagerBase.cc.

107 { return true; }

bool FWTableManagerBase::hasRowHeaders ( ) const

virtual

Returns 'true' if this table has row headers. Defaults return value is false.

Reimplemented in FWTableViewTableManager, and FWCollectionSummaryTableManager.

Definition at line 109 of file FWTableManagerBase.cc.

Referenced by cellHeight().

109 { return false; }

virtual void FWTableManagerBase::implSort	(	int	iCol,
		bool	iSortOrder
	)

protectedpure virtual

Called by 'sort' method to actually handle the sorting of the rows. Arguments are the same as 'sort'.

Implemented in FWGeometryTableManagerBase, FWPSetTableManager, FWTableViewTableManager, DataAdderTableManager, FWCollectionSummaryTableManager, FWTriggerTableViewTableManager, FWAdapterHeaderTableManager, and FWAdapterRowHeaderTableManager.

Referenced by dataChanged(), and sort().

std::vector< unsigned int > FWTableManagerBase::maxWidthForColumns ( ) const

virtual

for each column in the table this returns the present maximum width for that column

Reimplemented in FWPSetTableManager.

Definition at line 89 of file FWTableManagerBase.cc.

References cellRenderer(), cuy::col, SiStripPI::max, numberOfColumns(), numberOfRows(), and FWTableCellRendererBase::width().

Referenced by FWTabularWidget::dataChanged(), FWTabularWidget::FWTabularWidget(), and FWPSetTableManager::maxWidthForColumns().

                                                                      {
   std::vector<unsigned int> returnValue;
   returnValue.reserve(numberOfColumns());
   const int numCols = numberOfColumns();
   const int numRows = numberOfRows();
   for (int col = 0; col < numCols; ++col) {
     unsigned int max = 0;
     for (int row = 0; row < numRows; ++row) {
       unsigned int width = cellRenderer(row, col)->width();
       if (width > max) {
         max = width;
       }
     }
     returnValue.push_back(max);
   }
   return returnValue;
 }

virtual int FWTableManagerBase::numberOfColumns ( ) const

pure virtual

Number of columns in the table.

Implemented in FWPSetTableManager, DataAdderTableManager, FWGeometryTableManager, FWOverlapTableManager, FWCollectionSummaryTableManager, FWTableViewTableManager, FWTriggerTableViewTableManager, FWAdapterHeaderTableManager, and FWAdapterRowHeaderTableManager.

Referenced by FWGeometryTableManagerBase::getTitles(), maxWidthForColumns(), FWAdapterHeaderTableManager::numberOfColumns(), FWTabularWidget::setWidthOfTextInColumns(), and sort().

virtual int FWTableManagerBase::numberOfRows ( ) const

pure virtual

Number of rows in the table.

Implemented in FWGeometryTableManagerBase, FWPSetTableManager, DataAdderTableManager, FWCollectionSummaryTableManager, FWTableViewTableManager, FWTriggerTableViewTableManager, FWAdapterHeaderTableManager, and FWAdapterRowHeaderTableManager.

Referenced by FWTabularWidget::DoRedraw(), FWTabularWidget::GetDefaultSize(), maxWidthForColumns(), FWAdapterRowHeaderTableManager::numberOfRows(), and FWTabularWidget::translateToRowColumn().

FWTableCellRendererBase * FWTableManagerBase::rowHeader ( int iSortedRowNumber ) const

virtual

Returns the renderer for the row header for the sorted row number iSortedRowNumber.

Reimplemented in FWTableViewTableManager, and FWCollectionSummaryTableManager.

Definition at line 110 of file FWTableManagerBase.cc.

Referenced by cellHeight(), and FWAdapterRowHeaderTableManager::cellRenderer().

110 { return nullptr; }

void FWTableManagerBase::sort	(	int	iCol,
		bool	iSortOrder
	)

Call to have table sorted on values in column iCol with the sort order being descending if iSortOrder is 'true'.

Definition at line 54 of file FWTableManagerBase.cc.

References cuy::col, implSort(), m_sortColumn, m_sortOrder, numberOfColumns(), sortOrder(), and visualPropertiesChanged().

Referenced by FWGUIEventDataAdder::metadataUpdatedSlot(), FWTableWidget::sort(), and DataAdderTableManager::sortWithFilter().

                                                      {
   if (col <= numberOfColumns()) {
     m_sortColumn = col;
     m_sortOrder = sortOrder;
     implSort(col, sortOrder);
     visualPropertiesChanged();
   }
 }