git.sur5r.net Git - glabels/blob - docs/libglabels/html/libglabels-3.0-db.html

   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>Database</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="LibGlabels 3.0 Reference Manual">
   8 <link rel="up" href="ch01.html" title="Basic LibGlabels Usage">
   9 <link rel="prev" href="ch01.html" title="Basic LibGlabels Usage">
  10 <link rel="next" href="libglabels-3.0-template.html" title="The lglTemplate Structure">
  11 <meta name="generator" content="GTK-Doc V1.18 (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="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="ch01.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">LibGlabels 3.0 Reference Manual</th>
  21 <td><a accesskey="n" href="libglabels-3.0-template.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#libglabels-3.0-db.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#libglabels-3.0-db.description" class="shortcut">Description</a>
  27 </td></tr>
  28 </table>
  29 <div class="refentry">
  30 <a name="libglabels-3.0-db"></a><div class="titlepage"></div>
  31 <div class="refnamediv"><table width="100%"><tr>
  32 <td valign="top">
  33 <h2><span class="refentrytitle"><a name="libglabels-3.0-db.top_of_page"></a>Database</span></h2>
  34 <p>Database — Database of pre-defined templates</p>
  35 </td>
  36 <td valign="top" align="right"></td>
  37 </tr></table></div>
  38 <div class="refsynopsisdiv">
  39 <a name="libglabels-3.0-db.synopsis"></a><h2>Synopsis</h2>
  40 <pre class="synopsis">
  41 #include &lt;libglabels/lgl-db.h&gt;
  42
  43 enum                <a class="link" href="libglabels-3.0-db.html#lglDbRegStatus" title="enum lglDbRegStatus">lglDbRegStatus</a>;
  44 enum                <a class="link" href="libglabels-3.0-db.html#lglDbDeleteStatus" title="enum lglDbDeleteStatus">lglDbDeleteStatus</a>;
  45
  46 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-db.html#lgl-db-init" title="lgl_db_init ()">lgl_db_init</a>                         (<em class="parameter"><code><span class="type">void</span></code></em>);
  47
  48 <span class="returnvalue">void</span>                (<a class="link" href="libglabels-3.0-db.html#lglDbNotifyFunc" title="lglDbNotifyFunc ()">*lglDbNotifyFunc</a>)                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
  49 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a>              <a class="link" href="libglabels-3.0-db.html#lgl-db-notify-add" title="lgl_db_notify_add ()">lgl_db_notify_add</a>                   (<em class="parameter"><code><a class="link" href="libglabels-3.0-db.html#lglDbNotifyFunc" title="lglDbNotifyFunc ()"><span class="type">lglDbNotifyFunc</span></a> func</code></em>,
  50                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
  51 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-db.html#lgl-db-notify-remove" title="lgl_db_notify_remove ()">lgl_db_notify_remove</a>                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> id</code></em>);
  52
  53 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="libglabels-3.0-db.html#lgl-db-get-paper-id-list" title="lgl_db_get_paper_id_list ()">lgl_db_get_paper_id_list</a>            (<em class="parameter"><code><span class="type">void</span></code></em>);
  54 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-db.html#lgl-db-free-paper-id-list" title="lgl_db_free_paper_id_list ()">lgl_db_free_paper_id_list</a>           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *ids</code></em>);
  55 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="libglabels-3.0-db.html#lgl-db-get-paper-name-list" title="lgl_db_get_paper_name_list ()">lgl_db_get_paper_name_list</a>          (<em class="parameter"><code><span class="type">void</span></code></em>);
  56 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-db.html#lgl-db-free-paper-name-list" title="lgl_db_free_paper_name_list ()">lgl_db_free_paper_name_list</a>         (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *names</code></em>);
  57 <a class="link" href="libglabels-3.0-paper.html#lglPaper" title="struct lglPaper"><span class="returnvalue">lglPaper</span></a> *          <a class="link" href="libglabels-3.0-db.html#lgl-db-lookup-paper-from-id" title="lgl_db_lookup_paper_from_id ()">lgl_db_lookup_paper_from_id</a>         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>);
  58 <a class="link" href="libglabels-3.0-paper.html#lglPaper" title="struct lglPaper"><span class="returnvalue">lglPaper</span></a> *          <a class="link" href="libglabels-3.0-db.html#lgl-db-lookup-paper-from-name" title="lgl_db_lookup_paper_from_name ()">lgl_db_lookup_paper_from_name</a>       (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
  59 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="libglabels-3.0-db.html#lgl-db-lookup-paper-id-from-name" title="lgl_db_lookup_paper_id_from_name ()">lgl_db_lookup_paper_id_from_name</a>    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
  60 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="libglabels-3.0-db.html#lgl-db-lookup-paper-name-from-id" title="lgl_db_lookup_paper_name_from_id ()">lgl_db_lookup_paper_name_from_id</a>    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>);
  61 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libglabels-3.0-db.html#lgl-db-is-paper-id-known" title="lgl_db_is_paper_id_known ()">lgl_db_is_paper_id_known</a>            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>);
  62 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libglabels-3.0-db.html#lgl-db-is-paper-id-other" title="lgl_db_is_paper_id_other ()">lgl_db_is_paper_id_other</a>            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>);
  63
  64 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="libglabels-3.0-db.html#lgl-db-get-category-id-list" title="lgl_db_get_category_id_list ()">lgl_db_get_category_id_list</a>         (<em class="parameter"><code><span class="type">void</span></code></em>);
  65 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-db.html#lgl-db-free-category-id-list" title="lgl_db_free_category_id_list ()">lgl_db_free_category_id_list</a>        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *ids</code></em>);
  66 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="libglabels-3.0-db.html#lgl-db-get-category-name-list" title="lgl_db_get_category_name_list ()">lgl_db_get_category_name_list</a>       (<em class="parameter"><code><span class="type">void</span></code></em>);
  67 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-db.html#lgl-db-free-category-name-list" title="lgl_db_free_category_name_list ()">lgl_db_free_category_name_list</a>      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *names</code></em>);
  68 <a class="link" href="libglabels-3.0-category.html#lglCategory" title="struct lglCategory"><span class="returnvalue">lglCategory</span></a> *       <a class="link" href="libglabels-3.0-db.html#lgl-db-lookup-category-from-id" title="lgl_db_lookup_category_from_id ()">lgl_db_lookup_category_from_id</a>      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>);
  69 <a class="link" href="libglabels-3.0-category.html#lglCategory" title="struct lglCategory"><span class="returnvalue">lglCategory</span></a> *       <a class="link" href="libglabels-3.0-db.html#lgl-db-lookup-category-from-name" title="lgl_db_lookup_category_from_name ()">lgl_db_lookup_category_from_name</a>    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
  70 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="libglabels-3.0-db.html#lgl-db-lookup-category-id-from-name" title="lgl_db_lookup_category_id_from_name ()">lgl_db_lookup_category_id_from_name</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
  71 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="libglabels-3.0-db.html#lgl-db-lookup-category-name-from-id" title="lgl_db_lookup_category_name_from_id ()">lgl_db_lookup_category_name_from_id</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>);
  72 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libglabels-3.0-db.html#lgl-db-is-category-id-known" title="lgl_db_is_category_id_known ()">lgl_db_is_category_id_known</a>         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>);
  73
  74 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="libglabels-3.0-db.html#lgl-db-get-brand-list" title="lgl_db_get_brand_list ()">lgl_db_get_brand_list</a>               (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *paper_id</code></em>,
  75                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *category_id</code></em>);
  76 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-db.html#lgl-db-free-brand-list" title="lgl_db_free_brand_list ()">lgl_db_free_brand_list</a>              (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *brands</code></em>);
  77
  78 <a class="link" href="libglabels-3.0-db.html#lglDbRegStatus" title="enum lglDbRegStatus"><span class="returnvalue">lglDbRegStatus</span></a>      <a class="link" href="libglabels-3.0-db.html#lgl-db-register-template" title="lgl_db_register_template ()">lgl_db_register_template</a>            (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>);
  79 <a class="link" href="libglabels-3.0-db.html#lglDbDeleteStatus" title="enum lglDbDeleteStatus"><span class="returnvalue">lglDbDeleteStatus</span></a>   <a class="link" href="libglabels-3.0-db.html#lgl-db-delete-template-by-brand-part" title="lgl_db_delete_template_by_brand_part ()">lgl_db_delete_template_by_brand_part</a>
  80                                                         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *brand</code></em>,
  81                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *part</code></em>);
  82 <a class="link" href="libglabels-3.0-db.html#lglDbDeleteStatus" title="enum lglDbDeleteStatus"><span class="returnvalue">lglDbDeleteStatus</span></a>   <a class="link" href="libglabels-3.0-db.html#lgl-db-delete-template-by-name" title="lgl_db_delete_template_by_name ()">lgl_db_delete_template_by_name</a>      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
  83 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libglabels-3.0-db.html#lgl-db-does-template-exist" title="lgl_db_does_template_exist ()">lgl_db_does_template_exist</a>          (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *brand</code></em>,
  84                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *part</code></em>);
  85 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libglabels-3.0-db.html#lgl-db-does-template-name-exist" title="lgl_db_does_template_name_exist ()">lgl_db_does_template_name_exist</a>     (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
  86 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="libglabels-3.0-db.html#lgl-db-get-template-name-list-all" title="lgl_db_get_template_name_list_all ()">lgl_db_get_template_name_list_all</a>   (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *brand</code></em>,
  87                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *paper_id</code></em>,
  88                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *category_id</code></em>);
  89 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="libglabels-3.0-db.html#lgl-db-get-similar-template-name-list" title="lgl_db_get_similar_template_name_list ()">lgl_db_get_similar_template_name_list</a>
  90                                                         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
  91 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-db.html#lgl-db-free-template-name-list" title="lgl_db_free_template_name_list ()">lgl_db_free_template_name_list</a>      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *names</code></em>);
  92 <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *       <a class="link" href="libglabels-3.0-db.html#lgl-db-lookup-template-from-name" title="lgl_db_lookup_template_from_name ()">lgl_db_lookup_template_from_name</a>    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
  93 <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *       <a class="link" href="libglabels-3.0-db.html#lgl-db-lookup-template-from-brand-part" title="lgl_db_lookup_template_from_brand_part ()">lgl_db_lookup_template_from_brand_part</a>
  94                                                         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *brand</code></em>,
  95                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *part</code></em>);
  96
  97 <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             <a class="link" href="libglabels-3.0-db.html#lgl-db-get-vendor-name-list" title="lgl_db_get_vendor_name_list ()">lgl_db_get_vendor_name_list</a>         (<em class="parameter"><code><span class="type">void</span></code></em>);
  98 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-db.html#lgl-db-free-vendor-name-list" title="lgl_db_free_vendor_name_list ()">lgl_db_free_vendor_name_list</a>        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *names</code></em>);
  99 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libglabels-3.0-db.html#lgl-db-is-vendor-name-known" title="lgl_db_is_vendor_name_known ()">lgl_db_is_vendor_name_known</a>         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
 100 <a class="link" href="libglabels-3.0-vendor.html#lglVendor" title="struct lglVendor"><span class="returnvalue">lglVendor</span></a> *         <a class="link" href="libglabels-3.0-db.html#lgl-db-lookup-vendor-from-name" title="lgl_db_lookup_vendor_from_name ()">lgl_db_lookup_vendor_from_name</a>      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
 101
 102 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-db.html#lgl-db-print-known-papers" title="lgl_db_print_known_papers ()">lgl_db_print_known_papers</a>           (<em class="parameter"><code><span class="type">void</span></code></em>);
 103 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-db.html#lgl-db-print-known-categories" title="lgl_db_print_known_categories ()">lgl_db_print_known_categories</a>       (<em class="parameter"><code><span class="type">void</span></code></em>);
 104 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-db.html#lgl-db-print-known-templates" title="lgl_db_print_known_templates ()">lgl_db_print_known_templates</a>        (<em class="parameter"><code><span class="type">void</span></code></em>);
 105 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-db.html#lgl-db-print-known-vendors" title="lgl_db_print_known_vendors ()">lgl_db_print_known_vendors</a>          (<em class="parameter"><code><span class="type">void</span></code></em>);
 106 </pre>
 107 </div>
 108 <div class="refsect1">
 109 <a name="libglabels-3.0-db.description"></a><h2>Description</h2>
 110 <p>
 111 This section describes a set of functions to locate and add templates and related information in
 112 the LibGlabels template database.
 113 </p>
 114 </div>
 115 <div class="refsect1">
 116 <a name="libglabels-3.0-db.details"></a><h2>Details</h2>
 117 <div class="refsect2">
 118 <a name="lglDbRegStatus"></a><h3>enum lglDbRegStatus</h3>
 119 <pre class="programlisting">typedef enum {
 120         LGL_DB_REG_OK                =  0,
 121         LGL_DB_REG_BAD_PAPER_ID      = -1,
 122         LGL_DB_REG_BRAND_PART_EXISTS = -2,
 123         LGL_DB_REG_FILE_WRITE_ERROR  = -3
 124 } lglDbRegStatus;
 125 </pre>
 126 <p>
 127 This enumeration defines a set of possible return values for <a class="link" href="libglabels-3.0-db.html#lgl-db-register-template" title="lgl_db_register_template ()"><code class="function">lgl_db_register_template()</code></a>.
 128 </p>
 129 <div class="variablelist"><table border="0">
 130 <col align="left" valign="top">
 131 <tbody>
 132 <tr>
 133 <td><p><a name="LGL-DB-REG-OK:CAPS"></a><span class="term"><code class="literal">LGL_DB_REG_OK</code></span></p></td>
 134 <td>Registration successful.
 135 </td>
 136 </tr>
 137 <tr>
 138 <td><p><a name="LGL-DB-REG-BAD-PAPER-ID:CAPS"></a><span class="term"><code class="literal">LGL_DB_REG_BAD_PAPER_ID</code></span></p></td>
 139 <td> Registration failed because paper id is unknown.
 140 </td>
 141 </tr>
 142 <tr>
 143 <td><p><a name="LGL-DB-REG-BRAND-PART-EXISTS:CAPS"></a><span class="term"><code class="literal">LGL_DB_REG_BRAND_PART_EXISTS</code></span></p></td>
 144 <td>Registration failed because template with same brand and part name/number already exists.
 145 </td>
 146 </tr>
 147 <tr>
 148 <td><p><a name="LGL-DB-REG-FILE-WRITE-ERROR:CAPS"></a><span class="term"><code class="literal">LGL_DB_REG_FILE_WRITE_ERROR</code></span></p></td>
 149 <td>Registration failed because an error while writing to disk.
 150 </td>
 151 </tr>
 152 </tbody>
 153 </table></div>
 154 </div>
 155 <hr>
 156 <div class="refsect2">
 157 <a name="lglDbDeleteStatus"></a><h3>enum lglDbDeleteStatus</h3>
 158 <pre class="programlisting">typedef enum {
 159         LGL_DB_DELETE_OK                =  0,
 160         LGL_DB_DELETE_DOES_NOT_EXIST    = -1,
 161         LGL_DB_DELETE_NOT_USER_DEFINED  = -2,
 162         LGL_DB_DELETE_FILE_ERROR        = -3
 163 } lglDbDeleteStatus;
 164 </pre>
 165 <p>
 166 This enumeration defines a set of possible return values for <a class="link" href="libglabels-3.0-db.html#lgl-db-delete-template-by-name" title="lgl_db_delete_template_by_name ()"><code class="function">lgl_db_delete_template_by_name()</code></a> or <a class="link" href="libglabels-3.0-db.html#lgl-db-delete-template-by-brand-part" title="lgl_db_delete_template_by_brand_part ()"><code class="function">lgl_db_delete_template_by_brand_part()</code></a>.
 167 </p>
 168 <div class="variablelist"><table border="0">
 169 <col align="left" valign="top">
 170 <tbody>
 171 <tr>
 172 <td><p><a name="LGL-DB-DELETE-OK:CAPS"></a><span class="term"><code class="literal">LGL_DB_DELETE_OK</code></span></p></td>
 173 <td>Deletion successful.
 174 </td>
 175 </tr>
 176 <tr>
 177 <td><p><a name="LGL-DB-DELETE-DOES-NOT-EXIST:CAPS"></a><span class="term"><code class="literal">LGL_DB_DELETE_DOES_NOT_EXIST</code></span></p></td>
 178 <td>Deletion failed because template with given brand and part name/number does not exist.
 179 </td>
 180 </tr>
 181 <tr>
 182 <td><p><a name="LGL-DB-DELETE-NOT-USER-DEFINED:CAPS"></a><span class="term"><code class="literal">LGL_DB_DELETE_NOT_USER_DEFINED</code></span></p></td>
 183 <td>Deletion failed because given template is not a user defined template.
 184 </td>
 185 </tr>
 186 <tr>
 187 <td><p><a name="LGL-DB-DELETE-FILE-ERROR:CAPS"></a><span class="term"><code class="literal">LGL_DB_DELETE_FILE_ERROR</code></span></p></td>
 188 <td>Deletion failed because of an error while attempting to remove template from disk.
 189 </td>
 190 </tr>
 191 </tbody>
 192 </table></div>
 193 </div>
 194 <hr>
 195 <div class="refsect2">
 196 <a name="lgl-db-init"></a><h3>lgl_db_init ()</h3>
 197 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_db_init                         (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 198 <p>
 199 Initialize all libglabels subsystems.  It is not necessary for an application to call
 200 <a class="link" href="libglabels-3.0-db.html#lgl-db-init" title="lgl_db_init ()"><code class="function">lgl_db_init()</code></a>, because libglabels will initialize on demand.  An application programmer may
 201 choose to call <a class="link" href="libglabels-3.0-db.html#lgl-db-init" title="lgl_db_init ()"><code class="function">lgl_db_init()</code></a> at startup to minimize the impact of the first libglabels call
 202 on GUI response time.
 203 </p>
 204 <p>
 205 This function initializes its paper definitions, category definitions, vendor definitions,
 206 and its template database. It will search both system and user template directories to locate
 207 this data.
 208 </p>
 209 </div>
 210 <hr>
 211 <div class="refsect2">
 212 <a name="lglDbNotifyFunc"></a><h3>lglDbNotifyFunc ()</h3>
 213 <pre class="programlisting"><span class="returnvalue">void</span>                (*lglDbNotifyFunc)                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 214 <p>
 215 Defines the type of notify callback function to be called when database changes.
 216 </p>
 217 <div class="variablelist"><table border="0">
 218 <col align="left" valign="top">
 219 <tbody><tr>
 220 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 221 <td>Pointer to user data that is passed to the notify function.</td>
 222 </tr></tbody>
 223 </table></div>
 224 </div>
 225 <hr>
 226 <div class="refsect2">
 227 <a name="lgl-db-notify-add"></a><h3>lgl_db_notify_add ()</h3>
 228 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a>              lgl_db_notify_add                   (<em class="parameter"><code><a class="link" href="libglabels-3.0-db.html#lglDbNotifyFunc" title="lglDbNotifyFunc ()"><span class="type">lglDbNotifyFunc</span></a> func</code></em>,
 229                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 230 <p>
 231 Register a notification callback function to be called when the database changes.
 232 </p>
 233 <div class="variablelist"><table border="0">
 234 <col align="left" valign="top">
 235 <tbody>
 236 <tr>
 237 <td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
 238 <td>Callback function to be called when database changes.</td>
 239 </tr>
 240 <tr>
 241 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 242 <td>Passback user data to supply to callback function.</td>
 243 </tr>
 244 <tr>
 245 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 246 <td>an ID for this notification registration.</td>
 247 </tr>
 248 </tbody>
 249 </table></div>
 250 </div>
 251 <hr>
 252 <div class="refsect2">
 253 <a name="lgl-db-notify-remove"></a><h3>lgl_db_notify_remove ()</h3>
 254 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_db_notify_remove                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> id</code></em>);</pre>
 255 <p>
 256 Cancel a previous registration a notification callback function.
 257 </p>
 258 <div class="variablelist"><table border="0">
 259 <col align="left" valign="top">
 260 <tbody><tr>
 261 <td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
 262 <td>ID of notification registration to cancel (see <a class="link" href="libglabels-3.0-db.html#lgl-db-notify-add" title="lgl_db_notify_add ()"><code class="function">lgl_db_notify_add()</code></a>).</td>
 263 </tr></tbody>
 264 </table></div>
 265 </div>
 266 <hr>
 267 <div class="refsect2">
 268 <a name="lgl-db-get-paper-id-list"></a><h3>lgl_db_get_paper_id_list ()</h3>
 269 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             lgl_db_get_paper_id_list            (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 270 <p>
 271 Get a list of all paper ids known to libglabels.
 272 </p>
 273 <div class="variablelist"><table border="0">
 274 <col align="left" valign="top">
 275 <tbody><tr>
 276 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 277 <td>a list of paper ids.</td>
 278 </tr></tbody>
 279 </table></div>
 280 </div>
 281 <hr>
 282 <div class="refsect2">
 283 <a name="lgl-db-free-paper-id-list"></a><h3>lgl_db_free_paper_id_list ()</h3>
 284 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_db_free_paper_id_list           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *ids</code></em>);</pre>
 285 <p>
 286 Free up all storage associated with an id list obtained with
 287 <a class="link" href="libglabels-3.0-db.html#lgl-db-get-paper-id-list" title="lgl_db_get_paper_id_list ()"><code class="function">lgl_db_get_paper_id_list()</code></a>.
 288 </p>
 289 <div class="variablelist"><table border="0">
 290 <col align="left" valign="top">
 291 <tbody><tr>
 292 <td><p><span class="term"><em class="parameter"><code>ids</code></em> :</span></p></td>
 293 <td>List of id strings to be freed.</td>
 294 </tr></tbody>
 295 </table></div>
 296 </div>
 297 <hr>
 298 <div class="refsect2">
 299 <a name="lgl-db-get-paper-name-list"></a><h3>lgl_db_get_paper_name_list ()</h3>
 300 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             lgl_db_get_paper_name_list          (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 301 <p>
 302 Get a list of all localized paper names known to libglabels.
 303 </p>
 304 <div class="variablelist"><table border="0">
 305 <col align="left" valign="top">
 306 <tbody><tr>
 307 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 308 <td>a list of localized paper names.</td>
 309 </tr></tbody>
 310 </table></div>
 311 </div>
 312 <hr>
 313 <div class="refsect2">
 314 <a name="lgl-db-free-paper-name-list"></a><h3>lgl_db_free_paper_name_list ()</h3>
 315 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_db_free_paper_name_list         (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *names</code></em>);</pre>
 316 <p>
 317 Free up all storage associated with a name list obtained with
 318 <a class="link" href="libglabels-3.0-db.html#lgl-db-get-paper-name-list" title="lgl_db_get_paper_name_list ()"><code class="function">lgl_db_get_paper_name_list()</code></a>.
 319 </p>
 320 <div class="variablelist"><table border="0">
 321 <col align="left" valign="top">
 322 <tbody><tr>
 323 <td><p><span class="term"><em class="parameter"><code>names</code></em> :</span></p></td>
 324 <td>List of localized paper name strings to be freed.</td>
 325 </tr></tbody>
 326 </table></div>
 327 </div>
 328 <hr>
 329 <div class="refsect2">
 330 <a name="lgl-db-lookup-paper-from-id"></a><h3>lgl_db_lookup_paper_from_id ()</h3>
 331 <pre class="programlisting"><a class="link" href="libglabels-3.0-paper.html#lglPaper" title="struct lglPaper"><span class="returnvalue">lglPaper</span></a> *          lgl_db_lookup_paper_from_id         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>);</pre>
 332 <p>
 333 Lookup paper definition from id string.
 334 </p>
 335 <div class="variablelist"><table border="0">
 336 <col align="left" valign="top">
 337 <tbody>
 338 <tr>
 339 <td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
 340 <td>paper id string</td>
 341 </tr>
 342 <tr>
 343 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 344 <td>pointer to a newly allocated <a class="link" href="libglabels-3.0-paper.html#lglPaper" title="struct lglPaper"><span class="type">lglPaper</span></a> structure.</td>
 345 </tr>
 346 </tbody>
 347 </table></div>
 348 </div>
 349 <hr>
 350 <div class="refsect2">
 351 <a name="lgl-db-lookup-paper-from-name"></a><h3>lgl_db_lookup_paper_from_name ()</h3>
 352 <pre class="programlisting"><a class="link" href="libglabels-3.0-paper.html#lglPaper" title="struct lglPaper"><span class="returnvalue">lglPaper</span></a> *          lgl_db_lookup_paper_from_name       (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 353 <p>
 354 Lookup paper definition from localized paper name string.
 355 </p>
 356 <div class="variablelist"><table border="0">
 357 <col align="left" valign="top">
 358 <tbody>
 359 <tr>
 360 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 361 <td>localized paper name string</td>
 362 </tr>
 363 <tr>
 364 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 365 <td>pointer to a newly allocated <a class="link" href="libglabels-3.0-paper.html#lglPaper" title="struct lglPaper"><span class="type">lglPaper</span></a> structure.</td>
 366 </tr>
 367 </tbody>
 368 </table></div>
 369 </div>
 370 <hr>
 371 <div class="refsect2">
 372 <a name="lgl-db-lookup-paper-id-from-name"></a><h3>lgl_db_lookup_paper_id_from_name ()</h3>
 373 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             lgl_db_lookup_paper_id_from_name    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 374 <p>
 375 Lookup paper name string from localized paper name string.
 376 </p>
 377 <div class="variablelist"><table border="0">
 378 <col align="left" valign="top">
 379 <tbody>
 380 <tr>
 381 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 382 <td>localized paper name stringp</td>
 383 </tr>
 384 <tr>
 385 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 386 <td>pointer to a newly allocated id string.</td>
 387 </tr>
 388 </tbody>
 389 </table></div>
 390 </div>
 391 <hr>
 392 <div class="refsect2">
 393 <a name="lgl-db-lookup-paper-name-from-id"></a><h3>lgl_db_lookup_paper_name_from_id ()</h3>
 394 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             lgl_db_lookup_paper_name_from_id    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>);</pre>
 395 <p>
 396 Lookup localized paper name string from paper id string.
 397 </p>
 398 <div class="variablelist"><table border="0">
 399 <col align="left" valign="top">
 400 <tbody>
 401 <tr>
 402 <td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
 403 <td>paper id string</td>
 404 </tr>
 405 <tr>
 406 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 407 <td>pointer to a newly allocated localized paper name string.</td>
 408 </tr>
 409 </tbody>
 410 </table></div>
 411 </div>
 412 <hr>
 413 <div class="refsect2">
 414 <a name="lgl-db-is-paper-id-known"></a><h3>lgl_db_is_paper_id_known ()</h3>
 415 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            lgl_db_is_paper_id_known            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>);</pre>
 416 <p>
 417 Determine if given paper id is known to libglabels.
 418 </p>
 419 <div class="variablelist"><table border="0">
 420 <col align="left" valign="top">
 421 <tbody>
 422 <tr>
 423 <td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
 424 <td>paper id to test</td>
 425 </tr>
 426 <tr>
 427 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 428 <td>TRUE if id is known, otherwise FALSE.</td>
 429 </tr>
 430 </tbody>
 431 </table></div>
 432 </div>
 433 <hr>
 434 <div class="refsect2">
 435 <a name="lgl-db-is-paper-id-other"></a><h3>lgl_db_is_paper_id_other ()</h3>
 436 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            lgl_db_is_paper_id_other            (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>);</pre>
 437 <p>
 438 Determine if given paper id is the special id "Other."
 439 </p>
 440 <div class="variablelist"><table border="0">
 441 <col align="left" valign="top">
 442 <tbody>
 443 <tr>
 444 <td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
 445 <td>paper id to test</td>
 446 </tr>
 447 <tr>
 448 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 449 <td>TRUE if id is "Other", otherwise FALSE.</td>
 450 </tr>
 451 </tbody>
 452 </table></div>
 453 </div>
 454 <hr>
 455 <div class="refsect2">
 456 <a name="lgl-db-get-category-id-list"></a><h3>lgl_db_get_category_id_list ()</h3>
 457 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             lgl_db_get_category_id_list         (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 458 <p>
 459 Get a list of all category ids known to libglabels.
 460 </p>
 461 <div class="variablelist"><table border="0">
 462 <col align="left" valign="top">
 463 <tbody><tr>
 464 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 465 <td>a list of category ids.</td>
 466 </tr></tbody>
 467 </table></div>
 468 </div>
 469 <hr>
 470 <div class="refsect2">
 471 <a name="lgl-db-free-category-id-list"></a><h3>lgl_db_free_category_id_list ()</h3>
 472 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_db_free_category_id_list        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *ids</code></em>);</pre>
 473 <p>
 474 Free up all storage associated with an id list obtained with
 475 <a class="link" href="libglabels-3.0-db.html#lgl-db-get-category-id-list" title="lgl_db_get_category_id_list ()"><code class="function">lgl_db_get_category_id_list()</code></a>.
 476 </p>
 477 <div class="variablelist"><table border="0">
 478 <col align="left" valign="top">
 479 <tbody><tr>
 480 <td><p><span class="term"><em class="parameter"><code>ids</code></em> :</span></p></td>
 481 <td>List of id strings to be freed.</td>
 482 </tr></tbody>
 483 </table></div>
 484 </div>
 485 <hr>
 486 <div class="refsect2">
 487 <a name="lgl-db-get-category-name-list"></a><h3>lgl_db_get_category_name_list ()</h3>
 488 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             lgl_db_get_category_name_list       (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 489 <p>
 490 Get a list of all localized category names known to libglabels.
 491 </p>
 492 <div class="variablelist"><table border="0">
 493 <col align="left" valign="top">
 494 <tbody><tr>
 495 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 496 <td>a list of localized category names.</td>
 497 </tr></tbody>
 498 </table></div>
 499 </div>
 500 <hr>
 501 <div class="refsect2">
 502 <a name="lgl-db-free-category-name-list"></a><h3>lgl_db_free_category_name_list ()</h3>
 503 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_db_free_category_name_list      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *names</code></em>);</pre>
 504 <p>
 505 Free up all storage associated with a name list obtained with
 506 <a class="link" href="libglabels-3.0-db.html#lgl-db-get-category-name-list" title="lgl_db_get_category_name_list ()"><code class="function">lgl_db_get_category_name_list()</code></a>.
 507 </p>
 508 <div class="variablelist"><table border="0">
 509 <col align="left" valign="top">
 510 <tbody><tr>
 511 <td><p><span class="term"><em class="parameter"><code>names</code></em> :</span></p></td>
 512 <td>List of localized category name strings to be freed.</td>
 513 </tr></tbody>
 514 </table></div>
 515 </div>
 516 <hr>
 517 <div class="refsect2">
 518 <a name="lgl-db-lookup-category-from-id"></a><h3>lgl_db_lookup_category_from_id ()</h3>
 519 <pre class="programlisting"><a class="link" href="libglabels-3.0-category.html#lglCategory" title="struct lglCategory"><span class="returnvalue">lglCategory</span></a> *       lgl_db_lookup_category_from_id      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>);</pre>
 520 <p>
 521 Lookup category definition from id string.
 522 </p>
 523 <div class="variablelist"><table border="0">
 524 <col align="left" valign="top">
 525 <tbody>
 526 <tr>
 527 <td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
 528 <td>category id string</td>
 529 </tr>
 530 <tr>
 531 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 532 <td>pointer to a newly allocated <a class="link" href="libglabels-3.0-category.html#lglCategory" title="struct lglCategory"><span class="type">lglCategory</span></a> structure.</td>
 533 </tr>
 534 </tbody>
 535 </table></div>
 536 </div>
 537 <hr>
 538 <div class="refsect2">
 539 <a name="lgl-db-lookup-category-from-name"></a><h3>lgl_db_lookup_category_from_name ()</h3>
 540 <pre class="programlisting"><a class="link" href="libglabels-3.0-category.html#lglCategory" title="struct lglCategory"><span class="returnvalue">lglCategory</span></a> *       lgl_db_lookup_category_from_name    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 541 <p>
 542 Lookup category definition from localized category name string.
 543 </p>
 544 <div class="variablelist"><table border="0">
 545 <col align="left" valign="top">
 546 <tbody>
 547 <tr>
 548 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 549 <td>localized category name string</td>
 550 </tr>
 551 <tr>
 552 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 553 <td>pointer to a newly allocated <a class="link" href="libglabels-3.0-category.html#lglCategory" title="struct lglCategory"><span class="type">lglCategory</span></a> structure.</td>
 554 </tr>
 555 </tbody>
 556 </table></div>
 557 </div>
 558 <hr>
 559 <div class="refsect2">
 560 <a name="lgl-db-lookup-category-id-from-name"></a><h3>lgl_db_lookup_category_id_from_name ()</h3>
 561 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             lgl_db_lookup_category_id_from_name (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 562 <p>
 563 Lookup category name string from localized category name string.
 564 </p>
 565 <div class="variablelist"><table border="0">
 566 <col align="left" valign="top">
 567 <tbody>
 568 <tr>
 569 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 570 <td>localized category name stringp</td>
 571 </tr>
 572 <tr>
 573 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 574 <td>pointer to a newly allocated id string.</td>
 575 </tr>
 576 </tbody>
 577 </table></div>
 578 </div>
 579 <hr>
 580 <div class="refsect2">
 581 <a name="lgl-db-lookup-category-name-from-id"></a><h3>lgl_db_lookup_category_name_from_id ()</h3>
 582 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             lgl_db_lookup_category_name_from_id (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>);</pre>
 583 <p>
 584 Lookup localized category name string from category id string.
 585 </p>
 586 <div class="variablelist"><table border="0">
 587 <col align="left" valign="top">
 588 <tbody>
 589 <tr>
 590 <td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
 591 <td>category id string</td>
 592 </tr>
 593 <tr>
 594 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 595 <td>pointer to a newly allocated localized category name string.</td>
 596 </tr>
 597 </tbody>
 598 </table></div>
 599 </div>
 600 <hr>
 601 <div class="refsect2">
 602 <a name="lgl-db-is-category-id-known"></a><h3>lgl_db_is_category_id_known ()</h3>
 603 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            lgl_db_is_category_id_known         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>);</pre>
 604 <p>
 605 Determine if given category id is known to libglabels.
 606 </p>
 607 <div class="variablelist"><table border="0">
 608 <col align="left" valign="top">
 609 <tbody>
 610 <tr>
 611 <td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
 612 <td>category id to test</td>
 613 </tr>
 614 <tr>
 615 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 616 <td>TRUE if id is known, otherwise FALSE.</td>
 617 </tr>
 618 </tbody>
 619 </table></div>
 620 </div>
 621 <hr>
 622 <div class="refsect2">
 623 <a name="lgl-db-get-brand-list"></a><h3>lgl_db_get_brand_list ()</h3>
 624 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             lgl_db_get_brand_list               (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *paper_id</code></em>,
 625                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *category_id</code></em>);</pre>
 626 <p>
 627 Get a list of all valid brands of templates in the template database.
 628 Results can be filtered by page size and/or template category.  A list of valid page
 629 sizes can be obtained using <a class="link" href="libglabels-3.0-db.html#lgl-db-get-paper-id-list" title="lgl_db_get_paper_id_list ()"><code class="function">lgl_db_get_paper_id_list()</code></a>.  A list of valid template
 630 categories can be obtained using <a class="link" href="libglabels-3.0-db.html#lgl-db-get-category-id-list" title="lgl_db_get_category_id_list ()"><code class="function">lgl_db_get_category_id_list()</code></a>.
 631 </p>
 632 <div class="variablelist"><table border="0">
 633 <col align="left" valign="top">
 634 <tbody>
 635 <tr>
 636 <td><p><span class="term"><em class="parameter"><code>paper_id</code></em> :</span></p></td>
 637 <td>If non NULL, limit results to given page size.</td>
 638 </tr>
 639 <tr>
 640 <td><p><span class="term"><em class="parameter"><code>category_id</code></em> :</span></p></td>
 641 <td>If non NULL, limit results to given template category.</td>
 642 </tr>
 643 <tr>
 644 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 645 <td>a list of brands</td>
 646 </tr>
 647 </tbody>
 648 </table></div>
 649 </div>
 650 <hr>
 651 <div class="refsect2">
 652 <a name="lgl-db-free-brand-list"></a><h3>lgl_db_free_brand_list ()</h3>
 653 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_db_free_brand_list              (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *brands</code></em>);</pre>
 654 <p>
 655 Free up all storage associated with a list of template names obtained with
 656 <a class="link" href="libglabels-3.0-db.html#lgl-db-get-brand-list" title="lgl_db_get_brand_list ()"><code class="function">lgl_db_get_brand_list()</code></a>.
 657 </p>
 658 <div class="variablelist"><table border="0">
 659 <col align="left" valign="top">
 660 <tbody><tr>
 661 <td><p><span class="term"><em class="parameter"><code>brands</code></em> :</span></p></td>
 662 <td>List of template brand strings to be freed.</td>
 663 </tr></tbody>
 664 </table></div>
 665 </div>
 666 <hr>
 667 <div class="refsect2">
 668 <a name="lgl-db-register-template"></a><h3>lgl_db_register_template ()</h3>
 669 <pre class="programlisting"><a class="link" href="libglabels-3.0-db.html#lglDbRegStatus" title="enum lglDbRegStatus"><span class="returnvalue">lglDbRegStatus</span></a>      lgl_db_register_template            (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>);</pre>
 670 <p>
 671 Register a template.  This function adds a template to the template database.
 672 The template will be stored in an individual XML file in the user template directory.
 673 </p>
 674 <div class="variablelist"><table border="0">
 675 <col align="left" valign="top">
 676 <tbody>
 677 <tr>
 678 <td><p><span class="term"><em class="parameter"><code>template</code></em> :</span></p></td>
 679 <td>Pointer to a template structure to add to database.</td>
 680 </tr>
 681 <tr>
 682 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 683 <td>Status of registration attempt (<a class="link" href="libglabels-3.0-db.html#lglDbRegStatus" title="enum lglDbRegStatus"><span class="type">lglDbRegStatus</span></a>)</td>
 684 </tr>
 685 </tbody>
 686 </table></div>
 687 </div>
 688 <hr>
 689 <div class="refsect2">
 690 <a name="lgl-db-delete-template-by-brand-part"></a><h3>lgl_db_delete_template_by_brand_part ()</h3>
 691 <pre class="programlisting"><a class="link" href="libglabels-3.0-db.html#lglDbDeleteStatus" title="enum lglDbDeleteStatus"><span class="returnvalue">lglDbDeleteStatus</span></a>   lgl_db_delete_template_by_brand_part
 692                                                         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *brand</code></em>,
 693                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *part</code></em>);</pre>
 694 <p>
 695 Delete a user defined template.  This function deletes a template from
 696 the template database. The individual XML file in the user template
 697 directory will also be removed.
 698 </p>
 699 <div class="variablelist"><table border="0">
 700 <col align="left" valign="top">
 701 <tbody>
 702 <tr>
 703 <td><p><span class="term"><em class="parameter"><code>brand</code></em> :</span></p></td>
 704 <td>Brand name or vendor of template to be deleted.</td>
 705 </tr>
 706 <tr>
 707 <td><p><span class="term"><em class="parameter"><code>part</code></em> :</span></p></td>
 708 <td>Part name or number of template to be deleted.</td>
 709 </tr>
 710 <tr>
 711 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 712 <td>Status of registration attempt (<a class="link" href="libglabels-3.0-db.html#lglDbDeleteStatus" title="enum lglDbDeleteStatus"><span class="type">lglDbDeleteStatus</span></a>)</td>
 713 </tr>
 714 </tbody>
 715 </table></div>
 716 </div>
 717 <hr>
 718 <div class="refsect2">
 719 <a name="lgl-db-delete-template-by-name"></a><h3>lgl_db_delete_template_by_name ()</h3>
 720 <pre class="programlisting"><a class="link" href="libglabels-3.0-db.html#lglDbDeleteStatus" title="enum lglDbDeleteStatus"><span class="returnvalue">lglDbDeleteStatus</span></a>   lgl_db_delete_template_by_name      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 721 <p>
 722 Delete a user defined template.  This function deletes a template from
 723 the template database. The individual XML file in the user template
 724 directory will also be removed.
 725 </p>
 726 <div class="variablelist"><table border="0">
 727 <col align="left" valign="top">
 728 <tbody>
 729 <tr>
 730 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 731 <td>Name of template to be deleted.</td>
 732 </tr>
 733 <tr>
 734 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 735 <td>Status of registration attempt (<a class="link" href="libglabels-3.0-db.html#lglDbDeleteStatus" title="enum lglDbDeleteStatus"><span class="type">lglDbDeleteStatus</span></a>)</td>
 736 </tr>
 737 </tbody>
 738 </table></div>
 739 </div>
 740 <hr>
 741 <div class="refsect2">
 742 <a name="lgl-db-does-template-exist"></a><h3>lgl_db_does_template_exist ()</h3>
 743 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            lgl_db_does_template_exist          (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *brand</code></em>,
 744                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *part</code></em>);</pre>
 745 <p>
 746 This function tests whether a template with the given brand and part name/number exists.
 747 </p>
 748 <div class="variablelist"><table border="0">
 749 <col align="left" valign="top">
 750 <tbody>
 751 <tr>
 752 <td><p><span class="term"><em class="parameter"><code>brand</code></em> :</span></p></td>
 753 <td>Brand name.</td>
 754 </tr>
 755 <tr>
 756 <td><p><span class="term"><em class="parameter"><code>part</code></em> :</span></p></td>
 757 <td>Part name/number.</td>
 758 </tr>
 759 <tr>
 760 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 761 <td>TRUE if such a template exists in the database.</td>
 762 </tr>
 763 </tbody>
 764 </table></div>
 765 </div>
 766 <hr>
 767 <div class="refsect2">
 768 <a name="lgl-db-does-template-name-exist"></a><h3>lgl_db_does_template_name_exist ()</h3>
 769 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            lgl_db_does_template_name_exist     (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 770 <p>
 771 This function test whether a template with the given name exists.
 772 </p>
 773 <div class="variablelist"><table border="0">
 774 <col align="left" valign="top">
 775 <tbody>
 776 <tr>
 777 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 778 <td>name string</td>
 779 </tr>
 780 <tr>
 781 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 782 <td>TRUE if such a template exists in the database.</td>
 783 </tr>
 784 </tbody>
 785 </table></div>
 786 </div>
 787 <hr>
 788 <div class="refsect2">
 789 <a name="lgl-db-get-template-name-list-all"></a><h3>lgl_db_get_template_name_list_all ()</h3>
 790 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             lgl_db_get_template_name_list_all   (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *brand</code></em>,
 791                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *paper_id</code></em>,
 792                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *category_id</code></em>);</pre>
 793 <p>
 794 Get a list of all valid names of templates in the template database.
 795 Results can be filtered by page size and/or template category.  A list of valid page
 796 sizes can be obtained using <a class="link" href="libglabels-3.0-db.html#lgl-db-get-paper-id-list" title="lgl_db_get_paper_id_list ()"><code class="function">lgl_db_get_paper_id_list()</code></a>.  A list of valid template
 797 categories can be obtained using <a class="link" href="libglabels-3.0-db.html#lgl-db-get-category-id-list" title="lgl_db_get_category_id_list ()"><code class="function">lgl_db_get_category_id_list()</code></a>.
 798 </p>
 799 <div class="variablelist"><table border="0">
 800 <col align="left" valign="top">
 801 <tbody>
 802 <tr>
 803 <td><p><span class="term"><em class="parameter"><code>brand</code></em> :</span></p></td>
 804 <td>If non NULL, limit results to given brand</td>
 805 </tr>
 806 <tr>
 807 <td><p><span class="term"><em class="parameter"><code>paper_id</code></em> :</span></p></td>
 808 <td>If non NULL, limit results to given page size.</td>
 809 </tr>
 810 <tr>
 811 <td><p><span class="term"><em class="parameter"><code>category_id</code></em> :</span></p></td>
 812 <td>If non NULL, limit results to given template category.</td>
 813 </tr>
 814 <tr>
 815 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 816 <td>a list of template names.</td>
 817 </tr>
 818 </tbody>
 819 </table></div>
 820 </div>
 821 <hr>
 822 <div class="refsect2">
 823 <a name="lgl-db-get-similar-template-name-list"></a><h3>lgl_db_get_similar_template_name_list ()</h3>
 824 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             lgl_db_get_similar_template_name_list
 825                                                         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 826 <p>
 827 Get a list of all valid names of templates in the template database that
 828 have the same size and layout characteristics as the given template.
 829 </p>
 830 <div class="variablelist"><table border="0">
 831 <col align="left" valign="top">
 832 <tbody>
 833 <tr>
 834 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 835 <td>Name of template under test.</td>
 836 </tr>
 837 <tr>
 838 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 839 <td>a list of template names.</td>
 840 </tr>
 841 </tbody>
 842 </table></div>
 843 </div>
 844 <hr>
 845 <div class="refsect2">
 846 <a name="lgl-db-free-template-name-list"></a><h3>lgl_db_free_template_name_list ()</h3>
 847 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_db_free_template_name_list      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *names</code></em>);</pre>
 848 <p>
 849 Free up all storage associated with a list of template names obtained with
 850 <a class="link" href="libglabels-3.0-db.html#lgl-db-get-template-name-list-all" title="lgl_db_get_template_name_list_all ()"><code class="function">lgl_db_get_template_name_list_all()</code></a>.
 851 </p>
 852 <div class="variablelist"><table border="0">
 853 <col align="left" valign="top">
 854 <tbody><tr>
 855 <td><p><span class="term"><em class="parameter"><code>names</code></em> :</span></p></td>
 856 <td>List of template name strings to be freed.</td>
 857 </tr></tbody>
 858 </table></div>
 859 </div>
 860 <hr>
 861 <div class="refsect2">
 862 <a name="lgl-db-lookup-template-from-name"></a><h3>lgl_db_lookup_template_from_name ()</h3>
 863 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *       lgl_db_lookup_template_from_name    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 864 <p>
 865 Lookup template in template database from name string.
 866 </p>
 867 <div class="variablelist"><table border="0">
 868 <col align="left" valign="top">
 869 <tbody>
 870 <tr>
 871 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 872 <td>name string</td>
 873 </tr>
 874 <tr>
 875 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 876 <td>pointer to a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> structure.</td>
 877 </tr>
 878 </tbody>
 879 </table></div>
 880 </div>
 881 <hr>
 882 <div class="refsect2">
 883 <a name="lgl-db-lookup-template-from-brand-part"></a><h3>lgl_db_lookup_template_from_brand_part ()</h3>
 884 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *       lgl_db_lookup_template_from_brand_part
 885                                                         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *brand</code></em>,
 886                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *part</code></em>);</pre>
 887 <p>
 888 Lookup template in template database from brand and part strings.
 889 </p>
 890 <div class="variablelist"><table border="0">
 891 <col align="left" valign="top">
 892 <tbody>
 893 <tr>
 894 <td><p><span class="term"><em class="parameter"><code>brand</code></em> :</span></p></td>
 895 <td>brand name string</td>
 896 </tr>
 897 <tr>
 898 <td><p><span class="term"><em class="parameter"><code>part</code></em> :</span></p></td>
 899 <td>part name string</td>
 900 </tr>
 901 <tr>
 902 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 903 <td>pointer to a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> structure.</td>
 904 </tr>
 905 </tbody>
 906 </table></div>
 907 </div>
 908 <hr>
 909 <div class="refsect2">
 910 <a name="lgl-db-get-vendor-name-list"></a><h3>lgl_db_get_vendor_name_list ()</h3>
 911 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *             lgl_db_get_vendor_name_list         (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 912 <p>
 913 Get a list of all localized vendor names known to libglabels.
 914 </p>
 915 <div class="variablelist"><table border="0">
 916 <col align="left" valign="top">
 917 <tbody><tr>
 918 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 919 <td>a list of localized vendor names.</td>
 920 </tr></tbody>
 921 </table></div>
 922 </div>
 923 <hr>
 924 <div class="refsect2">
 925 <a name="lgl-db-free-vendor-name-list"></a><h3>lgl_db_free_vendor_name_list ()</h3>
 926 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_db_free_vendor_name_list        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *names</code></em>);</pre>
 927 <p>
 928 Free up all storage associated with a name list obtained with
 929 <a class="link" href="libglabels-3.0-db.html#lgl-db-get-vendor-name-list" title="lgl_db_get_vendor_name_list ()"><code class="function">lgl_db_get_vendor_name_list()</code></a>.
 930 </p>
 931 <div class="variablelist"><table border="0">
 932 <col align="left" valign="top">
 933 <tbody><tr>
 934 <td><p><span class="term"><em class="parameter"><code>names</code></em> :</span></p></td>
 935 <td>List of localized vendor name strings to be freed.</td>
 936 </tr></tbody>
 937 </table></div>
 938 </div>
 939 <hr>
 940 <div class="refsect2">
 941 <a name="lgl-db-is-vendor-name-known"></a><h3>lgl_db_is_vendor_name_known ()</h3>
 942 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            lgl_db_is_vendor_name_known         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 943 <p>
 944 Determine if given vendor id is known to libglabels.
 945 </p>
 946 <div class="variablelist"><table border="0">
 947 <col align="left" valign="top">
 948 <tbody>
 949 <tr>
 950 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 951 <td>vendor name to test</td>
 952 </tr>
 953 <tr>
 954 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 955 <td>TRUE if id is known, otherwise FALSE.</td>
 956 </tr>
 957 </tbody>
 958 </table></div>
 959 </div>
 960 <hr>
 961 <div class="refsect2">
 962 <a name="lgl-db-lookup-vendor-from-name"></a><h3>lgl_db_lookup_vendor_from_name ()</h3>
 963 <pre class="programlisting"><a class="link" href="libglabels-3.0-vendor.html#lglVendor" title="struct lglVendor"><span class="returnvalue">lglVendor</span></a> *         lgl_db_lookup_vendor_from_name      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 964 <p>
 965 Lookup vendor definition from localized vendor name string.
 966 </p>
 967 <div class="variablelist"><table border="0">
 968 <col align="left" valign="top">
 969 <tbody>
 970 <tr>
 971 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
 972 <td>localized vendor name string</td>
 973 </tr>
 974 <tr>
 975 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 976 <td>pointer to a newly allocated <a class="link" href="libglabels-3.0-vendor.html#lglVendor" title="struct lglVendor"><span class="type">lglVendor</span></a> structure.</td>
 977 </tr>
 978 </tbody>
 979 </table></div>
 980 </div>
 981 <hr>
 982 <div class="refsect2">
 983 <a name="lgl-db-print-known-papers"></a><h3>lgl_db_print_known_papers ()</h3>
 984 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_db_print_known_papers           (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 985 <p>
 986 For debugging purposes: print a list of all paper definitions known to
 987 libglabels.
 988 </p>
 989 </div>
 990 <hr>
 991 <div class="refsect2">
 992 <a name="lgl-db-print-known-categories"></a><h3>lgl_db_print_known_categories ()</h3>
 993 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_db_print_known_categories       (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 994 <p>
 995 For debugging purposes: print a list of all category definitions known to
 996 libglabels.
 997 </p>
 998 </div>
 999 <hr>
1000 <div class="refsect2">
1001 <a name="lgl-db-print-known-templates"></a><h3>lgl_db_print_known_templates ()</h3>
1002 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_db_print_known_templates        (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1003 <p>
1004 Print all known templates (for debugging purposes).
1005 </p>
1006 </div>
1007 <hr>
1008 <div class="refsect2">
1009 <a name="lgl-db-print-known-vendors"></a><h3>lgl_db_print_known_vendors ()</h3>
1010 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_db_print_known_vendors          (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1011 <p>
1012 For debugging purposes: print a list of all vendor definitions known to
1013 libglabels.
1014 </p>
1015 </div>
1016 </div>
1017 </div>
1018 <div class="footer">
1019 <hr>
1020           Generated by GTK-Doc V1.18</div>
1021 </body>
1022 </html>