Sophie

Sophie

distrib > PLD > ac > amd64 > media > dist > by-pkgid > 90467ea6a387df728f7218a11e972208 > files > 6544

kdelibs-apidocs-3.5.6-3.amd64.rpm

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US">

<head>
  <title>kio/bookmarks: KBookmark Class Reference (kio/bookmarks)</title>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

  <meta http-equiv="Content-Style-Type" content="text/css" />

  <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org"  r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org"  r (n 0 s 0 v 0 l 0))' />

  <meta name="trademark" content="KDE e.V." />
  <meta name="description" content="K Desktop Environment Homepage, KDE.org" />
  <meta name="MSSmartTagsPreventParsing" content="true" />
  <meta name="robots" content="all" />

  <link rel="shortcut icon" href="../../../favicon.ico" />

<link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" />



</head>

<body>

<div id="nav_header_top" align="right">
  <a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a>

  <a href="../../.."><img id="nav_header_logo" alt="Home" align="left" src="../../../kde_gear_64.png" border="0" /></a>
  <span class="doNotDisplay">::</span>

  <div id="nav_header_title" align="left">KDE API Reference</div>


</div>

<div id="nav_header_bottom" align="right">
  <span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span>
  <div id="nav_header_bottom_right" style="text-align: left;">
/ <a href="../../..">API Reference</a>
 / <a href="../../html/index.html">kio</a> / <a href=".">bookmarks</a>
  </div>
</div>


<table id="main" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
      <td valign="top" class="menuheader" height="0"></td>

  <td id="contentcolumn" valign="top" rowspan="2" >
    <div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;">
    <a name="content"></a>


<!-- Generated by Doxygen 1.4.4 -->
<h1>KBookmark Class Reference</h1><!-- doxytag: class="KBookmark" --><p>Inheritance diagram for KBookmark:
<p><center><img src="classKBookmark.png" usemap="#KBookmark_map" border="0" alt=""></center>
<map name="KBookmark_map">
<area href="classKBookmarkGroup.html" alt="KBookmarkGroup" shape="rect" coords="0,56,110,80">
</map>
<a href="classKBookmark-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2>

<p>

<p>
Definition at line <a class="el" href="kbookmark_8h-source.html#l00031">31</a> of file <a class="el" href="kbookmark_8h-source.html">kbookmark.h</a>.<table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Types</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">enum &nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#w2">MetaDataOverwriteMode</a> { <b>OverwriteMetaData</b>, 
<b>DontOverwriteMetaData</b>
 }</td></tr>

<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a0"></a><!-- doxytag: member="KBookmark::KBookmark" ref="a0" args="()" -->
&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a0">KBookmark</a> ()</td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a1"></a><!-- doxytag: member="KBookmark::KBookmark" ref="a1" args="(QDomElement elem)" -->
&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a1">KBookmark</a> (<a class="elRef" doxygen="qt.tag:" href="qdomelement.html">QDomElement</a> elem)</td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a2">isGroup</a> () const </td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a3">isSeparator</a> () const </td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a4">isNull</a> () const </td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a5">hasParent</a> () const </td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a6">text</a> () const </td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a7">fullText</a> () const </td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">KURL&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a8">url</a> () const </td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a9">icon</a> () const </td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classKBookmarkGroup.html">KBookmarkGroup</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a10">parentGroup</a> () const </td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classKBookmarkGroup.html">KBookmarkGroup</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a11">toGroup</a> () const </td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a12">address</a> () const </td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a13"></a><!-- doxytag: member="KBookmark::internalElement" ref="a13" args="() const " -->
<a class="elRef" doxygen="qt.tag:" href="qdomelement.html">QDomElement</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a13">internalElement</a> () const </td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a14">updateAccessMetadata</a> ()</td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a15">metaDataItem</a> (const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;key) const </td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#a16">setMetaDataItem</a> (const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;key, const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;value, <a class="el" href="classKBookmark.html#w2">MetaDataOverwriteMode</a> mode=OverwriteMetaData)</td></tr>

