blingbling.calendar.html 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
  2. "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
  3. <html>
  4. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
  5. <head>
  6. <title>Reference</title>
  7. <link rel="stylesheet" href="../ldoc.css" type="text/css" />
  8. </head>
  9. <body>
  10. <div id="container">
  11. <div id="product">
  12. <div id="product_logo"></div>
  13. <div id="product_name"><big><b></b></big></div>
  14. <div id="product_description"></div>
  15. </div> <!-- id="product" -->
  16. <div id="main">
  17. <!-- Menu -->
  18. <div id="navigation">
  19. <br/>
  20. <h1>ldoc</h1>
  21. <ul>
  22. <li><a href="../index.html">Index</a></li>
  23. </ul>
  24. <h2>Contents</h2>
  25. <ul>
  26. <li><a href="#Functions">Functions</a></li>
  27. </ul>
  28. <h2>Modules</h2>
  29. <ul class="$(kind=='Topics' and '' or 'nowrap'">
  30. <li><strong>blingbling.calendar</strong></li>
  31. <li><a href="../modules/blingbling.clock.html">blingbling.clock</a></li>
  32. <li><a href="../modules/blingbling.helpers.html">blingbling.helpers</a></li>
  33. <li><a href="../modules/blingbling.linegraph.html">blingbling.linegraph</a></li>
  34. <li><a href="../modules/blingbling.widget.html">blingbling.widget</a></li>
  35. <li><a href="../modules/blingbling.popups.html">blingbling.popups</a></li>
  36. <li><a href="../modules/blingbling.progress_graph.html">blingbling.progress_graph</a></li>
  37. <li><a href="../modules/blingbling.system.html">blingbling.system</a></li>
  38. <li><a href="../modules/blingbling.tagslist.html">blingbling.tagslist</a></li>
  39. <li><a href="../modules/blingbling.task_warrior.html">blingbling.task_warrior</a></li>
  40. <li><a href="../modules/blingbling.text_box.html">blingbling.text_box</a></li>
  41. <li><a href="../modules/blingbling.transient.html">blingbling.transient</a></li>
  42. <li><a href="../modules/blingbling.triangular_progress_graph.html">blingbling.triangular_progress_graph</a></li>
  43. <li><a href="../modules/blingbling.udisks_glue.html">blingbling.udisks_glue</a></li>
  44. <li><a href="../modules/blingbling.value_text_box.html">blingbling.value_text_box</a></li>
  45. <li><a href="../modules/blingbling.volume.html">blingbling.volume</a></li>
  46. <li><a href="../modules/blingbling.wlourf_circle_graph.html">blingbling.wlourf_circle_graph</a></li>
  47. </ul>
  48. </div>
  49. <div id="content">
  50. <h1>Module <code>blingbling.calendar</code></h1>
  51. <p>Calendar widget.</p>
  52. <p>
  53. Show current month user can navigate through previous or next month with two button. The top centered button with current mont string allow user to reload the current month.
  54. User can get events from remind and taskwarrior and can add their own events handler.</p>
  55. <h2><a href="#Functions">Functions</a></h2>
  56. <table class="function_list">
  57. <tr>
  58. <td class="name" nowrap><a href="#set_prev_next_widget_style">set_prev_next_widget_style (style)</a></td>
  59. <td class="summary">Set the style of the previous and next month button.</td>
  60. </tr>
  61. <tr>
  62. <td class="name" nowrap><a href="#set_current_date_widget_style">set_current_date_widget_style (style)</a></td>
  63. <td class="summary">Set the style of the current date text_box widget.</td>
  64. </tr>
  65. <tr>
  66. <td class="name" nowrap><a href="#set_days_of_week_widget_style">set_days_of_week_widget_style (style)</a></td>
  67. <td class="summary">Define the style of the cells that contains the week days names.</td>
  68. </tr>
  69. <tr>
  70. <td class="name" nowrap><a href="#set_days_of_month_widget_style">set_days_of_month_widget_style (style)</a></td>
  71. <td class="summary">Set the style of the days of the month widget.</td>
  72. </tr>
  73. <tr>
  74. <td class="name" nowrap><a href="#set_weeks_number_widget_style">set_weeks_number_widget_style (style)</a></td>
  75. <td class="summary">Define the style of the cells that displays the week number (left column).</td>
  76. </tr>
  77. <tr>
  78. <td class="name" nowrap><a href="#set_corner_widget_style">set_corner_widget_style (style)</a></td>
  79. <td class="summary">Set the style of the cell used as a corner between the week days line and the week number column.</td>
  80. </tr>
  81. <tr>
  82. <td class="name" nowrap><a href="#set_current_day_widget_style">set_current_day_widget_style (style)</a></td>
  83. <td class="summary">Define the style used in order to show the current day.</td>
  84. </tr>
  85. <tr>
  86. <td class="name" nowrap><a href="#set_focus_widget_style">set_focus_widget_style (style)</a></td>
  87. <td class="summary">Define the style used when the mouse pass on a cell (only active is set_link_to_external_calendar(true)).</td>
  88. </tr>
  89. <tr>
  90. <td class="name" nowrap><a href="#set_info_cell_style">set_info_cell_style (style)</a></td>
  91. <td class="summary">Define the style of the big widget on the right that displays information (current day or external calendar events).</td>
  92. </tr>
  93. <tr>
  94. <td class="name" nowrap><a href="#set_link_to_external_calendar">set_link_to_external_calendar (boolean)</a></td>
  95. <td class="summary">Allow to get information from external calendar.</td>
  96. </tr>
  97. <tr>
  98. <td class="name" nowrap><a href="#set_locale">set_locale (locale)</a></td>
  99. <td class="summary">Use a specific locale for the week days.</td>
  100. </tr>
  101. <tr>
  102. <td class="name" nowrap><a href="#append_function_get_events_from">append_function_get_events_from (my_function)</a></td>
  103. <td class="summary">Add new function in order to get events from external application.</td>
  104. </tr>
  105. <tr>
  106. <td class="name" nowrap><a href="#clear_and_add_function_get_events_from">clear_and_add_function_get_events_from (my_function)</a></td>
  107. <td class="summary">Add new function in order to get events from external application and remove the existing function.</td>
  108. </tr>
  109. </table>
  110. <br/>
  111. <br/>
  112. <h2><a name="Functions"></a>Functions</h2>
  113. <dl class="function">
  114. <dt>
  115. <a name = "set_prev_next_widget_style"></a>
  116. <strong>set_prev_next_widget_style (style)</strong>
  117. </dt>
  118. <dd>
  119. Set the style of the previous and next month button.
  120. <h3>Parameters:</h3>
  121. <ul>
  122. <li><span class="parameter">style</span>
  123. a table of parameters (see text_box widget in order to find which ones are available)
  124. </li>
  125. </ul>
  126. <h3>Usage:</h3>
  127. <ul>
  128. <pre class="example">mycalendar:set_prev_next_widget_style(style)</pre>
  129. </ul>
  130. </dd>
  131. <dt>
  132. <a name = "set_current_date_widget_style"></a>
  133. <strong>set_current_date_widget_style (style)</strong>
  134. </dt>
  135. <dd>
  136. Set the style of the current date text_box widget.
  137. <h3>Parameters:</h3>
  138. <ul>
  139. <li><span class="parameter">style</span>
  140. a table of parameters (see text_box widget in order to find which ones are available)
  141. </li>
  142. </ul>
  143. <h3>Usage:</h3>
  144. <ul>
  145. <pre class="example">mycalendar:set_current_date_widget_style(style)</pre>
  146. </ul>
  147. </dd>
  148. <dt>
  149. <a name = "set_days_of_week_widget_style"></a>
  150. <strong>set_days_of_week_widget_style (style)</strong>
  151. </dt>
  152. <dd>
  153. Define the style of the cells that contains the week days names.
  154. <h3>Parameters:</h3>
  155. <ul>
  156. <li><span class="parameter">style</span>
  157. a table of parameters (see text_box widget in order to find which ones are available)
  158. </li>
  159. </ul>
  160. <h3>Usage:</h3>
  161. <ul>
  162. <pre class="example">mycalendar:set_days_of_week_widget_style(style)</pre>
  163. </ul>
  164. </dd>
  165. <dt>
  166. <a name = "set_days_of_month_widget_style"></a>
  167. <strong>set_days_of_month_widget_style (style)</strong>
  168. </dt>
  169. <dd>
  170. Set the style of the days of the month widget.
  171. <h3>Parameters:</h3>
  172. <ul>
  173. <li><span class="parameter">style</span>
  174. a table of parameters (see text_box widget in order to find which ones are available)
  175. </li>
  176. </ul>
  177. <h3>Usage:</h3>
  178. <ul>
  179. <pre class="example">mycalendar:set_days_of_month_widget_style(style)</pre>
  180. </ul>
  181. </dd>
  182. <dt>
  183. <a name = "set_weeks_number_widget_style"></a>
  184. <strong>set_weeks_number_widget_style (style)</strong>
  185. </dt>
  186. <dd>
  187. Define the style of the cells that displays the week number (left column).
  188. <h3>Parameters:</h3>
  189. <ul>
  190. <li><span class="parameter">style</span>
  191. a table of parameters (see text_box widget in order to find which ones are available)
  192. </li>
  193. </ul>
  194. <h3>Usage:</h3>
  195. <ul>
  196. <pre class="example">mycalendar:set_weeks_number_widget_style(style)</pre>
  197. </ul>
  198. </dd>
  199. <dt>
  200. <a name = "set_corner_widget_style"></a>
  201. <strong>set_corner_widget_style (style)</strong>
  202. </dt>
  203. <dd>
  204. Set the style of the cell used as a corner between the week days line and the week number column.
  205. <h3>Parameters:</h3>
  206. <ul>
  207. <li><span class="parameter">style</span>
  208. a table of parameters (see text_box widget in order to find which ones are available)
  209. </li>
  210. </ul>
  211. <h3>Usage:</h3>
  212. <ul>
  213. <pre class="example">mycalendar:set_corner_widget_style(style)</pre>
  214. </ul>
  215. </dd>
  216. <dt>
  217. <a name = "set_current_day_widget_style"></a>
  218. <strong>set_current_day_widget_style (style)</strong>
  219. </dt>
  220. <dd>
  221. Define the style used in order to show the current day.
  222. <h3>Parameters:</h3>
  223. <ul>
  224. <li><span class="parameter">style</span>
  225. a table of parameters (see text_box widget in order to find which ones are available)
  226. </li>
  227. </ul>
  228. <h3>Usage:</h3>
  229. <ul>
  230. <pre class="example">mycalendar:set_current_day_widget_style(style)</pre>
  231. </ul>
  232. </dd>
  233. <dt>
  234. <a name = "set_focus_widget_style"></a>
  235. <strong>set_focus_widget_style (style)</strong>
  236. </dt>
  237. <dd>
  238. Define the style used when the mouse pass on a cell (only active is set_link_to_external_calendar(true)).
  239. <h3>Parameters:</h3>
  240. <ul>
  241. <li><span class="parameter">style</span>
  242. a table of parameters (see text_box widget in order to find which ones are available)
  243. </li>
  244. </ul>
  245. <h3>Usage:</h3>
  246. <ul>
  247. <pre class="example">mycalendar:set_focus_widget_style(style)</pre>
  248. </ul>
  249. </dd>
  250. <dt>
  251. <a name = "set_info_cell_style"></a>
  252. <strong>set_info_cell_style (style)</strong>
  253. </dt>
  254. <dd>
  255. Define the style of the big widget on the right that displays information (current day or external calendar events).
  256. <h3>Parameters:</h3>
  257. <ul>
  258. <li><span class="parameter">style</span>
  259. a table of parameters (see text_box widget in order to find which ones are available)
  260. </li>
  261. </ul>
  262. <h3>Usage:</h3>
  263. <ul>
  264. <pre class="example">mycalendar:set_info_cell_style</pre>
  265. </ul>
  266. </dd>
  267. <dt>
  268. <a name = "set_link_to_external_calendar"></a>
  269. <strong>set_link_to_external_calendar (boolean)</strong>
  270. </dt>
  271. <dd>
  272. Allow to get information from external calendar.
  273. <h3>Parameters:</h3>
  274. <ul>
  275. <li><span class="parameter">boolean</span>
  276. true or false
  277. </li>
  278. </ul>
  279. <h3>Usage:</h3>
  280. <ul>
  281. <pre class="example">mycalendar:set_link_to_external_calendar(boolean)</pre>
  282. </ul>
  283. </dd>
  284. <dt>
  285. <a name = "set_locale"></a>
  286. <strong>set_locale (locale)</strong>
  287. </dt>
  288. <dd>
  289. Use a specific locale for the week days.
  290. <h3>Parameters:</h3>
  291. <ul>
  292. <li><span class="parameter">locale</span>
  293. a string
  294. </li>
  295. </ul>
  296. <h3>Usage:</h3>
  297. <ul>
  298. <pre class="example">mycalendar:set_locale(locale)</pre>
  299. </ul>
  300. </dd>
  301. <dt>
  302. <a name = "append_function_get_events_from"></a>
  303. <strong>append_function_get_events_from (my_function)</strong>
  304. </dt>
  305. <dd>
  306. Add new function in order to get events from external application.
  307. This method let the taskwarrior and remind links intact and add your founction.
  308. <h3>Parameters:</h3>
  309. <ul>
  310. <li><span class="parameter">my_function</span>
  311. a function that you write
  312. </li>
  313. </ul>
  314. <h3>Usage:</h3>
  315. <ul>
  316. <pre class="example"> mycalendar:append_function_get_events_from(<span class="keyword">function</span>(day, month, year)
  317. s=<span class="string">"third function "</span>.. <span class="string">" "</span> .. day .. <span class="string">" "</span> .. month ..<span class="string">" "</span> ..year
  318. <span class="keyword">return</span> s
  319. <span class="keyword">end</span>)
  320. This <span class="keyword">function</span> display <span class="keyword">in</span> the menu the <span class="global">string</span> <span class="string">"third function 26 11 2011"</span> <span class="keyword">for</span> example.</pre>
  321. </ul>
  322. </dd>
  323. <dt>
  324. <a name = "clear_and_add_function_get_events_from"></a>
  325. <strong>clear_and_add_function_get_events_from (my_function)</strong>
  326. </dt>
  327. <dd>
  328. Add new function in order to get events from external application and remove the existing function.
  329. <h3>Parameters:</h3>
  330. <ul>
  331. <li><span class="parameter">my_function</span>
  332. a function that you write
  333. </li>
  334. </ul>
  335. <h3>Usage:</h3>
  336. <ul>
  337. <pre class="example">mycalendar:clear_and_add_function_get_events_from(my_function)</pre>
  338. </ul>
  339. </dd>
  340. </dl>
  341. </div> <!-- id="content" -->
  342. </div> <!-- id="main" -->
  343. <div id="about">
  344. <i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.3</a></i>
  345. <i style="float:right;">Last updated 2015-08-04 10:16:50 </i>
  346. </div> <!-- id="about" -->
  347. </div> <!-- id="container" -->
  348. </body>
  349. </html>