<!-- ##### SECTION Title ##### -->
GdaObjectRef

<!-- ##### SECTION Short_Description ##### -->
Used to reference other objects

<!-- ##### SECTION Long_Description ##### -->
<para>
This object is a simple wrapper to reference other objects. It can be used in places where referenced objects
do not yet exist when they are needed, and their xml ID or their name is known. In this situation, create a
#GdaObjectRef object, give it the xml ID or name of the object which is to be referenced, and activate the
#GdaObjectRef object. If it is activated, then the real object can be fetched through the #GdaObjectRef object.
</para>
<para>
There are restrictions on the types of objects which can be handled:
<itemizedlist>
    <listitem>
         <para>#GdaDictTable</para>
    </listitem>
    <listitem>
         <para>#GdaDictField</para>
    </listitem>
    <listitem>
         <para>#GdaQuery</para>
    </listitem>
    <listitem>
         <para>#GdaQueryTarget</para>
    </listitem>
    <listitem>
         <para>#GdaEntityField (for any #GdaDictField of #GdaQueryField object)</para>
    </listitem>
</itemizedlist>
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### SECTION Stability_Level ##### -->


<!-- ##### STRUCT GdaObjectRef ##### -->
<para>

</para>


<!-- ##### SIGNAL GdaObjectRef::ref-found ##### -->
<para>

</para>

@dbrefbase: the object which received the signal.

<!-- ##### SIGNAL GdaObjectRef::ref-lost ##### -->
<para>

</para>

@dbrefbase: the object which received the signal.

<!-- ##### ARG GdaObjectRef:helper-ref ##### -->
<para>

</para>

<!-- ##### ENUM GdaObjectRefType ##### -->
<para>

</para>

@REFERENCE_BY_XML_ID: 
@REFERENCE_BY_NAME: 

<!-- ##### FUNCTION gda_object_ref_new ##### -->
<para>

</para>

@dict: 
@Returns: 


<!-- ##### FUNCTION gda_object_ref_new_no_ref_count ##### -->
<para>

</para>

@dict: 
@Returns: 


<!-- ##### FUNCTION gda_object_ref_new_copy ##### -->
<para>

</para>

@orig: 
@Returns: 


<!-- ##### FUNCTION gda_object_ref_set_ref_name ##### -->
<para>

</para>

@ref: 
@ref_type: 
@type: 
@name: 


<!-- ##### FUNCTION gda_object_ref_set_ref_object_type ##### -->
<para>

</para>

@ref: 
@object: 
@type: 


<!-- ##### FUNCTION gda_object_ref_set_ref_object ##### -->
<para>

</para>

@ref: 
@object: 


<!-- ##### FUNCTION gda_object_ref_replace_ref_object ##### -->
<para>

</para>

@ref: 
@replacements: 


<!-- ##### FUNCTION gda_object_ref_get_ref_name ##### -->
<para>

</para>

@ref: 
@ref_type: 
@type: 
@Returns: 


<!-- ##### FUNCTION gda_object_ref_get_ref_type ##### -->
<para>

</para>

@ref: 
@Returns: 


<!-- ##### FUNCTION gda_object_ref_get_ref_object ##### -->
<para>

</para>

@ref: 
@Returns: 


<!-- ##### FUNCTION gda_object_ref_activate ##### -->
<para>

</para>

@ref: 
@Returns: 


<!-- ##### FUNCTION gda_object_ref_deactivate ##### -->
<para>

</para>

@ref: 


<!-- ##### FUNCTION gda_object_ref_is_active ##### -->
<para>

</para>

@ref: 
@Returns: 