<tr><td colspan="2"><br><h2>Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="e0"></a><!-- doxytag: member="KBookmark::standaloneBookmark" ref="e0" args="(const QString &amp;text, const KURL &amp;url, const QString &amp;icon=QString::null)" -->
static <a class="el" href="classKBookmark.html">KBookmark</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#e0">standaloneBookmark</a> (const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;text, const KURL &amp;url, const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;icon=QString::null)</td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#e1">parentAddress</a> (const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;address)</td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">static uint&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#e2">positionInParent</a> (const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;address)</td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#e3">previousAddress</a> (const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;address)</td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#e4">nextAddress</a> (const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;address)</td></tr>

<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#e5">commonParent</a> (<a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> A, <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> B)</td></tr>

<tr><td colspan="2"><br><h2>Protected Attributes</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="p0"></a><!-- doxytag: member="KBookmark::element" ref="p0" args="" -->
<a class="elRef" doxygen="qt.tag:" href="qdomelement.html">QDomElement</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#p0">element</a></td></tr>

<tr><td colspan="2"><br><h2>Friends</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="n0"></a><!-- doxytag: member="KBookmark::KBookmarkGroup" ref="n0" args="" -->
class&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKBookmark.html#n0">KBookmarkGroup</a></td></tr>

</table>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="a12"></a><!-- doxytag: member="KBookmark::address" ref="a12" args="() const " --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> KBookmark::address           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap> const</td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Return the "address" of this bookmark in the whole tree. 
<p>
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.
<p>
Definition at line <a class="el" href="kbookmark_8cc-source.html#l00323">323</a> of file <a class="el" href="kbookmark_8cc-source.html">kbookmark.cc</a>.    </td>
  </tr>
</table>
<a class="anchor" name="e5"></a><!-- doxytag: member="KBookmark::commonParent" ref="e5" args="(QString A, QString B)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> KBookmark::commonParent           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>A</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>B</em></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"><code> [static]</code></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
<dl compact><dt><b>Returns:</b></dt><dd>the common parent of both addresses which has the greatest depth </dd></dl>
<dl compact><dt><b>Since:</b></dt><dd>3.5</dd></dl>

<p>
Definition at line <a class="el" href="kbookmark_8cc-source.html#l00371">371</a> of file <a class="el" href="kbookmark_8cc-source.html">kbookmark.cc</a>.    </td>
  </tr>
</table>
<a class="anchor" name="a7"></a><!-- doxytag: member="KBookmark::fullText" ref="a7" args="() const " --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> KBookmark::fullText           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap> const</td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Text shown for the bookmark, not truncated. 
<p>
You should not use this - this is mainly for keditbookmarks.
<p>
Definition at line <a class="el" href="kbookmark_8cc-source.html#l00283">283</a> of file <a class="el" href="kbookmark_8cc-source.html">kbookmark.cc</a>.    </td>
  </tr>
</table>
<a class="anchor" name="a5"></a><!-- doxytag: member="KBookmark::hasParent" ref="a5" args="() const " --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">bool KBookmark::hasParent           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap> const</td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
<dl compact><dt><b>Returns:</b></dt><dd>true if bookmark is contained by a <a class="elRef" doxygen="qt.tag:" href="qdomdocument.html">QDomDocument</a>, if not it is most likely that it has become separated and is thus invalid and/or has been deleted from the bookmarks. </dd></dl>
<dl compact><dt><b>Since:</b></dt><dd>3.2</dd></dl>

<p>
Definition at line <a class="el" href="kbookmark_8cc-source.html#l00272">272</a> of file <a class="el" href="kbookmark_8cc-source.html">kbookmark.cc</a>.    </td>
  </tr>
</table>
<a class="anchor" name="a9"></a><!-- doxytag: member="KBookmark::icon" ref="a9" args="() const " --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> KBookmark::icon           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap> const</td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
<dl compact><dt><b>Returns:</b></dt><dd>the pixmap file for this bookmark (i.e. the name of the icon)</dd></dl>

<p>
Definition at line <a class="el" href="kbookmark_8cc-source.html#l00296">296</a> of file <a class="el" href="kbookmark_8cc-source.html">kbookmark.cc</a>.    </td>
  </tr>
</table>
<a class="anchor" name="a2"></a><!-- doxytag: member="KBookmark::isGroup" ref="a2" args="() const " --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">bool KBookmark::isGroup           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap> const</td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Whether the bookmark is a group or a normal bookmark. 
<p>

