![]() |
![]() |
![]() |
GData Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
#include <gdata/atom/gdata-category.h> #define GDATA_CATEGORY_SCHEMA_LABELS #define GDATA_CATEGORY_SCHEMA_LABELS_STARRED GDataCategory; GDataCategoryClass; GDataCategory * gdata_category_new (const gchar *term
,const gchar *scheme
,const gchar *label
); const gchar * gdata_category_get_term (GDataCategory *self
); void gdata_category_set_term (GDataCategory *self
,const gchar *term
); const gchar * gdata_category_get_scheme (GDataCategory *self
); void gdata_category_set_scheme (GDataCategory *self
,const gchar *scheme
); const gchar * gdata_category_get_label (GDataCategory *self
); void gdata_category_set_label (GDataCategory *self
,const gchar *label
);
"label" gchar* : Read / Write "scheme" gchar* : Read / Write "term" gchar* : Read / Write
#define GDATA_CATEGORY_SCHEMA_LABELS "http://schemas.google.com/g/2005/labels"
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 GDATA_CATEGORY_SCHEMA_LABELS_STARRED
) are service-specific.
Since 0.11.0
#define GDATA_CATEGORY_SCHEMA_LABELS_STARRED GDATA_CATEGORY_SCHEMA_LABELS"#starred"
A term for categories of the GDATA_CATEGORY_SCHEMA_LABELS
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.
Since 0.11.0
typedef struct _GDataCategory GDataCategory;
All the fields in the GDataCategory structure are private and should never be accessed directly.
typedef struct { } GDataCategoryClass;
All the fields in the GDataCategoryClass structure are private and should never be accessed directly.
Since 0.4.0
GDataCategory * gdata_category_new (const gchar *term
,const gchar *scheme
,const gchar *label
);
Creates a new GDataCategory. More information is available in the Atom specification.
|
a category identifier |
|
an IRI to define the categorisation scheme, or NULL . [allow-none]
|
|
a human-readable label for the category, or NULL . [allow-none]
|
Returns : |
a new GDataCategory, or NULL ; unref with g_object_unref()
|
const gchar * gdata_category_get_term (GDataCategory *self
);
Gets the "term" property.
|
a GDataCategory |
Returns : |
the category's term |
Since 0.4.0
void gdata_category_set_term (GDataCategory *self
,const gchar *term
);
Sets the "term" property to term
.
|
a GDataCategory |
|
the new term for the category |
Since 0.4.0
const gchar * gdata_category_get_scheme (GDataCategory *self
);
Gets the "scheme" property.
|
a GDataCategory |
Returns : |
the category's scheme, or NULL
|
Since 0.4.0
void gdata_category_set_scheme (GDataCategory *self
,const gchar *scheme
);
Sets the "scheme" property to scheme
.
Set scheme
to NULL
to unset the property in the category.
|
a GDataCategory |
|
the new scheme for the category, or NULL . [allow-none]
|
Since 0.4.0
const gchar * gdata_category_get_label (GDataCategory *self
);
Gets the "label" property.
|
a GDataCategory |
Returns : |
the category's label, or NULL
|
Since 0.4.0
void gdata_category_set_label (GDataCategory *self
,const gchar *label
);
Sets the "label" property to label
.
Set label
to NULL
to unset the property in the category.
|
a GDataCategory |
|
the new label for the category, or NULL . [allow-none]
|
Since 0.4.0
"label"
property"label" gchar* : Read / Write
A human-readable label for display in end-user applications.
For more information, see the Atom specification.
Default value: NULL
Since 0.4.0
"scheme"
property"scheme" gchar* : Read / Write
An IRI that identifies a categorization scheme.
For more information, see the Atom specification.
Default value: NULL
Since 0.4.0
"term"
property"term" gchar* : Read / Write
Identifies the category to which the entry or feed belongs.
For more information, see the Atom specification.
Default value: NULL
Since 0.4.0