You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tqt3/doc/man/man3/tqmetaobject.3qt

185 lines
6.8 KiB

'\" t
.TH TQMetaObject 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*-
.\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the
.\" license file included in the distribution for a complete license
.\" statement.
.\"
.ad l
.nh
.SH NAME
TQMetaObject \- Meta information about TQt objects
.SH SYNOPSIS
\fC#include <tqmetaobject.h>\fR
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "const char * \fBclassName\fR () const"
.br
.ti -1c
.BI "const char * \fBsuperClassName\fR () const"
.br
.ti -1c
.BI "TQMetaObject * \fBsuperClass\fR () const"
.br
.ti -1c
.BI "bool \fBinherits\fR ( const char * clname ) const"
.br
.ti -1c
.BI "int \fBnumSlots\fR ( bool super = FALSE ) const"
.br
.ti -1c
.BI "int \fBnumSignals\fR ( bool super = FALSE ) const"
.br
.ti -1c
.BI "TQStrList \fBslotNames\fR ( bool super = FALSE ) const"
.br
.ti -1c
.BI "TQStrList \fBsignalNames\fR ( bool super = FALSE ) const"
.br
.ti -1c
.BI "int \fBnumClassInfo\fR ( bool super = FALSE ) const"
.br
.ti -1c
.BI "const QClassInfo * \fBclassInfo\fR ( int index, bool super = FALSE ) const"
.br
.ti -1c
.BI "const char * \fBclassInfo\fR ( const char * name, bool super = FALSE ) const"
.br
.ti -1c
.BI "const TQMetaProperty * \fBproperty\fR ( int index, bool super = FALSE ) const"
.br
.ti -1c
.BI "int \fBfindProperty\fR ( const char * name, bool super = FALSE ) const"
.br
.ti -1c
.BI "TQStrList \fBpropertyNames\fR ( bool super = FALSE ) const"
.br
.ti -1c
.BI "int \fBnumProperties\fR ( bool super = FALSE ) const"
.br
.in -1c
.SH DESCRIPTION
The TQMetaObject class contains meta information about TQt objects.
.PP
The Meta Object System in TQt is responsible for the signals and slots inter-object communication mechanism, runtime type information and the property system. All meta information in TQt is kept in a single instance of TQMetaObject per class.
.PP
This class is not normally required for application programming. But if you write meta applications, such as scripting engines or GUI builders, you might find these functions useful:
.TP
className() to get the name of a class.
.TP
superClassName() to get the name of the superclass.
.TP
inherits(), the function called by TQObject::inherits().
.TP
superClass() to access the superclass's meta object.
.TP
numSlots(), numSignals(), slotNames(), and signalNames() to get information about a class's signals and slots.
.TP
property() and propertyNames() to obtain information about a class's properties.
.PP
Classes may have a list of name-value pairs of class information. The number of pairs is returned by numClassInfo(), and values are returned by classInfo().
.PP
See also tqmoc (Meta Object Compiler) and Object Model.
.PP
.SH MEMBER FUNCTION DOCUMENTATION
.SH "const QClassInfo * TQMetaObject::classInfo ( int index, bool super = FALSE ) const"
Returns the class information with index \fIindex\fR or 0 if no such information exists.
.PP
If \fIsuper\fR is TRUE, inherited class information is included.
.SH "const char * TQMetaObject::classInfo ( const char * name, bool super = FALSE ) const"
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
.PP
Returns the class information with name \fIname\fR or 0 if no such information exists.
.PP
If \fIsuper\fR is TRUE, inherited class information is included.
.SH "const char * TQMetaObject::className () const"
Returns the class name.
.PP
See also TQObject::className() and superClassName().
.SH "int TQMetaObject::findProperty ( const char * name, bool super = FALSE ) const"
Returns the index for the property with name \fIname\fR or -1 if no such property exists.
.PP
If \fIsuper\fR is TRUE, inherited properties are included.
.PP
See also property() and propertyNames().
.SH "bool TQMetaObject::inherits ( const char * clname ) const"
Returns TRUE if this class inherits \fIclname\fR within the meta object inheritance chain; otherwise returns FALSE.
.PP
(A class is considered to inherit itself.)
.SH "int TQMetaObject::numClassInfo ( bool super = FALSE ) const"
Returns the number of items of class information available for this class.
.PP
If \fIsuper\fR is TRUE, inherited class information is included.
.SH "int TQMetaObject::numProperties ( bool super = FALSE ) const"
Returns the number of properties for this class.
.PP
If \fIsuper\fR is TRUE, inherited properties are included.
.PP
See also propertyNames().
.SH "int TQMetaObject::numSignals ( bool super = FALSE ) const"
Returns the number of signals for this class.
.PP
If \fIsuper\fR is TRUE, inherited signals are included.
.PP
See also signalNames().
.SH "int TQMetaObject::numSlots ( bool super = FALSE ) const"
Returns the number of slots for this class.
.PP
If \fIsuper\fR is TRUE, inherited slots are included.
.PP
See also slotNames().
.SH "const TQMetaProperty * TQMetaObject::property ( int index, bool super = FALSE ) const"
Returns the property meta data for the property at index \fIindex\fR or 0 if no such property exists.
.PP
If \fIsuper\fR is TRUE, inherited properties are included.
.PP
See also propertyNames().
.SH "TQStrList TQMetaObject::propertyNames ( bool super = FALSE ) const"
Returns a list with the names of all this class's properties.
.PP
If \fIsuper\fR is TRUE, inherited properties are included.
.PP
See also property().
.SH "TQStrList TQMetaObject::signalNames ( bool super = FALSE ) const"
Returns a list with the names of all this class's signals.
.PP
If \fIsuper\fR is TRUE, inherited signals are included.
.SH "TQStrList TQMetaObject::slotNames ( bool super = FALSE ) const"
Returns a list with the names of all this class's slots.
.PP
If \fIsuper\fR is TRUE, inherited slots are included.
.PP
See also numSlots().
.SH "TQMetaObject * TQMetaObject::superClass () const"
Returns the meta object of the super class or 0 if there is no such object.
.SH "const char * TQMetaObject::superClassName () const"
Returns the class name of the superclass or 0 if there is no superclass in the TQObject hierachy.
.PP
See also className().
.SH "SEE ALSO"
.BR http://doc.trolltech.com/tqmetaobject.html
.BR http://www.trolltech.com/faq/tech.html
.SH COPYRIGHT
Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the
license file included in the distribution for a complete license
statement.
.SH AUTHOR
Generated automatically from the source code.
.SH BUGS
If you find a bug in Qt, please report it as described in
.BR http://doc.trolltech.com/bughowto.html .
Good bug reports help us to help you. Thank you.
.P
The definitive TQt documentation is provided in HTML format; it is
located at $TQTDIR/doc/html and can be read using TQt Assistant or with
a web browser. This man page is provided as a convenience for those
users who prefer man pages, although this format is not officially
supported by Trolltech.
.P
If you find errors in this manual page, please report them to
.BR qt-bugs@trolltech.com .
Please include the name of the manual page (tqmetaobject.3qt) and the Qt
version (3.3.8).