---

qdbtbasetabular.h

#ifndef _QDBTBASETABULAR_H
#define _QDBTBASETABULAR_H

#include <qframe.h>
#include <qguardedptr.h>

#include <qdbt/qdbtglobal.h>
#include <qdbt/qdbtsingleton.h>
#include <qdbt/qdbtselection.h>
#include <qdbt/qdbtsection.h>
#include <qdbt/qdbttabularinfo.h>
#include <qdbt/qdbtbasecell.h>

class QCursor;
class QSize;
class QString;

// some internal classes used to implement this widget

class QdbtBaseTabular;
class QdbtBaseCell;
class QdbtSlideBar;
class QdbtHeader;
class QdbtTable;
class QdbtTabularSelectDialog;
class QdbtSection;
class QdbtCascade;
class QdbtLineEdit;
class QdbtDynaTip;
class QdbtPImpl;

class QDBT_EXPORT QdbtBaseTabular : public QFrame, public QdbtSingletonObject
{
  friend class QdbtHeader;
  friend class QdbtTable;
  friend class QdbtSection;
  friend class QdbtCascade;
  friend class QdbtTabularSelectDialog;
  friend QdbtSection::QdbtSection( QdbtBaseTabular *, const char * );
  friend QdbtSection::QdbtSection( QString, QdbtBaseTabular *, const char * );
  friend const QdbtPImpl *QdbtBaseCell::pimpl( QdbtBaseTabular * ) const;
  friend QdbtSelection::QdbtSelection( QdbtBaseTabular * );
  friend const QdbtPImpl *QdbtTabularInfo::pimpl(
    QGuardedPtr<QdbtBaseTabular> );

  
  Q_OBJECT

public:
  enum HeaderMode        { MODE_QDBTTABULAR = 0x0000,
                           MODE_QLISTVIEW = 0x0001 };
  enum EditResult        { NotChanged = 0, Changed = 1, EditESCed = 2,
                           LoseFocus = 3 };
  enum TraverseReasons   { KeyPress, MouseClick, MouseDrag };

  enum ConfigureSwitches { SELECT_NONE                     = 0x00000000,
                           
                           SELECT_BY_ROW                   = 0x00000001,
                           SELECT_MULTIPLE                 = 0x00000002,
                           CLEAR_SELECTION_UNLESS_CTRL     = 0x00000004,
                           SHIFT_CLICK_MARKS_REGION        = 0x00000008,
                           
                           ALLOW_DESELECT                  = 0x00000010,
                           ENABLE_JUMP_SCROLL              = 0x00000020,
                           
                           SHOW_HEADER                     = 0x00000100,
                           SHOW_CASCADE                    = 0x00000200,
                           SHOW_VERTICAL_SCROLLBAR         = 0x00000400,
                           SHOW_HORIZONTAL_SCROLLBAR       = 0x00000800,
                           
                           ENABLE_TOOLTIPS                 = 0x00001000,
                           SELECTION_FOLLOW_KEYBOARD_FOCUS = 0x00002000,
                           TRAVERSE_ROW_ONLY               = 0x00004000,
                           TRAVERSE_COLUMN_ONLY            = 0x00008000 };

  QdbtBaseTabular( QWidget *parent = 0, const char *name = 0, WFlags w = 0 );
  ~QdbtBaseTabular();

  void setHeaderFont( const QFont &font );
  const QFont headerFont() const;
  void setCellFont( const QFont &font );
  const QFont cellFont() const;
  virtual void setDimensions( int rows, int cols );
  
  void changeSection( QdbtSection *section, int col );
  QdbtSection *section( int col ) const;
  void insertRow( int row = -1, bool selectable = TRUE );
  void removeRow( int row );
  virtual void insertCol( int col = -1 );
  virtual void removeCol( int col );
  int  numRows() const;
  int  numCols() const;
  
