kgantt Library API Documentation

KGanttItem Class Reference

KGanttItem. More...

#include <KGanttItem.h>

Inheritance diagram for KGanttItem:

QObject List of all members.

Public Types

enum  Change {
  NoChange = 0, StartChanged = 1, EndChanged = 2, HeightChanged = 4,
  TotalHeightChanged = 8, StyleChanged = 16, TextChanged = 32, ModeChanged = 64,
  MinChanged = 128, MaxChanged = 256, Opened = 512, Closed = 1024,
  Selected = 2048, Unselected = 4096, Unknown = 8192, RelationAdded = 16384,
  RelationRemoved = 32768
}
enum  Style {
  DrawNothing = 0, DrawBorder = 1, DrawFilled = 2, DrawText = 4,
  DrawHandle = 16, DrawHandleWSubitems = 32, DrawAll = 255
}
enum  Mode { Normal, Rubberband }

Signals

void changed (KGanttItem *, KGanttItem::Change)
void destroyed (KGanttItem *)

Public Methods

 KGanttItem (KGanttItem *parentItem, const QString &text, const QDateTime &start, const QDateTime &end)
 KGanttItem (KGanttItem *parentItem, const QString &text, const QDateTime &start, long durationMin)
 ~KGanttItem ()
KGanttRelationaddRelation (KGanttItem *from, KGanttItem *to, const QString &text)
bool isOpen ()
void open (bool f)
void setEditable (bool f)
bool isEditable ()
bool isSelected ()
void select (bool f)
void setMode (Mode flag)
void setStyle (int flag, bool includeSubitems=false)
int getStyle ()
void setBrush (const QBrush &brush)
QBrushgetBrush ()
QBrushgetSelectBrush ()
void setPen (const QPen &pen)
QPengetPen ()
void setTextPen (const QPen &pen)
QPengetTextPen ()
void setText (const QString &text)
QString getText ()
QDateTime getStart ()
QDateTime getEnd ()
void setStart (const QDateTime &start)
void setEnd (const QDateTime &end)
void setHeight (int h)
int getHeight ()
int getTotalHeight ()
int getWidth ()
QPtrList< KGanttItem > & getSubItems ()
QPtrList< KGanttRelation > & getRelations ()
void startTransaction ()
void endTransaction ()
void dump (QTextOStream &cout, const QString &pre)

Static Public Methods

QString ChangeAsString (Change c)

Detailed Description

KGanttItem.

This class describes a item. It contains dates on which the item starts and ends. It also contains attributes that gouverns the graphical representation in a gantt diagramm.

Definition at line 53 of file KGanttItem.h.


Member Enumeration Documentation

enum KGanttItem::Change
 

Enumeration values:
HeightChanged  Height for this item has changed. The height doesn't include the subitems.
TotalHeightChanged  Total height has changed. This happens if the item was opened, closed or subitems has been added or removed while item is open.
StyleChanged  Style for drawing has changed.
Opened  Draw item including subitems.
Closed  Draw item without subitems.
Selected  Item has been selected.
Unselected  Item has been unselected.
Unknown  Changes may occurred but the types are unknown.
RelationAdded  Relation between two subitems has been added.
RelationRemoved  Relation between two subitems has been removed.

Definition at line 62 of file KGanttItem.h.

Referenced by xQGanttBarViewPort::xQGanttBarViewPort().

enum KGanttItem::Style
 

Enumeration values:
DrawNothing  Set item invisible.
DrawBorder  Draw border.
DrawHandleWSubitems  Draw handle only if item contains subitems.

Definition at line 109 of file KGanttItem.h.


Constructor & Destructor Documentation

KGanttItem::KGanttItem KGanttItem *    parentItem,
const QString   text,
const QDateTime   start,
const QDateTime   end
 

Constructor.

Definition at line 15 of file KGanttItem.cpp.

KGanttItem::KGanttItem KGanttItem *    parentItem,
const QString   text,
const QDateTime   start,
long    durationMin
 

Constructor.

Definition at line 25 of file KGanttItem.cpp.

References QDateTime::addSecs().

KGanttItem::~KGanttItem  
 

Destructor.

Definition at line 67 of file KGanttItem.cpp.


Member Function Documentation

KGanttRelation * KGanttItem::addRelation KGanttItem *    from,
KGanttItem *    to,
const QString   text
 

Add relation between two subitems.

Definition at line 90 of file KGanttItem.cpp.

References QPtrList< KGanttRelation >::append(), changed(), QObject::connect(), QPtrList< KGanttItem >::containsRef(), QObject::destroyed(), and RelationAdded.

bool KGanttItem::isOpen   [inline]
 

Returns true if item is open (subitems has to be drawn).

Definition at line 176 of file KGanttItem.h.

void KGanttItem::open bool    f
 

Open / Close item.

Draw/don't draw subitems.

Definition at line 435 of file KGanttItem.cpp.

void KGanttItem::setEditable bool    f [inline]
 

Set item editable or not.

If item is not editable these methods have no effect : setStart(), setEnd(), setText(), select(), setMode(), setStyle(), setHeight(),

