find_track_elements


Description:

public List<TrackElement> find_track_elements (Track? track, TrackType track_type, Type type)

Finds the TrackElement-s controlled by the clip that match the given criteria.

If track is given as null and track_type is given as UNKNOWN, then the search will match all elements in any track, including those with no track, and of any track_type. Otherwise, if track is not null, but track_type is UNKNOWN, then only the track elements in track are searched for. Otherwise, if track_type is not UNKNOWN, but track is null, then only the track elements whose track_type matches track_type are searched for. Otherwise, when both are given, the track elements that match **either** criteria are searched for. Therefore, if you wish to only find elements in a specific track, you should give the track as track, but you should not give the track's track_type as track_type because this would also select elements from other tracks of the same type.

You may also give type to _further_ restrict the search to track elements of the given type.

Parameters:

this

A Clip

track

The track to search in, or null to search in all tracks

track_type

The track-type of the track element to search for, or UNKNOWN to match any track type

type

The type of track element to search for, or g_type_none to match any type

Returns:

A list of all the TrackElement-s controlled by this, in track or of the given track_type, and of the given type.