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