|
|
Class for handling Palettes.
This class makes it easy to handle palettes. A palette is a set of colors. This class can read and write palettes from and to a file.
This class uses the "GIMP" palette file format.
This class is totally unrelated to QPalette.
QStringList getPaletteList ()
| getPaletteList |
[static]
Query which KDE palettes are installed.
Returns: A list with a palette names.
KPalette (const QString &name=QString::null)
| KPalette |
KPalette constructor. Creates a KPalette from a file the filename is derived from the name.
Parameters:
name | The name of palette as returned by getPaletteList() |
KPalette (const KPalette &)
| KPalette |
KPalette copy constructor.
~KPalette ()
| ~KPalette |
[virtual]
KPalette destructor.
KPalette& operator= ( const KPalette &)
| operator= |
KPalette assignment operator
bool save ()
| save |
Save the palette
Returns: 'true' if successfull
QString description ()
| description |
Get the description of the palette.
void setDescription (const QString &desc)
| setDescription |
Set the description of the palette.
QString name ()
| name |
Get the name of the palette.
void setName (const QString &name)
| setName |
Set the name of the palette.
enum Editable { Yes, No, Ask } | Editable |
Editable editable ()
| editable |
Returns whether the palette may be edited.
void setEditable (Editable editable)
| setEditable |
Change whether the palette may be editted.
int nrColors ()
| nrColors |
Return the number of colors in the palette.
QColor color (int index)
| color |
Find color by index.
Returns: The index
-th color of the palette.
int findColor (const QColor &color)
| findColor |
Find index by color
.
Returns: The index of the color in the palette or -1 if the color is not found.
QString colorName (int index)
| colorName |
Find colorname by index
.
Returns: The name of the index
-th color.
Note that not all palettes have named the colors.
QString colorName (const QColor &color)
| colorName |
Find colorname by color
.
Returns: The name of color according to this palette. Note that not all palettes have named the colors. Note also that each palette can give the same color a different name.
int addColor (const QColor &newColor,
const QString &newColorName = QString::null)
| addColor |
Add a color.
Parameters:
newColor | The color to add. |
newColorName | The name of the color. |
Returns: The index of the added color.
int changeColor (int index,
const QColor &newColor,
const QString &newColorName = QString::null)
| changeColor |
Change a color.
Parameters:
index | Index of the color to change |
newColor | The new color. |
newColorName | The new color name. |
Returns: The index of the new color or -1 if the color couldn't be changed.
int changeColor (const QColor &oldColor,
const QColor &newColor,
const QString &newColorName = QString::null)
| changeColor |
Change a color.
Parameters:
oldColor | The original color |
newColor | The new color. |
newColorName | The new color name. |
Returns: The index of the new color or -1 if the color couldn't be changed.