<refentry id="GalViewCollection">
<refmeta>
<refentrytitle>GalViewCollection</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GAL Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GalViewCollection</refname><refpurpose></refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>

<synopsis>



#define     <link linkend="GAL-VIEW-COLLECTION-TYPE:CAPS">GAL_VIEW_COLLECTION_TYPE</link>
typedef     <link linkend="GalViewCollection">GalViewCollection</link>;
<link linkend="GalViewCollection">GalViewCollection</link>* <link linkend="gal-view-collection-new">gal_view_collection_new</link>  (void);
<link linkend="void">void</link>        <link linkend="gal-view-collection-set-storage-directories">gal_view_collection_set_storage_directories</link>
                                            (<link linkend="GalViewCollection">GalViewCollection</link> *collection,
                                             <link linkend="char">char</link> *system_dir,
                                             <link linkend="char">char</link> *local_dir);
<link linkend="void">void</link>        <link linkend="gal-view-collection-add-factory">gal_view_collection_add_factory</link> (<link linkend="GalViewCollection">GalViewCollection</link> *collection,
                                             <link linkend="GalViewFactory">GalViewFactory</link> *factory);
<link linkend="void">void</link>        <link linkend="gal-view-collection-display-view">gal_view_collection_display_view</link>
                                            (<link linkend="GalViewCollection">GalViewCollection</link> *collection,
                                             <link linkend="GalView">GalView</link> *view);

</synopsis>
</refsynopsisdiv>

<refsect1>
<title>Object Hierarchy</title>
<synopsis>

  <link linkend="GtkObject">GtkObject</link>
   +----GalViewCollection
</synopsis>

</refsect1>






<refsect1>
<title>Signal Prototypes</title>
<synopsis>

&quot;<link linkend="GalViewCollection-display-view">display-view</link>&quot;
            <link linkend="void">void</link>        user_function      (<link linkend="GalViewCollection">GalViewCollection</link> *galviewcollection,
                                            <link linkend="GtkObject">GtkObject</link> *arg1,
                                            <link linkend="gpointer">gpointer</link> user_data);
</synopsis>
</refsect1>


<refsect1>
<title>Description</title>
<para>

</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="GAL-VIEW-COLLECTION-TYPE:CAPS">GAL_VIEW_COLLECTION_TYPE</title>
<indexterm><primary>GAL_VIEW_COLLECTION_TYPE</primary></indexterm><programlisting>#define GAL_VIEW_COLLECTION_TYPE        (gal_view_collection_get_type ())
</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="GalViewCollection">GalViewCollection</title>
<indexterm><primary>GalViewCollection</primary></indexterm><programlisting>typedef struct {
	GtkObject base;

	GList *view_list;
	GList *factory_list;
} GalViewCollection;
</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="gal-view-collection-new">gal_view_collection_new ()</title>
<indexterm><primary>gal_view_collection_new</primary></indexterm><programlisting><link linkend="GalViewCollection">GalViewCollection</link>* gal_view_collection_new  (void);</programlisting>
<para>
A collection of views and view factories.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gal-view-collection-set-storage-directories">gal_view_collection_set_storage_directories ()</title>
<indexterm><primary>gal_view_collection_set_storage_directories</primary></indexterm><programlisting><link linkend="void">void</link>        gal_view_collection_set_storage_directories
                                            (<link linkend="GalViewCollection">GalViewCollection</link> *collection,
                                             <link linkend="char">char</link> *system_dir,
                                             <link linkend="char">char</link> *local_dir);</programlisting>
<para>
Sets up the GalViewCollection.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>collection</parameter>&nbsp;:</term>
<listitem><simpara> The view collection to initialize
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>system_dir</parameter>&nbsp;:</term>
<listitem><simpara> The location of the system built in views
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>local_dir</parameter>&nbsp;:</term>
<listitem><simpara> The location to store the users set up views
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gal-view-collection-add-factory">gal_view_collection_add_factory ()</title>
<indexterm><primary>gal_view_collection_add_factory</primary></indexterm><programlisting><link linkend="void">void</link>        gal_view_collection_add_factory (<link linkend="GalViewCollection">GalViewCollection</link> *collection,
                                             <link linkend="GalViewFactory">GalViewFactory</link> *factory);</programlisting>
<para>
Adds the given factory to this collection.  This list is used both
when loading views from their xml description as well as when the
user tries to create a new view.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>collection</parameter>&nbsp;:</term>
<listitem><simpara> The view collection to add a factory to
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>factory</parameter>&nbsp;:</term>
<listitem><simpara> The factory to add.  The <parameter>collection</parameter> will add a reference
to the factory object, so you should unref it after calling this
function if you no longer need it.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gal-view-collection-display-view">gal_view_collection_display_view ()</title>
<indexterm><primary>gal_view_collection_display_view</primary></indexterm><programlisting><link linkend="void">void</link>        gal_view_collection_display_view
                                            (<link linkend="GalViewCollection">GalViewCollection</link> *collection,
                                             <link linkend="GalView">GalView</link> *view);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>collection</parameter>&nbsp;:</term>
<listitem><simpara> The GalViewCollection to send the signal on.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>view</parameter>&nbsp;:</term>
<listitem><simpara> The view to display.
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>

<refsect1>
<title>Signals</title>
<refsect2><title><anchor id="GalViewCollection-display-view">The &quot;display-view&quot; signal</title>
<programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GalViewCollection">GalViewCollection</link> *galviewcollection,
                                            <link linkend="GtkObject">GtkObject</link> *arg1,
                                            <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>galviewcollection</parameter>&nbsp;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&nbsp;:</term>
<listitem><simpara>

</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>



</refentry>
