kcolordialog.h

/* This file is part of the KDE libraries
    Copyright (C) 1997 Martin Jones (mjones@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.
*/
//----------------------------------------------------------------------
// KDE color selection dialog.
 
// layout management added Oct 1997 by Mario Weilguni
// <mweilguni@sime.com>
 
#ifndef KDELIBS_KCOLORDIALOG_H
#define KDELIBS_KCOLORDIALOG_H
 
#ifdef TQ_WS_QWS
// FIXME(E): Do we need the KColorDialog extra functionality in Qt Embedded?
#include <tqcolordialog.h>
#define KColorDialog QColorDialog
#else //UNIX, WIN32
#include <kdialogbase.h>
#include <tqframe.h>
#include <tqpixmap.h>
#include <tqgridview.h>
 
#include "tdeselect.h"
 
class TQComboBox;
class TQLineEdit;
class TDEListBox;
class KPalette;
class KColorCells;
 
 
class TDEUI_EXPORT KHSSelector : public KXYSelector
{
  TQ_OBJECT
 
public:
  KHSSelector( TQWidget *parent=0, const char *name=0 );
 
protected:
  virtual void drawPalette( TQPixmap *pixmap );
  virtual void resizeEvent( TQResizeEvent * );
 
  virtual void drawContents( TQPainter *painter );
 
private:
  void updateContents();
  TQPixmap pixmap;
 
protected:
  virtual void virtual_hook( int id, void* data );
private:
  class KHSSelectorPrivate;
  KHSSelectorPrivate *d;
};
 
 
class KValueSelectorPrivate;
class TDEUI_EXPORT KValueSelector : public TDESelector
{
  TQ_OBJECT
 
public:
  KValueSelector( TQWidget *parent=0, const char *name=0 );
  KValueSelector( Orientation o, TQWidget *parent = 0, const char *name = 0 );
 
  int hue() const
        { return _hue; }
  void setHue( int h )
        { _hue = h; }
  int saturation() const
        { return _sat; }
  void setSaturation( int s )
        { _sat = s; }
 
  void updateContents();
protected:
  virtual void drawPalette( TQPixmap *pixmap );
  virtual void resizeEvent( TQResizeEvent * );
 
  virtual void drawContents( TQPainter *painter );
 
private:
  int _hue;
  int _sat;
  TQPixmap pixmap;
 
protected:
  virtual void virtual_hook( int id, void* data );
private:
  class KValueSelectorPrivate;
  KValueSelectorPrivate *d;
};
 
 
class TDEUI_EXPORT KColor : public TQColor
{
public:
  KColor();
  KColor( const KColor &col);
  KColor( const TQColor &col);
 
  KColor& operator=( const KColor& col);
 
  bool operator==( const KColor& col) const;
 
  void setHsv(int _h, int _s, int _v);
  void setRgb(int _r, int _g, int _b);
 
  void rgb(int *_r, int *_g, int *_b) const;
  void hsv(int *_h, int *_s, int *_v) const;
protected:
  int h;
  int s;
  int v;
  int r;
  int g;
  int b;
 
private:
  class KColorPrivate;
  KColorPrivate *d;
};
 
class TDEUI_EXPORT KPaletteTable : public TQWidget
{
  TQ_OBJECT
public:
  KPaletteTable( TQWidget *parent, int minWidth=210, int cols = 16);
  ~KPaletteTable();
  void addToCustomColors( const TQColor &);
  void addToRecentColors( const TQColor &);
  TQString palette() const;
public slots:
  void setPalette(const TQString &paletteName);
signals:
  void colorSelected( const TQColor &, const TQString & );
  void colorDoubleClicked( const TQColor &, const TQString & );
 
protected slots:
  void slotColorCellSelected( int );
  void slotColorCellDoubleClicked( int );
  void slotColorTextSelected( const TQString &colorText );
  void slotSetPalette( const TQString &_paletteName );
  void slotShowNamedColorReadError( void );
 
protected:
  void readNamedColor( void );
 
protected:
  TQString i18n_customColors; 
  TQString i18n_recentColors; 
  TQString i18n_namedColors;
  TQComboBox *combo;
  KColorCells *cells;
  TQScrollView *sv;
  TDEListBox *mNamedColorList;
  KPalette *mPalette;
  int mMinWidth;
  int mCols;
 
private:
 
  virtual void setPalette(const TQPalette& p) { TQWidget::setPalette(p); }
protected:
  virtual void virtual_hook( int id, void* data );
private:
  class KPaletteTablePrivate;
  KPaletteTablePrivate *d;
};
 
 
class TDEUI_EXPORT KColorCells : public TQGridView
{
  TQ_OBJECT
public:
  KColorCells( TQWidget *parent, int rows, int cols );
  ~KColorCells();
 
  void setColor( int colNum, const TQColor &col );
  TQColor color( int indx ) const
  { return colors[indx]; }
  int numCells() const
  { return numRows() * numCols(); }
 
  void setShading(bool _shade) { shade = _shade; }
 
  void setAcceptDrags(bool _acceptDrags) { acceptDrags = _acceptDrags; }
 
  int getSelected() const
  { return selected; }
 
  signals:
  void colorSelected( int col );
  void colorDoubleClicked( int col );
 
protected:
  virtual void paintCell( TQPainter *painter, int row, int col );
  virtual void resizeEvent( TQResizeEvent * );
  virtual void mouseReleaseEvent( TQMouseEvent * );
  virtual void mousePressEvent( TQMouseEvent * );
  virtual void mouseMoveEvent( TQMouseEvent * );
  virtual void dragEnterEvent( TQDragEnterEvent *);
  virtual void dropEvent( TQDropEvent *);
  virtual void mouseDoubleClickEvent( TQMouseEvent * );
 
  int posToCell(const TQPoint &pos, bool ignoreBorders=false);
 
  TQColor *colors;
  bool inMouse;
  TQPoint mPos;
  int   selected;
  bool shade;
  bool acceptDrags;
 
protected:
  virtual void virtual_hook( int id, void* data );
private:
  class KColorCellsPrivate;
  KColorCellsPrivate *d;
};
 
class TDEUI_EXPORT KColorPatch : public TQFrame
{
  TQ_OBJECT
public:
  KColorPatch( TQWidget *parent );
  virtual ~KColorPatch();
 
  void setColor( const TQColor &col );
 
signals:
  void colorChanged( const TQColor&);
 
protected:
  virtual void drawContents( TQPainter *painter );
  virtual void mouseMoveEvent( TQMouseEvent * );
  virtual void dragEnterEvent( TQDragEnterEvent *);
  virtual void dropEvent( TQDropEvent *);
 
private:
  TQColor color;
  uint pixel;
  int colContext;
 
protected:
  virtual void virtual_hook( int id, void* data );
private:
  class KColorPatchPrivate;
  KColorPatchPrivate *d;
};
 
class TDEUI_EXPORT KColorDialog : public KDialogBase
{
  TQ_OBJECT
 
  public:
    KColorDialog( TQWidget *parent = 0L, const char *name = 0L,
          bool modal = false );
    ~KColorDialog();
 
    TQColor color() const;
 
    static int getColor( TQColor &theColor, TQWidget *parent=0L );
 
    static int getColor( TQColor &theColor, const TQColor& defaultColor, TQWidget *parent=0L );
 
    static TQColor grabColor(const TQPoint &p);
 
    void setDefaultColor( const TQColor& defaultCol );
 
    TQColor defaultColor() const;
 
  public slots:
    void setColor( const TQColor &col );
 
  signals:
    void colorSelected( const TQColor &col );
 
  private slots:
    void slotRGBChanged( void );
    void slotHSVChanged( void );
    void slotHtmlChanged( void );
    void slotHSChanged( int, int );
    void slotVChanged( int );
    void slotColorSelected( const TQColor &col );
    void slotColorSelected( const TQColor &col, const TQString &name );
    void slotColorDoubleClicked( const TQColor &col, const TQString &name );
    void slotColorPicker();
    void slotAddToCustomColors();
    void slotDefaultColorClicked();
    void slotWriteSettings();
 
  private:
    void readSettings();
 
    void setRgbEdit( const KColor &col );
    void setHsvEdit( const KColor &col );
    void setHtmlEdit( const KColor &col );
    void _setColor( const KColor &col, const TQString &name=TQString::null );
    void showColor( const KColor &color, const TQString &name );
 
  protected:
    virtual void mouseReleaseEvent( TQMouseEvent * );
    virtual void keyPressEvent( TQKeyEvent * );
    virtual bool eventFilter( TQObject *obj, TQEvent *ev );
 
  protected:
    virtual void virtual_hook( int id, void* data );
  private:
    class KColorDialogPrivate;
    KColorDialogPrivate *d;
};
 
#endif      // !TQ_WS_QWS
#endif      // KDELIBS_KCOLORDIALOG_H