NimfCandidatable.html 36 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <html>
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  5. <title>NimfCandidatable: Nimf Reference Manual</title>
  6. <meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
  7. <link rel="home" href="index.html" title="Nimf Reference Manual">
  8. <link rel="up" href="interfaces.html" title="Interfaces">
  9. <link rel="prev" href="interfaces.html" title="Interfaces">
  10. <link rel="next" href="NimfPreeditable.html" title="NimfPreeditable">
  11. <meta name="generator" content="GTK-Doc V1.34.0 (XML mode)">
  12. <link rel="stylesheet" href="style.css" type="text/css">
  13. </head>
  14. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15. <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
  16. <td width="100%" align="left" class="shortcuts">
  17. <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
  18. <a href="#NimfCandidatable.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
  19. <a href="#NimfCandidatable.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_prerequisites">  <span class="dim">|</span> 
  20. <a href="#NimfCandidatable.prerequisites" class="shortcut">Prerequisites</a></span>
  21. </td>
  22. <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
  23. <td><a accesskey="u" href="interfaces.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
  24. <td><a accesskey="p" href="interfaces.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
  25. <td><a accesskey="n" href="NimfPreeditable.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
  26. </tr></table>
  27. <div class="refentry">
  28. <a name="NimfCandidatable"></a><div class="titlepage"></div>
  29. <div class="refnamediv"><table width="100%"><tr>
  30. <td valign="top">
  31. <h2><span class="refentrytitle"><a name="NimfCandidatable.top_of_page"></a>NimfCandidatable</span></h2>
  32. <p>NimfCandidatable</p>
  33. </td>
  34. <td class="gallery_image" valign="top" align="right"></td>
  35. </tr></table></div>
  36. <div class="refsect1">
  37. <a name="NimfCandidatable.functions"></a><h2>Functions</h2>
  38. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  39. <colgroup>
  40. <col width="150px" class="functions_proto_type">
  41. <col class="functions_proto_name">
  42. </colgroup>
  43. <tbody>
  44. <tr>
  45. <td class="function_type">
  46. <span class="returnvalue">void</span>
  47. </td>
  48. <td class="function_name">
  49. <a class="link" href="NimfCandidatable.html#nimf-candidatable-show" title="nimf_candidatable_show ()">nimf_candidatable_show</a> <span class="c_punctuation">()</span>
  50. </td>
  51. </tr>
  52. <tr>
  53. <td class="function_type">
  54. <span class="returnvalue">void</span>
  55. </td>
  56. <td class="function_name">
  57. <a class="link" href="NimfCandidatable.html#nimf-candidatable-hide" title="nimf_candidatable_hide ()">nimf_candidatable_hide</a> <span class="c_punctuation">()</span>
  58. </td>
  59. </tr>
  60. <tr>
  61. <td class="function_type">
  62. <span class="returnvalue">gboolean</span>
  63. </td>
  64. <td class="function_name">
  65. <a class="link" href="NimfCandidatable.html#nimf-candidatable-is-visible" title="nimf_candidatable_is_visible ()">nimf_candidatable_is_visible</a> <span class="c_punctuation">()</span>
  66. </td>
  67. </tr>
  68. <tr>
  69. <td class="function_type">
  70. <span class="returnvalue">void</span>
  71. </td>
  72. <td class="function_name">
  73. <a class="link" href="NimfCandidatable.html#nimf-candidatable-clear" title="nimf_candidatable_clear ()">nimf_candidatable_clear</a> <span class="c_punctuation">()</span>
  74. </td>
  75. </tr>
  76. <tr>
  77. <td class="function_type">
  78. <span class="returnvalue">void</span>
  79. </td>
  80. <td class="function_name">
  81. <a class="link" href="NimfCandidatable.html#nimf-candidatable-set-page-values" title="nimf_candidatable_set_page_values ()">nimf_candidatable_set_page_values</a> <span class="c_punctuation">()</span>
  82. </td>
  83. </tr>
  84. <tr>
  85. <td class="function_type">
  86. <span class="returnvalue">void</span>
  87. </td>
  88. <td class="function_name">
  89. <a class="link" href="NimfCandidatable.html#nimf-candidatable-append" title="nimf_candidatable_append ()">nimf_candidatable_append</a> <span class="c_punctuation">()</span>
  90. </td>
  91. </tr>
  92. <tr>
  93. <td class="function_type">
  94. <span class="returnvalue">gint</span>
  95. </td>
  96. <td class="function_name">
  97. <a class="link" href="NimfCandidatable.html#nimf-candidatable-get-selected-index" title="nimf_candidatable_get_selected_index ()">nimf_candidatable_get_selected_index</a> <span class="c_punctuation">()</span>
  98. </td>
  99. </tr>
  100. <tr>
  101. <td class="function_type">
  102. <span class="returnvalue">gchar</span> *
  103. </td>
  104. <td class="function_name">
  105. <a class="link" href="NimfCandidatable.html#nimf-candidatable-get-selected-text" title="nimf_candidatable_get_selected_text ()">nimf_candidatable_get_selected_text</a> <span class="c_punctuation">()</span>
  106. </td>
  107. </tr>
  108. <tr>
  109. <td class="function_type">
  110. <span class="returnvalue">void</span>
  111. </td>
  112. <td class="function_name">
  113. <a class="link" href="NimfCandidatable.html#nimf-candidatable-select-first-item-in-page" title="nimf_candidatable_select_first_item_in_page ()">nimf_candidatable_select_first_item_in_page</a> <span class="c_punctuation">()</span>
  114. </td>
  115. </tr>
  116. <tr>
  117. <td class="function_type">
  118. <span class="returnvalue">void</span>
  119. </td>
  120. <td class="function_name">
  121. <a class="link" href="NimfCandidatable.html#nimf-candidatable-select-last-item-in-page" title="nimf_candidatable_select_last_item_in_page ()">nimf_candidatable_select_last_item_in_page</a> <span class="c_punctuation">()</span>
  122. </td>
  123. </tr>
  124. <tr>
  125. <td class="function_type">
  126. <span class="returnvalue">void</span>
  127. </td>
  128. <td class="function_name">
  129. <a class="link" href="NimfCandidatable.html#nimf-candidatable-select-item-by-index-in-page" title="nimf_candidatable_select_item_by_index_in_page ()">nimf_candidatable_select_item_by_index_in_page</a> <span class="c_punctuation">()</span>
  130. </td>
  131. </tr>
  132. <tr>
  133. <td class="function_type">
  134. <span class="returnvalue">void</span>
  135. </td>
  136. <td class="function_name">
  137. <a class="link" href="NimfCandidatable.html#nimf-candidatable-select-previous-item" title="nimf_candidatable_select_previous_item ()">nimf_candidatable_select_previous_item</a> <span class="c_punctuation">()</span>
  138. </td>
  139. </tr>
  140. <tr>
  141. <td class="function_type">
  142. <span class="returnvalue">void</span>
  143. </td>
  144. <td class="function_name">
  145. <a class="link" href="NimfCandidatable.html#nimf-candidatable-select-next-item" title="nimf_candidatable_select_next_item ()">nimf_candidatable_select_next_item</a> <span class="c_punctuation">()</span>
  146. </td>
  147. </tr>
  148. <tr>
  149. <td class="function_type">
  150. <span class="returnvalue">void</span>
  151. </td>
  152. <td class="function_name">
  153. <a class="link" href="NimfCandidatable.html#nimf-candidatable-set-auxiliary-text" title="nimf_candidatable_set_auxiliary_text ()">nimf_candidatable_set_auxiliary_text</a> <span class="c_punctuation">()</span>
  154. </td>
  155. </tr>
  156. </tbody>
  157. </table></div>
  158. </div>
  159. <div class="refsect1">
  160. <a name="NimfCandidatable.other"></a><h2>Types and Values</h2>
  161. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  162. <colgroup>
  163. <col width="150px" class="other_proto_type">
  164. <col class="other_proto_name">
  165. </colgroup>
  166. <tbody>
  167. <tr>
  168. <td class="define_keyword">#define</td>
  169. <td class="function_name"><a class="link" href="NimfCandidatable.html#NIMF-TYPE-CANDIDATABLE:CAPS" title="NIMF_TYPE_CANDIDATABLE">NIMF_TYPE_CANDIDATABLE</a></td>
  170. </tr>
  171. <tr>
  172. <td class="datatype_keyword">struct</td>
  173. <td class="function_name"><a class="link" href="NimfCandidatable.html#NimfCandidatableInterface" title="struct NimfCandidatableInterface">NimfCandidatableInterface</a></td>
  174. </tr>
  175. <tr>
  176. <td class="datatype_keyword"> </td>
  177. <td class="function_name"><a class="link" href="NimfCandidatable.html#NimfCandidatable-struct" title="NimfCandidatable">NimfCandidatable</a></td>
  178. </tr>
  179. </tbody>
  180. </table></div>
  181. </div>
  182. <div class="refsect1">
  183. <a name="NimfCandidatable.object-hierarchy"></a><h2>Object Hierarchy</h2>
  184. <pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>
  185. <span class="lineart">╰──</span> NimfCandidatable
  186. </pre>
  187. </div>
  188. <div class="refsect1">
  189. <a name="NimfCandidatable.prerequisites"></a><h2>Prerequisites</h2>
  190. <p>
  191. NimfCandidatable requires
  192. GObject.</p>
  193. </div>
  194. <div class="refsect1">
  195. <a name="NimfCandidatable.description"></a><h2>Description</h2>
  196. </div>
  197. <div class="refsect1">
  198. <a name="NimfCandidatable.functions_details"></a><h2>Functions</h2>
  199. <div class="refsect2">
  200. <a name="nimf-candidatable-show"></a><h3>nimf_candidatable_show ()</h3>
  201. <pre class="programlisting"><span class="returnvalue">void</span>
  202. nimf_candidatable_show (<em class="parameter"><code><a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a> *candidatable</code></em>,
  203. <em class="parameter"><code><a class="link" href="NimfServiceIC.html" title="NimfServiceIC"><span class="type">NimfServiceIC</span></a> *target</code></em>,
  204. <em class="parameter"><code><span class="type">gboolean</span> show_entry</code></em>);</pre>
  205. <div class="refsect3">
  206. <a name="nimf-candidatable-show.parameters"></a><h4>Parameters</h4>
  207. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  208. <colgroup>
  209. <col width="150px" class="parameters_name">
  210. <col class="parameters_description">
  211. <col width="200px" class="parameters_annotations">
  212. </colgroup>
  213. <tbody>
  214. <tr>
  215. <td class="parameter_name"><p>candidatable</p></td>
  216. <td class="parameter_description"><p>a <a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a></p></td>
  217. <td class="parameter_annotations"> </td>
  218. </tr>
  219. <tr>
  220. <td class="parameter_name"><p>target</p></td>
  221. <td class="parameter_description"><p>a <a class="link" href="NimfServiceIC.html" title="NimfServiceIC"><span class="type">NimfServiceIC</span></a></p></td>
  222. <td class="parameter_annotations"> </td>
  223. </tr>
  224. <tr>
  225. <td class="parameter_name"><p>show_entry</p></td>
  226. <td class="parameter_description"><p><code class="literal">TRUE</code> if the entry for auxiliary text should be shown</p></td>
  227. <td class="parameter_annotations"> </td>
  228. </tr>
  229. </tbody>
  230. </table></div>
  231. </div>
  232. </div>
  233. <hr>
  234. <div class="refsect2">
  235. <a name="nimf-candidatable-hide"></a><h3>nimf_candidatable_hide ()</h3>
  236. <pre class="programlisting"><span class="returnvalue">void</span>
  237. nimf_candidatable_hide (<em class="parameter"><code><a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a> *candidatable</code></em>);</pre>
  238. <p>Hides the candidatable</p>
  239. <div class="refsect3">
  240. <a name="nimf-candidatable-hide.parameters"></a><h4>Parameters</h4>
  241. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  242. <colgroup>
  243. <col width="150px" class="parameters_name">
  244. <col class="parameters_description">
  245. <col width="200px" class="parameters_annotations">
  246. </colgroup>
  247. <tbody><tr>
  248. <td class="parameter_name"><p>candidatable</p></td>
  249. <td class="parameter_description"><p>a <a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a></p></td>
  250. <td class="parameter_annotations"> </td>
  251. </tr></tbody>
  252. </table></div>
  253. </div>
  254. </div>
  255. <hr>
  256. <div class="refsect2">
  257. <a name="nimf-candidatable-is-visible"></a><h3>nimf_candidatable_is_visible ()</h3>
  258. <pre class="programlisting"><span class="returnvalue">gboolean</span>
  259. nimf_candidatable_is_visible (<em class="parameter"><code><a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a> *candidatable</code></em>);</pre>
  260. <div class="refsect3">
  261. <a name="nimf-candidatable-is-visible.parameters"></a><h4>Parameters</h4>
  262. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  263. <colgroup>
  264. <col width="150px" class="parameters_name">
  265. <col class="parameters_description">
  266. <col width="200px" class="parameters_annotations">
  267. </colgroup>
  268. <tbody><tr>
  269. <td class="parameter_name"><p>candidatable</p></td>
  270. <td class="parameter_description"><p>a <a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a></p></td>
  271. <td class="parameter_annotations"> </td>
  272. </tr></tbody>
  273. </table></div>
  274. </div>
  275. <div class="refsect3">
  276. <a name="nimf-candidatable-is-visible.returns"></a><h4>Returns</h4>
  277. <p> <code class="literal">TRUE</code> if the <em class="parameter"><code>candidatable</code></em>
  278. is visible</p>
  279. </div>
  280. </div>
  281. <hr>
  282. <div class="refsect2">
  283. <a name="nimf-candidatable-clear"></a><h3>nimf_candidatable_clear ()</h3>
  284. <pre class="programlisting"><span class="returnvalue">void</span>
  285. nimf_candidatable_clear (<em class="parameter"><code><a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a> *candidatable</code></em>,
  286. <em class="parameter"><code><a class="link" href="NimfServiceIC.html" title="NimfServiceIC"><span class="type">NimfServiceIC</span></a> *target</code></em>);</pre>
  287. <p>Clears the contents of the candidatable</p>
  288. <div class="refsect3">
  289. <a name="nimf-candidatable-clear.parameters"></a><h4>Parameters</h4>
  290. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  291. <colgroup>
  292. <col width="150px" class="parameters_name">
  293. <col class="parameters_description">
  294. <col width="200px" class="parameters_annotations">
  295. </colgroup>
  296. <tbody>
  297. <tr>
  298. <td class="parameter_name"><p>candidatable</p></td>
  299. <td class="parameter_description"><p>a <a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a></p></td>
  300. <td class="parameter_annotations"> </td>
  301. </tr>
  302. <tr>
  303. <td class="parameter_name"><p>target</p></td>
  304. <td class="parameter_description"><p>a <a class="link" href="NimfServiceIC.html" title="NimfServiceIC"><span class="type">NimfServiceIC</span></a></p></td>
  305. <td class="parameter_annotations"> </td>
  306. </tr>
  307. </tbody>
  308. </table></div>
  309. </div>
  310. </div>
  311. <hr>
  312. <div class="refsect2">
  313. <a name="nimf-candidatable-set-page-values"></a><h3>nimf_candidatable_set_page_values ()</h3>
  314. <pre class="programlisting"><span class="returnvalue">void</span>
  315. nimf_candidatable_set_page_values (<em class="parameter"><code><a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a> *candidatable</code></em>,
  316. <em class="parameter"><code><a class="link" href="NimfServiceIC.html" title="NimfServiceIC"><span class="type">NimfServiceIC</span></a> *target</code></em>,
  317. <em class="parameter"><code><span class="type">gint</span> page_index</code></em>,
  318. <em class="parameter"><code><span class="type">gint</span> n_pages</code></em>,
  319. <em class="parameter"><code><span class="type">gint</span> page_size</code></em>);</pre>
  320. <p>Sets page values.</p>
  321. <div class="refsect3">
  322. <a name="nimf-candidatable-set-page-values.parameters"></a><h4>Parameters</h4>
  323. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  324. <colgroup>
  325. <col width="150px" class="parameters_name">
  326. <col class="parameters_description">
  327. <col width="200px" class="parameters_annotations">
  328. </colgroup>
  329. <tbody>
  330. <tr>
  331. <td class="parameter_name"><p>candidatable</p></td>
  332. <td class="parameter_description"><p>a <a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a></p></td>
  333. <td class="parameter_annotations"> </td>
  334. </tr>
  335. <tr>
  336. <td class="parameter_name"><p>target</p></td>
  337. <td class="parameter_description"><p>a <a class="link" href="NimfServiceIC.html" title="NimfServiceIC"><span class="type">NimfServiceIC</span></a></p></td>
  338. <td class="parameter_annotations"> </td>
  339. </tr>
  340. <tr>
  341. <td class="parameter_name"><p>page_index</p></td>
  342. <td class="parameter_description"><p>page index</p></td>
  343. <td class="parameter_annotations"> </td>
  344. </tr>
  345. <tr>
  346. <td class="parameter_name"><p>n_pages</p></td>
  347. <td class="parameter_description"><p>the number of pages</p></td>
  348. <td class="parameter_annotations"> </td>
  349. </tr>
  350. <tr>
  351. <td class="parameter_name"><p>page_size</p></td>
  352. <td class="parameter_description"><p>page size</p></td>
  353. <td class="parameter_annotations"> </td>
  354. </tr>
  355. </tbody>
  356. </table></div>
  357. </div>
  358. </div>
  359. <hr>
  360. <div class="refsect2">
  361. <a name="nimf-candidatable-append"></a><h3>nimf_candidatable_append ()</h3>
  362. <pre class="programlisting"><span class="returnvalue">void</span>
  363. nimf_candidatable_append (<em class="parameter"><code><a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a> *candidatable</code></em>,
  364. <em class="parameter"><code>const <span class="type">gchar</span> *text1</code></em>,
  365. <em class="parameter"><code>const <span class="type">gchar</span> *text2</code></em>);</pre>
  366. <p>After appending a row, adds <em class="parameter"><code>text1</code></em>
  367. to the first column and <em class="parameter"><code>text2</code></em>
  368. to the
  369. second column.</p>
  370. <div class="refsect3">
  371. <a name="nimf-candidatable-append.parameters"></a><h4>Parameters</h4>
  372. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  373. <colgroup>
  374. <col width="150px" class="parameters_name">
  375. <col class="parameters_description">
  376. <col width="200px" class="parameters_annotations">
  377. </colgroup>
  378. <tbody>
  379. <tr>
  380. <td class="parameter_name"><p>candidatable</p></td>
  381. <td class="parameter_description"><p>a <a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a></p></td>
  382. <td class="parameter_annotations"> </td>
  383. </tr>
  384. <tr>
  385. <td class="parameter_name"><p>text1</p></td>
  386. <td class="parameter_description"><p>text for the first column; <em class="parameter"><code>text1</code></em>
  387. must be non-<code class="literal">NULL</code>.</p></td>
  388. <td class="parameter_annotations"> </td>
  389. </tr>
  390. <tr>
  391. <td class="parameter_name"><p>text2</p></td>
  392. <td class="parameter_description"><p>text for the second column; <em class="parameter"><code>text2</code></em>
  393. allows <code class="literal">NULL</code>. </p></td>
  394. <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
  395. </tr>
  396. </tbody>
  397. </table></div>
  398. </div>
  399. </div>
  400. <hr>
  401. <div class="refsect2">
  402. <a name="nimf-candidatable-get-selected-index"></a><h3>nimf_candidatable_get_selected_index ()</h3>
  403. <pre class="programlisting"><span class="returnvalue">gint</span>
  404. nimf_candidatable_get_selected_index (<em class="parameter"><code><a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a> *candidatable</code></em>);</pre>
  405. <div class="refsect3">
  406. <a name="nimf-candidatable-get-selected-index.parameters"></a><h4>Parameters</h4>
  407. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  408. <colgroup>
  409. <col width="150px" class="parameters_name">
  410. <col class="parameters_description">
  411. <col width="200px" class="parameters_annotations">
  412. </colgroup>
  413. <tbody><tr>
  414. <td class="parameter_name"><p>candidatable</p></td>
  415. <td class="parameter_description"><p>a <a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a></p></td>
  416. <td class="parameter_annotations"> </td>
  417. </tr></tbody>
  418. </table></div>
  419. </div>
  420. <div class="refsect3">
  421. <a name="nimf-candidatable-get-selected-index.returns"></a><h4>Returns</h4>
  422. <p> index of the selected row</p>
  423. </div>
  424. </div>
  425. <hr>
  426. <div class="refsect2">
  427. <a name="nimf-candidatable-get-selected-text"></a><h3>nimf_candidatable_get_selected_text ()</h3>
  428. <pre class="programlisting"><span class="returnvalue">gchar</span> *
  429. nimf_candidatable_get_selected_text (<em class="parameter"><code><a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a> *candidatable</code></em>);</pre>
  430. <div class="refsect3">
  431. <a name="nimf-candidatable-get-selected-text.parameters"></a><h4>Parameters</h4>
  432. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  433. <colgroup>
  434. <col width="150px" class="parameters_name">
  435. <col class="parameters_description">
  436. <col width="200px" class="parameters_annotations">
  437. </colgroup>
  438. <tbody><tr>
  439. <td class="parameter_name"><p>candidatable</p></td>
  440. <td class="parameter_description"><p>a <a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a></p></td>
  441. <td class="parameter_annotations"> </td>
  442. </tr></tbody>
  443. </table></div>
  444. </div>
  445. <div class="refsect3">
  446. <a name="nimf-candidatable-get-selected-text.returns"></a><h4>Returns</h4>
  447. <p> text of the first column in the selected row</p>
  448. </div>
  449. </div>
  450. <hr>
  451. <div class="refsect2">
  452. <a name="nimf-candidatable-select-first-item-in-page"></a><h3>nimf_candidatable_select_first_item_in_page ()</h3>
  453. <pre class="programlisting"><span class="returnvalue">void</span>
  454. nimf_candidatable_select_first_item_in_page
  455. (<em class="parameter"><code><a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a> *candidatable</code></em>);</pre>
  456. <p>Selects the first item in the page.</p>
  457. <div class="refsect3">
  458. <a name="nimf-candidatable-select-first-item-in-page.parameters"></a><h4>Parameters</h4>
  459. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  460. <colgroup>
  461. <col width="150px" class="parameters_name">
  462. <col class="parameters_description">
  463. <col width="200px" class="parameters_annotations">
  464. </colgroup>
  465. <tbody><tr>
  466. <td class="parameter_name"><p>candidatable</p></td>
  467. <td class="parameter_description"><p>a <a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a></p></td>
  468. <td class="parameter_annotations"> </td>
  469. </tr></tbody>
  470. </table></div>
  471. </div>
  472. </div>
  473. <hr>
  474. <div class="refsect2">
  475. <a name="nimf-candidatable-select-last-item-in-page"></a><h3>nimf_candidatable_select_last_item_in_page ()</h3>
  476. <pre class="programlisting"><span class="returnvalue">void</span>
  477. nimf_candidatable_select_last_item_in_page
  478. (<em class="parameter"><code><a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a> *candidatable</code></em>);</pre>
  479. <p>Selects the last item in the page.</p>
  480. <div class="refsect3">
  481. <a name="nimf-candidatable-select-last-item-in-page.parameters"></a><h4>Parameters</h4>
  482. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  483. <colgroup>
  484. <col width="150px" class="parameters_name">
  485. <col class="parameters_description">
  486. <col width="200px" class="parameters_annotations">
  487. </colgroup>
  488. <tbody><tr>
  489. <td class="parameter_name"><p>candidatable</p></td>
  490. <td class="parameter_description"><p>a <a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a></p></td>
  491. <td class="parameter_annotations"> </td>
  492. </tr></tbody>
  493. </table></div>
  494. </div>
  495. </div>
  496. <hr>
  497. <div class="refsect2">
  498. <a name="nimf-candidatable-select-item-by-index-in-page"></a><h3>nimf_candidatable_select_item_by_index_in_page ()</h3>
  499. <pre class="programlisting"><span class="returnvalue">void</span>
  500. nimf_candidatable_select_item_by_index_in_page
  501. (<em class="parameter"><code><a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a> *candidatable</code></em>,
  502. <em class="parameter"><code><span class="type">gint</span> index</code></em>);</pre>
  503. <p>Selects an item by the index in the page.</p>
  504. <div class="refsect3">
  505. <a name="nimf-candidatable-select-item-by-index-in-page.parameters"></a><h4>Parameters</h4>
  506. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  507. <colgroup>
  508. <col width="150px" class="parameters_name">
  509. <col class="parameters_description">
  510. <col width="200px" class="parameters_annotations">
  511. </colgroup>
  512. <tbody>
  513. <tr>
  514. <td class="parameter_name"><p>candidatable</p></td>
  515. <td class="parameter_description"><p>a <a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a></p></td>
  516. <td class="parameter_annotations"> </td>
  517. </tr>
  518. <tr>
  519. <td class="parameter_name"><p>index</p></td>
  520. <td class="parameter_description"><p>a gint</p></td>
  521. <td class="parameter_annotations"> </td>
  522. </tr>
  523. </tbody>
  524. </table></div>
  525. </div>
  526. </div>
  527. <hr>
  528. <div class="refsect2">
  529. <a name="nimf-candidatable-select-previous-item"></a><h3>nimf_candidatable_select_previous_item ()</h3>
  530. <pre class="programlisting"><span class="returnvalue">void</span>
  531. nimf_candidatable_select_previous_item
  532. (<em class="parameter"><code><a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a> *candidatable</code></em>);</pre>
  533. <p>Selects the previous item.</p>
  534. <div class="refsect3">
  535. <a name="nimf-candidatable-select-previous-item.parameters"></a><h4>Parameters</h4>
  536. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  537. <colgroup>
  538. <col width="150px" class="parameters_name">
  539. <col class="parameters_description">
  540. <col width="200px" class="parameters_annotations">
  541. </colgroup>
  542. <tbody><tr>
  543. <td class="parameter_name"><p>candidatable</p></td>
  544. <td class="parameter_description"><p>a <a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a></p></td>
  545. <td class="parameter_annotations"> </td>
  546. </tr></tbody>
  547. </table></div>
  548. </div>
  549. </div>
  550. <hr>
  551. <div class="refsect2">
  552. <a name="nimf-candidatable-select-next-item"></a><h3>nimf_candidatable_select_next_item ()</h3>
  553. <pre class="programlisting"><span class="returnvalue">void</span>
  554. nimf_candidatable_select_next_item (<em class="parameter"><code><a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a> *candidatable</code></em>);</pre>
  555. <p>Selects the next item.</p>
  556. <div class="refsect3">
  557. <a name="nimf-candidatable-select-next-item.parameters"></a><h4>Parameters</h4>
  558. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  559. <colgroup>
  560. <col width="150px" class="parameters_name">
  561. <col class="parameters_description">
  562. <col width="200px" class="parameters_annotations">
  563. </colgroup>
  564. <tbody><tr>
  565. <td class="parameter_name"><p>candidatable</p></td>
  566. <td class="parameter_description"><p>a <a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a></p></td>
  567. <td class="parameter_annotations"> </td>
  568. </tr></tbody>
  569. </table></div>
  570. </div>
  571. </div>
  572. <hr>
  573. <div class="refsect2">
  574. <a name="nimf-candidatable-set-auxiliary-text"></a><h3>nimf_candidatable_set_auxiliary_text ()</h3>
  575. <pre class="programlisting"><span class="returnvalue">void</span>
  576. nimf_candidatable_set_auxiliary_text (<em class="parameter"><code><a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a> *candidatable</code></em>,
  577. <em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
  578. <em class="parameter"><code><span class="type">gint</span> cursor_pos</code></em>);</pre>
  579. <p>Sets auxiliary text.</p>
  580. <div class="refsect3">
  581. <a name="nimf-candidatable-set-auxiliary-text.parameters"></a><h4>Parameters</h4>
  582. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  583. <colgroup>
  584. <col width="150px" class="parameters_name">
  585. <col class="parameters_description">
  586. <col width="200px" class="parameters_annotations">
  587. </colgroup>
  588. <tbody>
  589. <tr>
  590. <td class="parameter_name"><p>candidatable</p></td>
  591. <td class="parameter_description"><p>a <a class="link" href="NimfCandidatable.html" title="NimfCandidatable"><span class="type">NimfCandidatable</span></a></p></td>
  592. <td class="parameter_annotations"> </td>
  593. </tr>
  594. <tr>
  595. <td class="parameter_name"><p>text</p></td>
  596. <td class="parameter_description"><p>text</p></td>
  597. <td class="parameter_annotations"> </td>
  598. </tr>
  599. <tr>
  600. <td class="parameter_name"><p>cursor_pos</p></td>
  601. <td class="parameter_description"><p>cursor position within <em class="parameter"><code>text</code></em>
  602. </p></td>
  603. <td class="parameter_annotations"> </td>
  604. </tr>
  605. </tbody>
  606. </table></div>
  607. </div>
  608. </div>
  609. </div>
  610. <div class="refsect1">
  611. <a name="NimfCandidatable.other_details"></a><h2>Types and Values</h2>
  612. <div class="refsect2">
  613. <a name="NIMF-TYPE-CANDIDATABLE:CAPS"></a><h3>NIMF_TYPE_CANDIDATABLE</h3>
  614. <pre class="programlisting">#define NIMF_TYPE_CANDIDATABLE nimf_candidatable_get_type ()
  615. </pre>
  616. </div>
  617. <hr>
  618. <div class="refsect2">
  619. <a name="NimfCandidatableInterface"></a><h3>struct NimfCandidatableInterface</h3>
  620. <pre class="programlisting">struct NimfCandidatableInterface {
  621. GTypeInterface parent;
  622. void (* show) (NimfCandidatable *candidatable,
  623. NimfServiceIC *target,
  624. gboolean show_entry);
  625. void (* hide) (NimfCandidatable *candidatable);
  626. gboolean (* is_visible) (NimfCandidatable *candidatable);
  627. void (* clear) (NimfCandidatable *candidatable,
  628. NimfServiceIC *target);
  629. void (* set_page_values) (NimfCandidatable *candidatable,
  630. NimfServiceIC *target,
  631. gint page_index,
  632. gint n_pages,
  633. gint page_size);
  634. void (* append) (NimfCandidatable *candidatable,
  635. const gchar *item1,
  636. const gchar *item2);
  637. gint (* get_selected_index) (NimfCandidatable *candidatable);
  638. gchar * (* get_selected_text) (NimfCandidatable *candidatable);
  639. void (* select_first_item_in_page) (NimfCandidatable *candidatable);
  640. void (* select_last_item_in_page) (NimfCandidatable *candidatable);
  641. void (* select_item_by_index_in_page) (NimfCandidatable *candidatable,
  642. gint index);
  643. void (* select_previous_item) (NimfCandidatable *candidatable);
  644. void (* select_next_item) (NimfCandidatable *candidatable);
  645. void (* set_auxiliary_text) (NimfCandidatable *candidatable,
  646. const gchar *text,
  647. gint cursor_pos);
  648. };
  649. </pre>
  650. <p>Provides an interface for candidate window.</p>
  651. <div class="refsect3">
  652. <a name="NimfCandidatableInterface.members"></a><h4>Members</h4>
  653. <div class="informaltable"><table class="informaltable" width="100%" border="0">
  654. <colgroup>
  655. <col width="300px" class="struct_members_name">
  656. <col class="struct_members_description">
  657. <col width="200px" class="struct_members_annotations">
  658. </colgroup>
  659. <tbody>
  660. <tr>
  661. <td class="struct_member_name"><p><span class="type">GTypeInterface</span> <em class="structfield"><code><a name="NimfCandidatableInterface.parent"></a>parent</code></em>;</p></td>
  662. <td class="struct_member_description"><p>The parent interface.</p></td>
  663. <td class="struct_member_annotations"> </td>
  664. </tr>
  665. <tr>
  666. <td class="struct_member_name"><p><em class="structfield"><code><a name="NimfCandidatableInterface.show"></a>show</code></em> ()</p></td>
  667. <td class="struct_member_description"><p>Shows the candidatable.</p></td>
  668. <td class="struct_member_annotations"> </td>
  669. </tr>
  670. <tr>
  671. <td class="struct_member_name"><p><em class="structfield"><code><a name="NimfCandidatableInterface.hide"></a>hide</code></em> ()</p></td>
  672. <td class="struct_member_description"><p>Hides the candidatable.</p></td>
  673. <td class="struct_member_annotations"> </td>
  674. </tr>
  675. <tr>
  676. <td class="struct_member_name"><p><em class="structfield"><code><a name="NimfCandidatableInterface.is-visible"></a>is_visible</code></em> ()</p></td>
  677. <td class="struct_member_description"><p>Determines whether the candidatable is visible.</p></td>
  678. <td class="struct_member_annotations"> </td>
  679. </tr>
  680. <tr>
  681. <td class="struct_member_name"><p><em class="structfield"><code><a name="NimfCandidatableInterface.clear"></a>clear</code></em> ()</p></td>
  682. <td class="struct_member_description"><p>Clears the contents of the candidatable.</p></td>
  683. <td class="struct_member_annotations"> </td>
  684. </tr>
  685. <tr>
  686. <td class="struct_member_name"><p><em class="structfield"><code><a name="NimfCandidatableInterface.set-page-values"></a>set_page_values</code></em> ()</p></td>
  687. <td class="struct_member_description"><p>Sets page values.</p></td>
  688. <td class="struct_member_annotations"> </td>
  689. </tr>
  690. <tr>
  691. <td class="struct_member_name"><p><em class="structfield"><code><a name="NimfCandidatableInterface.append"></a>append</code></em> ()</p></td>
  692. <td class="struct_member_description"><p>Appends a new candidate.</p></td>
  693. <td class="struct_member_annotations"> </td>
  694. </tr>
  695. <tr>
  696. <td class="struct_member_name"><p><em class="structfield"><code><a name="NimfCandidatableInterface.get-selected-index"></a>get_selected_index</code></em> ()</p></td>
  697. <td class="struct_member_description"><p>Gets the index of the selected candidatable.</p></td>
  698. <td class="struct_member_annotations"> </td>
  699. </tr>
  700. <tr>
  701. <td class="struct_member_name"><p><em class="structfield"><code><a name="NimfCandidatableInterface.get-selected-text"></a>get_selected_text</code></em> ()</p></td>
  702. <td class="struct_member_description"><p>Gets the text of the selected candidatable.</p></td>
  703. <td class="struct_member_annotations"> </td>
  704. </tr>
  705. <tr>
  706. <td class="struct_member_name"><p><em class="structfield"><code><a name="NimfCandidatableInterface.select-first-item-in-page"></a>select_first_item_in_page</code></em> ()</p></td>
  707. <td class="struct_member_description"><p>Selects first item in page.</p></td>
  708. <td class="struct_member_annotations"> </td>
  709. </tr>
  710. <tr>
  711. <td class="struct_member_name"><p><em class="structfield"><code><a name="NimfCandidatableInterface.select-last-item-in-page"></a>select_last_item_in_page</code></em> ()</p></td>
  712. <td class="struct_member_description"><p>Selects last item in page.</p></td>
  713. <td class="struct_member_annotations"> </td>
  714. </tr>
  715. <tr>
  716. <td class="struct_member_name"><p><em class="structfield"><code><a name="NimfCandidatableInterface.select-item-by-index-in-page"></a>select_item_by_index_in_page</code></em> ()</p></td>
  717. <td class="struct_member_description"><p>Selects item in page with the index given as the argument.</p></td>
  718. <td class="struct_member_annotations"> </td>
  719. </tr>
  720. <tr>
  721. <td class="struct_member_name"><p><em class="structfield"><code><a name="NimfCandidatableInterface.select-previous-item"></a>select_previous_item</code></em> ()</p></td>
  722. <td class="struct_member_description"><p>Selects previus item.</p></td>
  723. <td class="struct_member_annotations"> </td>
  724. </tr>
  725. <tr>
  726. <td class="struct_member_name"><p><em class="structfield"><code><a name="NimfCandidatableInterface.select-next-item"></a>select_next_item</code></em> ()</p></td>
  727. <td class="struct_member_description"><p>Selects a next item.</p></td>
  728. <td class="struct_member_annotations"> </td>
  729. </tr>
  730. <tr>
  731. <td class="struct_member_name"><p><em class="structfield"><code><a name="NimfCandidatableInterface.set-auxiliary-text"></a>set_auxiliary_text</code></em> ()</p></td>
  732. <td class="struct_member_description"><p>Selects auxiliary text.</p></td>
  733. <td class="struct_member_annotations"> </td>
  734. </tr>
  735. </tbody>
  736. </table></div>
  737. </div>
  738. </div>
  739. <hr>
  740. <div class="refsect2">
  741. <a name="NimfCandidatable-struct"></a><h3>NimfCandidatable</h3>
  742. <pre class="programlisting">typedef struct _NimfCandidatable NimfCandidatable;</pre>
  743. </div>
  744. </div>
  745. </div>
  746. <div class="footer">
  747. <hr>Generated by GTK-Doc V1.34.0</div>
  748. </body>
  749. </html>