| 主页 | 所有的类 | 主要的类 | 注释的类 | 分组的类 | 函数 | |
这里是qtable.h包含文件的所有文本，一字不差。它仅仅用来说明，版权由Trolltech保留。
/****************************************************************************
**
** Definition of QTable widget class
**
** Created : 000607
**
** Copyright (C) 1992-2000 Trolltech AS. All rights reserved.
**
** This file is part of the table module of the Qt GUI Toolkit.
**
** This file may be distributed under the terms of the Q Public License
** as defined by Trolltech AS of Norway and appearing in the file
** LICENSE.QPL included in the packaging of this file.
**
** This file may be distributed and/or modified under the terms of the
** GNU General Public License version 2 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file.
**
** Licensees holding valid Qt Enterprise Edition licenses may use this
** file in accordance with the Qt Commercial License Agreement provided
** with the Software.
**
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
**
** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
** information about Qt Commercial License Agreements.
** See http://www.trolltech.com/qpl/ for QPL licensing information.
** See http://www.trolltech.com/gpl/ for GPL licensing information.
**
** Contact info@trolltech.com if any conditions of this licensing are
** not clear to you.
**
**********************************************************************/
#ifndef QTABLE_H
#define QTABLE_H
#ifndef QT_H
#include <qscrollview.h>
#include <qpixmap.h>
#include <qptrvector.h>
#include <qheader.h>
#include <qmemarray.h>
#include <qptrlist.h>
#include <qguardedptr.h>
#include <qshared.h>
#include <qintdict.h>
#include <qstringlist.h>
#endif // QT_H
#ifndef QT_NO_TABLE
class QTableHeader;
class QValidator;
class QTable;
class QPaintEvent;
class QTimer;
class QResizeEvent;
class QComboBox;
class QCheckBox;
class QDragObject;
struct QTablePrivate;
struct QTableHeaderPrivate;
class Q_EXPORT QTableSelection
{
public:
QTableSelection();
void init( int row, int col );
void expandTo( int row, int col );
bool operator==( const QTableSelection &s ) const;
bool operator!=( const QTableSelection &s ) const { return !(operator==(s)); }
int topRow() const { return tRow; }
int bottomRow() const { return bRow; }
int leftCol() const { return lCol; }
int rightCol() const { return rCol; }
int anchorRow() const { return aRow; }
int anchorCol() const { return aCol; }
bool isActive() const { return active; }
private:
uint active : 1;
uint inited : 1;
int tRow, lCol, bRow, rCol;
int aRow, aCol;
};
class Q_EXPORT QTableItem : public Qt
{
friend class QTable;
public:
enum EditType { Never, OnTyping, WhenCurrent, Always };
QTableItem( QTable *table, EditType et, const QString &text );
QTableItem( QTable *table, EditType et, const QString &text,
const QPixmap &p );
virtual ~QTableItem();
virtual QPixmap pixmap() const;
virtual QString text() const;
virtual void setPixmap( const QPixmap &p );
virtual void setText( const QString &t );
QTable *table() const { return t; }
virtual int alignment() const;
virtual void setWordWrap( bool b );
bool wordWrap() const;
EditType editType() const;
virtual QWidget *createEditor() const;
virtual void setContentFromEditor( QWidget *w );
virtual void setReplaceable( bool );
bool isReplaceable() const;
virtual QString key() const;
virtual QSize sizeHint() const;
virtual void setSpan( int rs, int cs );
int rowSpan() const;
int colSpan() const;
virtual void setRow( int r );
virtual void setCol( int c );
int row() const;
int col() const;
virtual void paint( QPainter *p, const QColorGroup &cg,
const QRect &cr, bool selected );
void updateEditor( int oldRow, int oldCol );
virtual void setEnabled( bool b );
bool isEnabled() const;
virtual int rtti() const;
static int RTTI;
private:
QString txt;
QPixmap pix;
QTable *t;
EditType edType;
uint wordwrap : 1;
uint tcha : 1;
uint enabled : 1;
int rw, cl;
int rowspan, colspan;
};
class Q_EXPORT QComboTableItem : public QTableItem
{
public:
QComboTableItem( QTable *table, const QStringList &list, bool editable = FALSE );
virtual QWidget *createEditor() const;
virtual void setContentFromEditor( QWidget *w );
virtual void paint( QPainter *p, const QColorGroup &cg,
const QRect &cr, bool selected );
virtual void setCurrentItem( int i );
virtual void setCurrentItem( const QString &i );
int currentItem() const;
QString currentText() const;
int count() const;
QString text( int i ) const;
virtual void setEditable( bool b );
bool isEditable() const;
virtual void setStringList( const QStringList &l );
int rtti() const;
static int RTTI;
private:
QComboBox *cb;
QStringList entries;
int current;
bool edit;
static QComboBox *fakeCombo;
};
class Q_EXPORT QCheckTableItem : public QTableItem
{
public:
QCheckTableItem( QTable *table, const QString &txt );
virtual QWidget *createEditor() const;
virtual void setContentFromEditor( QWidget *w );
virtual void paint( QPainter *p, const QColorGroup &cg,
const QRect &cr, bool selected );
virtual void setChecked( bool b );
bool isChecked() const;
int rtti() const;
static int RTTI;
private:
QCheckBox *cb;
bool checked;
};
#if defined(Q_TEMPLATEDLL)
// MOC_SKIP_BEGIN
Q_TEMPLATE_EXTERN template class Q_EXPORT QPtrVector<QTableItem>;
Q_TEMPLATE_EXTERN template class Q_EXPORT QPtrVector<QWidget>;
Q_TEMPLATE_EXTERN template class Q_EXPORT QPtrList<QTableSelection>;
Q_TEMPLATE_EXTERN template class Q_EXPORT QIntDict<int>;
// MOC_SKIP_END
#endif
class Q_EXPORT QTable : public QScrollView
{
Q_OBJECT
Q_ENUMS( SelectionMode FocusStyle )
Q_PROPERTY( int numRows READ numRows WRITE setNumRows )
Q_PROPERTY( int numCols READ numCols WRITE setNumCols )
Q_PROPERTY( bool showGrid READ showGrid WRITE setShowGrid )
Q_PROPERTY( bool rowMovingEnabled READ rowMovingEnabled WRITE setRowMovingEnabled )
Q_PROPERTY( bool columnMovingEnabled READ columnMovingEnabled WRITE setColumnMovingEnabled )
Q_PROPERTY( bool readOnly READ isReadOnly WRITE setReadOnly )
Q_PROPERTY( bool sorting READ sorting WRITE setSorting )
Q_PROPERTY( SelectionMode selectionMode READ selectionMode WRITE setSelectionMode )
Q_PROPERTY( FocusStyle focusStyle READ focusStyle WRITE setFocusStyle )
friend class QTableHeader;
friend class QComboTableItem;
friend class QCheckTableItem;
friend class QTableItem;
public:
QTable( QWidget* parent=0, const char* name=0 );
QTable( int numRows, int numCols,
QWidget* parent=0, const char* name=0 );
~QTable();
QHeader *horizontalHeader() const;
QHeader *verticalHeader() const;
enum SelectionMode { Single, Multi, SingleRow, MultiRow, NoSelection };
virtual void setSelectionMode( SelectionMode mode );
SelectionMode selectionMode() const;
virtual void setItem( int row, int col, QTableItem *item );
virtual void setText( int row, int col, const QString &text );
virtual void setPixmap( int row, int col, const QPixmap &pix );
virtual QTableItem *item( int row, int col ) const;
virtual QString text( int row, int col ) const;
virtual QPixmap pixmap( int row, int col ) const;
virtual void clearCell( int row, int col );
virtual QRect cellGeometry( int row, int col ) const;
virtual int columnWidth( int col ) const;
virtual int rowHeight( int row ) const;
virtual int columnPos( int col ) const;
virtual int rowPos( int row ) const;
virtual int columnAt( int x ) const;
virtual int rowAt( int y ) const;
virtual int numRows() const;
virtual int numCols() const;
void updateCell( int row, int col );
bool eventFilter( QObject * o, QEvent * );
int currentRow() const { return curRow; }
int currentColumn() const { return curCol; }
void ensureCellVisible( int row, int col );
bool isSelected( int row, int col ) const;
bool isRowSelected( int row, bool full = FALSE ) const;
bool isColumnSelected( int col, bool full = FALSE ) const;
int numSelections() const;
QTableSelection selection( int num ) const;
virtual int addSelection( const QTableSelection &s );
virtual void removeSelection( const QTableSelection &s );
virtual void removeSelection( int num );
virtual int currentSelection() const;
bool showGrid() const;
bool columnMovingEnabled() const;
bool rowMovingEnabled() const;
virtual void sortColumn( int col, bool ascending = TRUE,
bool wholeRows = FALSE );
bool sorting() const;
virtual void takeItem( QTableItem *i );
virtual void setCellWidget( int row, int col, QWidget *e );
virtual QWidget *cellWidget( int row, int col ) const;
virtual void clearCellWidget( int row, int col );
virtual QRect cellRect( int row, int col ) const;
virtual void paintCell( QPainter *p, int row, int col,
const QRect &cr, bool selected );
virtual void paintCell( QPainter *p, int row, int col,
const QRect &cr, bool selected, const QColorGroup &cg );
virtual void paintFocus( QPainter *p, const QRect &r );
QSize sizeHint() const;
bool isReadOnly() const;
bool isRowReadOnly( int row ) const;
bool isColumnReadOnly( int col ) const;
void setEnabled( bool b );
void repaintSelections();
enum FocusStyle { FollowStyle, SpreadSheet };
virtual void setFocusStyle( FocusStyle fs );
FocusStyle focusStyle() const;
public slots:
virtual void setNumRows( int r );
virtual void setNumCols( int r );
virtual void setShowGrid( bool b );
virtual void hideRow( int row );
virtual void hideColumn( int col );
virtual void showRow( int row );
virtual void showColumn( int col );
virtual void setColumnWidth( int col, int w );
virtual void setRowHeight( int row, int h );
virtual void adjustColumn( int col );
virtual void adjustRow( int row );
virtual void setColumnStretchable( int col, bool stretch );
virtual void setRowStretchable( int row, bool stretch );
bool isColumnStretchable( int col ) const;
bool isRowStretchable( int row ) const;
virtual void setSorting( bool b );
virtual void swapRows( int row1, int row2, bool swapHeader = FALSE );
virtual void swapColumns( int col1, int col2, bool swapHeader = FALSE );
virtual void swapCells( int row1, int col1, int row2, int col2 );
virtual void setLeftMargin( int m );
virtual void setTopMargin( int m );
virtual void setCurrentCell( int row, int col );
void clearSelection( bool repaint = TRUE );
virtual void setColumnMovingEnabled( bool b );
virtual void setRowMovingEnabled( bool b );
virtual void setReadOnly( bool b );
virtual void setRowReadOnly( int row, bool ro );
virtual void setColumnReadOnly( int col, bool ro );
virtual void setDragEnabled( bool b );
bool dragEnabled() const;
virtual void insertRows( int row, int count = 1 );
virtual void insertColumns( int col, int count = 1 );
virtual void removeRow( int row );
virtual void removeRows( const QMemArray<int> &rows );
virtual void removeColumn( int col );
virtual void removeColumns( const QMemArray<int> &cols );
virtual void editCell( int row, int col, bool replace = FALSE );
protected:
enum EditMode { NotEditing, Editing, Replacing };
void drawContents( QPainter *p, int cx, int cy, int cw, int ch );
void contentsMousePressEvent( QMouseEvent* );
void contentsMouseMoveEvent( QMouseEvent* );
void contentsMouseDoubleClickEvent( QMouseEvent* );
void contentsMouseReleaseEvent( QMouseEvent* );
void contentsContextMenuEvent( QContextMenuEvent * e );
void keyPressEvent( QKeyEvent* );
void focusInEvent( QFocusEvent* );
void focusOutEvent( QFocusEvent* );
void viewportResizeEvent( QResizeEvent * );
void showEvent( QShowEvent *e );
void setEditMode( EditMode mode, int row, int col );
#ifndef QT_NO_DRAGANDDROP
virtual void contentsDragEnterEvent( QDragEnterEvent *e );
virtual void contentsDragMoveEvent( QDragMoveEvent *e );
virtual void contentsDragLeaveEvent( QDragLeaveEvent *e );
virtual void contentsDropEvent( QDropEvent *e );
virtual QDragObject *dragObject();
virtual void startDrag();
#endif
virtual void paintEmptyArea( QPainter *p, int cx, int cy, int cw, int ch );
virtual void activateNextCell();
virtual QWidget *createEditor( int row, int col, bool initFromCell ) const;
virtual void setCellContentFromEditor( int row, int col );
virtual QWidget *beginEdit( int row, int col, bool replace );
virtual void endEdit( int row, int col, bool accept, bool replace );
virtual void resizeData( int len );
virtual void insertWidget( int row, int col, QWidget *w );
int indexOf( int row, int col ) const;
void windowActivationChange( bool );
bool isEditing() const;
EditMode editMode() const;
int currEditRow() const;
int currEditCol() const;
protected slots:
virtual void columnWidthChanged( int col );
virtual void rowHeightChanged( int row );
virtual void columnIndexChanged( int section, int fromIndex, int toIndex );
virtual void rowIndexChanged( int section, int fromIndex, int toIndex );
virtual void columnClicked( int col );
signals:
void currentChanged( int row, int col );
void clicked( int row, int col, int button, const QPoint &mousePos );
void doubleClicked( int row, int col, int button, const QPoint &mousePos );
void pressed( int row, int col, int button, const QPoint &mousePos );
void selectionChanged();
void valueChanged( int row, int col );
void contextMenuRequested( int row, int col, const QPoint &pos );
#ifndef QT_NO_DRAGANDDROP
void dropped( QDropEvent *e );
#endif
private slots:
void doAutoScroll();
void doValueChanged();
void updateGeometriesSlot();
private:
void contentsMousePressEventEx( QMouseEvent* );
void drawContents( QPainter* );
void updateGeometries();
void repaintSelections( QTableSelection *oldSelection,
QTableSelection *newSelection,
bool updateVertical = TRUE,
bool updateHorizontal = TRUE );
QRect rangeGeometry( int topRow, int leftCol,
int bottomRow, int rightCol, bool &optimize );
void fixRow( int &row, int y );
void fixCol( int &col, int x );
void init( int numRows, int numCols );
QSize tableSize() const;
void repaintCell( int row, int col );
void contentsToViewport2( int x, int y, int& vx, int& vy );
QPoint contentsToViewport2( const QPoint &p );
void viewportToContents2( int vx, int vy, int& x, int& y );
QPoint viewportToContents2( const QPoint &p );
void updateRowWidgets( int row );
void updateColWidgets( int col );
bool isSelected( int row, int col, bool includeCurrent ) const;
void setCurrentCell( int row, int col, bool updateSelections );
void fixCell( int &row, int &col, int key );
void delayedUpdateGeometries();
struct TableWidget
{
TableWidget( QWidget *w, int r, int c ) : wid( w ), row( r ), col ( c ) {}
QWidget *wid;
int row, col;
};
void saveContents( QPtrVector<QTableItem> &tmp,
QPtrVector<TableWidget> &tmp2 );
void updateHeaderAndResizeContents( QTableHeader *header,
int num, int colRow,
int width, bool &updateBefore );
void restoreContents( QPtrVector<QTableItem> &tmp,
QPtrVector<TableWidget> &tmp2 );
void finishContentsResze( bool updateBefore );
private:
QPtrVector<QTableItem> contents;
QPtrVector<QWidget> widgets;
int curRow;
int curCol;
QTableHeader *leftHeader, *topHeader;
EditMode edMode;
int editCol, editRow;
QPtrList<QTableSelection> selections;
QTableSelection *currentSel;
QTimer *autoScrollTimer;
int lastSortCol;
bool sGrid : 1;
bool mRows : 1;
bool mCols : 1;
bool asc : 1;
bool doSort : 1;
bool mousePressed : 1;
bool readOnly : 1;
bool shouldClearSelection : 1;
bool dEnabled : 1;
bool context_menu : 1;
bool drawActiveSelection : 1;
bool was_visible : 1;
SelectionMode selMode;
int pressedRow, pressedCol;
QTablePrivate *d;
QIntDict<int> roRows;
QIntDict<int> roCols;
int startDragRow;
int startDragCol;
QPoint dragStartPos;
int oldCurrentRow, oldCurrentCol;
QWidget *topLeftCorner;
FocusStyle focusStl;
QSize cachedSizeHint;
};
#endif // QT_NO_TABLE
#endif // TABLE_H
| Copyright © 2002 Trolltech | Trademarks | 译者:farfareast | Qt 3.0.5版
|