object class

Base class for all the KVIrc objects
Inherits
none
Description
This is the base class for all the builtin KVirc object classes. It exports the functions to retrieve the object name, to iterate through children objects and to lookup a child object by name or class. Additionally , this class provides the builtin timer functionality. The $constructor and $destructor functions are empty implementations that all the other classes inherit.
Functions
$constructor()
Constructor for this object class. The default implementation does nothing.
$destructor()
Destructor for this object class. The default implementation emits the signal "destroyed".
$name()
Returns the name of this object.
$parent()
Returns the parent object of this object or 0 if this object has no parent.
$timerEvent(<timerId>)
Handler for the timer events. The default implementation does nothing. See also $startTimer() and $killTimer().
$startTimer(<timeout>)
Starts a builtin timer for this object and returns its timer id as a string or '-1' if the <timeout> was invalid. The $timerEvent() handler function will be called at each <timeout>. The <timeout> is in milliseconds.
$killTimer(<timer id>)
Stops the timer specified by <timer id>.
$killTimers()
Stops all the builtin timers running.
$className()
Returns the class name of this object instance
$findChild(<class>,<name>)
Returns the first child that matches <class> and <name>. If <class> is an empty string, any class matches, if <name> is an empty string, any name matches. This function traverses the entire tree of children but is NOT recursive.
$childCount()
Returns the number of children objects
$emit(<signal_name>[,parameters])
Emits the signal <signal_name> passing the optional [parameters]. See the objects documentation for an overview of signals and slots.
$children()
Returns an array of children object identifiers.
$signalSender()
Returns the current signal sender when in a slot connected to a signal. In other contexts this function returns an empty string. You can safely use it to test if the current function has been triggered directly or from a signal emission.
$signalName()
Returns the name of the signal last signal that has triggered one of this object's slots. This means that in a slot handler it returns the name of the signal that has triggered it.
Signals
destroyed()
Emitted by the default implementation of $destructor. If you reimplement $destructor in one of the derived classes (or as a private implementation), and still want this signal to be emitted you must emit it by yourself, or (better) call the base class destructor.

Index, Object Classes
KVIrc 3.2.0 Documentation
Generated by kris at Wed Oct 25 20:15:27 2006