Blob Blame History Raw
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GDataCategory: GData Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GData Reference Manual">
<link rel="up" href="ch07.html" title="Atom API">
<link rel="prev" href="GDataAuthor.html" title="GDataAuthor">
<link rel="next" href="GDataGenerator.html" title="GDataGenerator">
<meta name="generator" content="GTK-Doc V1.26.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#GDataCategory.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
                  <a href="#GDataCategory.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span> 
                  <a href="#GDataCategory.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties">  <span class="dim">|</span> 
                  <a href="#GDataCategory.properties" class="shortcut">Properties</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="ch07.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="GDataAuthor.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="GDataGenerator.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GDataCategory"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GDataCategory.top_of_page"></a>GDataCategory</span></h2>
<p>GDataCategory — Atom category element</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GDataCategory.stability-level"></a><h2>Stability Level</h2>
<acronym title="The intention of a Stable interface is to enable arbitrary third parties to
develop applications to these interfaces, release them, and have confidence that
they will run on all minor releases of the product (after the one in which the
interface was introduced, and within the same major release). Even at a major
release, incompatible changes are expected to be rare, and to have strong
justifications.
"><span class="acronym">Stable</span></acronym>, unless otherwise indicated
</div>
<div class="refsect1">
<a name="GDataCategory.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<a class="link" href="GDataCategory.html" title="GDataCategory"><span class="returnvalue">GDataCategory</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataCategory.html#gdata-category-new" title="gdata_category_new ()">gdata_category_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataCategory.html#gdata-category-get-term" title="gdata_category_get_term ()">gdata_category_get_term</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataCategory.html#gdata-category-set-term" title="gdata_category_set_term ()">gdata_category_set_term</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataCategory.html#gdata-category-get-scheme" title="gdata_category_get_scheme ()">gdata_category_get_scheme</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataCategory.html#gdata-category-set-scheme" title="gdata_category_set_scheme ()">gdata_category_set_scheme</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataCategory.html#gdata-category-get-label" title="gdata_category_get_label ()">gdata_category_get_label</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataCategory.html#gdata-category-set-label" title="gdata_category_set_label ()">gdata_category_set_label</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GDataCategory.properties"></a><h2>Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
<col width="200px" class="properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataCategory.html#GDataCategory--label" title="The “label” property">label</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataCategory.html#GDataCategory--scheme" title="The “scheme” property">scheme</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataCategory.html#GDataCategory--term" title="The “term” property">term</a></td>
<td class="property_flags">Read / Write</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GDataCategory.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GDataCategory.html#GDATA-CATEGORY-SCHEMA-LABELS:CAPS" title="GDATA_CATEGORY_SCHEMA_LABELS">GDATA_CATEGORY_SCHEMA_LABELS</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GDataCategory.html#GDATA-CATEGORY-SCHEMA-LABELS-SHARED:CAPS" title="GDATA_CATEGORY_SCHEMA_LABELS_SHARED">GDATA_CATEGORY_SCHEMA_LABELS_SHARED</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GDataCategory.html#GDATA-CATEGORY-SCHEMA-LABELS-STARRED:CAPS" title="GDATA_CATEGORY_SCHEMA_LABELS_STARRED">GDATA_CATEGORY_SCHEMA_LABELS_STARRED</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GDataCategory.html#GDATA-CATEGORY-SCHEMA-LABELS-VIEWED:CAPS" title="GDATA_CATEGORY_SCHEMA_LABELS_VIEWED">GDATA_CATEGORY_SCHEMA_LABELS_VIEWED</a></td>
</tr>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a class="link" href="GDataCategory.html#GDataCategory-struct" title="GDataCategory">GDataCategory</a></td>
</tr>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a class="link" href="GDataCategory.html#GDataCategoryClass" title="GDataCategoryClass">GDataCategoryClass</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GDataCategory.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen">    <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
    <span class="lineart">╰──</span> <a class="link" href="GDataParsable.html" title="GDataParsable">GDataParsable</a>
        <span class="lineart">╰──</span> GDataCategory
            <span class="lineart">╰──</span> <a class="link" href="GDataYouTubeCategory.html" title="GDataYouTubeCategory">GDataYouTubeCategory</a>
</pre>
</div>
<div class="refsect1">
<a name="GDataCategory.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GDataCategory implements
 <a class="link" href="GDataComparable.html" title="GDataComparable">GDataComparable</a>.</p>
</div>
<div class="refsect1">
<a name="GDataCategory.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include &lt;gdata/atom/gdata-category.h&gt;
</pre>
</div>
<div class="refsect1">
<a name="GDataCategory.description"></a><h2>Description</h2>
<p><a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a> represents a "category" element from the</p>
<a class="ulink" href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php" target="_top">Atom specification</a>.

