akregator/src

Akregator::Folder Class Reference

#include <folder.h>

Inheritance diagram for Akregator::Folder:

Akregator::TreeNode Akregator::TagFolder List of all members.

Detailed Description

Represents a folder (containing feeds and/or other folders).

Definition at line 44 of file folder.h.


Public Slots

virtual void slotDeleteExpiredArticles ()
virtual void slotMarkAllArticlesAsRead ()
virtual void slotChildChanged (TreeNode *node)
virtual void slotChildDestroyed (TreeNode *node)
virtual void slotAddToFetchQueue (FetchQueue *queue, bool intervalFetchesOnly=false)
virtual TreeNode * next ()

Signals

void signalChildAdded (TreeNode *)
void signalChildRemoved (Folder *, TreeNode *)

Public Member Functions

 Folder (const QString &title=QString::null)
virtual ~Folder ()
virtual bool accept (TreeNodeVisitor *visitor)
virtual QValueList< Article > articles (const QString &tag=QString::null)
virtual QStringList tags () const
virtual int unread () const
virtual int totalCount () const
virtual bool isGroup () const
virtual QDomElement toOPML (QDomElement parent, QDomDocument document) const
virtual QValueList< TreeNode * > children () const
virtual void insertChild (TreeNode *node, TreeNode *after)
virtual void prependChild (TreeNode *node)
virtual void appendChild (TreeNode *node)
virtual void removeChild (TreeNode *node)
virtual TreeNode * firstChild ()
virtual TreeNode * lastChild ()
virtual bool isOpen () const
virtual void setOpen (bool open)

Static Public Member Functions

static Folder * fromOPML (QDomElement e)

Protected Member Functions

virtual void insertChild (uint index, TreeNode *node)
virtual void doArticleNotification ()

Constructor & Destructor Documentation

Akregator::Folder::Folder (  const QString &  title = QString::null  ) 
 

Creates a new folder with a given title.

Parameters:
title The title of the feed group

Definition at line 71 of file folder.cpp.


Member Function Documentation

void Akregator::Folder::appendChild (  TreeNode *  node  )  [virtual]
 

inserts node as last child

Parameters:
node the tree node to insert

Definition at line 168 of file folder.cpp.

QValueList< Article > Akregator::Folder::articles (  const QString &  tag = QString::null  )  [virtual]
 

returns recursively concatenated articles of children

Returns:
an article sequence containing articles of children

Implements Akregator::TreeNode.

Definition at line 108 of file folder.cpp.

QValueList< TreeNode * > Akregator::Folder::children (   )  const [virtual]
 

returns the (direct) children of this node.

Returns:
a list of pointers to the child nodes

Definition at line 133 of file folder.cpp.

void Akregator::Folder::doArticleNotification (   )  [protected, virtual]
 

reimplement this in subclasses to do the actual notification called by articlesModified

Reimplemented from Akregator::TreeNode.

Definition at line 305 of file folder.cpp.

TreeNode * Akregator::Folder::firstChild (   )  [virtual]
 

returns the first child of the group, 0 if none exist

Definition at line 220 of file folder.cpp.

Folder * Akregator::Folder::fromOPML (  QDomElement  e  )  [static]
 

creates a feed group parsed from a XML dom element.

Child nodes are not inserted or parsed.

Parameters:
e the element representing the feed group
Returns:
a freshly created feed group

Definition at line 63 of file folder.cpp.

void Akregator::Folder::insertChild (  uint  index,
TreeNode *  node
)  [protected, virtual]
 

inserts node as child on position index

Parameters:
index the position where to insert
node the tree node to insert

Definition at line 148 of file folder.cpp.

void Akregator::Folder::insertChild (  TreeNode *  node,
TreeNode *  after
)  [virtual]
 

inserts node as child after child node after.

if after is not a child of this group, node will be inserted as first child

Parameters:
node the tree node to insert
after the node after which node will be inserted

Definition at line 138 of file folder.cpp.

virtual bool Akregator::Folder::isGroup (   )  const [inline, virtual]
 

