Release 0.52
[awl.git] / docs / api / awl / vComponent / vComponent.html
blob6a84c8c5d77e0c9c05809835572b32900e5d625e
2 Warning: strftime(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier. We selected the timezone 'UTC' for now, but please set date.timezone to select your timezone. in /usr/share/php/PhpDocumentor/phpDocumentor/Smarty-2.6.0/libs/Smarty_Compiler.class.php on line 370
3 <?xml version="1.0" encoding="iso-8859-1"?>
4 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5 <html xmlns="http://www.w3.org/1999/xhtml">
6 <head>
7 <!-- template designed by Marco Von Ballmoos -->
8 <title>Docs For Class vComponent</title>
9 <link rel="stylesheet" href="../../media/stylesheet.css" />
10 <script src="../../media/lib/classTree.js"></script>
11 <script language="javascript" type="text/javascript">
12 var imgPlus = new Image();
13 var imgMinus = new Image();
14 imgPlus.src = "../../media/images/plus.png";
15 imgMinus.src = "../../media/images/minus.png";
17 function showNode(Node){
18 switch(navigator.family){
19 case 'nn4':
20 // Nav 4.x code fork...
21 var oTable = document.layers["span" + Node];
22 var oImg = document.layers["img" + Node];
23 break;
24 case 'ie4':
25 // IE 4/5 code fork...
26 var oTable = document.all["span" + Node];
27 var oImg = document.all["img" + Node];
28 break;
29 case 'gecko':
30 // Standards Compliant code fork...
31 var oTable = document.getElementById("span" + Node);
32 var oImg = document.getElementById("img" + Node);
33 break;
35 oImg.src = imgMinus.src;
36 oTable.style.display = "block";
39 function hideNode(Node){
40 switch(navigator.family){
41 case 'nn4':
42 // Nav 4.x code fork...
43 var oTable = document.layers["span" + Node];
44 var oImg = document.layers["img" + Node];
45 break;
46 case 'ie4':
47 // IE 4/5 code fork...
48 var oTable = document.all["span" + Node];
49 var oImg = document.all["img" + Node];
50 break;
51 case 'gecko':
52 // Standards Compliant code fork...
53 var oTable = document.getElementById("span" + Node);
54 var oImg = document.getElementById("img" + Node);
55 break;
57 oImg.src = imgPlus.src;
58 oTable.style.display = "none";
61 function nodeIsVisible(Node){
62 switch(navigator.family){
63 case 'nn4':
64 // Nav 4.x code fork...
65 var oTable = document.layers["span" + Node];
66 break;
67 case 'ie4':
68 // IE 4/5 code fork...
69 var oTable = document.all["span" + Node];
70 break;
71 case 'gecko':
72 // Standards Compliant code fork...
73 var oTable = document.getElementById("span" + Node);
74 break;
76 return (oTable && oTable.style.display == "block");
79 function toggleNodeVisibility(Node){
80 if (nodeIsVisible(Node)){
81 hideNode(Node);
82 }else{
83 showNode(Node);
86 </script>
87 </head>
88 <body>
89 <div class="page-body">
90 <h2 class="class-name"><img src="../../media/images/Class_logo.png"
91 alt=" Class"
92 title=" Class"
93 style="vertical-align: middle"> vComponent</h2>
95 <a name="sec-description"></a>
96 <div class="info-box">
97 <div class="info-box-title">Description</div>
98 <div class="nav-bar">
99 <span class="disabled">Description</span> |
100 <a href="#sec-descendents">Descendents</a>
101 | <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
102 | <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
104 </div>
105 <div class="info-box-body">
107 Warning: strftime(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier. We selected the timezone 'UTC' for now, but please set date.timezone to select your timezone. in /usr/share/php/PhpDocumentor/phpDocumentor/Smarty-2.6.0/libs/Smarty_Compiler.class.php on line 370
108 <!-- ========== Info from phpDoc block ========= -->
109 <p class="short-description">A Class for representing components within an vComponent</p>
110 <p class="notes">
111 Located in <a class="field" href="_vComponent.php.html">/vComponent.php</a> (line <span class="field">409</span>)
112 </p>
115 <pre></pre>
117 </div>
118 </div>
120 <a name="sec-descendents"></a>
121 <div class="info-box">
122 <div class="info-box-title">Direct descendents</div>
123 <div class="nav-bar">
124 <a href="#sec-description">Description</a> |
125 <span class="disabled">Descendents</span>
126 | <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
127 | <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
129 </div>
130 <div class="info-box-body">
131 <table cellpadding="2" cellspacing="0" class="class-table">
132 <tr>
133 <th class="class-table-header">Class</th>
134 <th class="class-table-header">Description</th>
135 </tr>
136 <tr>
137 <td style="padding-right: 2em; white-space: nowrap">
138 <img src="../../media/images/Class.png"
139 alt=" class"
140 title=" class"
141 style="vertical-align: center"/>
142 <a href="../../awl/vCalendar/vCalendar.html">vCalendar</a>
143 </td>
144 <td>
145 A Class for representing components within an vComponent
146 </td>
147 </tr>
148 </table>
149 </div>
150 </div>
153 <a name="sec-var-summary"></a>
154 <div class="info-box">
155 <div class="info-box-title">Variable Summary</span></div>
156 <div class="nav-bar">
157 <a href="#sec-description">Description</a> |
158 <a href="#sec-descendents">Descendants</a> |
159 <span class="disabled">Vars</span> (<a href="#sec-vars">details</a>)
161 <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
163 </div>
164 <div class="info-box-body">
165 <div class="var-summary">
166 <div class="var-title">
167 <img src="../../media/images/Variable.png" alt=" " />
168 <span class="var-type">array</span>
169 <a href="#$components" title="details" class="var-name">$components</a>
170 </div>
171 <div class="var-title">
172 <img src="../../media/images/Variable.png" alt=" " />
173 <span class="var-type">array</span>
174 <a href="#$properties" title="details" class="var-name">$properties</a>
175 </div>
176 <div class="var-title">
177 <img src="../../media/images/Variable.png" alt=" " />
178 <span class="var-type">array</span>
179 <a href="#$rendered" title="details" class="var-name">$rendered</a>
180 </div>
181 <div class="var-title">
182 <img src="../../media/images/Variable.png" alt=" " />
183 <span class="var-type">string</span>
184 <a href="#$type" title="details" class="var-name">$type</a>
185 </div>
186 </div>
187 </div>
188 </div>
190 <a name="sec-method-summary"></a>
191 <div class="info-box">
192 <div class="info-box-title">Method Summary</span></div>
193 <div class="nav-bar">
194 <a href="#sec-description">Description</a> |
195 <a href="#sec-descendents">Descendants</a> |
196 <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
199 <span class="disabled">Methods</span> (<a href="#sec-methods">details</a>)
200 </div>
201 <div class="info-box-body">
202 <div class="method-summary">
204 <div class="method-definition">
205 <img src="../../media/images/Constructor.png" alt=" "/>
206 <span class="method-result">vComponent</span>
207 <a href="#__construct" title="details" class="method-name">__construct</a>
208 ([<span class="var-type"></span>&nbsp;<span class="var-name">$content</span> = <span class="var-default">null</span>])
209 </div>
211 <div class="method-definition">
212 <img src="../../media/images/Method.png" alt=" "/>
213 <span class="method-result">void</span>
214 <a href="#AddComponent" title="details" class="method-name">AddComponent</a>
215 (<span class="var-type"><a href="../../awl/vComponent/vComponent.html">vComponent</a></span>&nbsp;<span class="var-name">$new_component</span>)
216 </div>
218 <div class="method-definition">
219 <img src="../../media/images/Method.png" alt=" "/>
220 <span class="method-result">void</span>
221 <a href="#AddProperty" title="details" class="method-name">AddProperty</a>
222 (<span class="var-type"><a href="../../awl/vComponent/vProperty.html">vProperty</a></span>&nbsp;<span class="var-name">$new_property</span>, [<span class="var-type">string</span>&nbsp;<span class="var-name">$value</span> = <span class="var-default">null</span>], [<span class="var-type">array</span>&nbsp;<span class="var-name">$parameters</span> = <span class="var-default">null</span>])
223 </div>
225 <div class="method-definition">
226 <img src="../../media/images/Method.png" alt=" "/>
227 <span class="method-result">void</span>
228 <a href="#ClearComponents" title="details" class="method-name">ClearComponents</a>
229 ([<span class="var-type">string</span>&nbsp;<span class="var-name">$type</span> = <span class="var-default">null</span>])
230 </div>
232 <div class="method-definition">
233 <img src="../../media/images/Method.png" alt=" "/>
234 <span class="method-result">void</span>
235 <a href="#ClearProperties" title="details" class="method-name">ClearProperties</a>
236 ([<span class="var-type">string|array</span>&nbsp;<span class="var-name">$type</span> = <span class="var-default">null</span>])
237 </div>
239 <div class="method-definition">
240 <img src="../../media/images/Method.png" alt=" "/>
241 <span class="method-result">void</span>
242 <a href="#CollectParameterValues" title="details" class="method-name">CollectParameterValues</a>
243 (<span class="var-type"></span>&nbsp;<span class="var-name">$parameter_name</span>)
244 </div>
246 <div class="method-definition">
247 <img src="../../media/images/Method.png" alt=" "/>
248 <span class="method-result">void</span>
249 <a href="#ComponentCount" title="details" class="method-name">ComponentCount</a>
251 </div>
253 <div class="method-definition">
254 <img src="../../media/images/Method.png" alt=" "/>
255 <span class="method-result">array</span>
256 <a href="#GetComponents" title="details" class="method-name">GetComponents</a>
257 ([<span class="var-type">mixed</span>&nbsp;<span class="var-name">$type</span> = <span class="var-default">null</span>], [<span class="var-type">boolean</span>&nbsp;<span class="var-name">$normal_match</span> = <span class="var-default">true</span>])
258 </div>
260 <div class="method-definition">
261 <img src="../../media/images/Method.png" alt=" "/>
262 <span class="method-result">void</span>
263 <a href="#GetProperties" title="details" class="method-name">GetProperties</a>
264 ([<span class="var-type"></span>&nbsp;<span class="var-name">$type</span> = <span class="var-default">null</span>])
265 </div>
267 <div class="method-definition">
268 <img src="../../media/images/Method.png" alt=" "/>
269 <span class="method-result">array</span>
270 <a href="#GetPropertiesByPath" title="details" class="method-name">GetPropertiesByPath</a>
271 (<span class="var-type"></span>&nbsp;<span class="var-name">$path</span>)
272 </div>
274 <div class="method-definition">
275 <img src="../../media/images/Method.png" alt=" "/>
276 <span class="method-result">void</span>
277 <a href="#GetProperty" title="details" class="method-name">GetProperty</a>
278 (<span class="var-type"></span>&nbsp;<span class="var-name">$type</span>)
279 </div>
281 <div class="method-definition">
282 <img src="../../media/images/Method.png" alt=" "/>
283 <span class="method-result">void</span>
284 <a href="#GetPValue" title="details" class="method-name">GetPValue</a>
285 (<span class="var-type"></span>&nbsp;<span class="var-name">$type</span>)
286 </div>
288 <div class="method-definition">
289 <img src="../../media/images/Method.png" alt=" "/>
290 <span class="method-result">void</span>
291 <a href="#GetType" title="details" class="method-name">GetType</a>
293 </div>
295 <div class="method-definition">
296 <img src="../../media/images/Method.png" alt=" "/>
297 <span class="method-result">void</span>
298 <a href="#MaskComponents" title="details" class="method-name">MaskComponents</a>
299 (<span class="var-type">array</span>&nbsp;<span class="var-name">$keep</span>, [<span class="var-type">boolean</span>&nbsp;<span class="var-name">$recursive</span> = <span class="var-default">true</span>])
300 </div>
302 <div class="method-definition">
303 <img src="../../media/images/Method.png" alt=" "/>
304 <span class="method-result">void</span>
305 <a href="#MaskProperties" title="details" class="method-name">MaskProperties</a>
306 (<span class="var-type">array</span>&nbsp;<span class="var-name">$keep</span>, [<span class="var-type">array</span>&nbsp;<span class="var-name">$component_list</span> = <span class="var-default">null</span>])
307 </div>
309 <div class="method-definition">
310 <img src="../../media/images/Method.png" alt=" "/>
311 <span class="method-result">void</span>
312 <a href="#ParseFrom" title="details" class="method-name">ParseFrom</a>
313 (<span class="var-type">string</span>&nbsp;<span class="var-name">$content</span>)
314 </div>
316 <div class="method-definition">
317 <img src="../../media/images/Method.png" alt=" "/>
318 <span class="method-result">void</span>
319 <a href="#Render" title="details" class="method-name">Render</a>
320 ([<span class="var-type"></span>&nbsp;<span class="var-name">$restricted_properties</span> = <span class="var-default">null</span>], [<span class="var-type"></span>&nbsp;<span class="var-name">$force_rendering</span> = <span class="var-default">false</span>])
321 </div>
323 <div class="method-definition">
324 <img src="../../media/images/Method.png" alt=" "/>
325 <span class="method-result">void</span>
326 <a href="#SetComponents" title="details" class="method-name">SetComponents</a>
327 (<span class="var-type">array</span>&nbsp;<span class="var-name">$new_component</span>, [<span class="var-type">string</span>&nbsp;<span class="var-name">$type</span> = <span class="var-default">null</span>])
328 </div>
330 <div class="method-definition">
331 <img src="../../media/images/Method.png" alt=" "/>
332 <span class="method-result">void</span>
333 <a href="#SetProperties" title="details" class="method-name">SetProperties</a>
334 (<span class="var-type"></span>&nbsp;<span class="var-name">$new_properties</span>, [<span class="var-type"></span>&nbsp;<span class="var-name">$type</span> = <span class="var-default">null</span>])
335 </div>
337 <div class="method-definition">
338 <img src="../../media/images/Method.png" alt=" "/>
339 <span class="method-result">void</span>
340 <a href="#SetType" title="details" class="method-name">SetType</a>
341 (<span class="var-type"></span>&nbsp;<span class="var-name">$type</span>)
342 </div>
344 <div class="method-definition">
345 <img src="../../media/images/Method.png" alt=" "/>
346 <span class="method-result">boolean</span>
347 <a href="#TestFilter" title="details" class="method-name">TestFilter</a>
348 (<span class="var-type"></span>&nbsp;<span class="var-name">$filters</span>, <span class="var-type">array</span>&nbsp;<span class="var-name">$filter</span>)
349 </div>
351 <div class="method-definition">
352 <img src="../../media/images/Method.png" alt=" "/>
353 <span class="method-result">void</span>
354 <a href="#UnwrapComponent" title="details" class="method-name">UnwrapComponent</a>
355 (<span class="var-type"></span>&nbsp;<span class="var-name">$content</span>)
356 </div>
358 <div class="method-definition">
359 <img src="../../media/images/Method.png" alt=" "/>
360 <span class="method-result">void</span>
361 <a href="#WrapComponent" title="details" class="method-name">WrapComponent</a>
362 (<span class="var-type"></span>&nbsp;<span class="var-name">$content</span>)
363 </div>
365 <div class="method-definition">
366 <img src="../../media/images/Method.png" alt=" "/>
367 <span class="method-result">void</span>
368 <a href="#__toString" title="details" class="method-name">__toString</a>
370 </div>
371 </div>
372 </div>
373 </div>
375 <a name="sec-vars"></a>
376 <div class="info-box">
377 <div class="info-box-title">Variables</div>
378 <div class="nav-bar">
379 <a href="#sec-description">Description</a> |
380 <a href="#sec-descendents">Descendents</a> |
381 <a href="#sec-var-summary">Vars</a> (<span class="disabled">details</span>)
385 <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
387 </div>
388 <div class="info-box-body">
390 Strict Standards: Only variables should be passed by reference in /usr/share/php/PhpDocumentor/phpDocumentor/Smarty-2.6.0/libs/Smarty_Compiler.class.php on line 712
392 Warning: strftime(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier. We selected the timezone 'UTC' for now, but please set date.timezone to select your timezone. in /usr/share/php/PhpDocumentor/phpDocumentor/Smarty-2.6.0/libs/Smarty_Compiler.class.php on line 370
394 <a name="var$components" id="$components"><!-- --></A>
395 <div class="evenrow">
397 <div class="var-header">
398 <img src="../../media/images/Variable.png" />
399 <span class="var-title">
400 <span class="var-type">array</span>
401 <span class="var-name">$components</span>
402 (line <span class="line-number">433</span>)
403 </span>
404 </div>
406 <!-- ========== Info from phpDoc block ========= -->
407 <p class="short-description">An array of (sub-)components, which are vComponent objects</p>
408 <ul class="tags">
409 <li><span class="field">access:</span> protected</li>
410 </ul>
416 </div>
417 <a name="var$properties" id="$properties"><!-- --></A>
418 <div class="oddrow">
420 <div class="var-header">
421 <img src="../../media/images/Variable.png" />
422 <span class="var-title">
423 <span class="var-type">array</span>
424 <span class="var-name">$properties</span>
425 (line <span class="line-number">426</span>)
426 </span>
427 </div>
429 <!-- ========== Info from phpDoc block ========= -->
430 <p class="short-description">An array of properties, which are vProperty objects</p>
431 <ul class="tags">
432 <li><span class="field">access:</span> protected</li>
433 </ul>
439 </div>
440 <a name="var$rendered" id="$rendered"><!-- --></A>
441 <div class="evenrow">
443 <div class="var-header">
444 <img src="../../media/images/Variable.png" />
445 <span class="var-title">
446 <span class="var-type">array</span>
447 <span class="var-name">$rendered</span>
448 (line <span class="line-number">440</span>)
449 </span>
450 </div>
452 <!-- ========== Info from phpDoc block ========= -->
453 <p class="short-description">The rendered result (or what was originally parsed, if there have been no changes)</p>
454 <ul class="tags">
455 <li><span class="field">access:</span> protected</li>
456 </ul>
462 </div>
463 <a name="var$type" id="$type"><!-- --></A>
464 <div class="oddrow">
466 <div class="var-header">
467 <img src="../../media/images/Variable.png" />
468 <span class="var-title">
469 <span class="var-type">string</span>
470 <span class="var-name">$type</span>
471 (line <span class="line-number">419</span>)
472 </span>
473 </div>
475 <!-- ========== Info from phpDoc block ========= -->
476 <p class="short-description">The type of this component, such as 'VEVENT', 'VTODO', 'VTIMEZONE', 'VCARD', etc.</p>
477 <ul class="tags">
478 <li><span class="field">access:</span> protected</li>
479 </ul>
485 </div>
487 </div>
488 </div>
490 <a name="sec-methods"></a>
491 <div class="info-box">
492 <div class="info-box-title">Methods</div>
493 <div class="nav-bar">
494 <a href="#sec-description">Description</a> |
495 <a href="#sec-descendents">Descendents</a> |
496 <a href="#sec-var-summary">Vars</a> (<a href="#sec-vars">details</a>)
497 <a href="#sec-method-summary">Methods</a> (<span class="disabled">details</span>)
499 </div>
500 <div class="info-box-body">
502 Strict Standards: Only variables should be passed by reference in /usr/share/php/PhpDocumentor/phpDocumentor/Smarty-2.6.0/libs/Smarty_Compiler.class.php on line 712
504 Warning: strftime(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier. We selected the timezone 'UTC' for now, but please set date.timezone to select your timezone. in /usr/share/php/PhpDocumentor/phpDocumentor/Smarty-2.6.0/libs/Smarty_Compiler.class.php on line 370
505 <A NAME='method_detail'></A>
506 <a name="method__construct" id="__construct"><!-- --></a>
507 <div class="evenrow">
509 <div class="method-header">
510 <img src="../../media/images/Constructor.png" />
511 <span class="method-title">Constructor __construct</span> (line <span class="line-number">447</span>)
512 </div>
514 <!-- ========== Info from phpDoc block ========= -->
515 <p class="short-description">A basic constructor</p>
517 <div class="method-signature">
518 <span class="method-result">vComponent</span>
519 <span class="method-name">
520 __construct
521 </span>
522 ([<span class="var-type"></span>&nbsp;<span class="var-name">$content</span> = <span class="var-default">null</span>])
523 </div>
525 <ul class="parameters">
526 <li>
527 <span class="var-type"></span>
528 <span class="var-name">$content</span> </li>
529 </ul>
532 <hr class="separator" />
533 <div class="notes">Redefined in descendants as:</div>
534 <ul class="redefinitions">
535 <li>
536 <a href="../../awl/vCalendar/vCalendar.html#method__construct">vCalendar::__construct()</a>
537 : Constructor. If a string is passed it will be parsed as if it was an iCalendar object, otherwise a new vCalendar will be initialised with basic content. If an array of key value pairs is provided they will also be used as top-level properties.
538 </li>
539 </ul>
540 </div>
541 <a name="methodAddComponent" id="AddComponent"><!-- --></a>
542 <div class="oddrow">
544 <div class="method-header">
545 <img src="../../media/images/Method.png" />
546 <span class="method-title">AddComponent</span> (line <span class="line-number">796</span>)
547 </div>
549 <!-- ========== Info from phpDoc block ========= -->
550 <p class="short-description">Adds a new subcomponent</p>
552 <div class="method-signature">
553 <span class="method-result">void</span>
554 <span class="method-name">
555 AddComponent
556 </span>
557 (<span class="var-type"><a href="../../awl/vComponent/vComponent.html">vComponent</a></span>&nbsp;<span class="var-name">$new_component</span>)
558 </div>
560 <ul class="parameters">
561 <li>
562 <span class="var-type"><a href="../../awl/vComponent/vComponent.html">vComponent</a></span>
563 <span class="var-name">$new_component</span><span class="var-description">: The new component to append to the set</span> </li>
564 </ul>
567 </div>
568 <a name="methodAddProperty" id="AddProperty"><!-- --></a>
569 <div class="evenrow">
571 <div class="method-header">
572 <img src="../../media/images/Method.png" />
573 <span class="method-title">AddProperty</span> (line <span class="line-number">693</span>)
574 </div>
576 <!-- ========== Info from phpDoc block ========= -->
577 <p class="short-description">Adds a new property</p>
579 <div class="method-signature">
580 <span class="method-result">void</span>
581 <span class="method-name">
582 AddProperty
583 </span>
584 (<span class="var-type"><a href="../../awl/vComponent/vProperty.html">vProperty</a></span>&nbsp;<span class="var-name">$new_property</span>, [<span class="var-type">string</span>&nbsp;<span class="var-name">$value</span> = <span class="var-default">null</span>], [<span class="var-type">array</span>&nbsp;<span class="var-name">$parameters</span> = <span class="var-default">null</span>])
585 </div>
587 <ul class="parameters">
588 <li>
589 <span class="var-type"><a href="../../awl/vComponent/vProperty.html">vProperty</a></span>
590 <span class="var-name">$new_property</span><span class="var-description">: The new property to append to the set, or a string with the name</span> </li>
591 <li>
592 <span class="var-type">string</span>
593 <span class="var-name">$value</span><span class="var-description">: The value of the new property (default: param 1 is an vProperty with everything</span> </li>
594 <li>
595 <span class="var-type">array</span>
596 <span class="var-name">$parameters</span><span class="var-description">: The key/value parameter pairs (default: none, or param 1 is an vProperty with everything)</span> </li>
597 </ul>
600 </div>
601 <a name="methodClearComponents" id="ClearComponents"><!-- --></a>
602 <div class="oddrow">
604 <div class="method-header">
605 <img src="../../media/images/Method.png" />
606 <span class="method-title">ClearComponents</span> (line <span class="line-number">751</span>)
607 </div>
609 <!-- ========== Info from phpDoc block ========= -->
610 <p class="short-description">Clear all components, or the components matching a particular type</p>
612 <div class="method-signature">
613 <span class="method-result">void</span>
614 <span class="method-name">
615 ClearComponents
616 </span>
617 ([<span class="var-type">string</span>&nbsp;<span class="var-name">$type</span> = <span class="var-default">null</span>])
618 </div>
620 <ul class="parameters">
621 <li>
622 <span class="var-type">string</span>
623 <span class="var-name">$type</span><span class="var-description">: The type of component - omit for all components</span> </li>
624 </ul>
627 </div>
628 <a name="methodClearProperties" id="ClearProperties"><!-- --></a>
629 <div class="evenrow">
631 <div class="method-header">
632 <img src="../../media/images/Method.png" />
633 <span class="method-title">ClearProperties</span> (line <span class="line-number">655</span>)
634 </div>
636 <!-- ========== Info from phpDoc block ========= -->
637 <p class="short-description">Clear all properties, or the properties matching a particular type</p>
639 <div class="method-signature">
640 <span class="method-result">void</span>
641 <span class="method-name">
642 ClearProperties
643 </span>
644 ([<span class="var-type">string|array</span>&nbsp;<span class="var-name">$type</span> = <span class="var-default">null</span>])
645 </div>
647 <ul class="parameters">
648 <li>
649 <span class="var-type">string|array</span>
650 <span class="var-name">$type</span><span class="var-description">: The type of property - omit for all properties - or an array associating property names with true values: array( 'PROPERTY' =&gt; true, 'PROPERTY2' =&gt; true )</span> </li>
651 </ul>
654 </div>
655 <a name="methodCollectParameterValues" id="CollectParameterValues"><!-- --></a>
656 <div class="oddrow">
658 <div class="method-header">
659 <img src="../../media/images/Method.png" />
660 <span class="method-title">CollectParameterValues</span> (line <span class="line-number">462</span>)
661 </div>
663 <!-- ========== Info from phpDoc block ========= -->
664 <p class="short-description">Collect an array of all parameters of our properties which are the specified type</p>
665 <p class="description"><p>Mainly used for collecting the full variety of references TZIDs</p></p>
667 <div class="method-signature">
668 <span class="method-result">void</span>
669 <span class="method-name">
670 CollectParameterValues
671 </span>
672 (<span class="var-type"></span>&nbsp;<span class="var-name">$parameter_name</span>)
673 </div>
675 <ul class="parameters">
676 <li>
677 <span class="var-type"></span>
678 <span class="var-name">$parameter_name</span> </li>
679 </ul>
682 </div>
683 <a name="methodComponentCount" id="ComponentCount"><!-- --></a>
684 <div class="evenrow">
686 <div class="method-header">
687 <img src="../../media/images/Method.png" />
688 <span class="method-title">ComponentCount</span> (line <span class="line-number">712</span>)
689 </div>
691 <!-- ========== Info from phpDoc block ========= -->
692 <p class="short-description">Return number of components</p>
694 <div class="method-signature">
695 <span class="method-result">void</span>
696 <span class="method-name">
697 ComponentCount
698 </span>
700 </div>
704 </div>
705 <a name="methodGetComponents" id="GetComponents"><!-- --></a>
706 <div class="oddrow">
708 <div class="method-header">
709 <img src="../../media/images/Method.png" />
710 <span class="method-title">GetComponents</span> (line <span class="line-number">726</span>)
711 </div>
713 <!-- ========== Info from phpDoc block ========= -->
714 <p class="short-description">Get all sub-components, or at least get those matching a type, or failling to match, should the second parameter be set to false. Component types may be a string or an array associating property names with true values: array( 'TYPE' =&gt; true, 'TYPE2' =&gt; true )</p>
715 <ul class="tags">
716 <li><span class="field">return:</span> an array of the sub-components</li>
717 </ul>
719 <div class="method-signature">
720 <span class="method-result">array</span>
721 <span class="method-name">
722 GetComponents
723 </span>
724 ([<span class="var-type">mixed</span>&nbsp;<span class="var-name">$type</span> = <span class="var-default">null</span>], [<span class="var-type">boolean</span>&nbsp;<span class="var-name">$normal_match</span> = <span class="var-default">true</span>])
725 </div>
727 <ul class="parameters">
728 <li>
729 <span class="var-type">mixed</span>
730 <span class="var-name">$type</span><span class="var-description">: The type(s) to match (default: All)</span> </li>
731 <li>
732 <span class="var-type">boolean</span>
733 <span class="var-name">$normal_match</span><span class="var-description">: Set to false to invert the match (default: true)</span> </li>
734 </ul>
737 </div>
738 <a name="methodGetProperties" id="GetProperties"><!-- --></a>
739 <div class="evenrow">
741 <div class="method-header">
742 <img src="../../media/images/Method.png" />
743 <span class="method-title">GetProperties</span> (line <span class="line-number">638</span>)
744 </div>
746 <!-- ========== Info from phpDoc block ========= -->
747 <p class="short-description">Get all properties, or the properties matching a particular type, or matching an</p>
748 <p class="description"><p>array associating property names with true values: array( 'PROPERTY' =&gt; true, 'PROPERTY2' =&gt; true )</p></p>
750 <div class="method-signature">
751 <span class="method-result">void</span>
752 <span class="method-name">
753 GetProperties
754 </span>
755 ([<span class="var-type"></span>&nbsp;<span class="var-name">$type</span> = <span class="var-default">null</span>])
756 </div>
758 <ul class="parameters">
759 <li>
760 <span class="var-type"></span>
761 <span class="var-name">$type</span> </li>
762 </ul>
765 </div>
766 <a name="methodGetPropertiesByPath" id="GetPropertiesByPath"><!-- --></a>
767 <div class="oddrow">
769 <div class="method-header">
770 <img src="../../media/images/Method.png" />
771 <span class="method-title">GetPropertiesByPath</span> (line <span class="line-number">889</span>)
772 </div>
774 <!-- ========== Info from phpDoc block ========= -->
775 <p class="short-description">Return an array of properties matching the specified path</p>
776 <ul class="tags">
777 <li><span class="field">return:</span> An array of vProperty within the tree which match the path given, in the form [/]COMPONENT[/...]/PROPERTY in a syntax kind of similar to our poor man's XML queries. We also allow COMPONENT and PROPERTY to be !COMPONENT and !PROPERTY for ++fun.</li>
778 </ul>
780 <div class="method-signature">
781 <span class="method-result">array</span>
782 <span class="method-name">
783 GetPropertiesByPath
784 </span>
785 (<span class="var-type"></span>&nbsp;<span class="var-name">$path</span>)
786 </div>
788 <ul class="parameters">
789 <li>
790 <span class="var-type"></span>
791 <span class="var-name">$path</span> </li>
792 </ul>
795 </div>
796 <a name="methodGetProperty" id="GetProperty"><!-- --></a>
797 <div class="evenrow">
799 <div class="method-header">
800 <img src="../../media/images/Method.png" />
801 <span class="method-title">GetProperty</span> (line <span class="line-number">610</span>)
802 </div>
804 <!-- ========== Info from phpDoc block ========= -->
805 <p class="short-description">Return the first instance of a property of this name</p>
807 <div class="method-signature">
808 <span class="method-result">void</span>
809 <span class="method-name">
810 GetProperty
811 </span>
812 (<span class="var-type"></span>&nbsp;<span class="var-name">$type</span>)
813 </div>
815 <ul class="parameters">
816 <li>
817 <span class="var-type"></span>
818 <span class="var-name">$type</span> </li>
819 </ul>
822 </div>
823 <a name="methodGetPValue" id="GetPValue"><!-- --></a>
824 <div class="oddrow">
826 <div class="method-header">
827 <img src="../../media/images/Method.png" />
828 <span class="method-title">GetPValue</span> (line <span class="line-number">627</span>)
829 </div>
831 <!-- ========== Info from phpDoc block ========= -->
832 <p class="short-description">Return the value of the first instance of a property of this name, or null</p>
834 <div class="method-signature">
835 <span class="method-result">void</span>
836 <span class="method-name">
837 GetPValue
838 </span>
839 (<span class="var-type"></span>&nbsp;<span class="var-name">$type</span>)
840 </div>
842 <ul class="parameters">
843 <li>
844 <span class="var-type"></span>
845 <span class="var-name">$type</span> </li>
846 </ul>
849 </div>
850 <a name="methodGetType" id="GetType"><!-- --></a>
851 <div class="evenrow">
853 <div class="method-header">
854 <img src="../../media/images/Method.png" />
855 <span class="method-title">GetType</span> (line <span class="line-number">592</span>)
856 </div>
858 <!-- ========== Info from phpDoc block ========= -->
859 <p class="short-description">Return the type of component which this is</p>
861 <div class="method-signature">
862 <span class="method-result">void</span>
863 <span class="method-name">
864 GetType
865 </span>
867 </div>
871 </div>
872 <a name="methodMaskComponents" id="MaskComponents"><!-- --></a>
873 <div class="oddrow">
875 <div class="method-header">
876 <img src="../../media/images/Method.png" />
877 <span class="method-title">MaskComponents</span> (line <span class="line-number">815</span>)
878 </div>
880 <!-- ========== Info from phpDoc block ========= -->
881 <p class="short-description">Mask components, removing any that are not of the types in the list</p>
883 <div class="method-signature">
884 <span class="method-result">void</span>
885 <span class="method-name">
886 MaskComponents
887 </span>
888 (<span class="var-type">array</span>&nbsp;<span class="var-name">$keep</span>, [<span class="var-type">boolean</span>&nbsp;<span class="var-name">$recursive</span> = <span class="var-default">true</span>])
889 </div>
891 <ul class="parameters">
892 <li>
893 <span class="var-type">array</span>
894 <span class="var-name">$keep</span><span class="var-description">: An array of component types to be kept</span> </li>
895 <li>
896 <span class="var-type">boolean</span>
897 <span class="var-name">$recursive</span><span class="var-description">: (default true) Whether to recursively MaskComponents on the ones we find</span> </li>
898 </ul>
901 </div>
902 <a name="methodMaskProperties" id="MaskProperties"><!-- --></a>
903 <div class="evenrow">
905 <div class="method-header">
906 <img src="../../media/images/Method.png" />
907 <span class="method-title">MaskProperties</span> (line <span class="line-number">833</span>)
908 </div>
910 <!-- ========== Info from phpDoc block ========= -->
911 <p class="short-description">Mask properties, removing any that are not in the list</p>
913 <div class="method-signature">
914 <span class="method-result">void</span>
915 <span class="method-name">
916 MaskProperties
917 </span>
918 (<span class="var-type">array</span>&nbsp;<span class="var-name">$keep</span>, [<span class="var-type">array</span>&nbsp;<span class="var-name">$component_list</span> = <span class="var-default">null</span>])
919 </div>
921 <ul class="parameters">
922 <li>
923 <span class="var-type">array</span>
924 <span class="var-name">$keep</span><span class="var-description">: An array of property names to be kept</span> </li>
925 <li>
926 <span class="var-type">array</span>
927 <span class="var-name">$component_list</span><span class="var-description">: An array of component types to check within</span> </li>
928 </ul>
931 </div>
932 <a name="methodParseFrom" id="ParseFrom"><!-- --></a>
933 <div class="oddrow">
935 <div class="method-header">
936 <img src="../../media/images/Method.png" />
937 <span class="method-title">ParseFrom</span> (line <span class="line-number">483</span>)
938 </div>
940 <!-- ========== Info from phpDoc block ========= -->
941 <p class="short-description">Parse the text $content into sets of vProperty &amp; vComponent within this vComponent</p>
943 <div class="method-signature">
944 <span class="method-result">void</span>
945 <span class="method-name">
946 ParseFrom
947 </span>
948 (<span class="var-type">string</span>&nbsp;<span class="var-name">$content</span>)
949 </div>
951 <ul class="parameters">
952 <li>
953 <span class="var-type">string</span>
954 <span class="var-name">$content</span><span class="var-description">: The raw RFC2445-compliant vComponent component, including BEGIN:TYPE &amp; END:TYPE</span> </li>
955 </ul>
958 </div>
959 <a name="methodRender" id="Render"><!-- --></a>
960 <div class="evenrow">
962 <div class="method-header">
963 <img src="../../media/images/Method.png" />
964 <span class="method-title">Render</span> (line <span class="line-number">851</span>)
965 </div>
967 <!-- ========== Info from phpDoc block ========= -->
968 <p class="short-description">Renders the component, possibly restricted to only the listed properties</p>
970 <div class="method-signature">
971 <span class="method-result">void</span>
972 <span class="method-name">
973 Render
974 </span>
975 ([<span class="var-type"></span>&nbsp;<span class="var-name">$restricted_properties</span> = <span class="var-default">null</span>], [<span class="var-type"></span>&nbsp;<span class="var-name">$force_rendering</span> = <span class="var-default">false</span>])
976 </div>
978 <ul class="parameters">
979 <li>
980 <span class="var-type"></span>
981 <span class="var-name">$restricted_properties</span> </li>
982 <li>
983 <span class="var-type"></span>
984 <span class="var-name">$force_rendering</span> </li>
985 </ul>
988 </div>
989 <a name="methodSetComponents" id="SetComponents"><!-- --></a>
990 <div class="oddrow">
992 <div class="method-header">
993 <img src="../../media/images/Method.png" />
994 <span class="method-title">SetComponents</span> (line <span class="line-number">782</span>)
995 </div>
997 <!-- ========== Info from phpDoc block ========= -->
998 <p class="short-description">Sets some or all sub-components of the component to the supplied new components</p>
1000 <div class="method-signature">
1001 <span class="method-result">void</span>
1002 <span class="method-name">
1003 SetComponents
1004 </span>
1005 (<span class="var-type">array</span>&nbsp;<span class="var-name">$new_component</span>, [<span class="var-type">string</span>&nbsp;<span class="var-name">$type</span> = <span class="var-default">null</span>])
1006 </div>
1008 <ul class="parameters">
1009 <li>
1010 <span class="var-type">string</span>
1011 <span class="var-name">$type</span><span class="var-description">: The type of components to be replaced. Defaults to null, which means all components will be replaced.</span> </li>
1012 <li>
1013 <span class="var-type">array</span>
1014 <span class="var-name">$new_component</span><span class="var-description">: of vComponent $new_components The new components to replace the existing ones</span> </li>
1015 </ul>
1018 </div>
1019 <a name="methodSetProperties" id="SetProperties"><!-- --></a>
1020 <div class="evenrow">
1022 <div class="method-header">
1023 <img src="../../media/images/Method.png" />
1024 <span class="method-title">SetProperties</span> (line <span class="line-number">677</span>)
1025 </div>
1027 <!-- ========== Info from phpDoc block ========= -->
1028 <p class="short-description">Set all properties, or the ones matching a particular type</p>
1030 <div class="method-signature">
1031 <span class="method-result">void</span>
1032 <span class="method-name">
1033 SetProperties
1034 </span>
1035 (<span class="var-type"></span>&nbsp;<span class="var-name">$new_properties</span>, [<span class="var-type"></span>&nbsp;<span class="var-name">$type</span> = <span class="var-default">null</span>])
1036 </div>
1038 <ul class="parameters">
1039 <li>
1040 <span class="var-type"></span>
1041 <span class="var-name">$new_properties</span> </li>
1042 <li>
1043 <span class="var-type"></span>
1044 <span class="var-name">$type</span> </li>
1045 </ul>
1048 </div>
1049 <a name="methodSetType" id="SetType"><!-- --></a>
1050 <div class="oddrow">
1052 <div class="method-header">
1053 <img src="../../media/images/Method.png" />
1054 <span class="method-title">SetType</span> (line <span class="line-number">600</span>)
1055 </div>
1057 <!-- ========== Info from phpDoc block ========= -->
1058 <p class="short-description">Set the type of component which this is</p>
1060 <div class="method-signature">
1061 <span class="method-result">void</span>
1062 <span class="method-name">
1063 SetType
1064 </span>
1065 (<span class="var-type"></span>&nbsp;<span class="var-name">$type</span>)
1066 </div>
1068 <ul class="parameters">
1069 <li>
1070 <span class="var-type"></span>
1071 <span class="var-name">$type</span> </li>
1072 </ul>
1075 </div>
1076 <a name="methodTestFilter" id="TestFilter"><!-- --></a>
1077 <div class="evenrow">
1079 <div class="method-header">
1080 <img src="../../media/images/Method.png" />
1081 <span class="method-title">TestFilter</span> (line <span class="line-number">942</span>)
1082 </div>
1084 <!-- ========== Info from phpDoc block ========= -->
1085 <p class="short-description">Test a PROP-FILTER or COMP-FILTER and return a true/false COMP-FILTER (is-defined | is-not-defined | (time-range?, prop-filter*, comp-filter*)) PROP-FILTER (is-defined | is-not-defined | ((time-range | text-match)?, param-filter*))</p>
1086 <ul class="tags">
1087 <li><span class="field">return:</span> Whether or not this vComponent passes the test</li>
1088 </ul>
1090 <div class="method-signature">
1091 <span class="method-result">boolean</span>
1092 <span class="method-name">
1093 TestFilter
1094 </span>
1095 (<span class="var-type"></span>&nbsp;<span class="var-name">$filters</span>, <span class="var-type">array</span>&nbsp;<span class="var-name">$filter</span>)
1096 </div>
1098 <ul class="parameters">
1099 <li>
1100 <span class="var-type">array</span>
1101 <span class="var-name">$filter</span><span class="var-description">: An array of XMLElement defining the filter</span> </li>
1102 <li>
1103 <span class="var-type"></span>
1104 <span class="var-name">$filters</span> </li>
1105 </ul>
1108 </div>
1109 <a name="methodUnwrapComponent" id="UnwrapComponent"><!-- --></a>
1110 <div class="oddrow">
1112 <div class="method-header">
1113 <img src="../../media/images/Method.png" />
1114 <span class="method-title">UnwrapComponent</span> (line <span class="line-number">568</span>)
1115 </div>
1117 <!-- ========== Info from phpDoc block ========= -->
1118 <p class="short-description">This unescapes the (CRLF + linear space) wrapping specified in RFC2445. According to RFC2445 we should always end with CRLF but the CalDAV spec says that normalising XML parsers often muck with it and may remove the CR. We accept either case.</p>
1120 <div class="method-signature">
1121 <span class="method-result">void</span>
1122 <span class="method-name">
1123 UnwrapComponent
1124 </span>
1125 (<span class="var-type"></span>&nbsp;<span class="var-name">$content</span>)
1126 </div>
1128 <ul class="parameters">
1129 <li>
1130 <span class="var-type"></span>
1131 <span class="var-name">$content</span> </li>
1132 </ul>
1135 </div>
1136 <a name="methodWrapComponent" id="WrapComponent"><!-- --></a>
1137 <div class="evenrow">
1139 <div class="method-header">
1140 <img src="../../media/images/Method.png" />
1141 <span class="method-title">WrapComponent</span> (line <span class="line-number">580</span>)
1142 </div>
1144 <!-- ========== Info from phpDoc block ========= -->
1145 <p class="short-description">This imposes the (CRLF + linear space) wrapping specified in RFC2445. According to RFC2445 we should always end with CRLF but the CalDAV spec says that normalising XML parsers often muck with it and may remove the CR. We output RFC2445 compliance.</p>
1146 <p class="description"><p>In order to preserve pre-existing wrapping in the component, we split the incoming string on line breaks before running wordwrap over each component of that.</p></p>
1148 <div class="method-signature">
1149 <span class="method-result">void</span>
1150 <span class="method-name">
1151 WrapComponent
1152 </span>
1153 (<span class="var-type"></span>&nbsp;<span class="var-name">$content</span>)
1154 </div>
1156 <ul class="parameters">
1157 <li>
1158 <span class="var-type"></span>
1159 <span class="var-name">$content</span> </li>
1160 </ul>
1163 </div>
1164 <a name="method__toString" id="__toString"><!-- --></a>
1165 <div class="oddrow">
1167 <div class="method-header">
1168 <img src="../../media/images/Method.png" />
1169 <span class="method-title">__toString</span> (line <span class="line-number">875</span>)
1170 </div>
1172 <!-- ========== Info from phpDoc block ========= -->
1173 <ul class="tags">
1174 <li><span class="field">access:</span> public</li>
1175 </ul>
1177 <div class="method-signature">
1178 <span class="method-result">void</span>
1179 <span class="method-name">
1180 __toString
1181 </span>
1183 </div>
1187 </div>
1189 </div>
1190 </div>
1194 Warning: strftime(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. In case you used any of those methods and you are still getting this warning, you most likely misspelled the timezone identifier. We selected the timezone 'UTC' for now, but please set date.timezone to select your timezone. in /usr/share/php/PhpDocumentor/phpDocumentor/Smarty-2.6.0/libs/Smarty_Compiler.class.php on line 370
1195 <p class="notes" id="credit">
1196 Documentation generated on Sun, 17 Jun 2012 10:00:19 +0000 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.3</a>
1197 </p>
1198 </div></body>
1199 </html>