</div>
<div class="refsect1">
<a name="GDataCategory.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gdata-category-new"></a><h3>gdata_category_new ()</h3>
<pre class="programlisting"><a class="link" href="GDataCategory.html" title="GDataCategory"><span class="returnvalue">GDataCategory</span></a> *
gdata_category_new (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *term</code></em>,
                    <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *scheme</code></em>,
                    <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
<p>Creates a new <a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a>. More information is available in the <a class="ulink" href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.category" target="_top">Atom specification</a>.</p>
<p><em class="parameter"><code>term</code></em>
 must be non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and non-empty. <em class="parameter"><code>scheme</code></em>
 must be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or non-empty.</p>
<div class="refsect3">
<a name="gdata-category-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>term</p></td>
<td class="parameter_description"><p>a category identifier</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>scheme</p></td>
<td class="parameter_description"><p>an IRI to define the categorisation scheme, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>a human-readable label for the category, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-category-new.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; unref with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gdata-category-get-term"></a><h3>gdata_category_get_term ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_category_get_term (<em class="parameter"><code><a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataCategory.html#GDataCategory--term" title="The “term” property"><span class="type">“term”</span></a> property. The term will always be a non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, non-empty string.</p>
<div class="refsect3">
<a name="gdata-category-get-term.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-category-get-term.returns"></a><h4>Returns</h4>
<p> the category's term</p>
</div>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-category-set-term"></a><h3>gdata_category_set_term ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_category_set_term (<em class="parameter"><code><a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a> *self</code></em>,
                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *term</code></em>);</pre>
<p>Sets the <a class="link" href="GDataCategory.html#GDataCategory--term" title="The “term” property"><span class="type">“term”</span></a> property to <em class="parameter"><code>term</code></em>
. <em class="parameter"><code>term</code></em>
 must be non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and non-empty.</p>
<div class="refsect3">
<a name="gdata-category-set-term.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>term</p></td>
<td class="parameter_description"><p>the new term for the category</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-category-get-scheme"></a><h3>gdata_category_get_scheme ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_category_get_scheme (<em class="parameter"><code><a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataCategory.html#GDataCategory--scheme" title="The “scheme” property"><span class="type">“scheme”</span></a> property. If the scheme is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, it will be non-empty.</p>
<div class="refsect3">
<a name="gdata-category-get-scheme.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-category-get-scheme.returns"></a><h4>Returns</h4>
<p> the category's scheme, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-category-set-scheme"></a><h3>gdata_category_set_scheme ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_category_set_scheme (<em class="parameter"><code><a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a> *self</code></em>,
                           <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *scheme</code></em>);</pre>
<p>Sets the <a class="link" href="GDataCategory.html#GDataCategory--scheme" title="The “scheme” property"><span class="type">“scheme”</span></a> property to <em class="parameter"><code>scheme</code></em>
. <em class="parameter"><code>scheme</code></em>
 must be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or non-empty.</p>
<p>Set <em class="parameter"><code>scheme</code></em>
 to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset the property in the category.</p>
<div class="refsect3">
<a name="gdata-category-set-scheme.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>scheme</p></td>
<td class="parameter_description"><p>the new scheme for the category, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-category-get-label"></a><h3>gdata_category_get_label ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_category_get_label (<em class="parameter"><code><a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataCategory.html#GDataCategory--label" title="The “label” property"><span class="type">“label”</span></a> property.</p>
<div class="refsect3">
<a name="gdata-category-get-label.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-category-get-label.returns"></a><h4>Returns</h4>
<p> the category's label, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-category-set-label"></a><h3>gdata_category_set_label ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_category_set_label (<em class="parameter"><code><a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a> *self</code></em>,
                          <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
<p>Sets the <a class="link" href="GDataCategory.html#GDataCategory--label" title="The “label” property"><span class="type">“label”</span></a> property to <em class="parameter"><code>label</code></em>
.</p>
<p>Set <em class="parameter"><code>label</code></em>
 to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset the property in the category.</p>
