| gstreamermm
    0.10.11
    | 
An interface for multi child elements. More...


| Public Member Functions | |
| virtual | ~ChildProxy () | 
| GstChildProxy* | gobj () | 
| Provides access to the underlying C GObject. | |
| const GstChildProxy* | gobj () const | 
| Provides access to the underlying C GObject. | |
| guint | get_children_count () const | 
| Gets the number of child objects this parent contains. | |
| Glib::RefPtr< Gst::Object > | get_child (const Glib::ustring& name) | 
| Looks up a child element by the given name. | |
| Glib::RefPtr< const Gst::Object > | get_child (const Glib::ustring& name) const | 
| Looks up a child element by the given name. | |
| Glib::RefPtr< Gst::Object > | get_child (guint index) | 
| Fetches a child by its number. | |
| Glib::RefPtr< const Gst::Object > | get_child (guint index) const | 
| Fetches a child by its number. | |
| Glib::RefPtr< Gst::ChildProxy > | get_proxy_property (const Glib::ustring& name, Glib::ValueBase&value) | 
| Gets a single property using the Gst::ChildProxy mechanism. | |
| Glib::RefPtr< const Gst::ChildProxy > | get_proxy_property (const Glib::ustring& name, Glib::ValueBase&value) const | 
| Gets a single property using the Gst::ChildProxy mechanism. | |
| Glib::RefPtr< Gst::ChildProxy > | set_proxy_property (const Glib::ustring& name, const Glib::ValueBase&value) | 
| Sets a single property using the Gst::ChildProxy mechanism. | |
| void | child_added (const Glib::RefPtr< Gst::Object >& child) | 
| Emits the "child-added" signal. | |
| void | child_removed (const Glib::RefPtr< Gst::Object >& child) | 
| Emits the "child-removed" signal. | |
| Glib::SignalProxy1< void, const Glib::RefPtr < Gst::Object >& > | signal_child_added () | 
| Glib::SignalProxy1< void, const Glib::RefPtr < Gst::Object >& > | signal_child_removed () | 
| virtual Glib::RefPtr< Gst::Object > | get_child_by_index_vfunc (guint index) const | 
| Virtual method to fetch the child. | |
| virtual guint | get_children_count_vfunc () const | 
| Virtual method to get the children count. | |
| Static Public Member Functions | |
| static void | add_interface (GType gtype_implementer) | 
| static GType | get_type () | 
| Get the GType for this class, for use with the underlying GObject type system. | |
| static bool | lookup (const Glib::RefPtr< Gst::Object >& object, const Glib::ustring& name, Glib::RefPtr< Gst::Object >& target, GParamSpec*& pspec) | 
| Looks up which object and ParamSpec would be effected by the given name. | |
| Protected Member Functions | |
| ChildProxy () | |
| You should derive from this class to use it. | |
| virtual void | on_child_added (const Glib::RefPtr< Gst::Object >& object) | 
| This is a default handler for the signal signal_child_added(). | |
| virtual void | on_child_removed (const Glib::RefPtr< Gst::Object >& object) | 
| This is a default handler for the signal signal_child_removed(). | |
| Related Functions | |
| (Note that these are not member functions.) | |
| Glib::RefPtr< Gst::ChildProxy > | wrap (GstChildProxy* object, bool take_copy=false) | 
| A Glib::wrap() method for this object. | |
An interface for multi child elements.
This interface abstracts handling of property sets for child elements. Imagine elements such as mixers or polyphonic generators. They all have multiple Gst::Pad or some kind of voice objects. The element acts as a parent for those child objects. Each child has the same properties.
By implementing this interface the child properties can be accessed from the parent element by using get_proxy_property() and set_proxy_property().
Property names are written as "child-name::property-name". The whole naming scheme is recursive. Thus "child1::child2::property" is valid too, if "child1" also implements the Gst::ChildProxy interface.
| Gst::ChildProxy::ChildProxy | ( | ) |  [protected] | 
You should derive from this class to use it.
| virtual Gst::ChildProxy::~ChildProxy | ( | ) |  [virtual] | 
| static void Gst::ChildProxy::add_interface | ( | GType | gtype_implementer | ) |  [static] | 
| void Gst::ChildProxy::child_added | ( | const Glib::RefPtr< Gst::Object >& | child | ) | 
Emits the "child-added" signal.
| child | The newly added child. | 
| void Gst::ChildProxy::child_removed | ( | const Glib::RefPtr< Gst::Object >& | child | ) | 
Emits the "child-removed" signal.
| child | The newly added child. | 
| Glib::RefPtr<Gst::Object> Gst::ChildProxy::get_child | ( | const Glib::ustring & | name | ) | 
Looks up a child element by the given name.
Implementors can use Gst::Object together with Gst::Object::get_name()
| name | The childs name. | 
0 if not found. Unref after usage.MT safe.
| Glib::RefPtr<const Gst::Object> Gst::ChildProxy::get_child | ( | const Glib::ustring & | name | ) | const | 
Looks up a child element by the given name.
Implementors can use Gst::Object together with Gst::Object::get_name()
| name | The childs name. | 
0 if not found. Unref after usage.MT safe.
| Glib::RefPtr<Gst::Object> Gst::ChildProxy::get_child | ( | guint | index | ) | 
Fetches a child by its number.
| index | The childs position in the child list. | 
0 if not found (index too high). Unref after usage.MT safe.
| Glib::RefPtr<const Gst::Object> Gst::ChildProxy::get_child | ( | guint | index | ) | const | 
Fetches a child by its number.
| index | The childs position in the child list. | 
0 if not found (index too high). Unref after usage.MT safe.
| virtual Glib::RefPtr<Gst::Object> Gst::ChildProxy::get_child_by_index_vfunc | ( | guint | index | ) | const  [virtual] | 
Virtual method to fetch the child.
| guint Gst::ChildProxy::get_children_count | ( | ) | const | 
Gets the number of child objects this parent contains.
MT safe.
| virtual guint Gst::ChildProxy::get_children_count_vfunc | ( | ) | const  [virtual] | 
Virtual method to get the children count.
| Glib::RefPtr<Gst::ChildProxy> Gst::ChildProxy::get_proxy_property | ( | const Glib::ustring & | name, | 
| Glib::ValueBase & | value | ||
| ) | 
Gets a single property using the Gst::ChildProxy mechanism.
| name | The property to get. | 
| value | An empty Glib::ValueBase in which to store the property. | 
| Glib::RefPtr<const Gst::ChildProxy> Gst::ChildProxy::get_proxy_property | ( | const Glib::ustring & | name, | 
| Glib::ValueBase & | value | ||
| ) | const | 
Gets a single property using the Gst::ChildProxy mechanism.
| name | The property to get. | 
| value | An empty Glib::ValueBase in which to store the property. | 
| static GType Gst::ChildProxy::get_type | ( | ) |  [static] | 
Get the GType for this class, for use with the underlying GObject type system.
Reimplemented in Gst::Bin, Gst::PlayBin2, Gst::Pipeline, Gst::UriDecodeBin, Gst::DecodeBin2, Gst::DecodeBin, Gst::PlayBin, and Gst::SubtitleOverlay.
| GstChildProxy* Gst::ChildProxy::gobj | ( | ) |  [inline] | 
Provides access to the underlying C GObject.
Reimplemented from Glib::Interface.
Reimplemented in Gst::Bin, Gst::PlayBin2, Gst::Pipeline, Gst::UriDecodeBin, Gst::DecodeBin2, Gst::DecodeBin, Gst::PlayBin, and Gst::SubtitleOverlay.
| const GstChildProxy* Gst::ChildProxy::gobj | ( | ) | const  [inline] | 
Provides access to the underlying C GObject.
Reimplemented from Glib::Interface.
Reimplemented in Gst::Bin, Gst::PlayBin2, Gst::Pipeline, Gst::UriDecodeBin, Gst::DecodeBin2, Gst::DecodeBin, Gst::PlayBin, and Gst::SubtitleOverlay.
| static bool Gst::ChildProxy::lookup | ( | const Glib::RefPtr< Gst::Object >& | object, | 
| const Glib::ustring & | name, | ||
| Glib::RefPtr< Gst::Object >& | target, | ||
| GParamSpec *& | pspec | ||
| ) |  [static] | 
Looks up which object and ParamSpec would be effected by the given name.
| object | Object to lookup the property in. | 
| name | Name of the property to look up. | 
| target | Pointer to a Gst::Object that takes the real object to set property on. | 
| pspec | Pointer to take the ParamSpec describing the property. | 
true if target and pspec could be found. false otherwise. In that case the values for pspec and target are not modified. Unref target after usage.MT safe.
| virtual void Gst::ChildProxy::on_child_added | ( | const Glib::RefPtr< Gst::Object >& | object | ) |  [protected, virtual] | 
This is a default handler for the signal signal_child_added().
| virtual void Gst::ChildProxy::on_child_removed | ( | const Glib::RefPtr< Gst::Object >& | object | ) |  [protected, virtual] | 
This is a default handler for the signal signal_child_removed().
| Glib::RefPtr<Gst::ChildProxy> Gst::ChildProxy::set_proxy_property | ( | const Glib::ustring & | name, | 
| const Glib::ValueBase & | value | ||
| ) | 
Sets a single property using the Gst::ChildProxy mechanism.
| name | The property to get. | 
| value | The Glib::ValueBase to set the property to (non-empty). | 
| Glib::SignalProxy1< void,const Glib::RefPtr<Gst::Object>& > Gst::ChildProxy::signal_child_added | ( | ) | 
void on_my_child_added(const Glib::RefPtr<Gst::Object>& object)Will be emitted after the object was added to the child_proxy.
| object | The Object that was added. | 
| Glib::SignalProxy1< void,const Glib::RefPtr<Gst::Object>& > Gst::ChildProxy::signal_child_removed | ( | ) | 
void on_my_child_removed(const Glib::RefPtr<Gst::Object>& object)Will be emitted after the object was removed from the child_proxy.
| object | The Object that was removed. | 
| Glib::RefPtr< Gst::ChildProxy > wrap | ( | GstChildProxy * | object, | 
| bool | take_copy = false | ||
| ) |  [related] | 
A Glib::wrap() method for this object.
| object | The C instance. | 
| take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. | 
 1.7.6.1
 1.7.6.1