<p>
Definition at line <a class="el" href="kbookmark_8cc-source.html#l00260">260</a> of file <a class="el" href="kbookmark_8cc-source.html">kbookmark.cc</a>.    </td>
  </tr>
</table>
<a class="anchor" name="a4"></a><!-- doxytag: member="KBookmark::isNull" ref="a4" args="() const " --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">bool KBookmark::isNull           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap> const<code> [inline]</code></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
<dl compact><dt><b>Returns:</b></dt><dd>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 <a class="el" href="classKBookmarkGroup.html#a6">KBookmarkGroup::next()</a></dd></dl>

<p>
Definition at line <a class="el" href="kbookmark_8h-source.html#l00059">59</a> of file <a class="el" href="kbookmark_8h-source.html">kbookmark.h</a>.    </td>
  </tr>
</table>
<a class="anchor" name="a3"></a><!-- doxytag: member="KBookmark::isSeparator" ref="a3" args="() const " --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">bool KBookmark::isSeparator           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap> const</td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Whether the bookmark is a separator. 
<p>

<p>
Definition at line <a class="el" href="kbookmark_8cc-source.html#l00267">267</a> of file <a class="el" href="kbookmark_8cc-source.html">kbookmark.cc</a>.    </td>
  </tr>
</table>
<a class="anchor" name="a15"></a><!-- doxytag: member="KBookmark::metaDataItem" ref="a15" args="(const QString &amp;key) const " --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> KBookmark::metaDataItem           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>key</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap> const</td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Get the value of a specific metadata item. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>Name of the metadata item </td></tr>
  </table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>Value of the metadata item. QString::null is returned in case the specified key does not exist. </dd></dl>
<dl compact><dt><b>Since:</b></dt><dd>3.4</dd></dl>

<p>
Definition at line <a class="el" href="kbookmark_8cc-source.html#l00465">465</a> of file <a class="el" href="kbookmark_8cc-source.html">kbookmark.cc</a>.    </td>
  </tr>
</table>
<a class="anchor" name="e4"></a><!-- doxytag: member="KBookmark::nextAddress" ref="e4" args="(const QString &amp;address)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">static <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> KBookmark::nextAddress           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>address</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap><code> [inline, static]</code></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
<dl compact><dt><b>Returns:</b></dt><dd>address of next sibling (e.g. /4/5/2 -&gt; /4/5/3) This doesn't check whether it actually exists</dd></dl>

<p>
Definition at line <a class="el" href="kbookmark_8h-source.html#l00155">155</a> of file <a class="el" href="kbookmark_8h-source.html">kbookmark.h</a>.    </td>
  </tr>
</table>
<a class="anchor" name="e1"></a><!-- doxytag: member="KBookmark::parentAddress" ref="e1" args="(const QString &amp;address)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">static <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> KBookmark::parentAddress           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>address</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap><code> [inline, static]</code></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
<dl compact><dt><b>Returns:</b></dt><dd>address of parent</dd></dl>

<p>
Definition at line <a class="el" href="kbookmark_8h-source.html#l00132">132</a> of file <a class="el" href="kbookmark_8h-source.html">kbookmark.h</a>.    </td>
  </tr>
</table>
<a class="anchor" name="a10"></a><!-- doxytag: member="KBookmark::parentGroup" ref="a10" args="() const " --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"><a class="el" href="classKBookmarkGroup.html">KBookmarkGroup</a> KBookmark::parentGroup           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap> const</td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
<dl compact><dt><b>Returns:</b></dt><dd>the group containing this bookmark</dd></dl>

<p>
Definition at line <a class="el" href="kbookmark_8cc-source.html#l00312">312</a> of file <a class="el" href="kbookmark_8cc-source.html">kbookmark.cc</a>.    </td>
  </tr>
</table>
<a class="anchor" name="e2"></a><!-- doxytag: member="KBookmark::positionInParent" ref="e2" args="(const QString &amp;address)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">static uint KBookmark::positionInParent           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>address</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap><code> [inline, static]</code></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
<dl compact><dt><b>Returns:</b></dt><dd>position in parent (e.g. /4/5/2 -&gt; 2)</dd></dl>

<p>
Definition at line <a class="el" href="kbookmark_8h-source.html#l00138">138</a> of file <a class="el" href="kbookmark_8h-source.html">kbookmark.h</a>.    </td>
  </tr>