  const QdbtBaseCell *cell( int row, int col );
  void changeCell( const QdbtBaseCell * const tc, int row, int col );
  void setKeyboardFocus( int row, int col );
  void exposeCell( int row, int col );
  
  int  columnWidth( int col ) const;
  int  columnWidthHint( int col ) const;
  int  rowHeight( int row ) const;
  
  bool rowSelected( int row ) const;
  void setRowSelected( int row, bool enable );
  
  void setAutoUpdate( bool state );
  bool autoUpdate() const;
  QSize sizeHint() const;
  
  const QFont cascadeFont() const;
  void setCascadeText( int col, const QString &text );
  void setCascadeMode( int col, const int mode );
  void setCascadeAlignment( int col, const int align );
  void setCascadeFont( const QFont &font );
  
  void setHeaderCursor( const QCursor &newCursor );
  void setHeaderAppearance( HeaderMode headerMode );
  HeaderMode headerAppearance();
  virtual void exchangeCols( int col1, int col2 );
  
  bool currentKeyboardFocus( int &row, int &col );
  
  void clearSelection( bool set = FALSE );
  
  void setColumnVisible( int column, bool visible );
  bool columnVisible( int column ) const;
  
  inline const QColor& notEditableColor() const
    {
      return _nonEditColor;
    }
  
  void setNotEditableColor( const QColor &col );

  void setJumpScrollTimeout( int mSeconds );
  int jumpScrollTimeout() const;
    
  int  configuration() const;
  void modifyConfiguration( ConfigureSwitches add    = SELECT_NONE,
                            ConfigureSwitches revoke = SELECT_NONE );
  void setDefaultCell( const QdbtBaseCell & );

  bool containsFocus() const;

  void performTrace( const QString & str )
    {
      emit traceMessage( str );
    }

public slots:
  void update();
  
  void redrawHeader();
  
  void redrawCascade();
  void setEnabled( bool state );

  void fitAll();
  void editCell( int row, int col, bool traverse );
  void editCell( int row, int col );
  void stopEdit( bool accept );

  
protected slots:
  void setYOffset( int offset );
  void setXOffset( int offset );
  void setColumnWidth( int col, int width );
  
private slots:
  void treatSelected( int row, bool state );
  void treatCellSelected( int row, int col, bool state );

signals:
  void sectionClicked( int col );
  void selected( int row, bool state );
  void activated( int row );
  void cellSelected( int row, int col, bool state );
  void cellActivated( int row, int col );
  void cellEditDone( int row, int col, int action, const QString &oldText );
  void yOffsetChanged( int offset );
  void xOffsetChanged( int offset );
  void columnWidthChanged( int col, int width );
  void rightButtonClicked( int col, int row );
  void traceMessage( const QString & );
  
protected:
  virtual void enterTableEvent( QEvent * );
  virtual void leaveTableEvent( QEvent * );
  QSize cellSize( int row, int col ) const;
  QPoint cellOffset( int row, int col ) const;
  int xOffset() const;
  int yOffset() const;
  int findRow( int yPos ) const;
  int findCol( int xPos ) const;
  int headerHeight() const;
  virtual bool keyboardFocusTraversal( const int reason,
                                       const int sourceRow,
                                       const int sourceCol,
                                       int &destRow, int &destCol );
  virtual bool moveFocusForJumpScroll( const int row, const int col,
                                       int &newRow, int &newCol );
  void generateRightButtonClicked( int row, int col );
  
private:
  void          startSlideBar( int minx, int xpos, bool cascadeMode = FALSE );

  QColor                                 _nonEditColor;
  int                                    _configuration, _jumpScrollTimeout;
  int                                    prevSelectedRow, prevSelectedCol;
  HeaderMode                             _headerMode;
  static QValueList< QdbtBaseTabular * > _tabulars;

  static QValueList< QdbtBaseTabular * >& tabulars();

  QdbtPImpl                              *_pimpl;

protected:
  const QdbtPImpl * pimpl() const { return _pimpl; }
};

#endif

---