folks Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy |
#define FOLKS_TYPE_AVATAR_CACHE void folks_avatar_cache_load_avatar (FolksAvatarCache *self
,const gchar *id
,GAsyncReadyCallback _callback_
,gpointer _user_data_
); GLoadableIcon * folks_avatar_cache_load_avatar_finish (FolksAvatarCache *self
,GAsyncResult *_res_
,GError **error
); void folks_avatar_cache_store_avatar (FolksAvatarCache *self
,const gchar *id
,GLoadableIcon *avatar
,GAsyncReadyCallback _callback_
,gpointer _user_data_
); gchar * folks_avatar_cache_store_avatar_finish (FolksAvatarCache *self
,GAsyncResult *_res_
,GError **error
); void folks_avatar_cache_remove_avatar (FolksAvatarCache *self
,const gchar *id
,GAsyncReadyCallback _callback_
,gpointer _user_data_
); void folks_avatar_cache_remove_avatar_finish (FolksAvatarCache *self
,GAsyncResult *_res_
,GError **error
); gchar * folks_avatar_cache_build_uri_for_avatar (FolksAvatarCache *self
,const gchar *id
); FolksAvatarCache * folks_avatar_cache_dup (void
); struct FolksAvatarCache;
#define FOLKS_TYPE_AVATAR_CACHE (folks_avatar_cache_get_type ())
The type for FolksAvatarCache.
void folks_avatar_cache_load_avatar (FolksAvatarCache *self
,const gchar *id
,GAsyncReadyCallback _callback_
,gpointer _user_data_
);
Fetch an avatar from the cache by its globally unique ID.
See also: folks_avatar_cache_load_avatar_finish()
|
the FolksAvatarCache instance |
|
the globally unique ID for the avatar. [in] |
|
callback to call when the request is satisfied. [scope async] |
|
the data to pass to _callback_ function. [closure]
|
Since 0.6.0
GLoadableIcon * folks_avatar_cache_load_avatar_finish (FolksAvatarCache *self
,GAsyncResult *_res_
,GError **error
);
Fetch an avatar from the cache by its globally unique ID.
See also: folks_avatar_cache_load_avatar()
|
the FolksAvatarCache instance |
|
a GAsyncResult |
|
location to store the error occuring, or NULL to ignore |
Returns : |
Avatar from the cache, or `null` if it doesn't exist in the cache |
Since 0.6.0
void folks_avatar_cache_store_avatar (FolksAvatarCache *self
,const gchar *id
,GLoadableIcon *avatar
,GAsyncReadyCallback _callback_
,gpointer _user_data_
);
Store an avatar in the cache, assigning the given globally unique ID to it, which can later be used to load and remove the avatar from the cache. For example, this ID could be the UID of a persona. The URI of the cached avatar file will be returned.
See also: folks_avatar_cache_store_avatar_finish()
|
the FolksAvatarCache instance |
|
the globally unique ID for the avatar. [in] |
|
the avatar data to cache. [in] |
|
callback to call when the request is satisfied. [scope async] |
|
the data to pass to _callback_ function. [closure]
|
Since 0.6.0
gchar * folks_avatar_cache_store_avatar_finish (FolksAvatarCache *self
,GAsyncResult *_res_
,GError **error
);
Store an avatar in the cache, assigning the given globally unique ID to it, which can later be used to load and remove the avatar from the cache. For example, this ID could be the UID of a persona. The URI of the cached avatar file will be returned.
See also: folks_avatar_cache_store_avatar()
|
the FolksAvatarCache instance |
|
a GAsyncResult |
|
location to store the error occuring, or NULL to ignore |
Returns : |
a URI for the file storing the cached avatar |
Since 0.6.0
void folks_avatar_cache_remove_avatar (FolksAvatarCache *self
,const gchar *id
,GAsyncReadyCallback _callback_
,gpointer _user_data_
);
Remove an avatar from the cache, if it exists in the cache. If the avatar exists in the cache but there is a problem in removing it, a GError will be thrown.
See also: folks_avatar_cache_remove_avatar_finish()
|
the FolksAvatarCache instance |
|
the globally unique ID for the avatar. [in] |
|
callback to call when the request is satisfied. [scope async] |
|
the data to pass to _callback_ function. [closure]
|
Since 0.6.0
void folks_avatar_cache_remove_avatar_finish (FolksAvatarCache *self
,GAsyncResult *_res_
,GError **error
);
Remove an avatar from the cache, if it exists in the cache. If the avatar exists in the cache but there is a problem in removing it, a GError will be thrown.
See also: folks_avatar_cache_remove_avatar()
|
the FolksAvatarCache instance |
|
a GAsyncResult |
|
location to store the error occuring, or NULL to ignore |
Since 0.6.0
gchar * folks_avatar_cache_build_uri_for_avatar (FolksAvatarCache *self
,const gchar *id
);
Build the URI of an avatar file in the cache from a globally unique ID. This will always succeed, even if the avatar doesn't exist in the cache.
|
the FolksAvatarCache instance |
|
the globally unique ID for the avatar. [in] |
Returns : |
URI of the avatar file with the given globally unique ID |
Since 0.6.0
FolksAvatarCache * folks_avatar_cache_dup (void
);
Create or return the singleton
class instance. If the instance doesn't exist already, it will be created.
folks_avatar_cache_new()
This function is thread-safe.
Returns : |
Singleton instance |
Since 0.6.0