</table>
<a class="anchor" name="e3"></a><!-- doxytag: member="KBookmark::previousAddress" ref="e3" args="(const QString &amp;address)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">static <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> KBookmark::previousAddress           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;&nbsp;</td>
          <td class="mdname1" valign="top" nowrap> <em>address</em>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap><code> [inline, static]</code></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
<dl compact><dt><b>Returns:</b></dt><dd>address of previous sibling (e.g. /4/5/2 -&gt; /4/5/1) Returns QString::null for a first child</dd></dl>

<p>
Definition at line <a class="el" href="kbookmark_8h-source.html#l00145">145</a> of file <a class="el" href="kbookmark_8h-source.html">kbookmark.h</a>.    </td>
  </tr>
</table>
<a class="anchor" name="a16"></a><!-- doxytag: member="KBookmark::setMetaDataItem" ref="a16" args="(const QString &amp;key, const QString &amp;value, MetaDataOverwriteMode mode=OverwriteMetaData)" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">void KBookmark::setMetaDataItem           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="md" nowrap valign="top">const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;&nbsp;</td>
          <td class="mdname" nowrap> <em>key</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap>const <a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> &amp;&nbsp;</td>
          <td class="mdname" nowrap> <em>value</em>, </td>
        </tr>
        <tr>
          <td class="md" nowrap align="right"></td>
          <td class="md"></td>
          <td class="md" nowrap><a class="el" href="classKBookmark.html#w2">MetaDataOverwriteMode</a>&nbsp;</td>
          <td class="mdname" nowrap> <em>mode</em> = <code>OverwriteMetaData</code></td>
        </tr>
        <tr>
          <td class="md"></td>
          <td class="md">)&nbsp;</td>
          <td class="md" colspan="2"></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Change the value of a specific metadata item, or create the given item if it doesn't exist already. 
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>key</em>&nbsp;</td><td>Name of the metadata item to change </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>Value to use for the specified metadata item </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>mode</em>&nbsp;</td><td>Whether to overwrite the item's value if it exists already or not. </td></tr>
  </table>
</dl>
<dl compact><dt><b>Since:</b></dt><dd>3.4</dd></dl>

<p>
Definition at line <a class="el" href="kbookmark_8cc-source.html#l00481">481</a> of file <a class="el" href="kbookmark_8cc-source.html">kbookmark.cc</a>.    </td>
  </tr>
</table>
<a class="anchor" name="a6"></a><!-- doxytag: member="KBookmark::text" ref="a6" args="() const " --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"><a class="elRef" doxygen="qt.tag:" href="qstring.html">QString</a> KBookmark::text           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap> const</td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

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

<p>
Definition at line <a class="el" href="kbookmark_8cc-source.html#l00278">278</a> of file <a class="el" href="kbookmark_8cc-source.html">kbookmark.cc</a>.    </td>
  </tr>
</table>
<a class="anchor" name="a11"></a><!-- doxytag: member="KBookmark::toGroup" ref="a11" args="() const " --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top"><a class="el" href="classKBookmarkGroup.html">KBookmarkGroup</a> KBookmark::toGroup           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap> const</td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Convert this to a group - do this only if <a class="el" href="classKBookmark.html#a2">isGroup()</a> returns true. 
<p>

<p>
Definition at line <a class="el" href="kbookmark_8cc-source.html#l00317">317</a> of file <a class="el" href="kbookmark_8cc-source.html">kbookmark.cc</a>.    </td>
  </tr>
</table>
<a class="anchor" name="a14"></a><!-- doxytag: member="KBookmark::updateAccessMetadata" ref="a14" args="()" --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">void KBookmark::updateAccessMetadata           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap></td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
Updates the bookmarks access metadata Call when a user accesses the bookmark. 
<p>
<dl compact><dt><b>Since:</b></dt><dd>3.2</dd></dl>

<p>
Definition at line <a class="el" href="kbookmark_8cc-source.html#l00446">446</a> of file <a class="el" href="kbookmark_8cc-source.html">kbookmark.cc</a>.    </td>
  </tr>
