//============================================================================= // // File : class_label.cpp // Creation date : Mon Sep 18 14:21:48 CEST 2000 by Krzysztof Godlewski // // This file is part of the KVirc irc client distribution // Copyright (C) 2000 Krzysztof Godlewski // Copyright (C) 2000-2008 Szymon Stefanek (pragma at kvirc dot net) // // 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 opinion) any later version. // // This program 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 General Public License for more details. // // You should have received a copy of the GNU General Public License // along with this program. If not, write to the Free Software Foundation, // Inc. ,59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. // //============================================================================= #include "kvi_error.h" #include "kvi_debug.h" #include "class_label.h" #include "kvi_locale.h" #include "kvi_iconmanager.h" #include #include #include #include // Tables used in $setAlignment & $alignment const char * const align_tbl[] = { "Left", "Right", "HCenter", "VCenter", "Center", "Top", "Bottom", "WordBreak" }; const int align_cod[] = { Qt::AlignLeft, Qt::AlignRight, Qt::AlignHCenter, Qt::AlignVCenter, Qt::AlignCenter, Qt::AlignTop, Qt::AlignBottom, Qt::AlignJustify, }; #define align_num (sizeof(align_tbl) / sizeof(align_tbl[0])) // used in $frameStyle & $setFrameStyle const char * const frame_tbl[] = { "NoFrame", "Box", "Panel", "WinPanel", "Hline", // shadow styles "Plain", "Raised", "Sunken" }; const int frame_cod[] = { QFrame::NoFrame, QFrame::Box, QFrame::Panel, QFrame::WinPanel, QFrame::HLine, QFrame::Plain, QFrame::Raised, QFrame::Sunken }; #define frame_num (sizeof(frame_tbl) / sizeof(frame_tbl[0])) /* @doc: label @keyterms: label object class, show image @title: label class @type: class @short: Displays text or an image @inherits: [class]object[/class] [class]widget[/class] @description: This widget can be used to display a text or an image. It can have different frame styles and text/image alignment. @functions: !fn: $setText() Sets the text to be displayed by the label. The text can contain limited html tags. See also [classfnc]$text[/classfnc](). !fn: $text() Returns the text currently displayed by the label. See also [classfnc]$setText[/classfnc](). !fn: $margin() Returns current value of margin for this label (default is 0). See also [classfnc]$setMargin[/classfnc](). !fn: $setMargin() Sets margin width / height to . See also [classfnc]$margin[/classfnc](). !fn: $alignment() Returns a string containing alignment flags that are set for this label. The flags are separated by commas. An example output could look like this:[br] [pre]Bottom, Right[/pre][br] See [classfnc]$setAlignment[/classfnc]() for explanation of all alignment flags. !fn: $setAlignment(, , ...) This function sets alignment flags, given as parameters, for this label. Valid flags are: [pre] Right - Text is aligned to right border[br] Left - Text is aligned to left border[br] Top - Text is aligned to the top border[br] Bottom - Text is aligned to the bottom border[br] HCenter - Text is horizontally centered[br] VCenter - Text is vertically centered[br] Center - Equals HCenter + VCenter[br] WordBreak - Enables automatic word breaking[br] [/pre] It is obvious that you can not set for example [i]Right[/i] and [i]Left[/i] simoultaneously - this will [b]NOT[/b] result in an error message - this will simply not work :) !fn: $clear() Clears the label. Equal to calling [classfnc]$setText[/classfnc]("") !fn: $frameStyle() Returns a string containing this label's frame-style flags, separated with commas. Output from this function could look like this: [pre]Panel, Raised[/pre] See [classfnc]$setFrameStyle[/classfnc]() for a list of all frame-style flags and their explenation. !fn: $setFrameStyle(, , ...) Sets the frame-style flags to the ones passed as arguments. The flags can either decide of the shape or shadow of the label's frame. Valid shape flags are:[br] [pre] NoFrame - draw no frame. You shouldn't specify a shadow when using this.[br] Box - draws a rectangular box. Its borders can be [i]Raised[/i] or [i]Sunken[/i][br] Panel - draws a rectangular panel which can be [i]Raised[/i] or [i]Sunken[/i][br] WinPanel - similar to [i]Panel[/i], but is more in Win95 style[br] Hline - draws a horizontal line that frames nothing (useful as separator) [/pre] Valid shadow flags are:[br] [pre] Plain - no 3D effect (draws using foreground color)[br] Raised - makes the label look like it was raised above the parent widget[br] Sunken - makes the label look like it was "pushed" inside the parent widget[br] [/pre] !fn: $setImage() Sets the image to be displayed on this label. Giving empty argument clears the pixmap[br] See the [doc:image_id]image identifier[/doc] documentation for the explaination of the parameter. */ KVSO_BEGIN_REGISTERCLASS(KviKvsObject_label,"label","widget") KVSO_REGISTER_HANDLER_NEW(KviKvsObject_label,setText) KVSO_REGISTER_HANDLER_NEW(KviKvsObject_label,text) KVSO_REGISTER_HANDLER_NEW(KviKvsObject_label,margin) KVSO_REGISTER_HANDLER_NEW(KviKvsObject_label,setMargin) KVSO_REGISTER_HANDLER_NEW(KviKvsObject_label,alignment) KVSO_REGISTER_HANDLER_NEW(KviKvsObject_label,setAlignment) KVSO_REGISTER_HANDLER_NEW(KviKvsObject_label,clear) KVSO_REGISTER_HANDLER_NEW(KviKvsObject_label,frameStyle) KVSO_REGISTER_HANDLER_NEW(KviKvsObject_label,setFrameStyle) KVSO_REGISTER_HANDLER_NEW(KviKvsObject_label,setImage) KVSO_END_REGISTERCLASS(KviKvsObject_label) KVSO_BEGIN_CONSTRUCTOR(KviKvsObject_label,KviKvsObject_widget) KVSO_END_CONSTRUCTOR(KviKvsObject_label) KVSO_BEGIN_DESTRUCTOR(KviKvsObject_label) KVSO_END_CONSTRUCTOR(KviKvsObject_label) bool KviKvsObject_label::init(KviKvsRunTimeContext * pContext,KviKvsVariantList *pParams) { SET_OBJECT(QLabel) return true; } KVSO_CLASS_FUNCTION(label,setText) { QString szText; KVSO_PARAMETERS_BEGIN(c) KVSO_PARAMETER("text",KVS_PT_STRING,0,szText) KVSO_PARAMETERS_END(c) if (widget()) ((QLabel *)widget())->setText(szText); return true; } KVSO_CLASS_FUNCTION(label,text) { if (widget()) c->returnValue()->setString(((QLabel *)widget())->text()); return true; } KVSO_CLASS_FUNCTION(label,setMargin) { kvs_uint_t iMargin; KVSO_PARAMETERS_BEGIN(c) KVSO_PARAMETER("margin",KVS_PT_UNSIGNEDINTEGER,0,iMargin) KVSO_PARAMETERS_END(c) if (widget()) ((QLabel *)widget())->setMargin(iMargin); return true; } KVSO_CLASS_FUNCTION(label,margin) { if (widget()) c->returnValue()->setInteger(((QLabel *)widget())->margin()); return true; } /* // FIX ME bool KviKvsObject_label::functionSetAutoResize(KviKvsObjectFunctionCall *c) { bool bEnabled; KVSO_PARAMETERS_BEGIN(c) KVSO_PARAMETER("bEnabled",KVS_PT_BOOL,0,bEnabled) KVSO_PARAMETERS_END(c) return true; } // FIX ME bool KviKvsObject_label::functionAutoResize(KviKvsObjectFunctionCall *c) { if (widget()) c->returnValue()->setBoolean(true); return true; } */ KVSO_CLASS_FUNCTION(label,setAlignment) { QStringList alignment; KVSO_PARAMETERS_BEGIN(c) KVSO_PARAMETER("alignment",KVS_PT_STRINGLIST,KVS_PF_OPTIONAL,alignment) KVSO_PARAMETERS_END(c) if (!widget()) return true; int align,sum=0; for ( QStringList::Iterator it = alignment.begin(); it != alignment.end(); ++it ) { align = 0; for(unsigned int j = 0; j < align_num; j++) { if(KviQString::equalCI((*it), align_tbl[j])) { align=align_cod[j]; break; } } if(align) sum = sum | align; else c->warning(__tr2qs("Unknown alignment: '%Q'"),&(*it)); } ((QLabel *)widget())->setAlignment((Qt::Alignment)sum); return true; } KVSO_CLASS_FUNCTION(label,alignment) { int mode = ((QLabel *)widget())->alignment(); QString szAlignment=""; for(unsigned int i = 0; i < align_num; i++) { if(mode == align_cod[i]) { szAlignment=align_tbl[i]; break; } } c->returnValue()->setString(szAlignment); return true; } KVSO_CLASS_FUNCTION(label,clear) { if(widget()) ((QLabel *)widget())->clear(); return true; } KVSO_CLASS_FUNCTION(label,setFrameStyle) { QStringList style; KVSO_PARAMETERS_BEGIN(c) KVSO_PARAMETER("style",KVS_PT_STRINGLIST,KVS_PF_OPTIONAL,style) KVSO_PARAMETERS_END(c) if (!widget()) return true; int framestyle,sum=0; for ( QStringList::Iterator it = style.begin(); it != style.end(); ++it ) { framestyle = 0; for(unsigned int j = 0; j < align_num; j++) { if(KviQString::equalCI((*it), frame_tbl[j])) { framestyle=frame_cod[j]; break; } } if(framestyle) sum = sum | framestyle; else c->warning(__tr2qs("Unknown style: '%Q'"),&(*it)); } ((QLabel *)widget())->setFrameStyle(sum); return true; } KVSO_CLASS_FUNCTION(label,frameStyle) { int mode = ((QLabel *)widget())->frameStyle(); QString szStyle=""; for(unsigned int i = 0; i < frame_num; i++) { if(mode == frame_cod[i]) { szStyle=frame_tbl[i]; break; } } c->returnValue()->setString(szStyle); return true; } KVSO_CLASS_FUNCTION(label,setImage) { QString icon; KVSO_PARAMETERS_BEGIN(c) KVSO_PARAMETER("icon",KVS_PT_STRING,0,icon) KVSO_PARAMETERS_END(c) if(!widget())return true; QPixmap * pix = g_pIconManager->getImage(icon); if(pix) ((QLabel *)widget())->setPixmap(*pix); return true; }