Function
ECalutil_component_find_property_for_locale_filtered
since: 3.52
Declaration [src]
ICalProperty*
e_cal_util_component_find_property_for_locale_filtered (
ICalComponent* icalcomp,
ICalPropertyKind prop_kind,
const gchar* locale,
ECalUtilFilterPropertyFunc func,
gpointer user_data
)
Description [src]
Searches properties of kind prop_kind in the icalcomp, which can
be filtered by the func, and returns one, which is usable for the locale. When locale is NULL, the current locale is assumed. If no such property
for the locale exists either the one with no language parameter or the first
found is returned.
The func is called before checking of the applicability for the locale.
When the func is NULL, all the properties of the prop_kind are considered.
Free the returned non-NULL ICalProperty with g_object_unref(),
when no longer needed.
Available since: 3.52
Parameters
icalcomp-
Type:
NoneAn
ICalComponent.The data is owned by the caller of the function. prop_kind-
Type:
ICalPropertyKindAn
ICalPropertyKindto traverse. locale-
Type:
const gchar*A locale identifier, or
NULL.The argument can be NULL.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. func-
Type:
ECalUtilFilterPropertyFuncAn
ECalUtilFilterPropertyFunc, to determine whether a property can be considered.The argument can be NULL. user_data-
Type:
gpointerUser data for the
func.The argument can be NULL.The data is owned by the caller of the function.
Return value
Type: None
A property of kind prop_kind for the locale,
NULL if no such property is set on the comp.
| The caller of the function takes ownership of the data, and is responsible for freeing it. |
The return value can be NULL. |