ChildProxyIF

This interface abstracts handling of property sets for elements with children. Imagine elements such as mixers or polyphonic generators. They all have multiple GstPad or some kind of voice objects. Another use case are container elements like GstBin. The element implementing the interface acts as a parent for those child objects.

By implementing this interface the child properties can be accessed from the parent element by using gst_child_proxy_get() and gst_child_proxy_set().

Property names are written as "child-name::property-name". The whole naming scheme is recursive. Thus "child1::child2::property" is valid too, if "child1" and "child2" implement the GstChildProxy interface.

Members

Functions

addOnChildAdded
void addOnChildAdded(void delegate(ObjectG, string, ChildProxyIF) dlg, ConnectFlags connectFlags)

Will be emitted after the object was added to the child_proxy.

addOnChildRemoved
void addOnChildRemoved(void delegate(ObjectG, string, ChildProxyIF) dlg, ConnectFlags connectFlags)

Will be emitted after the object was removed from the child_proxy. See Also GstBin

childAdded
void childAdded(ObjectG child, string name)

Emits the "child-added" signal.

childRemoved
void childRemoved(ObjectG child, string name)

Emits the "child-removed" signal.

getChildByIndex
ObjectG getChildByIndex(uint index)

Fetches a child by its number.

getChildByName
ObjectG getChildByName(string name)

Looks up a child element by the given name. This virtual method has a default implementation that uses GstObject together with gst_object_get_name(). If the interface is to be used with GObjects, this methods needs to be overridden.

getChildProxyTStruct
GstChildProxy* getChildProxyTStruct()
Undocumented in source.
getChildrenCount
uint getChildrenCount()

Gets the number of child objects this parent contains.

getProperty
void getProperty(string name, Value value)

Gets a single property using the GstChildProxy mechanism. You are responsible for freeing it by calling g_value_unset()

getStruct
void* getStruct()

the main Gtk struct as a void*

getValist
void getValist(string firstPropertyName, void* varArgs)

Gets properties of the parent object and its children.

lookup
int lookup(string name, ObjectG target, ParamSpec pspec)

Looks up which object and GParamSpec would be effected by the given name. MT safe.

setProperty
void setProperty(string name, Value value)

Sets a single property using the GstChildProxy mechanism.

setValist
void setValist(string firstPropertyName, void* varArgs)

Sets properties of the parent object and its children.

Properties

onChildAddedListeners
void delegate(ObjectG, string, ChildProxyIF)[] onChildAddedListeners [@property getter]
onChildRemovedListeners
void delegate(ObjectG, string, ChildProxyIF)[] onChildRemovedListeners [@property getter]
Undocumented in source.

Meta