Helps the rest of the app to decide if node should be handled as group or not.

Use only where necessary, use polymorphism where possible.

Implements Akregator::TreeNode.

Definition at line 79 of file folder.h.

bool Akregator::Folder::isOpen (   )  const [virtual]
 

returns whether the feed group is opened or not.

Use only in FolderItem.

Definition at line 230 of file folder.cpp.

TreeNode * Akregator::Folder::lastChild (   )  [virtual]
 

returns the last child of the group, 0 if none exist

Definition at line 225 of file folder.cpp.

TreeNode * Akregator::Folder::next (   )  [virtual, slot]
 

returns the next node in the tree.

Calling next() unless it returns 0 iterates through the tree in pre-order

Implements Akregator::TreeNode.

Definition at line 327 of file folder.cpp.

void Akregator::Folder::prependChild (  TreeNode *  node  )  [virtual]
 

inserts node as first child

Parameters:
node the tree node to insert

Definition at line 185 of file folder.cpp.

void Akregator::Folder::removeChild (  TreeNode *  node  )  [virtual]
 

remove node from children.

Note that node will not be deleted

Parameters:
node the child node to remove

Definition at line 202 of file folder.cpp.

void Akregator::Folder::setOpen (  bool  open  )  [virtual]
 

open/close the feed group (display it as expanded/collapsed in the tree view).

Use only in FolderItem.

Definition at line 235 of file folder.cpp.

void Akregator::Folder::signalChildAdded (  TreeNode *   )  [signal]
 

emitted when a child was added

void Akregator::Folder::signalChildRemoved (  Folder *  ,
TreeNode * 
)  [signal]
 

emitted when a child was removed

void Akregator::Folder::slotAddToFetchQueue (  FetchQueue *  queue,
bool  intervalFetchesOnly = false
)  [virtual, slot]
 

enqueues children recursively for fetching

Parameters:
queue a fetch queue
internvalFetchesOnly 

Implements Akregator::TreeNode.

Definition at line 298 of file folder.cpp.

void Akregator::Folder::slotChildChanged (  TreeNode *  node  )  [virtual, slot]
 

Called when a child was modified.

Parameters:
node the child that was changed

Definition at line 276 of file folder.cpp.

void Akregator::Folder::slotChildDestroyed (  TreeNode *  node  )  [virtual, slot]
 

Called when a child was destroyed.

Parameters:
node the child that was destroyed

Definition at line 282 of file folder.cpp.

void Akregator::Folder::slotDeleteExpiredArticles (   )  [virtual, slot]
 

Delete expired articles recursively.

Implements Akregator::TreeNode.

Definition at line 289 of file folder.cpp.

void Akregator::Folder::slotMarkAllArticlesAsRead (   )  [virtual, slot]
 

Mark articles of children recursively as read.

Implements Akregator::TreeNode.

Definition at line 267 of file folder.cpp.

QStringList Akregator::Folder::tags (   )  const [virtual]
 

returns a list of all tags occurring in the subtree of this folder

Implements Akregator::TreeNode.

Definition at line 93 of file folder.cpp.

QDomElement Akregator::Folder::toOPML (  QDomElement  parent,
QDomDocument  document
)  const [virtual]
 

converts the feed group into OPML format for save and export and appends it to node parent in document .

Children are processed and appended recursively.

Parameters:
parent The parent element
document The DOM document
Returns:
The newly created element representing this feed group

Implements Akregator::TreeNode.

Reimplemented in Akregator::TagFolder.

Definition at line 118 of file folder.cpp.

int Akregator::Folder::totalCount (   )  const [virtual]
 

returns the number of articles in all children

Returns:
number of articles

Implements Akregator::TreeNode.

Definition at line 245 of file folder.cpp.

int Akregator::Folder::unread (   )  const [virtual]
 

returns the number of unread articles in all children

Returns:
number of unread articles

Implements Akregator::TreeNode.

Definition at line 240 of file folder.cpp.


The documentation for this class was generated from the following files:
KDE Home | KDE Accessibility Home | Description of Access Keys