<?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" xml:lang="en">
<head>
<title>customproperties.cpp Source File</title>
<style type="text/css">
.cp-doNotDisplay { display: none; }
@media aural, braille, handheld, tty { .cp-doNotDisplay { display: inline; speak: normal; }}
.cp-edit { text-align: right; }
@media print, embossed { .cp-edit { display: none; }}
</style>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<link rel="meta" href="http://www.kde.org/labels.rdf" type="application/rdf+xml" title="ICRA labels" />
<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" />
<meta name="no-email-collection" content="http://www.unspam.com/noemailcollection" />
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link rel="shortcut icon" href="../../favicon.ico" /><link rel="icon" href="../../favicon.ico" />
<link rel="stylesheet" media="screen" type="text/css" title="KDE Colors" href="../../kde.css" />
<link rel="stylesheet" media="print, embossed" type="text/css" href="../../print.css" />
<link rel="stylesheet" media="screen, aural, handheld, tty, braille" type="text/css" title="Flat" href="../../flat.css" />
<link rel="stylesheet" type="text/css" href="../../doxygen.css" />
<link rel="stylesheet" type="text/css" href="../../tabs.css" />
</head>
<body>
<ul class="cp-doNotDisplay">
<li><a href="#cp-content" accesskey="2">Skip to content</a></li>
<li><a href="#cp-menu" accesskey="5">Skip to link menu</a></li>
</ul>
<div id="container">
<div id="header">
<div id="header_top"><div><div>
<img alt ="" src="../../top-kde.jpg"/>
</div></div></div>
<div id="header_bottom">
<div id="location">
<ul>
<li><a href="http://api.kde.org">KDE API Reference</a></li>
<li><a href="../../index.html">kdepimlibs-4.10.5 API Reference</a></li>
</ul>
</div>
<div id="menu">
<ul>
<li><a href="http://www.kde.org/">KDE Home</a></li>
<li><a href="http://kde.org/contact/">Contact Us</a></li>
</ul>
</div>
</div>
</div>
<!-- End page header -->
<div id="body_wrapper">
<div id="body">
<!-- begin main content -->
<div id="right">
<div class="content">
<div id="main">
<div class="clearer"> </div>
<h2><a name="content"></a>KCal Library</h2>
<!-- BC -->
<div id="top">
<!-- Generated by Doxygen 1.8.3.1 -->
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_7bec31e8e66a1e27ebe055c8b326b5ef.html">kcal</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">customproperties.cpp</div> </div>
</div><!--header-->
<div class="contents">
<a href="customproperties_8cpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">/*</span></div>
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="comment"> This file is part of the kcal library.</span></div>
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment"></span></div>
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment"> Copyright (c) 2002,2006,2010 David Jarvie <djarvie@kde.org></span></div>
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment"></span></div>
<div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment"> This library is free software; you can redistribute it and/or</span></div>
<div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment"> modify it under the terms of the GNU Library General Public</span></div>
<div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment"> License as published by the Free Software Foundation; either</span></div>
<div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment"> version 2 of the License, or (at your option) any later version.</span></div>
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment"></span></div>
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment"> This library is distributed in the hope that it will be useful,</span></div>
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment"> but WITHOUT ANY WARRANTY; without even the implied warranty of</span></div>
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment"> MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span></div>
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment"> Library General Public License for more details.</span></div>
<div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment"></span></div>
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment"> You should have received a copy of the GNU Library General Public License</span></div>
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment"> along with this library; see the file COPYING.LIB. If not, write to</span></div>
<div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment"> the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,</span></div>
<div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment"> Boston, MA 02110-1301, USA.</span></div>
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment">*/</span></div>
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">#include "<a class="code" href="customproperties_8h.html" title="This file is part of the API for handling calendar data and defines the CustomProperties class...">customproperties.h</a>"</span></div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <kdebug.h></span></div>
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor">#include <QtCore/QByteArray></span></div>
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span> </div>
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="keyword">using namespace </span>KCal;</div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span> </div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="comment">//@cond PRIVATE</span></div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="keyword">static</span> <span class="keywordtype">bool</span> checkName( <span class="keyword">const</span> QByteArray &name );</div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span> </div>
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="keyword">class </span>CustomProperties::Private</div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span> {</div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span>  <span class="keyword">public</span>:</div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span>  <span class="keywordtype">bool</span> <a class="code" href="classKCal_1_1CustomProperties.html#a968927c0a78c53d74cbb86abf33f098d" title="Compare this with properties for equality.">operator==</a>( <span class="keyword">const</span> Private &other ) <span class="keyword">const</span>;</div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  QMap<QByteArray, QString> mProperties; <span class="comment">// custom calendar properties</span></div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span> };</div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span> </div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="keywordtype">bool</span> CustomProperties::Private::operator==( <span class="keyword">const</span> CustomProperties::Private &other )<span class="keyword"> const</span></div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="keyword"></span>{</div>
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span>  <span class="keywordflow">if</span> ( mProperties.count() != other.mProperties.count() ) {</div>
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span>  }</div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span>  <span class="keywordflow">for</span> ( QMap<QByteArray, QString>::ConstIterator it = mProperties.begin();</div>
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span>  it != mProperties.end(); ++it ) {</div>
<div class="line"><a name="l00055"></a><span class="lineno"> 55</span>  QMap<QByteArray, QString>::ConstIterator itOther =</div>
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span>  other.mProperties.find( it.key() );</div>
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span>  <span class="keywordflow">if</span> ( itOther == other.mProperties.end() || itOther.value() != it.value() ) {</div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  }</div>
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span>  }</div>
<div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span> }</div>
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span> <span class="comment">//@endcond</span></div>
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span> </div>
<div class="line"><a name="l00065"></a><span class="lineno"><a class="code" href="classKCal_1_1CustomProperties.html#aaa6096bfb2f30c00eb19f9c84ef801e0"> 65</a></span> <a class="code" href="classKCal_1_1CustomProperties.html#aaa6096bfb2f30c00eb19f9c84ef801e0" title="Constructs an empty custom properties instance.">CustomProperties::CustomProperties</a>()</div>
<div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  : d( new Private )</div>
<div class="line"><a name="l00067"></a><span class="lineno"> 67</span> {</div>
<div class="line"><a name="l00068"></a><span class="lineno"> 68</span> }</div>
<div class="line"><a name="l00069"></a><span class="lineno"> 69</span> </div>
<div class="line"><a name="l00070"></a><span class="lineno"><a class="code" href="classKCal_1_1CustomProperties.html#ae07b4404e1a9e20bfd6ff694e48fdd86"> 70</a></span> <a class="code" href="classKCal_1_1CustomProperties.html#aaa6096bfb2f30c00eb19f9c84ef801e0" title="Constructs an empty custom properties instance.">CustomProperties::CustomProperties</a>( <span class="keyword">const</span> <a class="code" href="classKCal_1_1CustomProperties.html" title="A class to manage custom calendar properties.">CustomProperties</a> &cp )</div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  : d( new Private( *cp.d ) )</div>
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span> {</div>
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span> }</div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span> </div>
<div class="line"><a name="l00075"></a><span class="lineno"><a class="code" href="classKCal_1_1CustomProperties.html#a376800b358f08d8ccf0121d68a3ffd50"> 75</a></span> <a class="code" href="classKCal_1_1CustomProperties.html" title="A class to manage custom calendar properties.">CustomProperties</a> &<a class="code" href="classKCal_1_1CustomProperties.html#a376800b358f08d8ccf0121d68a3ffd50" title="Assignment operator.">CustomProperties::operator=</a>( <span class="keyword">const</span> <a class="code" href="classKCal_1_1CustomProperties.html" title="A class to manage custom calendar properties.">CustomProperties</a> &other )</div>
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span> {</div>
<div class="line"><a name="l00077"></a><span class="lineno"> 77</span>  <span class="comment">// check for self assignment</span></div>
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span>  <span class="keywordflow">if</span> ( &other == <span class="keyword">this</span> ) {</div>
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span>  }</div>
<div class="line"><a name="l00081"></a><span class="lineno"> 81</span> </div>
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span>  *d = *other.d;</div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span> }</div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span> </div>
<div class="line"><a name="l00086"></a><span class="lineno"><a class="code" href="classKCal_1_1CustomProperties.html#a03da5cec8fff4505d92a19a4957c4064"> 86</a></span> <a class="code" href="classKCal_1_1CustomProperties.html#a03da5cec8fff4505d92a19a4957c4064" title="Destructor.">CustomProperties::~CustomProperties</a>()</div>
<div class="line"><a name="l00087"></a><span class="lineno"> 87</span> {</div>
<div class="line"><a name="l00088"></a><span class="lineno"> 88</span>  <span class="keyword">delete</span> d;</div>
<div class="line"><a name="l00089"></a><span class="lineno"> 89</span> }</div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span> </div>
<div class="line"><a name="l00091"></a><span class="lineno"><a class="code" href="classKCal_1_1CustomProperties.html#a968927c0a78c53d74cbb86abf33f098d"> 91</a></span> <span class="keywordtype">bool</span> <a class="code" href="classKCal_1_1CustomProperties.html#a968927c0a78c53d74cbb86abf33f098d" title="Compare this with properties for equality.">CustomProperties::operator==</a>( <span class="keyword">const</span> <a class="code" href="classKCal_1_1CustomProperties.html" title="A class to manage custom calendar properties.">CustomProperties</a> &other )<span class="keyword"> const</span></div>
<div class="line"><a name="l00092"></a><span class="lineno"> 92</span> <span class="keyword"></span>{</div>
<div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  <span class="keywordflow">return</span> *d == *other.d;</div>
<div class="line"><a name="l00094"></a><span class="lineno"> 94</span> }</div>
<div class="line"><a name="l00095"></a><span class="lineno"> 95</span> </div>
<div class="line"><a name="l00096"></a><span class="lineno"><a class="code" href="classKCal_1_1CustomProperties.html#a19c6f879d05848f7dae9772d1cc0a156"> 96</a></span> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1CustomProperties.html#a19c6f879d05848f7dae9772d1cc0a156" title="Create or modify a custom calendar property.">CustomProperties::setCustomProperty</a>( <span class="keyword">const</span> QByteArray &app, <span class="keyword">const</span> QByteArray &key,</div>
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span>  <span class="keyword">const</span> QString &value )</div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span> {</div>
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span>  <span class="keywordflow">if</span> ( value.isNull() || key.isEmpty() || app.isEmpty() ) {</div>
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span>  <span class="keywordflow">return</span>;</div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>  }</div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span>  QByteArray <span class="keyword">property</span> = <span class="stringliteral">"X-KDE-"</span> + app + <span class="charliteral">'-'</span> + key;</div>
<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  <span class="keywordflow">if</span> ( !checkName( property ) ) {</div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>  <span class="keywordflow">return</span>;</div>
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>  }</div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>  d->mProperties[property] = value;</div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>  <a class="code" href="classKCal_1_1CustomProperties.html#aa25b9e98bceccb8ea25a4c8c0a851026" title="Called when a custom property has been changed.">customPropertyUpdated</a>();</div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span> }</div>
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span> </div>
<div class="line"><a name="l00110"></a><span class="lineno"><a class="code" href="classKCal_1_1CustomProperties.html#a020a8495583d6cc979874339b956db8b"> 110</a></span> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1CustomProperties.html#a020a8495583d6cc979874339b956db8b" title="Delete a custom calendar property.">CustomProperties::removeCustomProperty</a>( <span class="keyword">const</span> QByteArray &app, <span class="keyword">const</span> QByteArray &key )</div>
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span> {</div>
<div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  <a class="code" href="classKCal_1_1CustomProperties.html#a75dc47ecc515411b0ad0d595a49acb78" title="Delete a non-KDE or non-standard custom calendar property.">removeNonKDECustomProperty</a>( QByteArray( <span class="stringliteral">"X-KDE-"</span> + app + <span class="charliteral">'-'</span> + key ) );</div>
<div class="line"><a name="l00113"></a><span class="lineno"> 113</span> }</div>
<div class="line"><a name="l00114"></a><span class="lineno"> 114</span> </div>
<div class="line"><a name="l00115"></a><span class="lineno"><a class="code" href="classKCal_1_1CustomProperties.html#a3405b55e5183ced1eb93ca1b52b0ab37"> 115</a></span> QString <a class="code" href="classKCal_1_1CustomProperties.html#a3405b55e5183ced1eb93ca1b52b0ab37" title="Return the value of a custom calendar property.">CustomProperties::customProperty</a>( <span class="keyword">const</span> QByteArray &app, <span class="keyword">const</span> QByteArray &key )<span class="keyword"> const</span></div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span> <span class="keyword"></span>{</div>
<div class="line"><a name="l00117"></a><span class="lineno"> 117</span>  <span class="keywordflow">return</span> <a class="code" href="classKCal_1_1CustomProperties.html#aabc3d9114425aed0b5e66f2f3f758ebd" title="Return the value of a non-KDE or non-standard custom calendar property.">nonKDECustomProperty</a>( QByteArray( <span class="stringliteral">"X-KDE-"</span> + app + <span class="charliteral">'-'</span> + key ) );</div>
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span> }</div>
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span> </div>
<div class="line"><a name="l00120"></a><span class="lineno"><a class="code" href="classKCal_1_1CustomProperties.html#ac706797afb507c9e010e86510ead83de"> 120</a></span> QByteArray <a class="code" href="classKCal_1_1CustomProperties.html#ac706797afb507c9e010e86510ead83de" title="Validate and return the full name of a custom calendar property.">CustomProperties::customPropertyName</a>( <span class="keyword">const</span> QByteArray &app, <span class="keyword">const</span> QByteArray &key )</div>
<div class="line"><a name="l00121"></a><span class="lineno"> 121</span> {</div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  QByteArray property( <span class="stringliteral">"X-KDE-"</span> + app + <span class="charliteral">'-'</span> + key );</div>
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  <span class="keywordflow">if</span> ( !checkName( property ) ) {</div>
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span>  <span class="keywordflow">return</span> QByteArray();</div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span>  }</div>
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span>  <span class="keywordflow">return</span> property;</div>
<div class="line"><a name="l00127"></a><span class="lineno"> 127</span> }</div>
<div class="line"><a name="l00128"></a><span class="lineno"> 128</span> </div>
<div class="line"><a name="l00129"></a><span class="lineno"><a class="code" href="classKCal_1_1CustomProperties.html#a7bc617fbf60cc7f83ed1407a1e2a292d"> 129</a></span> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1CustomProperties.html#a7bc617fbf60cc7f83ed1407a1e2a292d" title="Create or modify a non-KDE or non-standard custom calendar property.">CustomProperties::setNonKDECustomProperty</a>( <span class="keyword">const</span> QByteArray &name, <span class="keyword">const</span> QString &value )</div>
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span> {</div>
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  <span class="keywordflow">if</span> ( value.isNull() || !checkName( name ) ) {</div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span>  <span class="keywordflow">return</span>;</div>
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span>  }</div>
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  d->mProperties[name] = value;</div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span>  <a class="code" href="classKCal_1_1CustomProperties.html#aa25b9e98bceccb8ea25a4c8c0a851026" title="Called when a custom property has been changed.">customPropertyUpdated</a>();</div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span> }</div>
<div class="line"><a name="l00137"></a><span class="lineno"> 137</span> </div>
<div class="line"><a name="l00138"></a><span class="lineno"><a class="code" href="classKCal_1_1CustomProperties.html#a75dc47ecc515411b0ad0d595a49acb78"> 138</a></span> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1CustomProperties.html#a75dc47ecc515411b0ad0d595a49acb78" title="Delete a non-KDE or non-standard custom calendar property.">CustomProperties::removeNonKDECustomProperty</a>( <span class="keyword">const</span> QByteArray &name )</div>
<div class="line"><a name="l00139"></a><span class="lineno"> 139</span> {</div>
<div class="line"><a name="l00140"></a><span class="lineno"> 140</span>  <span class="keywordflow">if</span> ( d->mProperties.remove( name ) ) {</div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span>  <a class="code" href="classKCal_1_1CustomProperties.html#aa25b9e98bceccb8ea25a4c8c0a851026" title="Called when a custom property has been changed.">customPropertyUpdated</a>();</div>
<div class="line"><a name="l00142"></a><span class="lineno"> 142</span>  }</div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span> }</div>
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span> </div>
<div class="line"><a name="l00145"></a><span class="lineno"><a class="code" href="classKCal_1_1CustomProperties.html#aabc3d9114425aed0b5e66f2f3f758ebd"> 145</a></span> QString <a class="code" href="classKCal_1_1CustomProperties.html#aabc3d9114425aed0b5e66f2f3f758ebd" title="Return the value of a non-KDE or non-standard custom calendar property.">CustomProperties::nonKDECustomProperty</a>( <span class="keyword">const</span> QByteArray &name )<span class="keyword"> const</span></div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span> <span class="keyword"></span>{</div>
<div class="line"><a name="l00147"></a><span class="lineno"> 147</span>  <span class="keywordflow">return</span> d->mProperties.value( name );</div>
<div class="line"><a name="l00148"></a><span class="lineno"> 148</span> }</div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span> </div>
<div class="line"><a name="l00150"></a><span class="lineno"><a class="code" href="classKCal_1_1CustomProperties.html#a2c01feecd87e68852f6c6c9a27d084da"> 150</a></span> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1CustomProperties.html#a2c01feecd87e68852f6c6c9a27d084da" title="Initialise the alarm's custom calendar properties to the specified key/value pairs.">CustomProperties::setCustomProperties</a>( <span class="keyword">const</span> QMap<QByteArray, QString> &properties )</div>
<div class="line"><a name="l00151"></a><span class="lineno"> 151</span> {</div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  <span class="keywordtype">bool</span> changed = <span class="keyword">false</span>;</div>
<div class="line"><a name="l00153"></a><span class="lineno"> 153</span>  <span class="keywordflow">for</span> ( QMap<QByteArray, QString>::ConstIterator it = properties.begin();</div>
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  it != properties.end(); ++it ) {</div>
<div class="line"><a name="l00155"></a><span class="lineno"> 155</span>  <span class="comment">// Validate the property name and convert any null string to empty string</span></div>
<div class="line"><a name="l00156"></a><span class="lineno"> 156</span>  <span class="keywordflow">if</span> ( checkName( it.key() ) ) {</div>
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  d->mProperties[it.key()] = it.value().isNull() ? QString( <span class="stringliteral">""</span> ) : it.value();</div>
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  changed = <span class="keyword">true</span>;</div>
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  }</div>
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  }</div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span>  <span class="keywordflow">if</span> ( changed ) {</div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span>  <a class="code" href="classKCal_1_1CustomProperties.html#aa25b9e98bceccb8ea25a4c8c0a851026" title="Called when a custom property has been changed.">customPropertyUpdated</a>();</div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span>  }</div>
<div class="line"><a name="l00164"></a><span class="lineno"> 164</span> }</div>
<div class="line"><a name="l00165"></a><span class="lineno"> 165</span> </div>
<div class="line"><a name="l00166"></a><span class="lineno"><a class="code" href="classKCal_1_1CustomProperties.html#a67dcddac7e1c5624860f56007a63245c"> 166</a></span> QMap<QByteArray, QString> <a class="code" href="classKCal_1_1CustomProperties.html#a67dcddac7e1c5624860f56007a63245c" title="Returns all custom calendar property key/value pairs.">CustomProperties::customProperties</a>()<span class="keyword"> const</span></div>
<div class="line"><a name="l00167"></a><span class="lineno"> 167</span> <span class="keyword"></span>{</div>
<div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  <span class="keywordflow">return</span> d->mProperties;</div>
<div class="line"><a name="l00169"></a><span class="lineno"> 169</span> }</div>
<div class="line"><a name="l00170"></a><span class="lineno"> 170</span> </div>
<div class="line"><a name="l00171"></a><span class="lineno"> 171</span> <span class="comment">//@cond PRIVATE</span></div>
<div class="line"><a name="l00172"></a><span class="lineno"> 172</span> <span class="keywordtype">bool</span> checkName( <span class="keyword">const</span> QByteArray &name )</div>
<div class="line"><a name="l00173"></a><span class="lineno"> 173</span> {</div>
<div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  <span class="comment">// Check that the property name starts with 'X-' and contains</span></div>
<div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  <span class="comment">// only the permitted characters</span></div>
<div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  <span class="keyword">const</span> <span class="keywordtype">char</span> *n = name;</div>
<div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  <span class="keywordtype">int</span> len = name.length();</div>
<div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  <span class="keywordflow">if</span> ( len < 2 || n[0] != <span class="charliteral">'X'</span> || n[1] != <span class="charliteral">'-'</span> ) {</div>
<div class="line"><a name="l00179"></a><span class="lineno"> 179</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a name="l00180"></a><span class="lineno"> 180</span>  }</div>
<div class="line"><a name="l00181"></a><span class="lineno"> 181</span>  <span class="keywordflow">for</span> ( <span class="keywordtype">int</span> i = 2; i < len; ++i ) {</div>
<div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  <span class="keywordtype">char</span> ch = n[i];</div>
<div class="line"><a name="l00183"></a><span class="lineno"> 183</span>  <span class="keywordflow">if</span> ( ( ch >= <span class="charliteral">'A'</span> && ch <= <span class="charliteral">'Z'</span> ) ||</div>
<div class="line"><a name="l00184"></a><span class="lineno"> 184</span>  ( ch >= <span class="charliteral">'a'</span> && ch <= <span class="charliteral">'z'</span> ) ||</div>
<div class="line"><a name="l00185"></a><span class="lineno"> 185</span>  ( ch >= <span class="charliteral">'0'</span> && ch <= <span class="charliteral">'9'</span> ) ||</div>
<div class="line"><a name="l00186"></a><span class="lineno"> 186</span>  ch == <span class="charliteral">'-'</span> ) {</div>
<div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  <span class="keywordflow">continue</span>;</div>
<div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  }</div>
<div class="line"><a name="l00189"></a><span class="lineno"> 189</span>  <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// invalid character found</span></div>
<div class="line"><a name="l00190"></a><span class="lineno"> 190</span>  }</div>
<div class="line"><a name="l00191"></a><span class="lineno"> 191</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a name="l00192"></a><span class="lineno"> 192</span> }</div>
<div class="line"><a name="l00193"></a><span class="lineno"> 193</span> <span class="comment">//@endcond</span></div>
</div><!-- fragment --></div><!-- contents -->
<div class="copyrights">
This file is part of the KDE documentation.<br/>
Documentation copyright © 1996-2013 The KDE developers.<br/>
Generated on Fri Jul 12 2013 16:49:31 by
<a href="http://www.doxygen.org/index.html">doxygen</a> 1.8.3.1 written
by <a href="mailto:dimitri@stack.nl">Dimitri van Heesch</a>, © 1997-2006
<p>
KDE's <a href="http://techbase.kde.org/Policies/Library_Documentation_Policy">Doxygen guidelines</a> are available online.
</p>
</div>
</div>
</div>
</div>
<div id="left">
<div class="menu_box">
<a name="cp-menu" /><div class="menutitle"><div>
<h2 id="cp-menu-project">KCal Library</h2>
<a href="#cp-skip-project" class="cp-doNotDisplay">Skip menu "KCal Library"</a>
</div></div>
<ul><li><a href="index.html">Main Page</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="namespacemembers.html">Namespace Members</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="functions.html">Class Members</a></li><li><a href="files.html">File List</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="classKCal_1_1Alarm.html">kcal::alarm</option>, <option value="classKCal_1_1AssignmentVisitor.html">kcal::assignmentvisitor</option>, <option value="classKCal_1_1Attachment.html">kcal::attachment</option>, <option value="classKCal_1_1Attendee.html">kcal::attendee</option>, <option value="classKCal_1_1Calendar.html">kcal::calendar</option>, <option value="classKCal_1_1Calendar_1_1CalendarObserver.html">kcal::calendar::calendarobserver</option>, <option value="classKCal_1_1CalendarLocal.html">kcal::calendarlocal</option>, <option value="classKCal_1_1CalendarNull.html">kcal::calendarnull</option>, <option value="classKCal_1_1CalendarResources.html">kcal::calendarresources</option>, <option value="classKCal_1_1CalFilter.html">kcal::calfilter</option>, <option value="classKCal_1_1CalFormat.html">kcal::calformat</option>, <option value="classKCal_1_1CalStorage.html">kcal::calstorage</option>, <option value="classKCal_1_1ComparisonVisitor.html">kcal::comparisonvisitor</option>, <option value="classKCal_1_1Compat.html">kcal::compat</option>, <option value="classKCal_1_1CompatFactory.html">kcal::compatfactory</option>, <option value="classKCal_1_1CompatOutlook9.html">kcal::compatoutlook9</option>, <option value="classKCal_1_1CompatPre31.html">kcal::compatpre31</option>, <option value="classKCal_1_1CompatPre32.html">kcal::compatpre32</option>, <option value="classKCal_1_1CompatPre35.html">kcal::compatpre35</option>, <option value="classKCal_1_1CustomProperties.html">kcal::customproperties</option>, <option value="classKCal_1_1DndFactory.html">kcal::dndfactory</option>, <option value="classKCal_1_1DummyScheduler.html">kcal::dummyscheduler</option>, <option value="classKCal_1_1Duration.html">kcal::duration</option>, <option value="classKCal_1_1ErrorFormat.html">kcal::errorformat</option>, <option value="classKCal_1_1Event.html">kcal::event</option>, <option value="classKCal_1_1Exception.html">kcal::exception</option>, <option value="classKCal_1_1FileStorage.html">kcal::filestorage</option>, <option value="classKCal_1_1FreeBusy.html">kcal::freebusy</option>, <option value="classKCal_1_1FreeBusyCache.html">kcal::freebusycache</option>, <option value="classKCal_1_1FreeBusyPeriod.html">kcal::freebusyperiod</option>, <option value="classKCal_1_1HtmlExport.html">kcal::htmlexport</option>, <option value="classKCal_1_1ICalFormat.html">kcal::icalformat</option>, <option value="classKCal_1_1ICalFormatImpl.html">kcal::icalformatimpl</option>, <option value="classKCal_1_1ICalTimeZone.html">kcal::icaltimezone</option>, <option value="classKCal_1_1ICalTimeZoneBackend.html">kcal::icaltimezonebackend</option>, <option value="classKCal_1_1ICalTimeZoneData.html">kcal::icaltimezonedata</option>, <option value="classKCal_1_1ICalTimeZones.html">kcal::icaltimezones</option>, <option value="classKCal_1_1ICalTimeZoneSource.html">kcal::icaltimezonesource</option>, <option value="classKCal_1_1Incidence.html">kcal::incidence</option>, <option value="classKCal_1_1IncidenceBase.html">kcal::incidencebase</option>, <option value="classKCal_1_1IncidenceBase_1_1IncidenceObserver.html">kcal::incidencebase::incidenceobserver</option>, <option value="classKCal_1_1IncidenceBase_1_1Visitor.html">kcal::incidencebase::visitor</option>, <option value="classKCal_1_1Journal.html">kcal::journal</option>, <option value="classKCal_1_1KResult.html">kcal::kresult</option>, <option value="classKCal_1_1KResultError.html">kcal::kresulterror</option>, <option value="classKCal_1_1KResultInProgress.html">kcal::kresultinprogress</option>, <option value="classKCal_1_1KResultOk.html">kcal::kresultok</option>, <option value="classKCal_1_1ListBase.html">kcal::listbase</option>, <option value="classKCal_1_1Period.html">kcal::period</option>, <option value="classKCal_1_1Person.html">kcal::person</option>, <option value="classKCal_1_1QtopiaFormat.html">kcal::qtopiaformat</option>, <option value="classKCal_1_1Recurrence.html">kcal::recurrence</option>, <option value="classKCal_1_1RecurrenceRule.html">kcal::recurrencerule</option>, <option value="classKCal_1_1RecurrenceRule_1_1WDayPos.html">kcal::recurrencerule::wdaypos</option>, <option value="classKCal_1_1ResourceCached.html">kcal::resourcecached</option>, <option value="classKCal_1_1ResourceCachedReloadConfig.html">kcal::resourcecachedreloadconfig</option>, <option value="classKCal_1_1ResourceCachedSaveConfig.html">kcal::resourcecachedsaveconfig</option>, <option value="classKCal_1_1ResourceCalendar.html">kcal::resourcecalendar</option>, <option value="classKCal_1_1ResourceLocal.html">kcal::resourcelocal</option>, <option value="classKCal_1_1ResourceLocalConfig.html">kcal::resourcelocalconfig</option>, <option value="classKCal_1_1ResourceLocalDir.html">kcal::resourcelocaldir</option>, <option value="classKCal_1_1ResourceLocalDirConfig.html">kcal::resourcelocaldirconfig</option>, <option value="classKCal_1_1ScheduleMessage.html">kcal::schedulemessage</option>, <option value="classKCal_1_1Scheduler.html">kcal::scheduler</option>, <option value="classKCal_1_1SortableList.html">kcal::sortablelist</option>, <option value="classKCal_1_1Todo.html">kcal::todo</option>,
</select>
</form>
</div>
-->
<div class="menu_box">
<a name="cp-menu" /><div class="menutitle"><div>
<h2 id="cp-menu-project">kdepimlibs-4.10.5 API Reference</h2>
<a href="#cp-skip-project" class="cp-doNotDisplay">Skip menu "kdepimlibs-4.10.5 API Reference"</a>
</div></div>
<div class="nav_list">
<ul>
<li><a href="../../akonadi/html/index.html">akonadi</a></li><li> <a href="../../akonadi/contact/html/index.html">contact</a></li><li> <a href="../../akonadi/kmime/html/index.html">kmime</a></li><li> <a href="../../akonadi/socialutils/html/index.html">socialutils</a></li><li><a href="../../kabc/html/index.html">kabc</a></li><li><a href="../../kalarmcal/html/index.html">kalarmcal</a></li><li><a href="../../kblog/html/index.html">kblog</a></li><li><a href="../../kcal/html/index.html">kcal</a></li><li><a href="../../kcalcore/html/index.html">kcalcore</a></li><li><a href="../../kcalutils/html/index.html">kcalutils</a></li><li><a href="../../kholidays/html/index.html">kholidays</a></li><li><a href="../../kimap/html/index.html">kimap</a></li><li><a href="../../kioslave/html/index.html">kioslave</a></li><li> <a href="../../kioslave/imap4/html/index.html">imap4</a></li><li> <a href="../../kioslave/mbox/html/index.html">mbox</a></li><li> <a href="../../kioslave/nntp/html/index.html">nntp</a></li><li><a href="../../kldap/html/index.html">kldap</a></li><li><a href="../../kmbox/html/index.html">kmbox</a></li><li><a href="../../kmime/html/index.html">kmime</a></li><li><a href="../../kontactinterface/html/index.html">kontactinterface</a></li><li><a href="../../kpimidentities/html/index.html">kpimidentities</a></li><li><a href="../../kpimtextedit/html/index.html">kpimtextedit</a></li><li><a href="../../kpimutils/html/index.html">kpimutils</a></li><li><a href="../../kresources/html/index.html">kresources</a></li><li><a href="../../ktnef/html/index.html">ktnef</a></li><li><a href="../../kxmlrpcclient/html/index.html">kxmlrpcclient</a></li><li><a href="../../mailtransport/html/index.html">mailtransport</a></li><li><a href="../../microblog/html/index.html">microblog</a></li><li><a href="../../qgpgme/html/index.html">qgpgme</a></li><li><a href="../../syndication/html/index.html">syndication</a></li><li> <a href="../../syndication/atom/html/index.html">atom</a></li><li> <a href="../../syndication/rdf/html/index.html">rdf</a></li><li> <a href="../../syndication/rss2/html/index.html">rss2</a></li>
</ul></div></div>
<!-- api_searchbox -->
</div>
</div>
<div class="clearer"></div>
</div>
<div class="clearer"></div>
</div>
<div id="end_body"></div>
<div id="footer"><div id="footer_text">
Report problems with this website to <a href="https://bugs.kde.org/enter_sysadmin_request.cgi?component=api.kde.org">our bug tracking system</a>.<br>
Contact the specific authors with questions and comments about the page contents.<p>
KDE<sup>®</sup> and <a href="/media/images/kde_gear_black.png">the K Desktop Environment<sup>®</sup> logo</a> are registered trademarks of <a href="http://ev.kde.org/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
<a href="http://www.kde.org/contact/impressum.php">Legal</a></p>
</div></div>
</div>
<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-45abe0e0c3bebc77@kde.org">Block me</a>
WARNING END
-->
</body>
</html>
