Sophie

Sophie

distrib > Fedora > 15 > i386 > by-pkgid > 1f9eb832ba1e4b88d9a5c2b384813bb4 > files > 5325

kdelibs3-apidocs-3.5.10-31.fc15.noarch.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/kio: KService Class Reference (kio/kio)</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=".">kio</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.7.4 -->
</div>
<div class="header">
  <div class="summary">
<a href="#pub-types">Public Types</a> &#124;
<a href="#pub-methods">Public Member Functions</a> &#124;
<a href="#pub-static-methods">Static Public Member Functions</a> &#124;
<a href="#pro-methods">Protected Member Functions</a> &#124;
<a href="#friends">Friends</a>  </div>
  <div class="headertitle">
<div class="title">KService Class Reference</div>  </div>
</div>
<div class="contents">
<!-- doxytag: class="KService" --><!-- doxytag: inherits="KSycocaEntry" -->
<p>Represent a service, i.e.  
 <a href="classKService.html#details">More...</a></p>

<p><code>#include &lt;<a class="el" href="kservice_8h_source.html">kservice.h</a>&gt;</code></p>

<p>Inherits KSycocaEntry.</p>

<p><a href="classKService-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-types"></a>
Public Types</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a49cfeaf0ab4bc79ddd8431cff9bdfb54">DCOPServiceType_t</a> { <b>DCOP_None</b> =  0, 
<b>DCOP_Unique</b>, 
<b>DCOP_Multi</b>, 
<b>DCOP_Wait</b>
 }</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a1f779f61688fa83379c3f365cd578118"></a><!-- doxytag: member="KService::Ptr" ref="a1f779f61688fa83379c3f365cd578118" args="" -->
typedef KSharedPtr&lt; <a class="el" href="classKService.html">KService</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><b>Ptr</b></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a4201c09633fc84094eb08471477a5add"></a><!-- doxytag: member="KService::List" ref="a4201c09633fc84094eb08471477a5add" args="" -->
typedef <a class="elRef" href="qvaluelist.html">QValueList</a>&lt; Ptr &gt;&#160;</td><td class="memItemRight" valign="bottom"><b>List</b></td></tr>
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#aab3d8df61ef3e8235cf3cd4b2bacb0d9">KService</a> (const <a class="elRef" href="qstring.html">QString</a> &amp;_name, const <a class="elRef" href="qstring.html">QString</a> &amp;_exec, const <a class="elRef" href="qstring.html">QString</a> &amp;_icon)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#acd38f5cbc0fefe9167e1e257173828e6">KService</a> (const <a class="elRef" href="qstring.html">QString</a> &amp;_fullpath)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a4c84abc04ccb2829b458c52144426b14">KService</a> (KDesktopFile *config)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a75a9d95aa4986fe71ed5ae3fa296f173"></a><!-- doxytag: member="KService::KService" ref="a75a9d95aa4986fe71ed5ae3fa296f173" args="(QDataStream &amp;_str, int offset)" -->
&#160;</td><td class="memItemRight" valign="bottom"><b>KService</b> (<a class="elRef" href="qdatastream.html">QDataStream</a> &amp;_str, int offset)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a505ad4cbc782d8c84807aeb11ebef524">type</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a206dd1927ae8f591074630c370cc39ee">name</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a4a0471572826ed8239b85505506b4c7c">exec</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a9303af3fb47133be225ac78c6c360a19">library</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a369f43e5174e6594137b5806befa1721">init</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a96986870204859dc90f9dbb1d432bc15">icon</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qpixmap.html">QPixmap</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#abfaeb01482b8741bc5de9a5989836779">pixmap</a> (KIcon::Group _group, int _force_size=0, int _state=0, <a class="elRef" href="qstring.html">QString</a> *_path=0L) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#abf2c177682346064525deb776da4f25a">terminal</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a4c5b41b17fcce96710b6fe2b94ad9e86">terminalOptions</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a05759a1d0acfbb9997b95907c2afa688">substituteUid</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a031e97e187d994c45770bd0d1ac0c469">username</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a1dd162ea11b51511a37d202202aa96f1">desktopEntryPath</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a46068cdfad6f69c7e24992291cc879d0">desktopEntryName</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a4331b4c5b266867c2ddd4889506450ff">menuId</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a6d2da40ed48d4d4b9c459c1051732e0e">storageId</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classKService.html#a49cfeaf0ab4bc79ddd8431cff9bdfb54">DCOPServiceType_t</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a51f8f4f8bfb3a9e5d0a255149f6f1816">DCOPServiceType</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a7377fcd95d57c81a01e2f270da6aec1d">path</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a48940c24aff77894d6968b648b6576ff">comment</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a47dbda7e8dccadfdfee9fcc30971a11a">genericName</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a84b1cf958ffab69a1de6181925ca2114">untranslatedGenericName</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstringlist.html">QStringList</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#af770ba5a418ed2b0c8dfa5d014536e7c">keywords</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstringlist.html">QStringList</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a4c6cf9950455ee6c256fed7a265e1993">categories</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstringlist.html">QStringList</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#ab3b88547fc09b49e5afb0d3dcc02115c">serviceTypes</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a629396ef81d10adebe0deaaa7cd9e402">hasServiceType</a> (const <a class="elRef" href="qstring.html">QString</a> &amp;_service) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a9742aaf6682d554d7fd1f8e8551fe1c0">allowAsDefault</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a754d3fe8b55e138d1f8c773f1606df4a">allowMultipleFiles</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a7d27ce369e125362a3f80a333fe37969">initialPreference</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#af6d5fb5966bd073f05da1620216a32cf">initialPreferenceForMimeType</a> (const <a class="elRef" href="qstring.html">QString</a> &amp;mimeType) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aa3d54ee2f3d73752d80a92ab3dbd19f9"></a><!-- doxytag: member="KService::setInitialPreference" ref="aa3d54ee2f3d73752d80a92ab3dbd19f9" args="(int i)" -->
void&#160;</td><td class="memItemRight" valign="bottom"><b>setInitialPreference</b> (int i)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a161366b96d53bf3fba5739b0064d0ea2">noDisplay</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#ab67d01a8b6e4be0a64f3c9091098da72">parentApp</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="elRef" href="qvariant.html">QVariant</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#aebaff8ace9dc52f73326b3086a6b687a">property</a> (const <a class="elRef" href="qstring.html">QString</a> &amp;_name) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qvariant.html">QVariant</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#ac387e93eb31e981f5588c6b4912f631e">property</a> (const <a class="elRef" href="qstring.html">QString</a> &amp;_name, QVariant::Type t) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual <a class="elRef" href="qstringlist.html">QStringList</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a21c4b5dc07007f443bc73543d4baae10">propertyNames</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a6a414d83c6fde6520e64d89bd844681b">isValid</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#af6cd1c31634aa86c0eadaa5be91c6f9a">locateLocal</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a9006c617fce47290ed072ae0f80d3d59"></a><!-- doxytag: member="KService::load" ref="a9006c617fce47290ed072ae0f80d3d59" args="(QDataStream &amp;)" -->
virtual void&#160;</td><td class="memItemRight" valign="bottom"><b>load</b> (<a class="elRef" href="qdatastream.html">QDataStream</a> &amp;)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="abc7f163ef4e070162976cb6e938b6b1e"></a><!-- doxytag: member="KService::save" ref="abc7f163ef4e070162976cb6e938b6b1e" args="(QDataStream &amp;)" -->
virtual void&#160;</td><td class="memItemRight" valign="bottom"><b>save</b> (<a class="elRef" href="qdatastream.html">QDataStream</a> &amp;)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ac428beb293223b4e43719c2c8f5578df"></a><!-- doxytag: member="KService::setMenuId" ref="ac428beb293223b4e43719c2c8f5578df" args="(const QString &amp;menuId)" -->
void&#160;</td><td class="memItemRight" valign="bottom"><b>setMenuId</b> (const <a class="elRef" href="qstring.html">QString</a> &amp;menuId)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a83514d6733779a22d0a0c218d4f84953"></a><!-- doxytag: member="KService::setTerminal" ref="a83514d6733779a22d0a0c218d4f84953" args="(bool b)" -->
void&#160;</td><td class="memItemRight" valign="bottom"><b>setTerminal</b> (bool b)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a287ca714263203bac828c7d95150c710"></a><!-- doxytag: member="KService::setTerminalOptions" ref="a287ca714263203bac828c7d95150c710" args="(const QString &amp;options)" -->
void&#160;</td><td class="memItemRight" valign="bottom"><b>setTerminalOptions</b> (const <a class="elRef" href="qstring.html">QString</a> &amp;options)</td></tr>
<tr><td colspan="2"><h2><a name="pub-static-methods"></a>
Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static Ptr&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a2c5b00fd381b9843b6ba99da692c90ae">serviceByName</a> (const <a class="elRef" href="qstring.html">QString</a> &amp;_name)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static Ptr&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#aec0c50b72ff1b356a2fba1e0c4855967">serviceByDesktopPath</a> (const <a class="elRef" href="qstring.html">QString</a> &amp;_path)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static Ptr&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a6261ba7fcb0954a985fdba31dc6b6cf7">serviceByDesktopName</a> (const <a class="elRef" href="qstring.html">QString</a> &amp;_name)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static Ptr&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#ad07451b574cbd89a315ed3e38a064aa9">serviceByMenuId</a> (const <a class="elRef" href="qstring.html">QString</a> &amp;_menuId)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static Ptr&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a18103ccedb6d50a2148af738ca78c721">serviceByStorageId</a> (const <a class="elRef" href="qstring.html">QString</a> &amp;_storageId)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qvaluelist.html">List</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a4adac72b28d0736ae27a095c60bbd2f7">allServices</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qvaluelist.html">List</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a7b4674df8b7d8c63be02e57a9687a8c0">allInitServices</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#ad7f00a2246788a7626948794f25a138a">newServicePath</a> (bool showInMenu, const <a class="elRef" href="qstring.html">QString</a> &amp;suggestedName, <a class="elRef" href="qstring.html">QString</a> *menuId=0, const <a class="elRef" href="qstringlist.html">QStringList</a> *reservedMenuIds=0)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKService.html#a7b3c7376c87144f2a39a58d0ba9a809c">rebuildKSycoca</a> (<a class="elRef" href="qwidget.html">QWidget</a> *parent)</td></tr>
<tr><td colspan="2"><h2><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a20e975737f3c9c83a8eec61c6d510aa6"></a><!-- doxytag: member="KService::init" ref="a20e975737f3c9c83a8eec61c6d510aa6" args="(KDesktopFile *config)" -->
void&#160;</td><td class="memItemRight" valign="bottom"><b>init</b> (KDesktopFile *config)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a7606c28e49c6079d4fa41a8ebcbaf5ab"></a><!-- doxytag: member="KService::accessServiceTypes" ref="a7606c28e49c6079d4fa41a8ebcbaf5ab" args="()" -->
<a class="elRef" href="qstringlist.html">QStringList</a> &amp;&#160;</td><td class="memItemRight" valign="bottom"><b>accessServiceTypes</b> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aee697549cbf4b3da02c98486874da3d5"></a><!-- doxytag: member="KService::virtual_hook" ref="aee697549cbf4b3da02c98486874da3d5" args="(int id, void *data)" -->
virtual void&#160;</td><td class="memItemRight" valign="bottom"><b>virtual_hook</b> (int id, void *data)</td></tr>
<tr><td colspan="2"><h2><a name="friends"></a>
Friends</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ad728c2a40c5fb13f22efdbeb626ab75c"></a><!-- doxytag: member="KService::KBuildSycoca" ref="ad728c2a40c5fb13f22efdbeb626ab75c" args="" -->
class&#160;</td><td class="memItemRight" valign="bottom"><b>KBuildSycoca</b></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>Represent a service, i.e. </p>
<p>an application bound to one or several mimetypes (or servicetypes) as written in its desktop entry file.</p>
<p>A service may be a library, too. The starting point you need is often the static methods. Service types are stored as desktop files in the "service" resource..</p>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKServiceType.html" title="A service type is the generic notion for a mimetype, a type of service instead of a type of file...">KServiceType</a> </dd>
<dd>
<a class="el" href="classKServiceGroup.html" title="KServiceGroup represents a group of service, for example screensavers.">KServiceGroup</a> </dd></dl>
<dl class="author"><dt><b>Author:</b></dt><dd>Torben Weis &lt;<a href="mailto:weis@kde.org">weis@kde.org</a>&gt; </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00048">48</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>
</div><hr/><h2>Member Enumeration Documentation</h2>
<a class="anchor" id="a49cfeaf0ab4bc79ddd8431cff9bdfb54"></a><!-- doxytag: member="KService::DCOPServiceType_t" ref="a49cfeaf0ab4bc79ddd8431cff9bdfb54" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="classKService.html#a49cfeaf0ab4bc79ddd8431cff9bdfb54">KService::DCOPServiceType_t</a></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Describes the DCOP type of the service. </p>
<ul>
<li>None - This service has no DCOP support </li>
<li>Unique - This service provides a unique DCOP service. The service name is equal to the desktopEntryName. </li>
<li>Multi - This service provides a DCOP service which can be run with multiple instances in parallel. The service name of an instance is equal to the desktopEntryName + "-" + the PID of the process. </li>
<li>Wait - This service has no DCOP support, the launcher will wait till it is finished. </li>
</ul>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00213">213</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<hr/><h2>Constructor &amp; Destructor Documentation</h2>
<a class="anchor" id="aab3d8df61ef3e8235cf3cd4b2bacb0d9"></a><!-- doxytag: member="KService::KService" ref="aab3d8df61ef3e8235cf3cd4b2bacb0d9" args="(const QString &amp;_name, const QString &amp;_exec, const QString &amp;_icon)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">KService::KService </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> &amp;&#160;</td>
          <td class="paramname"><em>_name</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> &amp;&#160;</td>
          <td class="paramname"><em>_exec</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> &amp;&#160;</td>
          <td class="paramname"><em>_icon</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Construct a temporary service with a given name, exec-line and icon. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">_name</td><td>the name of the service </td></tr>
    <tr><td class="paramname">_exec</td><td>the executable </td></tr>
    <tr><td class="paramname">_icon</td><td>the name of the icon </td></tr>
  </table>
  </dd>
</dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00063">63</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="acd38f5cbc0fefe9167e1e257173828e6"></a><!-- doxytag: member="KService::KService" ref="acd38f5cbc0fefe9167e1e257173828e6" args="(const QString &amp;_fullpath)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">KService::KService </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> &amp;&#160;</td>
          <td class="paramname"><em>_fullpath</em></td><td>)</td>
          <td><code> [explicit]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Construct a service and take all information from a config file. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">_fullpath</td><td>Full path to the config file. </td></tr>
  </table>
  </dd>
</dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00079">79</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a4c84abc04ccb2829b458c52144426b14"></a><!-- doxytag: member="KService::KService" ref="a4c84abc04ccb2829b458c52144426b14" args="(KDesktopFile *config)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">KService::KService </td>
          <td>(</td>
          <td class="paramtype">KDesktopFile *&#160;</td>
          <td class="paramname"><em>config</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Construct a service and take all information from a desktop file. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">config</td><td>the desktop file to read </td></tr>
  </table>
  </dd>
</dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00087">87</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a7b4674df8b7d8c63be02e57a9687a8c0"></a><!-- doxytag: member="KService::allInitServices" ref="a7b4674df8b7d8c63be02e57a9687a8c0" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qvaluelist.html">KService::List</a> KService::allInitServices </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns all services that require initialisation. </p>
<p>Only needed by "kcminit" </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the list of all services that need to be initialized </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00668">668</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a9742aaf6682d554d7fd1f8e8551fe1c0"></a><!-- doxytag: member="KService::allowAsDefault" ref="a9742aaf6682d554d7fd1f8e8551fe1c0" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool KService::allowAsDefault </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Set to true if it is allowed to use this service as the default (main) action for the files it supports (e.g. </p>
<p>Left Click in a file manager, or <a class="el" href="classKRun.html" title="To open files with their associated applications in KDE, use KRun.">KRun</a> in general).</p>
<p>If not, then this service is only available in RMB popups, so it must be selected explicitely by the user in order to be used. Note that servicemenus supersede this functionality though, at least in konqueror.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if the service may be used as the default (main) handler </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00292">292</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="a754d3fe8b55e138d1f8c773f1606df4a"></a><!-- doxytag: member="KService::allowMultipleFiles" ref="a754d3fe8b55e138d1f8c773f1606df4a" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool KService::allowMultipleFiles </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Checks whether this service can handle several files as startup arguments. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if multiple files may be passed to this service at startup. False if only one file at a time may be passed. </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00738">738</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a4adac72b28d0736ae27a095c60bbd2f7"></a><!-- doxytag: member="KService::allServices" ref="a4adac72b28d0736ae27a095c60bbd2f7" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qvaluelist.html">KService::List</a> KService::allServices </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the whole list of services. </p>
<p>Useful for being able to to display them in a list box, for example. More memory consuming than the ones above, don't use unless really necessary. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the list of all services </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00610">610</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a4c6cf9950455ee6c256fed7a265e1993"></a><!-- doxytag: member="KService::categories" ref="a4c6cf9950455ee6c256fed7a265e1993" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstringlist.html">QStringList</a> KService::categories </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns a list of VFolder categories. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the list of VFolder categories </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.1 </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00747">747</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a48940c24aff77894d6968b648b6576ff"></a><!-- doxytag: member="KService::comment" ref="a48940c24aff77894d6968b648b6576ff" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::comment </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the descriptive comment for the service, if there is one. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the descriptive comment for the service, or QString::null if not set </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00233">233</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="a51f8f4f8bfb3a9e5d0a255149f6f1816"></a><!-- doxytag: member="KService::DCOPServiceType" ref="a51f8f4f8bfb3a9e5d0a255149f6f1816" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="classKService.html#a49cfeaf0ab4bc79ddd8431cff9bdfb54">DCOPServiceType_t</a> KService::DCOPServiceType </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the DCOPServiceType supported by this service. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the DCOPServiceType supported by this service </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00219">219</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="a46068cdfad6f69c7e24992291cc879d0"></a><!-- doxytag: member="KService::desktopEntryName" ref="a46068cdfad6f69c7e24992291cc879d0" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::desktopEntryName </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the filename of the service desktop entry without any extension. </p>
<p>E.g. "kppp" </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the name of the desktop entry without path or extension, or QString::null if not set </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00182">182</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="a1dd162ea11b51511a37d202202aa96f1"></a><!-- doxytag: member="KService::desktopEntryPath" ref="a1dd162ea11b51511a37d202202aa96f1" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::desktopEntryPath </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the path to the location where the service desktop entry is stored. </p>
<p>This is a relative path if the desktop entry was found in any of the locations pointed to by $KDEDIRS (e.g. "Internet/kppp.desktop") It is a full path if the desktop entry originates from another location. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the path of the service's desktop file, or QString::null if not set </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00174">174</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="a4a0471572826ed8239b85505506b4c7c"></a><!-- doxytag: member="KService::exec" ref="a4a0471572826ed8239b85505506b4c7c" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::exec </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the executable. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the command that the service executes, or QString::null if not set </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00104">104</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="a47dbda7e8dccadfdfee9fcc30971a11a"></a><!-- doxytag: member="KService::genericName" ref="a47dbda7e8dccadfdfee9fcc30971a11a" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::genericName </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the generic name for the service, if there is one (e.g. </p>
<p>"Mail Client"). </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the generic name, or QString::null if not set </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00241">241</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="a629396ef81d10adebe0deaaa7cd9e402"></a><!-- doxytag: member="KService::hasServiceType" ref="a629396ef81d10adebe0deaaa7cd9e402" args="(const QString &amp;_service) const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool KService::hasServiceType </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> &amp;&#160;</td>
          <td class="paramname"><em>_service</em></td><td>)</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Checks whether the service supports this service type. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">_service</td><td>The name of the service type you are interested in determining whether this services supports.</td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if the service you specified is supported, otherwise false. </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00352">352</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a96986870204859dc90f9dbb1d432bc15"></a><!-- doxytag: member="KService::icon" ref="a96986870204859dc90f9dbb1d432bc15" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::icon </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the name of the icon. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the icon associated with the service, or "unknown" if not set </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00125">125</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="a369f43e5174e6594137b5806befa1721"></a><!-- doxytag: member="KService::init" ref="a369f43e5174e6594137b5806befa1721" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::init </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the name of the init function to call (KControl modules). </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the name of the init function to call in this service during startup of KDE. (KControl modules only), or QString::null if not set </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00118">118</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="a7d27ce369e125362a3f80a333fe37969"></a><!-- doxytag: member="KService::initialPreference" ref="a7d27ce369e125362a3f80a333fe37969" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int KService::initialPreference </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>What preference to associate with this service initially (before the user has had any chance to define a profile for it). </p>
<p>The bigger the value, the most preferred the service is. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the service preference level of the service </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00308">308</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="af6d5fb5966bd073f05da1620216a32cf"></a><!-- doxytag: member="KService::initialPreferenceForMimeType" ref="af6d5fb5966bd073f05da1620216a32cf" args="(const QString &amp;mimeType) const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int KService::initialPreferenceForMimeType </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> &amp;&#160;</td>
          <td class="paramname"><em>mimeType</em></td><td>)</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>What preference to associate with this service initially for handling the specified mimetype. </p>
<p>(before the user has had any chance to define a profile for it). The bigger the value, the most preferred the service is. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the service preference level of the service for this mimetype </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00385">385</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a6a414d83c6fde6520e64d89bd844681b"></a><!-- doxytag: member="KService::isValid" ref="a6a414d83c6fde6520e64d89bd844681b" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool KService::isValid </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Checks whether the service is valid. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if the service is valid (e.g. name is not empty) </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00375">375</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="af770ba5a418ed2b0c8dfa5d014536e7c"></a><!-- doxytag: member="KService::keywords" ref="af770ba5a418ed2b0c8dfa5d014536e7c" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstringlist.html">QStringList</a> KService::keywords </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns a list of descriptive keywords the service, if there are any. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the list of keywords </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00257">257</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="a9303af3fb47133be225ac78c6c360a19"></a><!-- doxytag: member="KService::library" ref="a9303af3fb47133be225ac78c6c360a19" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::library </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the name of the service's library. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the name of the library that contains the services implementation, or QString::null if not set </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00111">111</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="af6cd1c31634aa86c0eadaa5be91c6f9a"></a><!-- doxytag: member="KService::locateLocal" ref="af6cd1c31634aa86c0eadaa5be91c6f9a" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::locateLocal </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns a path that can be used for saving changes to this service. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>path that can be used for saving changes to this service </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00769">769</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a4331b4c5b266867c2ddd4889506450ff"></a><!-- doxytag: member="KService::menuId" ref="a4331b4c5b266867c2ddd4889506450ff" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::menuId </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the menu ID of the service desktop entry. </p>
<p>The menu ID is used to add or remove the entry to a menu. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the menu ID </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00752">752</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a206dd1927ae8f591074630c370cc39ee"></a><!-- doxytag: member="KService::name" ref="a206dd1927ae8f591074630c370cc39ee" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">virtual <a class="elRef" href="qstring.html">QString</a> KService::name </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline, virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the name of the service. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the name of the service, or QString::null if not set </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00098">98</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="ad7f00a2246788a7626948794f25a138a"></a><!-- doxytag: member="KService::newServicePath" ref="ad7f00a2246788a7626948794f25a138a" args="(bool showInMenu, const QString &amp;suggestedName, QString *menuId=0, const QStringList *reservedMenuIds=0)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::newServicePath </td>
          <td>(</td>
          <td class="paramtype">bool&#160;</td>
          <td class="paramname"><em>showInMenu</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> &amp;&#160;</td>
          <td class="paramname"><em>suggestedName</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="elRef" href="qstring.html">QString</a> *&#160;</td>
          <td class="paramname"><em>menuId</em> = <code>0</code>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const <a class="elRef" href="qstringlist.html">QStringList</a> *&#160;</td>
          <td class="paramname"><em>reservedMenuIds</em> = <code>0</code>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns a path that can be used to create a new <a class="el" href="classKService.html" title="Represent a service, i.e.">KService</a> based on <code>suggestedName</code>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">showInMenu</td><td>true, if the service should be shown in the KDE menu false, if the service should be hidden from the menu </td></tr>
    <tr><td class="paramname">suggestedName</td><td>name to base the file on, if a service with such name already exists, a prefix will be added to make it unique. </td></tr>
    <tr><td class="paramname">menuId</td><td>If provided, menuId will be set to the menu id to use for the <a class="el" href="classKService.html" title="Represent a service, i.e.">KService</a> </td></tr>
    <tr><td class="paramname">reservedMenuIds</td><td>If provided, the path and menu id will be chosen in such a way that the new menu id does not conflict with any of the reservedMenuIds </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The path to use for the new <a class="el" href="classKService.html" title="Represent a service, i.e.">KService</a>. </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00778">778</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a161366b96d53bf3fba5739b0064d0ea2"></a><!-- doxytag: member="KService::noDisplay" ref="a161366b96d53bf3fba5739b0064d0ea2" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool KService::noDisplay </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Whether the entry should be suppressed in menus. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true to suppress this service </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00690">690</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="ab67d01a8b6e4be0a64f3c9091098da72"></a><!-- doxytag: member="KService::parentApp" ref="ab67d01a8b6e4be0a64f3c9091098da72" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::parentApp </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Name of the application this service belongs to. </p>
<p>(Useful for e.g. plugins) </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the parent application, or QString::null if not set </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.1 </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00728">728</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a7377fcd95d57c81a01e2f270da6aec1d"></a><!-- doxytag: member="KService::path" ref="a7377fcd95d57c81a01e2f270da6aec1d" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::path </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the working directory to run the program in. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the working directory to run the program in, or QString::null if not set </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00226">226</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="abfaeb01482b8741bc5de9a5989836779"></a><!-- doxytag: member="KService::pixmap" ref="abfaeb01482b8741bc5de9a5989836779" args="(KIcon::Group _group, int _force_size=0, int _state=0, QString *_path=0L) const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qpixmap.html">QPixmap</a> KService::pixmap </td>
          <td>(</td>
          <td class="paramtype">KIcon::Group&#160;</td>
          <td class="paramname"><em>_group</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>_force_size</em> = <code>0</code>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>_state</em> = <code>0</code>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="elRef" href="qstring.html">QString</a> *&#160;</td>
          <td class="paramname"><em>_path</em> = <code>0L</code>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the pixmap that represents the icon. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>a pixmap for this service (finds and loads <a class="el" href="classKService.html#a96986870204859dc90f9dbb1d432bc15" title="Returns the name of the icon.">icon()</a>), null if not set </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKService.html#a96986870204859dc90f9dbb1d432bc15" title="Returns the name of the icon.">icon()</a> </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00279">279</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="ac387e93eb31e981f5588c6b4912f631e"></a><!-- doxytag: member="KService::property" ref="ac387e93eb31e981f5588c6b4912f631e" args="(const QString &amp;_name, QVariant::Type t) const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qvariant.html">QVariant</a> KService::property </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> &amp;&#160;</td>
          <td class="paramname"><em>_name</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">QVariant::Type&#160;</td>
          <td class="paramname"><em>t</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the requested property. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">_name</td><td>the name of the property </td></tr>
    <tr><td class="paramname">t</td><td>the assumed type of the property </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the property, or invalid if not found </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKServiceType.html" title="A service type is the generic notion for a mimetype, a type of service instead of a type of file...">KServiceType</a> </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00490">490</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="aebaff8ace9dc52f73326b3086a6b687a"></a><!-- doxytag: member="KService::property" ref="aebaff8ace9dc52f73326b3086a6b687a" args="(const QString &amp;_name) const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qvariant.html">QVariant</a> KService::property </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> &amp;&#160;</td>
          <td class="paramname"><em>_name</em></td><td>)</td>
          <td> const<code> [virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the requested property. </p>
<p>Some often used properties have convenience access functions like <a class="el" href="classKService.html#a4a0471572826ed8239b85505506b4c7c" title="Returns the executable.">exec()</a>, serviceTypes etc.</p>
<p>It depends upon the <a class="el" href="classKService.html#ab3b88547fc09b49e5afb0d3dcc02115c" title="Returns the service types that this service supports.">serviceTypes()</a> of this service which properties a service can have.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">_name</td><td>the name of the property </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>the property, or invalid if not found </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKServiceType.html" title="A service type is the generic notion for a mimetype, a type of service instead of a type of file...">KServiceType</a> </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00475">475</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a21c4b5dc07007f443bc73543d4baae10"></a><!-- doxytag: member="KService::propertyNames" ref="a21c4b5dc07007f443bc73543d4baae10" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstringlist.html">QStringList</a> KService::propertyNames </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the list of all properties that this service can have. </p>
<p>That means, that some of these properties may be empty. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the list of supported properties </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00581">581</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a7b3c7376c87144f2a39a58d0ba9a809c"></a><!-- doxytag: member="KService::rebuildKSycoca" ref="a7b3c7376c87144f2a39a58d0ba9a809c" args="(QWidget *parent)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void KService::rebuildKSycoca </td>
          <td>(</td>
          <td class="paramtype"><a class="elRef" href="qwidget.html">QWidget</a> *&#160;</td>
          <td class="paramname"><em>parent</em></td><td>)</td>
          <td><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Rebuild KSycoca and show a progress dialog while doing so. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">parent</td><td>Parent widget for the progress dialog </td></tr>
  </table>
  </dd>
</dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00834">834</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a6261ba7fcb0954a985fdba31dc6b6cf7"></a><!-- doxytag: member="KService::serviceByDesktopName" ref="a6261ba7fcb0954a985fdba31dc6b6cf7" args="(const QString &amp;_name)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">KService::Ptr KService::serviceByDesktopName </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> &amp;&#160;</td>
          <td class="paramname"><em>_name</em></td><td>)</td>
          <td><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Find a service by the name of its desktop file, not depending on its actual location (as long as it's under the applnk or service directories). </p>
<p>For instance "konqbrowser" or "kcookiejar". Note that the ".desktop" extension is implicit.</p>
<p>This is the recommended method (safe even if the user moves stuff) but note that it assumes that no two entries have the same filename.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">_name</td><td>the name of the configuration file </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a pointer to the requested service or 0 if the service is unknown. <em>Very</em> <em>important:</em> Don't store the result in a KService* ! </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00627">627</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="aec0c50b72ff1b356a2fba1e0c4855967"></a><!-- doxytag: member="KService::serviceByDesktopPath" ref="aec0c50b72ff1b356a2fba1e0c4855967" args="(const QString &amp;_path)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">KService::Ptr KService::serviceByDesktopPath </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> &amp;&#160;</td>
          <td class="paramname"><em>_path</em></td><td>)</td>
          <td><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Find a service based on its path as returned by <a class="el" href="classKService.html#a1dd162ea11b51511a37d202202aa96f1" title="Returns the path to the location where the service desktop entry is stored.">desktopEntryPath()</a>. </p>
<p>It's usually better to use <a class="el" href="classKService.html#a18103ccedb6d50a2148af738ca78c721" title="Find a service by its storage-id or desktop-file path.">serviceByStorageId()</a> instead.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">_path</td><td>the path of the configuration file </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a pointer to the requested service or 0 if the service is unknown. <em>Very</em> <em>important:</em> Don't store the result in a KService* ! </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00621">621</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="ad07451b574cbd89a315ed3e38a064aa9"></a><!-- doxytag: member="KService::serviceByMenuId" ref="ad07451b574cbd89a315ed3e38a064aa9" args="(const QString &amp;_menuId)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">KService::Ptr KService::serviceByMenuId </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> &amp;&#160;</td>
          <td class="paramname"><em>_menuId</em></td><td>)</td>
          <td><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Find a service by its menu-id. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">_menuId</td><td>the menu id of the service </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a pointer to the requested service or 0 if the service is unknown. <em>Very</em> <em>important:</em> Don't store the result in a KService* ! </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00635">635</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a2c5b00fd381b9843b6ba99da692c90ae"></a><!-- doxytag: member="KService::serviceByName" ref="a2c5b00fd381b9843b6ba99da692c90ae" args="(const QString &amp;_name)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">KService::Ptr KService::serviceByName </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> &amp;&#160;</td>
          <td class="paramname"><em>_name</em></td><td>)</td>
          <td><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Find a service by name, i.e. </p>
