ECal.util_component_find_property_for_locale_filtered
Description: Reference for ECal.util_component_find_property_for_locale_filtered

### 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: `None`

  An `ICalComponent`.

  The data is owned by the caller of the function.

`prop_kind`

  Type: `ICalPropertyKind`

  An `ICalPropertyKind` to 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: `ECalUtilFilterPropertyFunc`

  An `ECalUtilFilterPropertyFunc`, to determine whether a property can be considered.

  The argument can be `NULL`.

`user_data`

  Type: `gpointer`

  User 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`.