#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.
virtual void	buttonReleasedInRowHeader (Int_t row, Event_t *event, Int_t relX, Int_t relY)
virtual unsigned int	cellHeight () const
	require all cells to be the same height
virtual FWTableCellRendererBase *	cellRenderer (int iSortedRowNumber, int iCol) const =0
	ClassDef (FWTableManagerBase, 0)
void	dataChanged ()
	Classes which inherit from FWTableManagerBase must call this when their underlying data changes.
	FWTableManagerBase ()
virtual std::vector< std::string >	getTitles () const =0
	returns the title names for each column
virtual bool	hasLabelHeaders () const
virtual bool	hasRowHeaders () const
	Returns 'true' if this table has row headers. Defaults return value is false.
virtual std::vector< unsigned int >	maxWidthForColumns () const
	for each column in the table this returns the present maximum width for that column
virtual int	numberOfColumns () const =0
	Number of columns in the table.
virtual int	numberOfRows () const =0
	Number of rows in the table.
virtual FWTableCellRendererBase *	rowHeader (int iSortedRowNumber) const
	Returns the renderer for the row header for the sorted row number iSortedRowNumber.
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'.
int	sortColumn (void)
	The current sort column.
bool	sortOrder (void)
	The current sort order for the table.
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
void	visualPropertiesChanged ()
	Classes which inherit from FWTableManagerBase must call this when how the data is shown (e.g. color) changes.
virtual	~FWTableManagerBase ()
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'.
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 45 of file FWTableManagerBase.h.

Constructor & Destructor Documentation

FWTableManagerBase::FWTableManagerBase ( )

Definition at line 32 of file FWTableManagerBase.cc.

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

FWTableManagerBase::~FWTableManagerBase ( ) [virtual]

Definition at line 43 of file FWTableManagerBase.cc.

{
}

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 138 of file FWTableManagerBase.cc.

{
}

void FWTableManagerBase::buttonReleasedInRowHeader	(	Int_t	row,
		Event_t *	event,
		Int_t	relX,
		Int_t	relY
	)		`[virtual]`

Reimplemented in FWCollectionSummaryTableManager.

Definition at line 142 of file FWTableManagerBase.cc.

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

{
}

unsigned int FWTableManagerBase::cellHeight ( ) const [virtual]

require all cells to be the same height

Definition at line 89 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 FWGeometryTableManager, FWTableViewTableManager, FWTriggerTableViewTableManager, FWCollectionSummaryTableManager, DataAdderTableManager, FWPSetTableManager, FWAdapterHeaderTableManager, and FWAdapterRowHeaderTableManager.

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

FWTableManagerBase::ClassDef	(	FWTableManagerBase	,
		0
	)

void FWTableManagerBase::dataChanged ( void )

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

Reimplemented in FWTableViewTableManager, FWTriggerTableViewTableManager, and FWCollectionSummaryTableManager.

Definition at line 73 of file FWTableManagerBase.cc.

References implSort(), m_sortColumn, and m_sortOrder.

Referenced by FWGeometryTableManager::firstColumnClicked(), FWCollectionSummaryTableManager::FWCollectionSummaryTableManager(), FWGeometryBrowser::newIndexSelected(), FWPathsPopup::postProcessEvent(), FWGeometryTableManager::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 FWGeometryTableManager, FWTableViewTableManager, FWTriggerTableViewTableManager, FWCollectionSummaryTableManager, DataAdderTableManager, FWPSetTableManager, FWAdapterHeaderTableManager, and FWAdapterRowHeaderTableManager.

Referenced by FWAdapterHeaderTableManager::getTitles().

bool FWTableManagerBase::hasLabelHeaders ( ) const [virtual]

Definition at line 123 of file FWTableManagerBase.cc.

{
   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 128 of file FWTableManagerBase.cc.

Referenced by cellHeight().

{
   return false;
}

virtual void FWTableManagerBase::implSort	(	int	iCol,
		bool	iSortOrder
	)		`[protected, pure virtual]`

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

Implemented in FWGeometryTableManager, FWTableViewTableManager, FWTriggerTableViewTableManager, FWCollectionSummaryTableManager, DataAdderTableManager, FWPSetTableManager, 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 104 of file FWTableManagerBase.cc.

References cellRenderer(), max(), numberOfColumns(), numberOfRows(), tablePrinter::width, and FWTableCellRendererBase::width().

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

{
   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 FWGeometryTableManager, FWTableViewTableManager, FWTriggerTableViewTableManager, FWCollectionSummaryTableManager, DataAdderTableManager, FWPSetTableManager, FWAdapterHeaderTableManager, and FWAdapterRowHeaderTableManager.

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

virtual int FWTableManagerBase::numberOfRows ( ) const [pure virtual]

Number of rows in the table.

Implemented in FWGeometryTableManager, FWTableViewTableManager, FWTriggerTableViewTableManager, FWCollectionSummaryTableManager, DataAdderTableManager, FWPSetTableManager, 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 132 of file FWTableManagerBase.cc.

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

{
   return 0;
}

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 63 of file FWTableManagerBase.cc.

References 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();
   }
}

int FWTableManagerBase::sortColumn ( void ) [inline]

The current sort column.

Definition at line 106 of file FWTableManagerBase.h.

References m_sortColumn.

{ return m_sortColumn; }

bool FWTableManagerBase::sortOrder ( void ) [inline]

The current sort order for the table.

Definition at line 103 of file FWTableManagerBase.h.

References m_sortOrder.

Referenced by DataAdderTableManager::implSort(), FWAdapterHeaderTableManager::implSort(), sort(), and DataAdderTableManager::sortWithFilter().

{ return m_sortOrder; }

virtual int FWTableManagerBase::unsortedRowNumber ( int iSortedRowNumber ) const [pure virtual]

when passed the index to the sorted order of the rows it returns the original row number from the underlying data

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

Referenced by FWTableWidget::buttonReleasedInBody(), and FWAdapterRowHeaderTableManager::unsortedRowNumber().

void FWTableManagerBase::visualPropertiesChanged ( )

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

Definition at line 81 of file FWTableManagerBase.cc.

Referenced by DataAdderTableManager::changeSelection(), FWGeometryTableManager::changeSelection(), FWGeometryTableManager::firstColumnClicked(), FWPSetTableManager::FWPSetTableManager(), FWGeometryTableManager::redrawTable(), FWPSetTableManager::setExpanded(), FWPSetTableManager::setSelection(), and sort().

{
   Emit("visualPropertiesChanged()");
}

Member Data Documentation

int FWTableManagerBase::m_sortColumn [private]

Definition at line 118 of file FWTableManagerBase.h.

Referenced by dataChanged(), sort(), and sortColumn().

bool FWTableManagerBase::m_sortOrder [private]

Definition at line 119 of file FWTableManagerBase.h.

Referenced by dataChanged(), sort(), and sortOrder().

FWTableManagerBase Class Reference

Public Member Functions

Protected Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation