<HTML> <HEAD> <TITLE>Source: kcolordialog.h</TITLE> <META NAME="Generator" CONTENT="KDOC "> </HEAD> <BODY bgcolor="#ffffff" text="#000000" link="#0000ff" vlink="#000099" alink= "#ffffff"> <TABLE WIDTH="100%" BORDER="0"> <TR> <TD> <TABLE BORDER="0"> <TR><TD valign="top" align="left" cellspacing="10"> <h1>Source: kcolordialog.h</h1> </TD> <TD valign="top" align="right" colspan="1"></TD></TR> </TABLE> <HR> <TABLE BORDER="0"> </TABLE> </TD> <TD align="right"><TABLE BORDER="0"><TR><TD><small><A HREF="index-long.html">Annotated List</A></small></TD></TR> <TR><TD><small><A HREF="header-list.html">Files</A></small></TD></TR> <TR><TD><small><A HREF="all-globals.html">Globals</A></small></TD></TR> <TR><TD><small><A HREF="hier.html">Hierarchy</A></small></TD></TR> <TR><TD><small><A HREF="index.html">Index</A></small></TD></TR> </TABLE></TD></TR></TABLE> <pre> /* 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ //---------------------------------------------------------------------- // KDE color selection dialog. // layout managment added Oct 1997 by Mario Weilguni // <mweilguni@sime.com> #ifndef __KCOLORDIALOG_H__ #define __KCOLORDIALOG_H__ #include <qcombobox.h> #include <kdialogbase.h> #include <qframe.h> #include <qpixmap.h> #include <qrangecontrol.h> #include <qtableview.h> #include "kselect.h" class QLineEdit; class KListBox; class KPalette; class KColorCells; /** * Widget for Hue/Saturation selection. * The actual values can be fetched using the inherited xValue and yValue * methods. * * @see KXYSelector, KValueSelector, KColorDialog * @author Martin Jones (mjones@kde.org) * @version $Id: kcolordialog.h,v 1.34 2000/12/21 18:53:18 waba Exp $ */ class KHSSelector : public KXYSelector { Q_OBJECT public: /** * Constructs a hue/saturation selection widget. */ KHSSelector( QWidget *parent=0, const char *name=0 ); void updateContents(); protected: /** * Draws the contents of the widget on a pixmap, * which is used for buffering. */ virtual void drawPalette( QPixmap *pixmap ); /** * @reimplemented */ virtual void resizeEvent( QResizeEvent * ); /** * Reimplemented from KXYSelector. This drawing is * buffered in a pixmap here. As real drawing * routine, drawPalette() is used. */ virtual void drawContents( QPainter *painter ); private: QPixmap pixmap; class KHSSelectorPrivate; KHSSelectorPrivate *d; }; /** * Dialog for colour value selection. * * @see KHSSelector, KColorDialog * @author Martin Jones (mjones@kde.org) * @version $Id: kcolordialog.h,v 1.34 2000/12/21 18:53:18 waba Exp $ */ class KValueSelector : public KSelector { Q_OBJECT public: /** * Constructs a widget for color selection. */ KValueSelector( QWidget *parent=0, const char *name=0 ); /** * Constructs a widget for color selection with a given orientation */ KValueSelector( Orientation o, QWidget *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: /** * Draws the contents of the widget on a pixmap, * which is used for buffering. */ virtual void drawPalette( QPixmap *pixmap ); /** * @reimplemented */ virtual void resizeEvent( QResizeEvent * ); /** * Reimplemented from KSelector. The drawing is * buffered in a pixmap here. As real drawing * routine, drawPalette() is used. */ virtual void drawContents( QPainter *painter ); private: int _hue; int _sat; QPixmap pixmap; class KValueSelectorPrivate; KValueSelectorPrivate *d; }; class KColor : public QColor { public: KColor(); KColor( const KColor &col); KColor( const QColor &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); void hsv(int *_h, int *_s, int *_v); protected: int h; int s; int v; int r; int g; int b; private: class KColorPrivate; KColorPrivate *d; }; /** * A color palette in table form. * @author Waldo Bastian <bastian@kde.org> * @version $Id: kcolordialog.h,v 1.34 2000/12/21 18:53:18 waba Exp $ **/ class KPaletteTable : public QWidget { Q_OBJECT public: KPaletteTable( QWidget *parent, int minWidth=210, int cols = 16); ~KPaletteTable(); void addToCustomColors( const QColor &); void addToRecentColors( const QColor &); QString palette(); public slots: void setPalette(const QString &paletteName); signals: void colorSelected( const QColor &, const QString & ); protected slots: void slotColorCellSelected( int ); void slotColorTextSelected( const QString &colorText ); void slotSetPalette( const QString &_paletteName ); void slotShowNamedColorReadError( void ); protected: void readNamedColor( void ); protected: QString i18n_customColors; QString i18n_recentColors; QString i18n_namedColors; QComboBox *combo; KColorCells *cells; QScrollView *sv; KListBox *mNamedColorList; KPalette *mPalette; int mMinWidth; int mCols; private: class KPaletteTablePrivate; KPaletteTablePrivate *d; virtual void setPalette(const QPalette& p) { QWidget::setPalette(p); } }; /** * A table of editable colour cells. * @author Martin Jones <mjones@kde.org> * @version $Id: kcolordialog.h,v 1.34 2000/12/21 18:53:18 waba Exp $ */ class KColorCells : public QTableView { Q_OBJECT public: KColorCells( QWidget *parent, int rows, int cols ); ~KColorCells(); void setColor( int colNum, const QColor &col ); QColor color( int indx ) { return colors[indx]; } int numCells() { return numRows() * numCols(); } void setShading(bool _shade) { shade = _shade; } void setAcceptDrags(bool _acceptDrags) { acceptDrags = _acceptDrags; } int getSelected() { return selected; } signals: void colorSelected( int col ); protected: /** * @reimplemented */ virtual void paintCell( QPainter *painter, int row, int col ); /** * @reimplemented */ virtual void resizeEvent( QResizeEvent * ); /** * @reimplemented */ virtual void mouseReleaseEvent( QMouseEvent * ); /** * @reimplemented */ virtual void mousePressEvent( QMouseEvent * ); /** * @reimplemented */ virtual void mouseMoveEvent( QMouseEvent * ); /** * @reimplemented */ virtual void dragEnterEvent( QDragEnterEvent *); /** * @reimplemented */ virtual void dropEvent( QDropEvent *); int posToCell(const QPoint &pos, bool ignoreBorders=false); QColor *colors; bool inMouse; QPoint mPos; int selected; bool shade; bool acceptDrags; private: class KColorCellsPrivate; KColorCellsPrivate *d; }; /** * The KColorPatch widget is a (usually small) widget showing * a selected color e. g. in the @ref KColorDialog. It * automatically handles drag and drop from and on the widget. * * @short A color shower. */ class KColorPatch : public QFrame { Q_OBJECT public: KColorPatch( QWidget *parent ); virtual ~KColorPatch(); void setColor( const QColor &col ); signals: void colorChanged( const QColor&); protected: /** * @reimplemented */ virtual void drawContents( QPainter *painter ); /** * @reimplemented */ virtual void mouseMoveEvent( QMouseEvent * ); /** * @reimplemented */ virtual void dragEnterEvent( QDragEnterEvent *); /** * @reimplemented */ virtual void dropEvent( QDropEvent *); private: QColor color; uint pixel; int colContext; class KColorPatchPrivate; KColorPatchPrivate *d; }; /** * The KColorDialog provides a dialog for color selection. * * @sect Features: * * @li Colour selection from a wide range of palettes. * @li Colour selection from a palette of H vs S and V selectors (similar to windoze). * @li Direct input of HSV or RGB values. * @li Saving of custom colors * * In most cases, you will want to use the static method @ref KColorDialog::getColor(). * This pops up the dialog (with an initial selection provided by you), lets the * user choose a color, and returns. * * Example: * * <pre> * QColor myColor; * int result = KColorDialog::getColor( myColor ); * if ( result == KColorDialog::Accepted ) * ... * </pre> * * @image kcolordialog.png KColorDialog * * The color dialog is really a collection of several widgets which can * you can also use separately: the quadratic plane in the top left of * the dialog is a @ref KXYSelector. Right next to it is a @ref KHSSelector * for chosing hue/saturation. * * On the right side of the dialog you see a @ref KPaletteTable showing * up to 40 colors with a combo box which offers several predefined * palettes or a palette configured by the user. The small field showing * the currently selected color is a @ref KColorPatch. * * @short A color selection dialog. **/ class KColorDialog : public KDialogBase { Q_OBJECT public: /** * Construct a @ref KColorDialog. */ KColorDialog( QWidget *parent = 0L, const char *name = 0L, bool modal = FALSE ); ~KColorDialog(); /** * Retrieve the currently selected color. **/ QColor color(); /** * Create a modal color dialog, let the user choose a * color, and return when the dialog is closed. * * The selected color is returned in the argument @p theColor. * * @returns @ref QDialog::result(). */ static int getColor( QColor &theColor, QWidget *parent=0L ); /** * Get the color from the pixel at point p on the screen. */ static QColor grabColor(const QPoint &p); public slots: /** * Preselects a color. */ void setColor( const QColor &col ); signals: /** * Emitted when a color is selected. * Connect to this to monitor the color as it as selected if you are * not running modal. */ void colorSelected( const QColor &col ); private slots: void slotRGBChanged( void ); void slotHSVChanged( void ); void slotHtmlChanged( void ); void slotHSChanged( int, int ); void slotVChanged( int ); void slotColorSelected( const QColor &col ); void slotColorSelected( const QColor &col, const QString &name ); void slotColorPicker(); void slotAddToCustomColors(); /** * Write the settings of the dialog to config file. **/ void slotWriteSettings(); private: /** * Read the settings for the dialog from config file. **/ void readSettings(); void setRgbEdit( void ); void setHsvEdit( void ); void setHtmlEdit( void ); void _setColor( const KColor &col, const QString &name=QString::null ); protected: /** * @reimplemented */ virtual void mouseReleaseEvent( QMouseEvent * ); /** * @reimplemented */ virtual void keyPressEvent( QKeyEvent * ); private: class KColorDialogPrivate; KColorDialogPrivate *d; }; #endif // __KCOLORDIALOG_H__ </pre> <HR> <table> <tr><td><small>Generated by: qateam on updates.mandrakesoft.com on Mon Dec 30 16:09:05 2002, using kdoc 2.0a53.</small></td></tr> </table> </BODY> </HTML>