summaryrefslogtreecommitdiffstats
path: root/kcoloredit/paletteviewscrolledarea.h
blob: abf09fe58530e89acdf0ab9d43d7311abb6eb2f8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
/***************************************************************************
                          paletteviewscrolledarea.h
                             -------------------
    begin                : Sun Jul 17 2000
    copyright            : (C) 2000 by Artur Rataj
    email                : art@zeus.polsl.gliwice.pl
 ***************************************************************************/

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

#ifndef PALETTEVIEWSCROLLEDAREA_H
#define PALETTEVIEWSCROLLEDAREA_H

#include <tqframe.h>
#include <tqevent.h>

#include "palette.h"

class KColorEditDoc;
class KColorEditView;
class TQScrollBar;

/** This widget draws the palette view scrolled area.
 *  It has paste and cut features.
 *  @author Artur Rataj
 */
class PaletteViewScrolledArea : public TQFrame {
	Q_OBJECT
  

public:
	/** Constructs the widget */
	PaletteViewScrolledArea(const int defaultCellWidth, const int defaultCellHeight,
		const int cellSpacing, TQScrollBar* scrollBar,
		TQScrollBar* hScrollBar, KColorEditView* view,
		TQWidget* parent = 0, const char* name = 0);
	~PaletteViewScrolledArea();
	/** Sets cells sizes and then calls repaintPalette() */
	void redraw();

public slots:
	/** Sets if the cursor follows a chosen color */
	void slotCursorFollowsChosenColor(bool follows);
	/** Sets whether to view color names */
	void slotViewColorNames(bool viewColorNames);

protected:
	/** The scrollbar widget */
	TQScrollBar* scrollBar;
	/** The horizontal scrollbar widget */
	TQScrollBar* hScrollBar;
	/** Pointer to the document view */
	KColorEditView* view;
	/** Default cell width */
	int defaultCellWidth;
	/** Default cell height */
	int defaultCellHeight;
	/** Cell spacing */
	int cellSpacing;
	/** Cell width */
	int cellWidth;
	/** Cell height */
	int cellHeight;
	/** The number of cells in a row */
	int cellsInRow;
	/** The number of rows */
	int rowsNum;
	/** A row width */
	int rowWidth;
	/** A row height */
	int rowHeight;
	/** Total height of cells table */
	int cellTableHeight;
	/** A position at which selection started */
	int selectionBegin;
	/** A position at which selection ended */
	int selectionEnd;
	/** Auto scroll timeout timer */
	TQTimer* scrollTimeoutTimer;
	/** Whether there is auto scroll timeout */
	bool scrollTimeout;
	/** Whether a mouse has been pressed over the palette and not yet released */
	bool mousePressed;
	/** Whether the cursor is being positioned */
	bool cursorPositioning;
	/** A color drag point */
	TQPoint colorDragPoint;
	/** Whether a color has been chosen and it is not dragged */
	bool colorChosen;
	/** Whether the cursor follows a chosen color */
	bool cursorFollowsChosenColor;
	/** Whether to view color names */
	bool viewColorNames;

	/** @return The viewed palette */
	Palette* palette() const;
	/** Computes the size of cell, number of cells in a row and
	 *  height of cells table, depending on colors number and
	 *  visible area width
	 */
	void setCellsSizes();
	/** repaints the palette */
	void repaintPalette();
	/** @return A color index at a given position, -1 if none */
	int colorIndex(const TQPoint& point) const;
	/** @return A color at a given position */
	TQColor color(const TQPoint& point) const;
	/** sets a palette cursor position */
	void setCursorPos(const int pos);
	/** Sets a cursor position due to a mouse position.
	 *  If not in cursor positioning, the cursor is set
	 *  only if mouse points to a possible cursor location
	 *  @return If the mouse points to a cursor location
	 */
	bool setCursorPos(const int x, const int y);
	/** @return a palette cursor position */
	int cursorPos() const;
	/** sets a palette selection */
	void setSelection(const int min, const int max);
	/** @return a palette selection lesser position, or equal position
	 *  if no colors are selected
	 */
	int selectionMin() const;
	/** @return a palette selection greater position, or equal position
	 *  if no colors are selected
	 */
	int selectionMax() const;
	/**  checks whether to scrolls the palette if a mouse position
	 *   is outside it
	 */
	void checkSelectionAutoScroll(const int mousePosY);
	/** The widget painting */
	void paintEvent(TQPaintEvent* event);
	/** Used to get mouse press events coordinates */
	void mousePressEvent(TQMouseEvent* event);
	/** Used to get mouse move events coordinates */
	void mouseMoveEvent(TQMouseEvent* event);
	/** Used to get mouse release events coordinates */
	void mouseReleaseEvent(TQMouseEvent* event);
	/** If there is a scroll timeout, scrolls palette,
	 *  sets scrollTimeout to false and resets scroll timeout timer
	 */
	void scrollPalette(const int amount, const int timeout);
	/** @return The viewed document */
	KColorEditDoc* document() const;
	/** Chooses a color to the color selector */
	void chooseColor(Color* const color);
	/** scrolls the scrolled area */
	void scrollBy(const int y);

protected slots:
	/** called if there is a scroll timeout, sets scrollTimeout to true */
	void slotScrollTimeout();
};

#endif /* !defined( PALETTEVIEWSCROLLEDAREA_H ) */