<p>the translated Name field. You should really not use this method, since the name is translated.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">_name</td><td>the name to search </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a pointer to the requested service or 0 if the service is unknown. <em>Very</em> <em>important:</em> Don't store the result in a KService* ! </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00615">615</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a18103ccedb6d50a2148af738ca78c721"></a><!-- doxytag: member="KService::serviceByStorageId" ref="a18103ccedb6d50a2148af738ca78c721" args="(const QString &amp;_storageId)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">KService::Ptr KService::serviceByStorageId </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> &amp;&#160;</td>
          <td class="paramname"><em>_storageId</em></td><td>)</td>
          <td><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Find a service by its storage-id or desktop-file path. </p>
<p>This function will try very hard to find a matching service.</p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">_storageId</td><td>the storage id or desktop-file path of the service </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a pointer to the requested service or 0 if the service is unknown. <em>Very</em> <em>important:</em> Don't store the result in a KService* ! </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00641">641</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="ab3b88547fc09b49e5afb0d3dcc02115c"></a><!-- doxytag: member="KService::serviceTypes" ref="ab3b88547fc09b49e5afb0d3dcc02115c" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstringlist.html">QStringList</a> KService::serviceTypes </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the service types that this service supports. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the list of service types that are supported </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00270">270</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="a6d2da40ed48d4d4b9c459c1051732e0e"></a><!-- doxytag: member="KService::storageId" ref="a6d2da40ed48d4d4b9c459c1051732e0e" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::storageId </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns a normalized ID suitable for storing in configuration files. </p>
<p>It will be based on the menu-id when available and otherwise falls back to <a class="el" href="classKService.html#a1dd162ea11b51511a37d202202aa96f1" title="Returns the path to the location where the service desktop entry is stored.">desktopEntryPath()</a> </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the storage ID </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00762">762</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a05759a1d0acfbb9997b95907c2afa688"></a><!-- doxytag: member="KService::substituteUid" ref="a05759a1d0acfbb9997b95907c2afa688" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool KService::substituteUid </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Checks whether the service runs with a different user id. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if the service has to be run under a different uid. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKService.html#a031e97e187d994c45770bd0d1ac0c469" title="Returns the user name, if the service runs with a different user id.">username()</a> </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00673">673</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="abf2c177682346064525deb776da4f25a"></a><!-- doxytag: member="KService::terminal" ref="abf2c177682346064525deb776da4f25a" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool KService::terminal </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Checks whethe the service should be run in a terminal. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if the service is to be run in a terminal. </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00138">138</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="a4c5b41b17fcce96710b6fe2b94ad9e86"></a><!-- doxytag: member="KService::terminalOptions" ref="a4c5b41b17fcce96710b6fe2b94ad9e86" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::terminalOptions </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns any options associated with the terminal the service runs in, if it requires a terminal. </p>
<p>The service must be a tty-oriented program. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the terminal options, or QString::null if not set </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00147">147</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="a505ad4cbc782d8c84807aeb11ebef524"></a><!-- doxytag: member="KService::type" ref="a505ad4cbc782d8c84807aeb11ebef524" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">virtual <a class="elRef" href="qstring.html">QString</a> KService::type </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline, virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the type of the service. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the type of the service ("Application" or "Service") </dd></dl>

<p>Definition at line <a class="el" href="kservice_8h_source.html#l00092">92</a> of file <a class="el" href="kservice_8h_source.html">kservice.h</a>.</p>

</div>
</div>
<a class="anchor" id="a84b1cf958ffab69a1de6181925ca2114"></a><!-- doxytag: member="KService::untranslatedGenericName" ref="a84b1cf958ffab69a1de6181925ca2114" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::untranslatedGenericName </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the untranslated (US English) generic name for the service, if there is one (e.g. </p>
<p>"Mail Client"). </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the generic name, or QString::null if not set </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.2 </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00723">723</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<a class="anchor" id="a031e97e187d994c45770bd0d1ac0c469"></a><!-- doxytag: member="KService::username" ref="a031e97e187d994c45770bd0d1ac0c469" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="qstring.html">QString</a> KService::username </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Returns the user name, if the service runs with a different user id. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the username under which the service has to be run, or QString::null if not set </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd>substututeUid()a </dd></dl>

<p>Definition at line <a class="el" href="kservice_8cpp_source.html#l00678">678</a> of file <a class="el" href="kservice_8cpp_source.html">kservice.cpp</a>.</p>

</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="kservice_8h_source.html">kservice.h</a></li>
<li><a class="el" href="kservice_8cpp_source.html">kservice.cpp</a></li>
</ul>
</div>
    </div></div>


      </td>
  </tr>
  <tr>
    <td valign="top" id="leftmenu" width="25%">
      <a name="navigation"></a>
      <div class="menu_box"><h2>kio/kio</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="modules.html">Modules</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="namespacemembers.html">Namespace Members</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="classKACL.html">kacl</option>,  <option value="classKAr.html">kar</option>,  <option value="classKArchive.html">karchive</option>,  <option value="classKArchiveDirectory.html">karchivedirectory</option>,  <option value="classKArchiveEntry.html">karchiveentry</option>,  <option value="classKArchiveFile.html">karchivefile</option>,  <option value="classKAutoMount.html">kautomount</option>,  <option value="classKAutoUnmount.html">kautounmount</option>,  <option value="classKDataTool.html">kdatatool</option>,  <option value="classKDataToolAction.html">kdatatoolaction</option>,  <option value="classKDataToolInfo.html">kdatatoolinfo</option>,  <option value="classKDCOPServiceStarter.html">kdcopservicestarter</option>,  <option value="classKDEDesktopMimeType.html">kdedesktopmimetype</option>,  <option value="classKDirLister.html">kdirlister</option>,  <option value="classKDirNotify.html">kdirnotify</option>,  <option value="classKDirWatch.html">kdirwatch</option>,  <option value="classKEMailSettings.html">kemailsettings</option>,  <option value="classKExecMimeType.html">kexecmimetype</option>,  <option value="classKFileFilter.html">kfilefilter</option>,  <option value="classKFileItem.html">kfileitem</option>,  <option value="classKFileMetaInfo.html">kfilemetainfo</option>,  <option value="classKFileMetaInfoGroup.html">kfilemetainfogroup</option>,  <option value="classKFileMetaInfoItem.html">kfilemetainfoitem</option>,  <option value="classKFileMimeTypeInfo.html">kfilemimetypeinfo</option>,  <option value="classKFileMimeTypeInfo_1_1GroupInfo.html">kfilemimetypeinfo::groupinfo</option>,  <option value="classKFileMimeTypeInfo_1_1ItemInfo.html">kfilemimetypeinfo::iteminfo</option>,  <option value="classKFilePlugin.html">kfileplugin</option>,  <option value="classKFileShare.html">kfileshare</option>,  <option value="classKFilterBase.html">kfilterbase</option>,  <option value="classKFilterDev.html">kfilterdev</option>,  <option value="classKFolderType.html">kfoldertype</option>,  <option value="classKImageIO.html">kimageio</option>,  <option value="classKIO_1_1AuthInfo.html">kio::authinfo</option>,  <option value="classKIO_1_1ChmodJob.html">kio::chmodjob</option>,  <option value="classKIO_1_1Connection.html">kio::connection</option>,  <option value="classKIO_1_1CopyJob.html">kio::copyjob</option>,  <option value="classKIO_1_1DataProtocol.html">kio::dataprotocol</option>,  <option value="classKIO_1_1DataSlave.html">kio::dataslave</option>,  <option value="classKIO_1_1DavJob.html">kio::davjob</option>,  <option value="classKIO_1_1DeleteJob.html">kio::deletejob</option>,  <option value="classKIO_1_1FileCopyJob.html">kio::filecopyjob</option>,  <option value="classKIO_1_1ForwardingSlaveBase.html">kio::forwardingslavebase</option>,  <option value="classKIO_1_1Job.html">kio::job</option>,  <option value="classKIO_1_1ListJob.html">kio::listjob</option>,  <option value="classKIO_1_1MetaData.html">kio::metadata</option>,  <option value="classKIO_1_1MetaInfoJob.html">kio::metainfojob</option>,  <option value="classKIO_1_1MimetypeJob.html">kio::mimetypejob</option>,  <option value="classKIO_1_1MkdirJob.html">kio::mkdirjob</option>,  <option value="classKIO_1_1MultiGetJob.html">kio::multigetjob</option>,  <option value="classKIO_1_1NetAccess.html">kio::netaccess</option>,  <option value="classKIO_1_1NetRC.html">kio::netrc</option>,  <option value="classKIO_1_1PasswordDialog.html">kio::passworddialog</option>,  <option value="classKIO_1_1PreviewJob.html">kio::previewjob</option>,  <option value="classKIO_1_1ProgressBase.html">kio::progressbase</option>,  <option value="classKIO_1_1RenameDlg.html">kio::renamedlg</option>,  <option value="classKIO_1_1Scheduler.html">kio::scheduler</option>,  <option value="classKIO_1_1SimpleJob.html">kio::simplejob</option>,  <option value="classKIO_1_1Slave.html">kio::slave</option>,  <option value="classKIO_1_1SlaveBase.html">kio::slavebase</option>,  <option value="classKIO_1_1SlaveConfig.html">kio::slaveconfig</option>,  <option value="classKIO_1_1SlaveInterface.html">kio::slaveinterface</option>,  <option value="classKIO_1_1StatJob.html">kio::statjob</option>,  <option value="classKIO_1_1StatusbarProgress.html">kio::statusbarprogress</option>,  <option value="classKIO_1_1StoredTransferJob.html">kio::storedtransferjob</option>,  <option value="classKIO_1_1TCPSlaveBase.html">kio::tcpslavebase</option>,  <option value="classKIO_1_1TransferJob.html">kio::transferjob</option>,  <option value="classKLimitedIODevice.html">klimitediodevice</option>,  <option value="classKMimeMagic.html">kmimemagic</option>,  <option value="classKMimeMagicResult.html">kmimemagicresult</option>,  <option value="classKMimeType.html">kmimetype</option>,  <option value="classKMimeTypeChooser.html">kmimetypechooser</option>,  <option value="classKMimeTypeChooserDialog.html">kmimetypechooserdialog</option>,  <option value="classKMimeTypeResolver.html">kmimetyperesolver</option>,  <option value="classKNFSShare.html">knfsshare</option>,  <option value="classKOCRDialog.html">kocrdialog</option>,  <option value="classKOCRDialogFactory.html">kocrdialogfactory</option>,  <option value="classKOpenWithHandler.html">kopenwithhandler</option>,  <option value="classKProtocolInfo.html">kprotocolinfo</option>,  <option value="classKProtocolManager.html">kprotocolmanager</option>,  <option value="classKRemoteEncoding.html">kremoteencoding</option>,  <option value="classKRun.html">krun</option>,  <option value="classKSambaShare.html">ksambashare</option>,  <option value="classKScanDialog.html">kscandialog</option>,  <option value="classKScanDialogFactory.html">kscandialogfactory</option>,  <option value="classKService.html">kservice</option>,  <option value="classKServiceGroup.html">kservicegroup</option>,  <option value="classKServiceOffer.html">kserviceoffer</option>,  <option value="classKServiceType.html">kservicetype</option>,  <option value="classKServiceTypeProfile.html">kservicetypeprofile</option>,  <option value="classKShellCompletion.html">kshellcompletion</option>,  <option value="classKShred.html">kshred</option>,  <option value="classKSimpleFileFilter.html">ksimplefilefilter</option>,  <option value="classKTar.html">ktar</option>,  <option value="classKTrader.html">ktrader</option>,  <option value="classKURIFilter.html">kurifilter</option>,  <option value="classKURIFilterData.html">kurifilterdata</option>,  <option value="classKURIFilterPlugin.html">kurifilterplugin</option>,  <option value="classKURIFilterPluginList.html">kurifilterpluginlist</option>,  <option value="classKURLCompletion.html">kurlcompletion</option>,  <option value="classKURLPixmapProvider.html">kurlpixmapprovider</option>,  <option value="classKZip.html">kzip</option>,  <option value="classObserver.html">observer</option>,  <option value="classRenameDlgPlugin.html">renamedlgplugin</option>,  <option value="classThumbCreator.html">thumbcreator</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>