kfontchooser.h

Go to the documentation of this file.

/*
    Requires the Qt widget libraries, available at no cost at
    http://www.troll.no

    Copyright (C) 1997 Bernd Johannes Wuebben <wuebben@kde.org>
    Copyright (c) 1999 Preston Brown <pbrown@kde.org>
    Copyright (c) 1999 Mario Weilguni <mweilguni@kde.org>

    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 K_FONT_CHOOSER_H
#define K_FONT_CHOOSER_H

#include <kdeui_export.h>
#include <QtGui/QWidget>

class QFont;
class QStringList;

class KDEUI_EXPORT KFontChooser : public QWidget
{
  Q_OBJECT
  Q_PROPERTY( QFont font READ font WRITE setFont NOTIFY fontSelected USER true )
  Q_PROPERTY( QColor color READ color WRITE setColor )
  Q_PROPERTY( QColor backgroundColor READ backgroundColor WRITE setBackgroundColor )
  Q_PROPERTY( Qt::CheckState sizeIsRelative READ sizeIsRelative WRITE setSizeIsRelative )
  Q_PROPERTY( QString sampleText READ sampleText WRITE setSampleText )

public:
    enum FontColumn { FamilyList=0x01, StyleList=0x02, SizeList=0x04};

    enum FontDiff { NoFontDiffFlags = 0,
                    FontDiffFamily = 1,
                    FontDiffStyle = 2,
                    FontDiffSize = 4,
                    AllFontDiffs = FontDiffFamily | FontDiffStyle | FontDiffSize };
    Q_DECLARE_FLAGS( FontDiffFlags, FontDiff )

    
    enum DisplayFlag { NoDisplayFlags = 0,
                       FixedFontsOnly = 1,
                       DisplayFrame = 2,
                       ShowDifferences = 4 };
    Q_DECLARE_FLAGS( DisplayFlags, DisplayFlag )

  
  explicit KFontChooser( QWidget *parent = 0L,
                         const DisplayFlags& flags = DisplayFrame,
                         const QStringList &fontList = QStringList(),
                         int visibleListSize = 8,
                         Qt::CheckState *sizeIsRelativeState = 0L );

  virtual ~KFontChooser();

  void enableColumn( int column, bool state );

  void setFont( const QFont &font, bool onlyFixed = false );

  FontDiffFlags fontDiffFlags() const;

  QFont font() const;

  void setColor( const QColor & col );

  QColor color() const;

  void setBackgroundColor( const QColor & col );

  QColor backgroundColor() const;

  void setSizeIsRelative( Qt::CheckState relative );

  Qt::CheckState sizeIsRelative() const;


  QString sampleText() const;

  void setSampleText( const QString &text );

  void setSampleBoxVisible( bool visible );

  enum FontListCriteria { FixedWidthFonts=0x01, ScalableFonts=0x02, SmoothScalableFonts=0x04 };

  static void getFontList( QStringList &list, uint fontListCriteria);

  virtual QSize sizeHint( void ) const;

Q_SIGNALS:
  void fontSelected( const QFont &font );

private:
    class Private;
    Private * const d;

    Q_DISABLE_COPY(KFontChooser)

    Q_PRIVATE_SLOT(d, void _k_toggled_checkbox())
    Q_PRIVATE_SLOT(d, void _k_family_chosen_slot(const QString&))
    Q_PRIVATE_SLOT(d, void _k_size_chosen_slot(const QString&))
    Q_PRIVATE_SLOT(d, void _k_style_chosen_slot(const QString&))
    Q_PRIVATE_SLOT(d, void _k_displaySample(const QFont &font))
    Q_PRIVATE_SLOT(d, void _k_showXLFDArea(bool))
    Q_PRIVATE_SLOT(d, void _k_size_value_slot(double))
};

Q_DECLARE_OPERATORS_FOR_FLAGS( KFontChooser::DisplayFlags )

#endif