class KPalette

Class for handling Palettes. More...

Definition#include <kpalette.h>
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Types

Public Methods

Public Static Methods


Detailed Description

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:
nameThe 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 successful

QString  description ()

description

[const]

Get the description of the palette.

void  setDescription (const QString &desc)

setDescription

Set the description of the palette.

QString  name ()

name

[const]

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

[const]

Returns whether the palette may be edited.

void  setEditable (Editable editable)

setEditable

Change whether the palette may be edited.

int  nrColors ()

nrColors

[const]

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

[const]

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 color name 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 color name 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:
newColorThe color to add.
newColorNameThe 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:
indexIndex of the color to change
newColorThe new color.
newColorNameThe 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:
oldColorThe original color
newColorThe new color.
newColorNameThe new color name.

Returns: The index of the new color or -1 if the color couldn't be changed.