Definition at line 197 of file KGanttItem.h.

bool KGanttItem::isEditable   [inline]
 

Returns if item is editable.

See also setEditable().

Definition at line 207 of file KGanttItem.h.

bool KGanttItem::isSelected   [inline]
 

Returns true if item is selected.

Definition at line 217 of file KGanttItem.h.

void KGanttItem::select bool    f
 

Select/unselect item.

Definition at line 450 of file KGanttItem.cpp.

void KGanttItem::setMode Mode    flag
 

Set mode.

If mode is 'Rubberband' and the number of subtaks is greater than 0, the start and end of the item is determined by the start and end of the earliest/latest subitem.
Default is 'Normal'.

Definition at line 466 of file KGanttItem.cpp.

Referenced by KGantt::KGantt().

void KGanttItem::setStyle int    flag,
bool    includeSubitems = false
 

Set drawing style.

Definition at line 480 of file KGanttItem.cpp.

int KGanttItem::getStyle   [inline]
 

Get drawing style.

Definition at line 254 of file KGanttItem.h.

void KGanttItem::setBrush const QBrush   brush
 

Set brush for filling.

Definition at line 503 of file KGanttItem.cpp.

QBrush& KGanttItem::getBrush   [inline]
 

Get brush that is used for filling the item.

Definition at line 272 of file KGanttItem.h.

QBrush& KGanttItem::getSelectBrush   [inline]
 

Get brush which has to be used for drawing this item as selected.

Definition at line 282 of file KGanttItem.h.

void KGanttItem::setPen const QPen   pen
 

Set pen for border.

Definition at line 512 of file KGanttItem.cpp.

void KGanttItem::setText const QString   text
 

Set text.

Definition at line 422 of file KGanttItem.cpp.

QString KGanttItem::getText   [inline]
 

Get text.

Definition at line 338 of file KGanttItem.h.

Referenced by KGanttRelation::dump().

QDateTime KGanttItem::getStart  
 

Get date of starting.

If mode == ´Rubberband´ and this item contains subitems, start of the item is determined by the start of the earliest subitem.

Definition at line 208 of file KGanttItem.cpp.

References QPtrList< KGanttItem >::count().

QDateTime KGanttItem::getEnd  
 

Get date of ending.

Definition at line 220 of file KGanttItem.cpp.

void KGanttItem::setStart const QDateTime   start
 

Set time/date of start.

Definition at line 232 of file KGanttItem.cpp.

References changed(), and QPtrList< KGanttItem >::count().

void KGanttItem::setEnd const QDateTime   end
 

Set time/date of end.

Definition at line 269 of file KGanttItem.cpp.

References changed(), and QPtrList< KGanttItem >::count().

void KGanttItem::setHeight int    h
 

Set height.

Set height in pixel. These are scaled when this item is drawn by the barview.

Definition at line 521 of file KGanttItem.cpp.

int KGanttItem::getHeight   [inline]
 

Get height.

Returns the height in pixel of this item. This does not include the height of any subitems; getTotalHeight() returns that if the subitems have to be drawn.

Definition at line 391 of file KGanttItem.h.

int KGanttItem::getTotalHeight  
 

Get total height.

Returns the total height of this object in pixel, including any visible subitems. Notice, that the pixels are no screen pixel since the barview scales the height of a item.

Definition at line 534 of file KGanttItem.cpp.

int KGanttItem::getWidth  
 

Get width in minutes.

Definition at line 550 of file KGanttItem.cpp.

QPtrList<KGanttItem>& KGanttItem::getSubItems   [inline]
 

Get list of subitems.

Definition at line 419 of file KGanttItem.h.

QPtrList<KGanttRelation>& KGanttItem::getRelations   [inline]
 

Get list of relations.

Definition at line 429 of file KGanttItem.h.

void KGanttItem::startTransaction   [inline]
 

Start a transaction.

If you want to add a lot of subitems -> block signals

Definition at line 439 of file KGanttItem.h.

References QObject::blockSignals().

void KGanttItem::endTransaction  
 

End a transaction.

If you started a transaction and all signals have been blocked by method startTransaction(), invoke endTransaction() to unblock signals.
Signal changed(this,Unknown) is emitted.

Definition at line 119 of file KGanttItem.cpp.

QString KGanttItem::ChangeAsString Change    c [static]
 

Return a given change as a string.

Definition at line 599 of file KGanttItem.cpp.

void KGanttItem::dump QTextOStream   cout,
const QString   pre
 

Dump to cout.

Definition at line 565 of file KGanttItem.cpp.

References KGanttRelation::dump().

void KGanttItem::changed KGanttItem *   ,
KGanttItem::Change   
[signal]
 

Item has changed.

This signal is emitted if any of the items properties have been changed.

Referenced by addRelation(), setEnd(), and setStart().

void KGanttItem::destroyed KGanttItem *    [signal]
 

Item will be deleted.

This signal will be emitted immediately before the object will be deleted.


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kgantt Library Version 3.2.2.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Sat May 1 11:37:42 2004 by doxygen 1.2.15 written by Dimitri van Heesch, © 1997-2003