Add Qt3 development HEAD version

author: Timothy Pearson <[email protected]> 2011-07-10 15:24:15 -0500
committer: Timothy Pearson <[email protected]> 2011-07-10 15:24:15 -0500
commit: bd0f3345a938b35ce6a12f6150373b0955b8dd12 (patch)
tree: 7a520322212d48ebcb9fbe1087e7fca28b76185c /doc/html/qlistbox-h.html
download: qt3-bd0f3345a938b35ce6a12f6150373b0955b8dd12.tar.gz
qt3-bd0f3345a938b35ce6a12f6150373b0955b8dd12.zip
1 files changed, 480 insertions, 0 deletions
diff --git a/doc/html/qlistbox-h.html b/doc/html/qlistbox-h.html
new file mode 100644
index 0000000..1b347c6
--- /dev/null
+++ b/doc/html/qlistbox-h.html
@@ -0,0 +1,480 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qlistbox.h:1 -->
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>qlistbox.h Include File</title>
+<style type="text/css"><!--
+fn { margin-left: 1cm; text-indent: -1cm; }
+a:link { color: #004faf; text-decoration: none }
+a:visited { color: #672967; text-decoration: none }
+body { background: #ffffff; color: black; }
+--></style>
+</head>
+<body>
+
+<table border="0" cellpadding="0" cellspacing="0" width="100%">
+<tr bgcolor="#E5E5E5">
+<td valign=center>
+ <a href="index.html">
+<font color="#004faf">Home</font></a>
+ | <a href="classes.html">
+<font color="#004faf">All&nbsp;Classes</font></a>
+ | <a href="mainclasses.html">
+<font color="#004faf">Main&nbsp;Classes</font></a>
+ | <a href="annotated.html">
+<font color="#004faf">Annotated</font></a>
+ | <a href="groups.html">
+<font color="#004faf">Grouped&nbsp;Classes</font></a>
+ | <a href="functions.html">
+<font color="#004faf">Functions</font></a>
+</td>
+<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>qlistbox.h</h1>
+
+<p>This is the verbatim text of the qlistbox.h include file. It is provided only for illustration; the copyright remains with Trolltech.
+<hr>
+<pre>
+/**********************************************************************
+** $Id: qt/qlistbox.h   3.3.8   edited Jan 11 14:38 $
+**
+** Definition of QListBox widget class
+**
+** Created : 941121
+**
+** Copyright (C) 1992-2007 Trolltech ASA.  All rights reserved.
+**
+** This file is part of the widgets module of the Qt GUI Toolkit.
+**
+** This file may be used under the terms of the GNU General Public
+** License versions 2.0 or 3.0 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file. Alternatively you may (at your option) use any
+** later version of the GNU General Public License if such license has
+** been publicly approved by Trolltech ASA (or its successors, if any)
+** and the KDE Free Qt Foundation.
+**
+** Please review the following information to ensure GNU General
+** Public Licensing requirements will be met:
+** http://trolltech.com/products/qt/licenses/licensing/opensource/.
+** If you are unsure which license is appropriate for your use, please
+** review the following information:
+** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
+** or contact the sales department at [email protected].
+**
+** This file may be used under the terms of the Q Public License as
+** defined by Trolltech ASA and appearing in the file LICENSE.QPL
+** included in the packaging of this file.  Licensees holding valid Qt
+** Commercial 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 WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
+** herein.
+**
+**********************************************************************/
+
+#ifndef QLISTBOX_H
+#define QLISTBOX_H
+
+#ifndef QT_H
+#include "qscrollview.h"
+#include "qpixmap.h"
+#endif // QT_H
+
+#ifndef QT_NO_LISTBOX
+
+
+class QListBoxPrivate;
+class QListBoxItem;
+class QString;
+class QStrList;
+class QStringList;
+
+
+class Q_EXPORT QListBox : public QScrollView
+{
+    friend class QListBoxItem;
+    friend class QListBoxPrivate;
+
+    Q_OBJECT
+    Q_ENUMS( SelectionMode LayoutMode )
+    Q_PROPERTY( uint count READ count )
+    Q_PROPERTY( int numItemsVisible READ numItemsVisible )
+    Q_PROPERTY( int currentItem READ currentItem WRITE setCurrentItem )
+    Q_PROPERTY( QString currentText READ currentText )
+    Q_PROPERTY( int topItem READ topItem WRITE setTopItem DESIGNABLE false )
+    Q_PROPERTY( SelectionMode selectionMode READ selectionMode WRITE setSelectionMode )
+    Q_PROPERTY( bool multiSelection READ isMultiSelection WRITE setMultiSelection DESIGNABLE false )
+    Q_PROPERTY( LayoutMode columnMode READ columnMode WRITE setColumnMode )
+    Q_PROPERTY( LayoutMode rowMode READ rowMode WRITE setRowMode )
+    Q_PROPERTY( int numColumns READ numColumns )
+    Q_PROPERTY( int numRows READ numRows )
+    Q_PROPERTY( bool variableWidth READ variableWidth WRITE setVariableWidth )
+    Q_PROPERTY( bool variableHeight READ variableHeight WRITE setVariableHeight )
+
+public:
+    QListBox( QWidget* parent=0, const char* name=0, WFlags f=0  );
+    ~QListBox();
+
+    virtual void setFont( const QFont &amp; );
+
+    uint count() const;
+
+    void insertStringList( const QStringList&amp;, int index=-1 );
+    void insertStrList( const QStrList *, int index=-1 );
+    void insertStrList( const QStrList &amp;, int index=-1 );
+    void insertStrList( const char **,
+			int numStrings=-1, int index=-1 );
+
+    void insertItem( const QListBoxItem *, int index=-1 );
+    void insertItem( const QListBoxItem *, const QListBoxItem *after );
+    void insertItem( const QString &amp;text, int index=-1 );
+    void insertItem( const QPixmap &amp;pixmap, int index=-1 );
+    void insertItem( const QPixmap &amp;pixmap, const QString &amp;text, int index=-1 );
+
+    void removeItem( int index );
+
+    QString text( int index )	const;
+    const QPixmap *pixmap( int index )	const;
+
+    void changeItem( const QListBoxItem *, int index );
+    void changeItem( const QString &amp;text, int index );
+    void changeItem( const QPixmap &amp;pixmap, int index );
+    void changeItem( const QPixmap &amp;pixmap, const QString &amp;text, int index );
+
+    void takeItem( const QListBoxItem * );
+
+    int numItemsVisible() const;
+
+    int currentItem() const;
+    QString currentText() const { return text(currentItem()); }
+    virtual void setCurrentItem( int index );
+    virtual void setCurrentItem( QListBoxItem * );
+    void centerCurrentItem() { ensureCurrentVisible(); }
+    int topItem() const;
+    virtual void setTopItem( int index );
+    virtual void setBottomItem( int index );
+
+    long maxItemWidth() const;
+
+    enum SelectionMode { Single, Multi, Extended, NoSelection };
+    virtual void setSelectionMode( SelectionMode );
+    SelectionMode selectionMode() const;
+
+    void setMultiSelection( bool multi );
+    bool isMultiSelection() const;
+
+    virtual void setSelected( QListBoxItem *, bool );
+    void setSelected( int, bool );
+    bool isSelected( int ) const;
+    bool isSelected( const QListBoxItem * ) const;
+    QListBoxItem* selectedItem() const;
+
+    QSize sizeHint() const;
+    QSize	minimumSizeHint() const;
+
+    QListBoxItem *item( int index ) const;
+    int index( const QListBoxItem * ) const;
+    QListBoxItem *findItem( const QString &amp;text, ComparisonFlags compare = BeginsWith ) const;
+
+    void triggerUpdate( bool doLayout );
+
+    bool itemVisible( int index );
+    bool itemVisible( const QListBoxItem * );
+
+    enum LayoutMode { FixedNumber,
+		      FitToWidth, FitToHeight = FitToWidth,
+		      Variable };
+    virtual void setColumnMode( LayoutMode );
+    virtual void setColumnMode( int );
+    virtual void setRowMode( LayoutMode );
+    virtual void setRowMode( int );
+
+    LayoutMode columnMode() const;
+    LayoutMode rowMode() const;
+
+    int numColumns() const;
+    int numRows() const;
+
+    bool variableWidth() const;
+    virtual void setVariableWidth( bool );
+
+    bool variableHeight() const;
+    virtual void setVariableHeight( bool );
+
+    void viewportPaintEvent( QPaintEvent * );
+
+#ifndef QT_NO_COMPAT
+    bool dragSelect() const { return TRUE; }
+    void setDragSelect( bool ) {}
+    bool autoScroll() const { return TRUE; }
+    void setAutoScroll( bool ) {}
+    bool autoScrollBar() const { return vScrollBarMode() == Auto; }
+    void setAutoScrollBar( bool enable ) { setVScrollBarMode( enable ? Auto : AlwaysOff ); }
+    bool scrollBar() const { return vScrollBarMode() != AlwaysOff; }
+    void setScrollBar( bool enable ) { setVScrollBarMode( enable ? AlwaysOn : AlwaysOff ); }
+    bool autoBottomScrollBar() const { return hScrollBarMode() == Auto; }
+    void setAutoBottomScrollBar( bool enable ) { setHScrollBarMode( enable ? Auto : AlwaysOff ); }
+    bool bottomScrollBar() const { return hScrollBarMode() != AlwaysOff; }
+    void setBottomScrollBar( bool enable ) { setHScrollBarMode( enable ? AlwaysOn : AlwaysOff ); }
+    bool smoothScrolling() const { return FALSE; }
+    void setSmoothScrolling( bool ) {}
+    bool autoUpdate() const { return TRUE; }
+    void setAutoUpdate( bool ) {}
+    void setFixedVisibleLines( int lines ) { setRowMode( lines ); }
+    int inSort( const QListBoxItem * );
+    int inSort( const QString&amp; text );
+    int cellHeight( int i ) const { return itemHeight(i); }
+    int cellHeight() const { return itemHeight(); }
+    int cellWidth() const { return maxItemWidth(); }
+    int cellWidth(int i) const { Q_ASSERT(i==0); Q_UNUSED(i) return maxItemWidth(); }
+    int	numCols() const { return numColumns(); }
+#endif
+
+    int itemHeight( int index = 0 ) const;
+    QListBoxItem * itemAt( const QPoint &amp; ) const;
+
+    QRect itemRect( QListBoxItem *item ) const;
+
+    QListBoxItem *firstItem() const;
+
+    void sort( bool ascending = TRUE );
+
+public slots:
+    void clear();
+    virtual void ensureCurrentVisible();
+    virtual void clearSelection();
+    virtual void selectAll( bool select );
+    virtual void invertSelection();
+
+signals:
+    void highlighted( int index );
+    void selected( int index );
+    void highlighted( const QString &amp;);
+    void selected( const QString &amp;);
+    void highlighted( QListBoxItem * );
+    void selected( QListBoxItem * );
+
+    void selectionChanged();
+    void selectionChanged( QListBoxItem * );
+    void currentChanged( QListBoxItem * );
+    void clicked( QListBoxItem * );
+    void clicked( QListBoxItem *, const QPoint &amp; );
+    void pressed( QListBoxItem * );
+    void pressed( QListBoxItem *, const QPoint &amp; );
+
+    void doubleClicked( QListBoxItem * );
+    void returnPressed( QListBoxItem * );
+    void rightButtonClicked( QListBoxItem *, const QPoint &amp; );
+    void rightButtonPressed( QListBoxItem *, const QPoint &amp; );
+    void mouseButtonPressed( int, QListBoxItem*, const QPoint&amp; );
+    void mouseButtonClicked( int, QListBoxItem*, const QPoint&amp; );
+
+    void contextMenuRequested( QListBoxItem *, const QPoint &amp; );
+
+    void onItem( QListBoxItem *item );
+    void onViewport();
+
+protected:
+    void mousePressEvent( QMouseEvent * );
+    void mouseReleaseEvent( QMouseEvent * );
+    void mouseDoubleClickEvent( QMouseEvent * );
+    void mouseMoveEvent( QMouseEvent * );
+    void contentsContextMenuEvent( QContextMenuEvent * );
+
+    void keyPressEvent( QKeyEvent *e );
+    void focusInEvent( QFocusEvent *e );
+    void focusOutEvent( QFocusEvent *e );
+    void resizeEvent( QResizeEvent * );
+    void showEvent( QShowEvent * );
+
+    bool eventFilter( QObject *o, QEvent *e );
+
+    void updateItem( int index );
+    void updateItem( QListBoxItem * );
+
+#ifndef QT_NO_COMPAT
+    void updateCellWidth() { }
+    int totalWidth() const { return contentsWidth(); }
+    int totalHeight() const { return contentsHeight(); }
+#endif
+
+    virtual void paintCell( QPainter *, int row, int col );
+
+    void toggleCurrentItem();
+    bool isRubberSelecting() const;
+
+    void doLayout() const;
+
+    void windowActivationChange( bool );
+
+#ifndef QT_NO_COMPAT
+    bool itemYPos( int index, int *yPos ) const;
+    int findItem( int yPos ) const { return index(itemAt(QPoint(0,yPos)) ); }
+#endif
+
+protected slots:
+    void clearInputString();
+
+private slots:
+    void refreshSlot();
+    void doAutoScroll();
+    void adjustItems();
+
+private:
+    void mousePressEventEx( QMouseEvent * );
+    void tryGeometry( int, int ) const;
+    int currentRow() const;
+    int currentColumn() const;
+    void updateSelection();
+    void repaintSelection();
+    void drawRubber();
+    void doRubberSelection( const QRect &amp;old, const QRect &amp;rubber );
+    void handleItemChange( QListBoxItem *old, bool shift, bool control );
+    void selectRange( QListBoxItem *from, QListBoxItem *to, bool invert, bool includeFirst, bool clearSel = FALSE );
+
+    void emitChangedSignal( bool );
+
+    int columnAt( int ) const;
+    int rowAt( int ) const;
+
+    QListBoxPrivate * d;
+
+    static QListBox * changedListBox;
+
+private:	// Disabled copy constructor and operator=
+#if defined(Q_DISABLE_COPY)
+    QListBox( const QListBox &amp; );
+    QListBox &amp;operator=( const QListBox &amp; );
+#endif
+};
+
+
+class Q_EXPORT QListBoxItem
+{
+public:
+    QListBoxItem( QListBox* listbox = 0 );
+    QListBoxItem( QListBox* listbox, QListBoxItem *after );
+    virtual ~QListBoxItem();
+
+    virtual QString text() const;
+    virtual const QPixmap *pixmap() const;
+
+    virtual int	 height( const QListBox * ) const;
+    virtual int	 width( const QListBox * )  const;
+
+    bool isSelected() const { return s; }
+    bool isCurrent() const;
+
+#ifndef QT_NO_COMPAT
+    bool selected() const { return isSelected(); }
+    bool current() const { return isCurrent(); }
+#endif
+
+    QListBox *listBox() const;
+
+    void setSelectable( bool b );
+    bool isSelectable() const;
+
+    QListBoxItem *next() const;
+    QListBoxItem *prev() const;
+
+    virtual int rtti() const;
+    static int RTTI;
+
+protected:
+    virtual void paint( QPainter * ) = 0;
+    virtual void setText( const QString &amp;text ) { txt = text; }
+    void setCustomHighlighting( bool );
+
+private:
+    QString txt;
+    uint s:1;
+    uint dirty:1;
+    uint custom_highlight : 1;
+    int x, y;
+    QListBoxItem * p, * n;
+    QListBox* lbox;
+    friend class QListBox;
+    friend class QListBoxPrivate;
+    friend class QComboBox;
+    friend class QComboBoxPopupItem;
+
+private:	// Disabled copy constructor and operator=
+#if defined(Q_DISABLE_COPY)
+    QListBoxItem( const QListBoxItem &amp; );
+    QListBoxItem &amp;operator=( const QListBoxItem &amp; );
+#endif
+};
+
+
+class Q_EXPORT QListBoxText : public QListBoxItem
+{
+public:
+    QListBoxText( QListBox* listbox, const QString &amp; text=QString::null );
+    QListBoxText( const QString &amp; text=QString::null );
+    QListBoxText( QListBox* listbox, const QString &amp; text, QListBoxItem *after );
+   ~QListBoxText();
+
+    int	 height( const QListBox * ) const;
+    int	 width( const QListBox * )  const;
+
+    int rtti() const;
+    static int RTTI;
+
+protected:
+    void  paint( QPainter * );
+
+private:	// Disabled copy constructor and operator=
+#if defined(Q_DISABLE_COPY)
+    QListBoxText( const QListBoxText &amp; );
+    QListBoxText &amp;operator=( const QListBoxText &amp; );
+#endif
+};
+
+
+class Q_EXPORT QListBoxPixmap : public QListBoxItem
+{
+public:
+    QListBoxPixmap( QListBox* listbox, const QPixmap &amp; );
+    QListBoxPixmap( const QPixmap &amp; );
+    QListBoxPixmap( QListBox* listbox, const QPixmap &amp; pix, QListBoxItem *after );
+    QListBoxPixmap( QListBox* listbox, const QPixmap &amp;, const QString&amp; );
+    QListBoxPixmap( const QPixmap &amp;, const QString&amp; );
+    QListBoxPixmap( QListBox* listbox, const QPixmap &amp; pix, const QString&amp;, QListBoxItem *after );
+   ~QListBoxPixmap();
+
+    const QPixmap *pixmap() const { return &amp;pm; }
+
+    int	 height( const QListBox * ) const;
+    int	 width( const QListBox * )  const;
+
+    int rtti() const;
+    static int RTTI;
+
+protected:
+    void paint( QPainter * );
+
+private:
+    QPixmap pm;
+private:	// Disabled copy constructor and operator=
+#if defined(Q_DISABLE_COPY)
+    QListBoxPixmap( const QListBoxPixmap &amp; );
+    QListBoxPixmap &amp;operator=( const QListBoxPixmap &amp; );
+#endif
+};
+
+
+#endif // QT_NO_LISTBOX
+
+#endif // QLISTBOX_H
+</pre>
+<!-- eof -->
+<p><address><hr><div align=center>
+<table width=100% cellspacing=0 border=0><tr>
+<td>Copyright &copy; 2007
+<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
+<td align=right><div align=right>Qt 3.3.8</div>
+</table></div></address></body>
+</html>
author	Timothy Pearson <[email protected]>	2011-07-10 15:24:15 -0500
committer	Timothy Pearson <[email protected]>	2011-07-10 15:24:15 -0500
commit	bd0f3345a938b35ce6a12f6150373b0955b8dd12 (patch)
tree	7a520322212d48ebcb9fbe1087e7fca28b76185c /doc/html/qlistbox-h.html
download	qt3-bd0f3345a938b35ce6a12f6150373b0955b8dd12.tar.gz qt3-bd0f3345a938b35ce6a12f6150373b0955b8dd12.zip