Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions

qspinbox.h

This is the verbatim text of the qspinbox.h include file. It is provided only for illustration; the copyright remains with Trolltech.

/****************************************************************************
** $Id: qt/qspinbox.h   3.3.8   edited Jan 11 14:38 $
**
** Definition of TQSpinBox widget class
**
** Created : 970101
**
** Copyright (C) 1992-2007 Trolltech ASA.  All rights reserved.
**
** This file is part of the widgets module of the TQt 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 TQt Foundation.
**
** Please review the following information to ensure GNU General
** Public Licensing retquirements 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 sales@trolltech.com.
**
** This file may be used under the terms of the Q Public License as
** defined by Trolltech ASA and appearing in the file LICENSE.TQPL
** included in the packaging of this file.  Licensees holding valid TQt
** Commercial licenses may use this file in accordance with the TQt
** 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 TQSPINBOX_H
#define TQSPINBOX_H

#ifndef QT_H
#include "qwidget.h"
#include "qrangecontrol.h"
#endif // QT_H

#ifndef QT_NO_SPINBOX

class TQLineEdit;
class TQValidator;
class TQSpinBoxPrivate;

class Q_EXPORT TQSpinBox: public TQWidget, public TQRangeControl
{
    Q_OBJECT
    Q_ENUMS( ButtonSymbols )
    Q_PROPERTY( TQString text READ text )
    Q_PROPERTY( TQString prefix READ prefix WRITE setPrefix )
    Q_PROPERTY( TQString suffix READ suffix WRITE setSuffix )
    Q_PROPERTY( TQString cleanText READ cleanText )
    Q_PROPERTY( TQString specialValueText READ specialValueText WRITE setSpecialValueText )
    Q_PROPERTY( bool wrapping READ wrapping WRITE setWrapping )
    Q_PROPERTY( ButtonSymbols buttonSymbols READ buttonSymbols WRITE setButtonSymbols )
    Q_PROPERTY( int maxValue READ maxValue WRITE setMaxValue )
    Q_PROPERTY( int minValue READ minValue WRITE setMinValue )
    Q_PROPERTY( int lineStep READ lineStep WRITE setLineStep )
    Q_PROPERTY( int value READ value WRITE setValue )

public:
    TQSpinBox( TQWidget* parent=0, const char* name=0 );
    TQSpinBox( int minValue, int maxValue, int step = 1,
	      TQWidget* parent=0, const char* name=0 );
    ~TQSpinBox();

    TQString		text() const;

    virtual TQString	prefix() const;
    virtual TQString	suffix() const;
    virtual TQString	cleanText() const;

    virtual void	setSpecialValueText( const TQString &text );
    TQString		specialValueText() const;

    virtual void	setWrapping( bool on );
    bool		wrapping() const;

    enum ButtonSymbols { UpDownArrows, PlusMinus };
    virtual void	setButtonSymbols( ButtonSymbols );
    ButtonSymbols	buttonSymbols() const;

    virtual void	setValidator( const TQValidator* v );
    const TQValidator * validator() const;

    TQSize		sizeHint() const;
    TQSize		minimumSizeHint() const;

    int	 minValue() const;
    int	 maxValue() const;
    void setMinValue( int );
    void setMaxValue( int );
    int	 lineStep() const;
    void setLineStep( int );
    int  value() const;

    TQRect		upRect() const;
    TQRect		downRect() const;

public slots:
    virtual void	setValue( int value );
    virtual void	setPrefix( const TQString &text );
    virtual void	setSuffix( const TQString &text );
    virtual void	stepUp();
    virtual void	stepDown();
    virtual void 	setEnabled( bool enabled );
    virtual void 	selectAll();

signals:
    void		valueChanged( int value );
    void		valueChanged( const TQString &valueText );

protected:
    virtual TQString	mapValueToText( int value );
    virtual int		mapTextToValue( bool* ok );
    TQString		currentValueText();

    virtual void	updateDisplay();
    virtual void	interpretText();

    TQLineEdit*		editor() const;

    virtual void	valueChange();
    virtual void	rangeChange();

    bool		eventFilter( TQObject* obj, TQEvent* ev );
    void		resizeEvent( TQResizeEvent* ev );
#ifndef QT_NO_WHEELEVENT
    void		wheelEvent( TQWheelEvent * );
#endif
    void		leaveEvent( TQEvent* );

    void		styleChange( TQStyle& );

protected slots:
    void		textChanged();

private:
    void initSpinBox();
    TQSpinBoxPrivate* d;
    TQLineEdit* vi;
    TQValidator* validate;
    TQString pfix;
    TQString sfix;
    TQString specText;

    uint wrap		: 1;
    uint edited		: 1;

    void arrangeWidgets();

private:	// Disabled copy constructor and operator=
#if defined(Q_DISABLE_COPY)
    TQSpinBox( const TQSpinBox& );
    TQSpinBox& operator=( const TQSpinBox& );
#endif

};

#endif // QT_NO_SPINBOX

#endif // TQSPINBOX_H