</table>
<a class="anchor" name="a8"></a><!-- doxytag: member="KBookmark::url" ref="a8" args="() const " --><p>
<table class="mdTable" cellpadding="2" cellspacing="0">
  <tr>
    <td class="mdRow">
      <table cellpadding="0" cellspacing="0" border="0">
        <tr>
          <td class="md" nowrap valign="top">KURL KBookmark::url           </td>
          <td class="md" valign="top">(&nbsp;</td>
          <td class="mdname1" valign="top" nowrap>          </td>
          <td class="md" valign="top">&nbsp;)&nbsp;</td>
          <td class="md" nowrap> const</td>
        </tr>
      </table>
    </td>
  </tr>
</table>
<table cellspacing="5" cellpadding="0" border="0">
  <tr>
    <td>
      &nbsp;
    </td>
    <td>

<p>
URL contained by the bookmark. 
<p>

<p>
Definition at line <a class="el" href="kbookmark_8cc-source.html#l00291">291</a> of file <a class="el" href="kbookmark_8cc-source.html">kbookmark.cc</a>.    </td>
  </tr>
</table>
<hr>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="kbookmark_8h-source.html">kbookmark.h</a><li><a class="el" href="kbookmark_8cc-source.html">kbookmark.cc</a></ul>
    </div></div>


      </td>
  </tr>
  <tr>
    <td valign="top" id="leftmenu" width="25%">
      <a name="navigation"></a>
      <div class="menu_box"><h2>kio/bookmarks</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="dirs.html">Directories</a></li><li><a href="functions.html">Class Members</a></li><li><a href="pages.html">Related Pages</a></li></ul>
