You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdenetwork/kopete/kopete/chatwindow/kopetechatwindowstyle.h

130 lines
3.5 KiB

/*
kopetechatwindowstyle.h - A Chat Window Style.
Copyright (c) 2005 by Michaël Larouche <michael.larouche@kdemail.net>
Kopete (c) 2002-2005 by the Kopete developers <kopete-devel@kde.org>
*************************************************************************
* *
* 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 KOPETECHATWINDOWSTYLE_H
#define KOPETECHATWINDOWSTYLE_H
#include <tqstring.h>
#include <tqmap.h>
/**
* This class represent a single chat window style.
*
* @author Michaël Larouche <michael.larouche@kdemail.net>
*/
class ChatWindowStyle
{
public:
/**
* StyleVariants is a typedef to a TQMap
* key = Variant Name
* value = Path to variant CSS file.
* Path is relative to Ressources directory.
*/
typedef TQMap<TQString,TQString> StyleVariants;
/**
* This enum specifies the mode of the constructor
* - StyleBuildFast : Build the style the fatest possible
* - StyleBuildNormal : List all variants of this style. Require a async dir list.
*/
enum StyleBuildMode { StyleBuildFast, StyleBuildNormal};
/**
* @brief Build a single chat window style.
*
*/
ChatWindowStyle(const TQString &stylePath, int styleBuildMode = StyleBuildNormal);
ChatWindowStyle(const TQString &stylePath, const TQString &variantPath, int styleBuildMode = StyleBuildFast);
~ChatWindowStyle();
/**
* Get the list of all variants for this theme.
* If the variant aren't listed, it call the lister
* before returning the list of the Variants.
* If the variant are listed, it just return the cached
* variant list.
* @return the StyleVariants TQMap.
*/
StyleVariants getVariants();
/**
* Get the style path.
* The style path points to the directory where the style is located.
* ex: ~/.trinity/share/apps/kopete/styles/StyleName/
*
* @return the style path based.
*/
TQString getStylePath() const;
/**
* Get the style ressource directory.
* Ressources directory is the base where all CSS, HTML and images are located.
*
* Adium(and now Kopete too) style directories are disposed like this:
* StyleName/
* Contents/
* Resources/
*
* @return the path to the the ressource directory.
*/
TQString getStyleBaseHref() const;
TQString getHeaderHtml() const;
TQString getFooterHtml() const;
TQString getIncomingHtml() const;
TQString getNextIncomingHtml() const;
TQString getOutgoingHtml() const;
TQString getNextOutgoingHtml() const;
TQString getStatusHtml() const;
TQString getActionIncomingHtml() const;
TQString getActionOutgoingHtml() const;
/**
* Check if the style has the support for Kopete Action template (Kopete extension)
* @return true if the style has Action template.
*/
bool hasActionTemplate() const;
/**
* Reload style from disk.
*/
void reload();
private:
/**
* Read style HTML files from disk
*/
void readStyleFiles();
/**
* Init this class
*/
void init(const TQString &stylePath, int styleBuildMode);
/**
* List available variants for the current style.
*/
void listVariants();
private:
class Private;
Private *d;
};
#endif