![]() |
![]() |
![]() |
GData Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
#include <gdata/services/picasaweb/gdata-picasaweb-query.h> GDataPicasaWebQuery; GDataPicasaWebQueryClass; GDataPicasaWebQuery * gdata_picasaweb_query_new (const gchar *q); GDataPicasaWebVisibility gdata_picasaweb_query_get_visibility (GDataPicasaWebQuery *self); void gdata_picasaweb_query_set_visibility (GDataPicasaWebQuery *self, GDataPicasaWebVisibility visibility); const gchar * gdata_picasaweb_query_get_thumbnail_size (GDataPicasaWebQuery *self); void gdata_picasaweb_query_set_thumbnail_size (GDataPicasaWebQuery *self, const gchar *thumbnail_size); const gchar * gdata_picasaweb_query_get_image_size (GDataPicasaWebQuery *self); void gdata_picasaweb_query_set_image_size (GDataPicasaWebQuery *self, const gchar *image_size); const gchar * gdata_picasaweb_query_get_tag (GDataPicasaWebQuery *self); void gdata_picasaweb_query_set_tag (GDataPicasaWebQuery *self, const gchar *tag); void gdata_picasaweb_query_get_bounding_box (GDataPicasaWebQuery *self, gdouble *north, gdouble *east, gdouble *south, gdouble *west); void gdata_picasaweb_query_set_bounding_box (GDataPicasaWebQuery *self, gdouble north, gdouble east, gdouble south, gdouble west); const gchar * gdata_picasaweb_query_get_location (GDataPicasaWebQuery *self); void gdata_picasaweb_query_set_location (GDataPicasaWebQuery *self, const gchar *location);
"image-size" gchar* : Read / Write "location" gchar* : Read / Write "tag" gchar* : Read / Write "thumbnail-size" gchar* : Read / Write "visibility" gint : Read / Write
GDataPicasaWebQuery represents a collection of query parameters specific to the Google PicasaWeb service, which go above and beyond those catered for by GDataQuery.
For more information on the custom GData query parameters supported by GDataPicasaWebQuery, see the online documentation.
typedef struct _GDataPicasaWebQuery GDataPicasaWebQuery;
All the fields in the GDataPicasaWebQuery structure are private and should never be accessed directly.
Since 0.4.0
typedef struct { } GDataPicasaWebQueryClass;
All the fields in the GDataPicasaWebQueryClass structure are private and should never be accessed directly.
Since 0.4.0
GDataPicasaWebQuery * gdata_picasaweb_query_new (const gchar *q);
Creates a new GDataPicasaWebQuery with its "q" property set to q
.
Note that when querying for albums with gdata_picasaweb_service_query_all_albums()
, the q
parameter cannot be used.
|
a query string |
Returns : |
a new GDataPicasaWebQuery |
Since 0.4.0
GDataPicasaWebVisibility gdata_picasaweb_query_get_visibility (GDataPicasaWebQuery *self);
Gets the "visibility" property.
|
a GDataPicasaWebQuery |
Returns : |
the visibility of the objects to retrieve, or 0 to retrieve all objects
|
Since 0.4.0
void gdata_picasaweb_query_set_visibility (GDataPicasaWebQuery *self, GDataPicasaWebVisibility visibility);
Sets the "visibility" property to visibility
.
|
a GDataPicasaWebQuery |
|
the visibility of the objects to retrieve, or 0 to retrieve all objects
|
Since 0.4.0
const gchar * gdata_picasaweb_query_get_thumbnail_size (GDataPicasaWebQuery *self);
Gets the "thumbnail-size" property.
|
a GDataPicasaWebQuery |
Returns : |
a comma-separated list of thumbnail sizes to retrieve, or NULL
|
Since 0.4.0
void gdata_picasaweb_query_set_thumbnail_size (GDataPicasaWebQuery *self, const gchar *thumbnail_size);
Sets the "thumbnail-size" property to thumbnail_size
.
Set thumbnail_size
to NULL
to unset the property.
|
a GDataPicasaWebQuery |
|
a comma-separated list of thumbnail sizes to retrieve, or NULL
|
Since 0.4.0
const gchar * gdata_picasaweb_query_get_image_size (GDataPicasaWebQuery *self);
Gets the "image-size" property.
|
a GDataPicasaWebQuery |
Returns : |
a comma-separated list of image sizes to retrieve, or NULL
|
Since 0.4.0
void gdata_picasaweb_query_set_image_size (GDataPicasaWebQuery *self, const gchar *image_size);
Sets the "image-size" property to image_size
.
Set image_size
to NULL
to unset the property.
|
a GDataPicasaWebQuery |
|
a comma-separated list of image sizes to retrieve, or NULL
|
Since 0.4.0
const gchar * gdata_picasaweb_query_get_tag (GDataPicasaWebQuery *self);
Gets the "tag" property.
|
a GDataPicasaWebQuery |
Returns : |
a tag which retrieved objects must have, or NULL
|
Since 0.4.0
void gdata_picasaweb_query_set_tag (GDataPicasaWebQuery *self, const gchar *tag);
Sets the "tag" property to tag
.
Set tag
to NULL
to unset the property.
|
a GDataPicasaWebQuery |
|
a tag which retrieved objects must have, or NULL
|
Since 0.4.0
void gdata_picasaweb_query_get_bounding_box (GDataPicasaWebQuery *self, gdouble *north, gdouble *east, gdouble *south, gdouble *west);
Gets the latitudes and longitudes of a bounding box, inside which all the results must lie.
|
a GDataPicasaWebQuery |
|
return location for the latitude of the top of the box, or NULL
|
|
return location for the longitude of the right of the box, or NULL
|
|
return location for the latitude of the south of the box, or NULL
|
|
return location for the longitude of the left of the box, or NULL
|
Since 0.4.0
void gdata_picasaweb_query_set_bounding_box (GDataPicasaWebQuery *self, gdouble north, gdouble east, gdouble south, gdouble west);
Sets a bounding box, inside which all the returned results must lie.
Set north
, east
, south
and west
to 0
to unset the property.
|
a GDataPicasaWebQuery |
|
latitude of the top of the box |
|
longitude of the right of the box |
|
latitude of the bottom of the box |
|
longitude of the left of the box |
Since 0.4.0
const gchar * gdata_picasaweb_query_get_location (GDataPicasaWebQuery *self);
Gets the "location" property.
|
a GDataPicasaWebQuery |
Returns : |
a location which returned objects must be near, or NULL
|
Since 0.4.0
void gdata_picasaweb_query_set_location (GDataPicasaWebQuery *self, const gchar *location);
Sets the "location" property to location
.
Set location
to NULL
to unset the property.
|
a GDataPicasaWebQuery |
|
a location which returned objects must be near, or NULL
|
Since 0.4.0
"image-size"
property"image-size" gchar* : Read / Write
A comma-separated list of image sizes (width in pixels) to return. Only certain sizes are allowed, and whether the image should be cropped or scaled can be specified; for more information, see the online documentation.
Default value: NULL
Since 0.4.0
"location"
property"location" gchar* : Read / Write
A location to search for photos, e.g. "London".
Default value: NULL
Since 0.4.0
"tag"
property"tag" gchar* : Read / Write
A tag which returned results must contain.
Default value: NULL
Since 0.4.0
"thumbnail-size"
property"thumbnail-size" gchar* : Read / Write
A comma-separated list of thumbnail sizes (width in pixels) to return. Only certain sizes are allowed, and whether the thumbnail should be cropped or scaled can be specified; for more information, see the online documentation.
Default value: NULL
Since 0.4.0
"visibility"
property"visibility" gint : Read / Write
Specifies which albums should be listed, in terms of their visibility ("visibility").
Set the property to 0
to list all albums, regardless of their visibility. Otherwise, use values from GDataPicasaWebVisibility.
For more information, see the online documentation.
Allowed values: [0,2]
Default value: 0
Since 0.4.0