kruler.h

Go to the documentation of this file.

/* -*- c++ -*- */
/* This file is part of the KDE libraries
    Copyright (C) 1998 Jörg Habenicht (j.habenicht@europemail.com)

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public License
    along with this library; see the file COPYING.LIB.  If not, write to
    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
    Boston, MA 02110-1301, USA.
*/

#ifndef KRULER_H
#define KRULER_H

#include <kdeui_export.h>

#include <QtGui/QAbstractSlider>

class KDEUI_EXPORT KRuler : public QAbstractSlider
{
  Q_OBJECT
  Q_PROPERTY( bool showTinyMarks READ showTinyMarks WRITE setShowTinyMarks )
  Q_PROPERTY( bool showLittleMarks READ showLittleMarks WRITE setShowLittleMarks )
  Q_PROPERTY( bool showMediumMarks READ showMediumMarks WRITE setShowMediumMarks )
  Q_PROPERTY( bool showBigMarks READ showBigMarks WRITE setShowBigMarks )
  Q_PROPERTY( bool showPointer READ showPointer WRITE setShowPointer )
  Q_PROPERTY( bool showEndLabel READ showEndLabel WRITE setShowEndLabel )
  Q_PROPERTY( int tinyMarkDistance READ tinyMarkDistance WRITE setTinyMarkDistance )
  Q_PROPERTY( int littleMarkDistance READ littleMarkDistance WRITE setLittleMarkDistance )
  Q_PROPERTY( int mediumMarkDistance READ mediumMarkDistance WRITE setBigMarkDistance )
  Q_PROPERTY( int bigMarkDistance READ bigMarkDistance WRITE setBigMarkDistance )
  Q_PROPERTY( double pixelPerMark READ pixelPerMark WRITE setPixelPerMark )
  Q_PROPERTY( bool lengthFixed READ lengthFixed WRITE setLengthFixed )
  Q_PROPERTY( QString endLabel READ endLabel WRITE setEndLabel )
  Q_ENUMS( MetricStyle )
  Q_PROPERTY( int length READ length WRITE setLength )
  Q_PROPERTY( int offset READ offset )
  Q_PROPERTY( int endOffset READ endOffset )

public:

/*
#define KRULER_ROTATE_TEST KRULER_ROTATE_TEST
#undef KRULER_ROTATE_TEST
#ifdef KRULER_ROTATE_TEST
  double xtrans, ytrans, rotate;
# warning tmporaer variablen eingeschaltet
#endif
*/

  enum MetricStyle { Custom=0, Pixel, Inch, Millimetres, Centimetres, Metres };

    //  enum PaintStyle { Flat, Raised, Sunken };

  explicit KRuler(QWidget *parent=0);
  explicit KRuler(Qt::Orientation orient, QWidget *parent=0, Qt::WFlags f=0);

  KRuler(Qt::Orientation orient, int widgetWidth, QWidget *parent=0,
     Qt::WFlags f=0);

  ~KRuler();

#ifndef KDE_NO_DEPRECATED
  KDE_DEPRECATED void setMinValue(int);
#endif

#ifndef KDE_NO_DEPRECATED
  KDE_DEPRECATED int minValue() const;
#endif

#ifndef KDE_NO_DEPRECATED
  KDE_DEPRECATED void setMaxValue(int);
#endif

#ifndef KDE_NO_DEPRECATED
  KDE_DEPRECATED int maxValue() const;
#endif


  void setTinyMarkDistance(int);
  int tinyMarkDistance() const;

  void setLittleMarkDistance(int);

  int littleMarkDistance() const;

  void setMediumMarkDistance(int);
  int mediumMarkDistance() const;

  void setBigMarkDistance(int);
  int bigMarkDistance() const;

  void setShowTinyMarks(bool);
  bool showTinyMarks() const;
  void setShowLittleMarks(bool);
  bool showLittleMarks() const;
  void setShowMediumMarks(bool);
  bool showMediumMarks() const;
  void setShowBigMarks(bool);
  bool showBigMarks() const;
  void setShowEndMarks(bool);
  bool showEndMarks() const;
  void setShowPointer(bool);
  bool showPointer() const;


  void setFrameStyle(int);

    //  void setShowLittleMarkLabel(bool);

    //  void setShowMediumMarkLabel(bool);

    //  void showBigMarkLabel(bool);

   void setShowEndLabel(bool);
   bool showEndLabel() const;

  void setEndLabel(const QString&);
  QString endLabel() const;

  void setRulerMetricStyle(KRuler::MetricStyle);

  void setPixelPerMark(double rate);

  double pixelPerMark() const;

  void setLength(int);
  int length() const;

  void setLengthFixed(bool fix);
  bool lengthFixed() const;

  void slideUp(int count = 1);

  void slideDown(int count = 1);

  void setOffset(int offset);

  int offset() const;

  int endOffset() const;

public Q_SLOTS:

  void slotNewValue(int);

  void slotNewOffset(int);

  void slotEndOffset(int);

protected:
  virtual void paintEvent(QPaintEvent *);

private:
  void init(Qt::Orientation orientation);

private:
  class KRulerPrivate;
  KRulerPrivate * const d;
};

#endif