<div class="refsect3">
<a name="gdata-category-set-label.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>the new label for the category, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
</div>
<div class="refsect1">
<a name="GDataCategory.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GDATA-CATEGORY-SCHEMA-LABELS:CAPS"></a><h3>GDATA_CATEGORY_SCHEMA_LABELS</h3>
<pre class="programlisting">#define GDATA_CATEGORY_SCHEMA_LABELS "http://schemas.google.com/g/2005/labels"
</pre>
<p>A schema for categories which label the entry they're applied to in some way, such as starring it. The semantics of the various labels
(such as <a class="link" href="GDataCategory.html#GDATA-CATEGORY-SCHEMA-LABELS-STARRED:CAPS" title="GDATA_CATEGORY_SCHEMA_LABELS_STARRED"><code class="literal">GDATA_CATEGORY_SCHEMA_LABELS_STARRED</code></a>) are service-specific.</p>
<p class="since">Since: <a class="link" href="ix14.html#api-index-0.11.0">0.11.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDATA-CATEGORY-SCHEMA-LABELS-SHARED:CAPS"></a><h3>GDATA_CATEGORY_SCHEMA_LABELS_SHARED</h3>
<pre class="programlisting">#define GDATA_CATEGORY_SCHEMA_LABELS_SHARED GDATA_CATEGORY_SCHEMA_LABELS"#shared"
</pre>
<p>A term for categories of the <a class="link" href="GDataCategory.html#GDATA-CATEGORY-SCHEMA-LABELS:CAPS" title="GDATA_CATEGORY_SCHEMA_LABELS"><code class="literal">GDATA_CATEGORY_SCHEMA_LABELS</code></a> schema which labels an entry as being “shared”. The semantics of this label are
service-specific, but are obvious for services such as Google Documents.</p>
<p class="since">Since: <a class="link" href="ix22.html#api-index-0.17.0">0.17.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDATA-CATEGORY-SCHEMA-LABELS-STARRED:CAPS"></a><h3>GDATA_CATEGORY_SCHEMA_LABELS_STARRED</h3>
<pre class="programlisting">#define GDATA_CATEGORY_SCHEMA_LABELS_STARRED GDATA_CATEGORY_SCHEMA_LABELS"#starred"
</pre>
<p>A term for categories of the <a class="link" href="GDataCategory.html#GDATA-CATEGORY-SCHEMA-LABELS:CAPS" title="GDATA_CATEGORY_SCHEMA_LABELS"><code class="literal">GDATA_CATEGORY_SCHEMA_LABELS</code></a> schema which labels an entry as being “starred”. The semantics of this label are
service-specific, but are obvious for services such as Google Documents.</p>
<p class="since">Since: <a class="link" href="ix14.html#api-index-0.11.0">0.11.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDATA-CATEGORY-SCHEMA-LABELS-VIEWED:CAPS"></a><h3>GDATA_CATEGORY_SCHEMA_LABELS_VIEWED</h3>
<pre class="programlisting">#define GDATA_CATEGORY_SCHEMA_LABELS_VIEWED GDATA_CATEGORY_SCHEMA_LABELS"#viewed"
</pre>
<p>A term for categories of the <a class="link" href="GDataCategory.html#GDATA-CATEGORY-SCHEMA-LABELS:CAPS" title="GDATA_CATEGORY_SCHEMA_LABELS"><code class="literal">GDATA_CATEGORY_SCHEMA_LABELS</code></a> schema which labels an entry as being “viewed”. The semantics of this label are
service-specific, but are obvious for services such as Google Documents.</p>
<p class="since">Since: <a class="link" href="ix22.html#api-index-0.17.0">0.17.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataCategory-struct"></a><h3>GDataCategory</h3>
<pre class="programlisting">typedef struct _GDataCategory GDataCategory;</pre>
<p>All the fields in the <a class="link" href="GDataCategory.html" title="GDataCategory"><span class="type">GDataCategory</span></a> structure are private and should never be accessed directly.</p>
</div>
<hr>
<div class="refsect2">
<a name="GDataCategoryClass"></a><h3>GDataCategoryClass</h3>
<pre class="programlisting">typedef struct {
} GDataCategoryClass;
</pre>
<p>All the fields in the <a class="link" href="GDataCategory.html#GDataCategoryClass" title="GDataCategoryClass"><span class="type">GDataCategoryClass</span></a> structure are private and should never be accessed directly.</p>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
</div>
<div class="refsect1">
<a name="GDataCategory.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GDataCategory--label"></a><h3>The <code class="literal">“label”</code> property</h3>
<pre class="programlisting">  “label”                    <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>A human-readable label for display in end-user applications.</p>
<p>For more information, see the</p>
<a class="ulink" href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.category" target="_top">
Atom specification</a>.
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataCategory--scheme"></a><h3>The <code class="literal">“scheme”</code> property</h3>
<pre class="programlisting">  “scheme”                   <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>An IRI that identifies a categorization scheme.</p>
<p>For more information, see the</p>
<a class="ulink" href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.category" target="_top">
Atom specification</a>.
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataCategory--term"></a><h3>The <code class="literal">“term”</code> property</h3>
<pre class="programlisting">  “term”                     <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>Identifies the category to which the entry or feed belongs.</p>
<p>For more information, see the</p>
<a class="ulink" href="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.category" target="_top">
Atom specification</a>.
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.26.1</div>
</body>
</html>