diff options
Diffstat (limited to 'doc/man/man3/tqnplugin.3qt')
| -rw-r--r-- | doc/man/man3/tqnplugin.3qt | 62 |
1 files changed, 31 insertions, 31 deletions
diff --git a/doc/man/man3/tqnplugin.3qt b/doc/man/man3/tqnplugin.3qt index f2f5c91f9..0c18274f8 100644 --- a/doc/man/man3/tqnplugin.3qt +++ b/doc/man/man3/tqnplugin.3qt @@ -1,5 +1,5 @@ '\" t -.TH QNPlugin 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQNPlugin 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. @@ -7,22 +7,22 @@ .ad l .nh .SH NAME -QNPlugin \- The main factory for plugin objects +TQNPlugin \- The main factory for plugin objects .SH SYNOPSIS This class is part of the \fBQt Netscape Extension\fR. .PP -\fC#include <ntqnp.h>\fR +\fC#include <tqnp.h>\fR .PP .SS "Public Members" .in +1c .ti -1c -.BI "virtual \fB~QNPlugin\fR ()" +.BI "virtual \fB~TQNPlugin\fR ()" .br .ti -1c .BI "void \fBgetVersionInfo\fR ( int & plugin_major, int & plugin_minor, int & browser_major, int & browser_minor )" .br .ti -1c -.BI "virtual QNPInstance * \fBnewInstance\fR () = 0" +.BI "virtual TQNPInstance * \fBnewInstance\fR () = 0" .br .ti -1c .BI "virtual const char * \fBgetMIMEDescription\fR () const = 0" @@ -46,50 +46,50 @@ This class is part of the \fBQt Netscape Extension\fR. .SS "Static Public Members" .in +1c .ti -1c -.BI "QNPlugin * \fBcreate\fR ()" +.BI "TQNPlugin * \fBcreate\fR ()" .br .ti -1c -.BI "QNPlugin * \fBactual\fR ()" +.BI "TQNPlugin * \fBactual\fR ()" .br .in -1c .SS "Protected Members" .in +1c .ti -1c -.BI "\fBQNPlugin\fR ()" +.BI "\fBTQNPlugin\fR ()" .br .in -1c .SH DESCRIPTION This class is defined in the \fBQt Netscape Extension\fR, which can be found in the \fCqt/extensions\fR directory. It is not included in the main TQt API. .PP -The QNPlugin class provides the main factory for plugin objects. +The TQNPlugin class provides the main factory for plugin objects. .PP -This class is the heart of the plugin. One instance of this object is created when the plugin is \fIfirst\fR needed, by calling QNPlugin::create(), which must be implemented in your plugin code to return some derived class of QNPlugin. The one QNPlugin object creates all QNPInstance instances for a web browser running in a single process. +This class is the heart of the plugin. One instance of this object is created when the plugin is \fIfirst\fR needed, by calling TQNPlugin::create(), which must be implemented in your plugin code to return some derived class of TQNPlugin. The one TQNPlugin object creates all TQNPInstance instances for a web browser running in a single process. .PP Additionally, if TQt is linked to the plugin as a dynamic library, only one instance of QApplication will exist \fIacross all plugins that have been made with Qt\fR. So, your plugin should tread lightly on global settings. Do not, for example, use QApplication::setFont() - that will change the font in every widget of every Qt-based plugin currently loaded! .SH MEMBER FUNCTION DOCUMENTATION -.SH "QNPlugin::QNPlugin ()\fC [protected]\fR" -Creates a QNPlugin. This may only be used by the constructor of the class, derived from QNPlugin, that is returned by your plugin's implementation of the QNPlugin::create() function. -.SH "QNPlugin::~QNPlugin ()\fC [virtual]\fR" -Destroys the QNPlugin. This is called by the plugin binding code just before the plugin is about to be unloaded from memory. If newWindow() has been called, a QApplication will still exist at this time, but will be deleted shortly after, just before the plugin is deleted. -.SH "QNPlugin * QNPlugin::actual ()\fC [static]\fR" -Returns the plugin most recently returned by QNPlugin::create(). -.SH "QNPlugin * QNPlugin::create ()\fC [static]\fR" -This function must be implemented by your plugin code. It should return a derived class of QNPlugin. -.SH "void * QNPlugin::getJavaClass ()\fC [virtual]\fR" +.SH "TQNPlugin::TQNPlugin ()\fC [protected]\fR" +Creates a TQNPlugin. This may only be used by the constructor of the class, derived from TQNPlugin, that is returned by your plugin's implementation of the TQNPlugin::create() function. +.SH "TQNPlugin::~TQNPlugin ()\fC [virtual]\fR" +Destroys the TQNPlugin. This is called by the plugin binding code just before the plugin is about to be unloaded from memory. If newWindow() has been called, a QApplication will still exist at this time, but will be deleted shortly after, just before the plugin is deleted. +.SH "TQNPlugin * TQNPlugin::actual ()\fC [static]\fR" +Returns the plugin most recently returned by TQNPlugin::create(). +.SH "TQNPlugin * TQNPlugin::create ()\fC [static]\fR" +This function must be implemented by your plugin code. It should return a derived class of TQNPlugin. +.SH "void * TQNPlugin::getJavaClass ()\fC [virtual]\fR" Override this function to return a reference to the Java class that represents the plugin. The default returns 0, indicating no class. .PP -If you override this class, you must also override QNPlugin::unuseJavaClass(). +If you override this class, you must also override TQNPlugin::unuseJavaClass(). .PP The return value is actually a \fCjref\fR; we use \fCvoid*\fR so as to avoid burdening plugins which do not require Java. .PP -See also getJavaEnv() and QNPInstance::getJavaPeer(). -.SH "void * QNPlugin::getJavaEnv () const" +See also getJavaEnv() and TQNPInstance::getJavaPeer(). +.SH "void * TQNPlugin::getJavaEnv () const" Returns a pointer to the Java execution environment, or 0 if either Java is disabled or an error occurred. .PP The return value is actually a \fCJRIEnv*\fR; we use \fCvoid*\fR so as to avoid burdening plugins which do not require Java. .PP -See also getJavaClass() and QNPInstance::getJavaPeer(). -.SH "const char * QNPlugin::getMIMEDescription () const\fC [pure virtual]\fR" +See also getJavaClass() and TQNPInstance::getJavaPeer(). +.SH "const char * TQNPlugin::getMIMEDescription () const\fC [pure virtual]\fR" Override this function to return the MIME description of the data formats supported by your plugin. The format of this string is shown by the following example: .PP .nf @@ -118,21 +118,21 @@ Override this function to return the MIME description of the data formats suppor .br } .fi -.SH "const char * QNPlugin::getPluginDescriptionString () const\fC [pure virtual]\fR" +.SH "const char * TQNPlugin::getPluginDescriptionString () const\fC [pure virtual]\fR" Returns a pointer to the plain-text description of the plugin. -.SH "const char * QNPlugin::getPluginNameString () const\fC [pure virtual]\fR" +.SH "const char * TQNPlugin::getPluginNameString () const\fC [pure virtual]\fR" Returns a pointer to the plain-text name of the plugin. -.SH "void QNPlugin::getVersionInfo ( int & plugin_major, int & plugin_minor, int & browser_major, int & browser_minor )" +.SH "void TQNPlugin::getVersionInfo ( int & plugin_major, int & plugin_minor, int & browser_major, int & browser_minor )" Populates \fI*\fR\fIplugin_major\fR and \fI*\fR\fIplugin_minor\fR with the version of the plugin API and populates \fI*\fR\fIbrowser_major\fR and \fI*\fR\fIbrowser_minor\fR with the version of the web browser. -.SH "QNPInstance * QNPlugin::newInstance ()\fC [pure virtual]\fR" -Override this function to return an appropriate derived class of QNPInstance. -.SH "void QNPlugin::unuseJavaClass ()\fC [virtual]\fR" +.SH "TQNPInstance * TQNPlugin::newInstance ()\fC [pure virtual]\fR" +Override this function to return an appropriate derived class of TQNPInstance. +.SH "void TQNPlugin::unuseJavaClass ()\fC [virtual]\fR" This function is called when the plugin is shutting down. The function should \fIunuse\fR the Java class returned earlier by getJavaClass(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/qnplugin.html +.BR http://doc.trolltech.com/tqnplugin.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the |