KBookmark Class Reference

Inheritance diagram for KBookmark:

KBookmarkGroup List of all members.

Detailed Description

Definition at line 31 of file kbookmark.h.


Public Types

enum  MetaDataOverwriteMode { OverwriteMetaData, DontOverwriteMetaData }

Public Member Functions

 KBookmark ()
 KBookmark (QDomElement elem)
bool isGroup () const
bool isSeparator () const
bool isNull () const
bool hasParent () const
QString text () const
QString fullText () const
KURL url () const
QString icon () const
KBookmarkGroup parentGroup () const
KBookmarkGroup toGroup () const
QString address () const
QDomElement internalElement () const
void updateAccessMetadata ()
QString metaDataItem (const QString &key) const
void setMetaDataItem (const QString &key, const QString &value, MetaDataOverwriteMode mode=OverwriteMetaData)

Static Public Member Functions

static KBookmark standaloneBookmark (const QString &text, const KURL &url, const QString &icon=QString::null)
static QString parentAddress (const QString &address)
static uint positionInParent (const QString &address)
static QString previousAddress (const QString &address)
static QString nextAddress (const QString &address)
static QString commonParent (QString A, QString B)

Protected Attributes

QDomElement element

Friends

class KBookmarkGroup

Member Function Documentation

bool KBookmark::isGroup (  )  const

Whether the bookmark is a group or a normal bookmark.

Definition at line 260 of file kbookmark.cc.

bool KBookmark::isSeparator (  )  const

Whether the bookmark is a separator.

Definition at line 267 of file kbookmark.cc.

bool KBookmark::isNull (  )  const [inline]

Returns:
true if this is a null bookmark.

This will never be the case for a real bookmark (in a menu), but it's used for instance as the end condition for KBookmarkGroup::next()

Definition at line 59 of file kbookmark.h.

bool KBookmark::hasParent (  )  const

Returns:
true if bookmark is contained by a QDomDocument, if not it is most likely that it has become separated and is thus invalid and/or has been deleted from the bookmarks.

Since:
3.2

Definition at line 272 of file kbookmark.cc.

QString KBookmark::text (  )  const

Text shown for the bookmark If bigger than 40, the text is shortened by replacing middle characters with "..." (see KStringHandler::csqueeze).

Definition at line 278 of file kbookmark.cc.

QString KBookmark::fullText (  )  const

Text shown for the bookmark, not truncated.

You should not use this - this is mainly for keditbookmarks.

Definition at line 283 of file kbookmark.cc.

KURL KBookmark::url (  )  const

URL contained by the bookmark.

Definition at line 291 of file kbookmark.cc.

QString KBookmark::icon (  )  const

Returns:
the pixmap file for this bookmark (i.e.

the name of the icon)

Definition at line 296 of file kbookmark.cc.

KBookmarkGroup KBookmark::parentGroup (  )  const

Returns:
the group containing this bookmark

Definition at line 312 of file kbookmark.cc.

KBookmarkGroup KBookmark::toGroup (  )  const

Convert this to a group - do this only if isGroup() returns true.

Definition at line 317 of file kbookmark.cc.

QString KBookmark::address (  )  const

Return the "address" of this bookmark in the whole tree.

This is used when telling other processes about a change in a given bookmark. The encoding of the address is "/4/2", for instance, to design the 2nd child inside the 4th child of the root bk.

Definition at line 323 of file kbookmark.cc.

void KBookmark::updateAccessMetadata (  ) 

Updates the bookmarks access metadata Call when a user accesses the bookmark.

Since:
3.2

Definition at line 446 of file kbookmark.cc.

static QString KBookmark::parentAddress ( const QString address  )  [inline, static]

Returns:
address of parent

Definition at line 132 of file kbookmark.h.

static uint KBookmark::positionInParent ( const QString address  )  [inline, static]

Returns:
position in parent (e.g.

/4/5/2 -> 2)

Definition at line 138 of file kbookmark.h.

static QString KBookmark::previousAddress ( const QString address  )  [inline, static]

Returns:
address of previous sibling (e.g.

/4/5/2 -> /4/5/1) Returns QString::null for a first child

Definition at line 145 of file kbookmark.h.

static QString KBookmark::nextAddress ( const QString address  )  [inline, static]

Returns:
address of next sibling (e.g.

/4/5/2 -> /4/5/3) This doesn't check whether it actually exists

Definition at line 155 of file kbookmark.h.

QString KBookmark::commonParent ( QString  A,
QString  B 
) [static]

Returns:
the common parent of both addresses which has the greatest depth

Since:
3.5

Definition at line 371 of file kbookmark.cc.

QString KBookmark::metaDataItem ( const QString key  )  const

Get the value of a specific metadata item.

Parameters:
key Name of the metadata item
Returns:
Value of the metadata item. QString::null is returned in case the specified key does not exist.
Since:
3.4

Definition at line 465 of file kbookmark.cc.

void KBookmark::setMetaDataItem ( const QString key,
const QString value,
MetaDataOverwriteMode  mode = OverwriteMetaData 
)

Change the value of a specific metadata item, or create the given item if it doesn't exist already.

Parameters:
key Name of the metadata item to change
value Value to use for the specified metadata item
mode Whether to overwrite the item's value if it exists already or not.
Since:
3.4

Definition at line 481 of file kbookmark.cc.


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