<!--
<h2>Class Picker</h2>
<div style="text-align: center;">
<form name="guideform">
<select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value">
<option value="annotated.html">-- Choose --</option>
  <option value="classKBookmark.html">kbookmark</option>,  <option value="classKBookmarkBar.html">kbookmarkbar</option>,  <option value="classKBookmarkDomBuilder.html">kbookmarkdombuilder</option>,  <option value="classKBookmarkDrag.html">kbookmarkdrag</option>,  <option value="classKBookmarkExporterBase.html">kbookmarkexporterbase</option>,  <option value="classKBookmarkGroup.html">kbookmarkgroup</option>,  <option value="classKBookmarkGroupTraverser.html">kbookmarkgrouptraverser</option>,  <option value="classKBookmarkImporter.html">kbookmarkimporter</option>,  <option value="classKBookmarkImporterBase.html">kbookmarkimporterbase</option>,  <option value="classKBookmarkManager.html">kbookmarkmanager</option>,  <option value="classKBookmarkMenu.html">kbookmarkmenu</option>,  <option value="classKBookmarkMenuNSImporter.html">kbookmarkmenunsimporter</option>,  <option value="classKBookmarkNotifier.html">kbookmarknotifier</option>,  <option value="classKBookmarkOwner.html">kbookmarkowner</option>,  <option value="classKCrashBookmarkImporter.html">kcrashbookmarkimporter</option>,  <option value="classKCrashBookmarkImporterImpl.html">kcrashbookmarkimporterimpl</option>,  <option value="classKExtendedBookmarkOwner.html">kextendedbookmarkowner</option>,  <option value="classKIEBookmarkExporterImpl.html">kiebookmarkexporterimpl</option>,  <option value="classKIEBookmarkImporter.html">kiebookmarkimporter</option>,  <option value="classKIEBookmarkImporterImpl.html">kiebookmarkimporterimpl</option>,  <option value="classKMozillaBookmarkImporterImpl.html">kmozillabookmarkimporterimpl</option>,  <option value="classKNSBookmarkExporter.html">knsbookmarkexporter</option>,  <option value="classKNSBookmarkExporterImpl.html">knsbookmarkexporterimpl</option>,  <option value="classKNSBookmarkImporter.html">knsbookmarkimporter</option>,  <option value="classKNSBookmarkImporterImpl.html">knsbookmarkimporterimpl</option>,  <option value="classKOperaBookmarkExporterImpl.html">koperabookmarkexporterimpl</option>,  <option value="classKOperaBookmarkImporter.html">koperabookmarkimporter</option>,  <option value="classKOperaBookmarkImporterImpl.html">koperabookmarkimporterimpl</option>,  <option value="classKXBELBookmarkImporterImpl.html">kxbelbookmarkimporterimpl</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../../arts/html/index.html">arts</a></li><li><a href="../../../dcop/html/index.html">dcop</a></li><li><a href="../../../dnssd/html/index.html">dnssd</a></li><li><a href="../../../interfaces/html/index.html">interfaces</a></li><li>&nbsp;&nbsp;&nbsp;&nbsp;<a href="../../../interfaces/kimproxy/interface/html/index.html">interface</a></li><li>&nbsp;&nbsp;&nbsp;&nbsp;<a href="../../../interfaces/kimproxy/library/html/index.html">library</a></li><li>&nbsp;&nbsp;<a href="../../../interfaces/kspeech/html/index.html">kspeech</a></li><li>&nbsp;&nbsp;<a href="../../../interfaces/ktexteditor/html/index.html">ktexteditor</a></li><li><a href="../../../kabc/html/index.html">kabc</a></li><li><a href="../../../kate/html/index.html">kate</a></li><li><a href="../../../kcmshell/html/index.html">kcmshell</a></li><li><a href="../../../kdecore/html/index.html">kdecore</a></li><li><a href="../../../kded/html/index.html">kded</a></li><li><a href="../../../kdefx/html/index.html">kdefx</a></li><li><a href="../../../kdeprint/html/index.html">kdeprint</a></li><li><a href="../../../kdesu/html/index.html">kdesu</a></li><li><a href="../../../kdeui/html/index.html">kdeui</a></li><li><a href="../../../kdoctools/html/index.html">kdoctools</a></li><li><a href="../../../khtml/html/index.html">khtml</a></li><li><a href="../../../kimgio/html/index.html">kimgio</a></li><li><a href="../../../kinit/html/index.html">kinit</a></li><li><a href="../../../kio/html/index.html">kio</a></li><li>&nbsp;&nbsp;<a href="../../../kio/bookmarks/html/index.html">bookmarks</a></li><li>&nbsp;&nbsp;<a href="../../../kio/httpfilter/html/index.html">httpfilter</a></li><li>&nbsp;&nbsp;<a href="../../../kio/kfile/html/index.html">kfile</a></li><li>&nbsp;&nbsp;<a href="../../../kio/kio/html/index.html">kio</a></li><li>&nbsp;&nbsp;<a href="../../../kio/kioexec/html/index.html">kioexec</a></li><li>&nbsp;&nbsp;<a href="../../../kio/kpasswdserver/html/index.html">kpasswdserver</a></li><li>&nbsp;&nbsp;<a href="../../../kio/kssl/html/index.html">kssl</a></li><li><a href="../../../kioslave/html/index.html">kioslave</a></li><li>&nbsp;&nbsp;<a href="../../../kioslave/http/html/index.html">http</a></li><li><a href="../../../kjs/html/index.html">kjs</a></li><li><a href="../../../kmdi/html/index.html">kmdi</a></li><li>&nbsp;&nbsp;<a href="../../../kmdi/kmdi/html/index.html">kmdi</a></li><li><a href="../../../knewstuff/html/index.html">knewstuff</a></li><li><a href="../../../kparts/html/index.html">kparts</a></li><li><a href="../../../kresources/html/index.html">kresources</a></li><li><a href="../../../kspell2/html/index.html">kspell2</a></li><li><a href="../../../kunittest/html/index.html">kunittest</a></li><li><a href="../../../kutils/html/index.html">kutils</a></li><li><a href="../../../kwallet/html/index.html">kwallet</a></li><li><a href="../../../libkmid/html/index.html">libkmid</a></li><li><a href="../../../libkscreensaver/html/index.html">libkscreensaver</a></li>
</ul></div></div>


        </td>
</tr>
</table>

<span class="doNotDisplay">
  <a href="http://www.kde.org/" accesskey="8">KDE Home</a> |
  <a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> |
  <a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a>
</span>


<div style="height: 8px"></div>

<div id="footer">
  <div id="footer_left">
    Maintained by <a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;groo&#116;&#64;kde&#46;or&#x67;">Adriaan de Groot</a>
and
<a href="&#109;a&#105;&#108;&#116;&#111;&#58;w&#105;nter&#64;kde&#46;or&#x67">Allen Winter</a>.
<br/>
    KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
    <a href="http://www.kde.org/contact/impressum.php">Legal</a>
  </div>
  <div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div>
</div>

<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a>
WARNING END
-->

</body>
</html>