Signed-off-by: Michele Calgaro <michele.calgaro@yahoo.it>pull/161/head
parent
7bc57326e6
commit
8a071b48ef
GPG Key ID:
2A75B7CA8ADED5CF
@ -1,86 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/doc/index.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>The ActiveTQt framework</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>The ActiveTQt framework</h1>
|
||||
|
||||
|
||||
<p> <!-- index ActiveTQt --><a name="ActiveTQt"></a>
|
||||
<p> These modules are part of the <a href="commercialeditions.html">TQt
|
||||
Enterprise Edition</a> and are <em>not</em> part of the Free or
|
||||
Non-Commercial Editions.
|
||||
<p> TQt's ActiveX support allows TQt/Windows developers to:
|
||||
<ol type=1>
|
||||
<li> Access and use ActiveX controls provided by any ActiveX server
|
||||
in their TQt applications.
|
||||
<li> Make their TQt applications available as ActiveX servers, with
|
||||
any number of TQt widgets as ActiveX controls.
|
||||
</ol>
|
||||
<p> <h2> ActiveTQt Modules
|
||||
</h2>
|
||||
<a name="1"></a><p> The framework consists of two modules.
|
||||
<p> <h3> TQAxContainer
|
||||
</h3>
|
||||
<a name="1-1"></a><p> The <a href="qaxcontainer.html">TQAxContainer module</a> is a static
|
||||
library implementing <a href="tqobject.html">TQObject</a> and <a href="tqwidget.html">TQWidget</a> subclasses, <a href="qaxobject.html">TQAxObject</a> and
|
||||
<a href="qaxwidget.html">TQAxWidget</a>, that act as a containers for COM objects and ActiveX
|
||||
controls. If built against a shared TQt library <a href="qaxwidget.html">TQAxWidget</a> integrates
|
||||
as a widget plugin into <a href="designer-manual.html">TQt Designer</a>.
|
||||
<p> The module also provides classes <a href="qaxscript.html">TQAxScript</a>, <a href="qaxscriptmanager.html">TQAxScriptManager</a> and
|
||||
<a href="qaxscriptengine.html">TQAxScriptEngine</a> that allow using Windows Script Host technologies to
|
||||
script COM objects embedded in the TQt applications.
|
||||
<p> <a href="qaxcontainer-examples.html">Examples</a> include a
|
||||
web browser application embedding Microsoft Internet Explorer, and an
|
||||
address book example synchronizing the contents with Microsoft
|
||||
Outlook.
|
||||
<p> <h3> TQAxServer
|
||||
</h3>
|
||||
<a name="1-2"></a><p> The <a href="qaxserver.html">TQAxServer module</a> is a
|
||||
static library that implements functionality for in-process and
|
||||
executable COM servers. This module provides the <a href="qaxaggregated.html">TQAxAggregated</a>,
|
||||
<a href="qaxbindable.html">TQAxBindable</a> and <a href="qaxfactory.html">TQAxFactory</a> classes.
|
||||
<p> <a href="qaxserver-examples.html">Examples</a> include in- and
|
||||
out-of-process servers providing different <a href="tqwidget.html">TQWidget</a> subclasses as
|
||||
ActiveX controls, as well as a <a href="activeqt-dotnet.html">walkthrough</a> how to use those objects in a .NET environment.
|
||||
<p> <h2> Additional Information
|
||||
</h2>
|
||||
<a name="2"></a><p> <ul>
|
||||
<li> <a href="activeqt-tools.html">ActiveTQt Tools</a>.
|
||||
<li> <a href="activeqt-examples.html">ActiveTQt Examples</a>.
|
||||
</ul>
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,459 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/dotnet/dotnet.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>Walkthrough: Using TQt objects in Microsoft .NET</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Walkthrough: Using TQt objects in Microsoft .NET</h1>
|
||||
|
||||
|
||||
|
||||
|
||||
<!-- toc -->
|
||||
<ul>
|
||||
<li><a href="#1"> Introduction
|
||||
</a>
|
||||
<ul>
|
||||
<li><a href="#1-1"> TQt vs .NET
|
||||
</a>
|
||||
</ul>
|
||||
<li><a href="#2"> Walkthrough: .NET interop with MC++ and IJW
|
||||
</a>
|
||||
<li><a href="#3"> Walkthrough: .NET/COM Interop with ActiveTQt
|
||||
</a>
|
||||
<ul>
|
||||
<li><a href="#3-1"> Starting a Project
|
||||
</a>
|
||||
<li><a href="#3-2"> Importing TQt Widgets
|
||||
</a>
|
||||
<li><a href="#3-3"> Using TQt Widgets
|
||||
</a>
|
||||
<li><a href="#3-4"> Handling TQt Signals
|
||||
</a>
|
||||
</ul>
|
||||
<li><a href="#4"> Summary
|
||||
</a>
|
||||
<ul>
|
||||
<li><a href="#4-1"> Limitations
|
||||
</a>
|
||||
<li><a href="#4-2"> Performance Considerations
|
||||
</a>
|
||||
</ul>
|
||||
</ul>
|
||||
<!-- endtoc -->
|
||||
|
||||
<p> <h2> Introduction
|
||||
</h2>
|
||||
<a name="1"></a><p> In the following walkthrough we will show how TQt objects can be used
|
||||
in a .NET environment, and how .NET objects can be used in a TQt
|
||||
environment.
|
||||
<p> <h3> TQt vs .NET
|
||||
</h3>
|
||||
<a name="1-1"></a><p> TQt is a C++ library and is compiled into traditional, native
|
||||
binaries that make full use of the performance provided by the
|
||||
runtime environment.
|
||||
<p> One of the key concepts of .NET is the idea of "intermediate language
|
||||
code" - the source code is compiled into a bytecode format, and at
|
||||
runtime, that bytecode is executed in a virtual machine - the <em>Common Language Runtime</em> (CLR).
|
||||
<p> Another key concept is that of <em>managed code</em>. This is essentially
|
||||
intermediate language code written in such a way that the CLR can take
|
||||
care of the memory management, i.e. the CLR will do automatic garbage
|
||||
collection, so the application code does not need to explicitly free
|
||||
the memory for unused objects.
|
||||
<p> The MS compilers for C# and VB.NET will only produce managed
|
||||
code. Such programs cannot directly call normal, native functions
|
||||
or classes. <a href="#footnote1"><sup>(1)</sup></a><a name="footnote-call1"></a>
|
||||
<p> The MS C++ compiler for .NET on the other hand, can produce both
|
||||
normal and managed code. To write a C++ class that can be compiled
|
||||
into managed code, the developer must flag the class as managed using
|
||||
the <tt>__gc</tt> keyword, and restrict the code to only use the subset of
|
||||
C++ known as "Managed Extensions for C++", or MC++ for short. The
|
||||
advantage is that MC++ code can freely call and use normal C++
|
||||
functions and classes. And it also works the other way around: normal
|
||||
C++ code can call managed functions and use managed classes (e.g. the
|
||||
entire .NET framework class library), including managed functions and
|
||||
classes implemented in C# or VB.NET. This feature of mixing managed
|
||||
and normal C++ code immensely eases the interoperability with .NET,
|
||||
and is by Microsoft referred to as the "It Just Works" (IJW) feature.
|
||||
<p> This document demonstrates two different ways of integrating normal
|
||||
C++ code (that uses TQt) with managed .NET code. First, the manual way
|
||||
is presented, which includes using a thin MC++ wrapper class around
|
||||
the normal TQt/C++ class. Then, the automated way is presented, which
|
||||
utilizes the <a href="activentqt.html#ActiveTQt">ActiveTQt</a> framework as a generic bridge. The advantage of
|
||||
the first method is that it gives the application developer full
|
||||
control, while the second method requires less coding and relieves the
|
||||
developer of dealing with the conversion between managed and normal
|
||||
data objects.
|
||||
<p> The impatient reader, who right away wants to see a <a href="ntqpushbutton.html">TQPushButton</a> and a
|
||||
custom TQt widget (<a href="qaxserver-example-multiple.html">TQAxWidget2</a>) run in a .NET GUI application is referred to the example
|
||||
directory of ActiveTQt. It contains the result of this walkthrough
|
||||
using both C# and VB.NET, created with Visual Studio.NET (not 2003).
|
||||
Load <tt>examples/dotnet/walkthrough/csharp.csproj</tt>,
|
||||
<tt>examples/dotnet/walkthrough/vb.vbproj</tt>
|
||||
<a href="#footnote2"><sup>(2)</sup></a><a name="footnote-call2"></a>
|
||||
or <tt>examples/dotnet/wrapper/wrapper.sln</tt> into the IDE and run
|
||||
the solution.
|
||||
<p> <h2> Walkthrough: .NET interop with MC++ and IJW
|
||||
</h2>
|
||||
<a name="2"></a><p> Normal C++ classes and functions can be used from managed .NET code by
|
||||
providing thin wrapper classes written in MC++. The wrapper class will
|
||||
take care of forwarding the calls to the normal C++ functions or
|
||||
methods, and converting parameter data as necessary. Since the wrapper
|
||||
class is a managed class, it can be used without further ado in any
|
||||
managed .NET application, whether written in C#, VB.NET, MC++ or other
|
||||
managed programming language.
|
||||
<p>
|
||||
|
||||
<pre> // native TQt/C++ class
|
||||
class Worker : public <a href="tqobject.html">TQObject</a>
|
||||
{
|
||||
<a href="metaobjects.html#TQ_OBJECT">TQ_OBJECT</a>
|
||||
TQ_PROPERTY(TQString statusString READ statusString WRITE setStatusString)
|
||||
public:
|
||||
Worker();
|
||||
|
||||
<a href="tqstring.html">TQString</a> statusString() const;
|
||||
|
||||
public slots:
|
||||
void setStatusString(const <a href="tqstring.html">TQString</a> &string);
|
||||
|
||||
signals:
|
||||
void statusStringChanged(const <a href="tqstring.html">TQString</a> &string);
|
||||
|
||||
private:
|
||||
<a href="tqstring.html">TQString</a> status;
|
||||
};
|
||||
</pre>
|
||||
<p> The TQt class has nothing unusual for TQt users, and as even the TQt
|
||||
specialities like <tt>TQ_PROPERTY</tt>, <tt>slots</tt> and <tt>signals</tt> are
|
||||
implemented with straight C++ they don't cause any trouble when
|
||||
compiling this class with any C++ compiler.
|
||||
<p>
|
||||
|
||||
<pre> class Worker;
|
||||
|
||||
// .NET class
|
||||
public __gc class netWorker
|
||||
{
|
||||
public:
|
||||
netWorker();
|
||||
~netWorker();
|
||||
|
||||
__property String *get_StatusString();
|
||||
__property void set_StatusString(String *string);
|
||||
|
||||
__event void statusStringChanged(String *args);
|
||||
|
||||
private:
|
||||
Worker *workerObject;
|
||||
};
|
||||
</pre>
|
||||
<p> The .NET wrapper class uses keywords that are part of MC++ to indicate
|
||||
that the class is managed/garbage collected (<tt>__gc</tt>), and that <tt>StatusString</tt> should be accessible as a property in languages that
|
||||
support this concept (<tt>__property</tt>). We also declare an event
|
||||
function <tt>statusStringChanged(String*)</tt> (<tt>__event</tt>), the
|
||||
equivalent of the respective signal in the TQt class.
|
||||
<p> Before we can start implementing the wrapper class we need a way to
|
||||
convert TQt's datatypes (and potentionally your own) into .NET
|
||||
datatypes, e.g. <a href="tqstring.html">TQString</a> objects need to be converted into objects
|
||||
of type <tt>String*</tt>.
|
||||
<p> When operating on managed objects in normal C++ code, a little extra
|
||||
care must be taken because of the CLR's garbage collection. A normal
|
||||
pointer variable should not <a href="#footnote3"><sup>(3)</sup></a><a name="footnote-call3"></a> be used to refer to a managed
|
||||
object. The reason is that the garbage collection can kick in at any
|
||||
time and move the object to another place on the heap, leaving you
|
||||
with an invalid pointer.
|
||||
<p> However, two methods are provided that solves this problem easily. The
|
||||
first is to use a <em>pinned</em> pointer, i.e. declare the pointer variable
|
||||
with the <tt>__pin</tt> keyword. This guarantees that the object pointed to
|
||||
will not be moved by the garbage collector. It is recommended that
|
||||
this method not be used to keep a references to managed objects for a
|
||||
long time, since it will decrease the efficiency of the garbage
|
||||
collector. The second way is to use the <tt>gcroot</tt> smartpointer
|
||||
template type. This lets you create safe pointers to managed
|
||||
objects. E.g. a variable of type <tt>gcroot<String></tt> will always point
|
||||
to the String object, even if it has been moved by the garbage
|
||||
collector, and it can be used just like a normal pointer.
|
||||
<p>
|
||||
|
||||
<pre> #include <<a href="tqstring-h.html">tqstring.h</a>>
|
||||
|
||||
#using <mscorlib.dll>
|
||||
#include <vcclr.h>
|
||||
|
||||
using namespace System;
|
||||
|
||||
String *TQStringToString(const <a href="tqstring.html">TQString</a> &tqstring)
|
||||
{
|
||||
<a name="x2467"></a> return new String(tqstring.<a href="tqstring.html#ucs2">ucs2</a>());
|
||||
}
|
||||
</pre>
|
||||
<p> <pre> TQString StringToTQString(String *string)
|
||||
{
|
||||
wchar_t __pin *chars = PtrToStringChars(string);
|
||||
return TQString::fromUcs2(chars);
|
||||
}
|
||||
</pre>
|
||||
<p> The convertor functions can then be used in the wrapper class
|
||||
implementation to call the functions in the native C++ class.
|
||||
<p>
|
||||
|
||||
<pre> #include "networker.h"
|
||||
#include "worker.h"
|
||||
#include "tools.h"
|
||||
|
||||
netWorker::netWorker()
|
||||
{
|
||||
workerObject = new Worker();
|
||||
}
|
||||
</pre>
|
||||
<p> <pre> netWorker::~netWorker()
|
||||
{
|
||||
delete workerObject;
|
||||
}
|
||||
</pre>
|
||||
<p> The constructor and destructor simply create and destroy the TQt
|
||||
object wrapped using the C++ operators <tt>new</tt> and <tt>delete</tt>.
|
||||
<p> <pre> String *netWorker::get_StatusString()
|
||||
{
|
||||
return TQStringToString(workerObject->statusString());
|
||||
}
|
||||
</pre>
|
||||
<p> The netWorker class delegates calls from the .NET code to the native
|
||||
code. Although the transition between those two worlds implies a small
|
||||
performance hit for each function call, and for the type conversion,
|
||||
this should be negligible since we are anyway going to run within the
|
||||
CLR.
|
||||
<p> <pre> void netWorker::set_StatusString(String *string)
|
||||
{
|
||||
workerObject->setStatusString(StringToTQString(string));
|
||||
__raise statusStringChanged(string);
|
||||
}
|
||||
</pre>
|
||||
<p> The property setter calls the native TQt class before firing the
|
||||
event using the <tt>__raise</tt> keyword.
|
||||
<p> This wrapper class can now be used in .NET code, e.g. using C++, C#,
|
||||
Visual Basic or any other programming language available for .NET.
|
||||
<p>
|
||||
|
||||
<pre> using System;
|
||||
|
||||
namespace WrapperApp
|
||||
{
|
||||
class App
|
||||
{
|
||||
void Run()
|
||||
{
|
||||
netWorker worker = new netWorker();
|
||||
|
||||
worker.statusStringChanged += new netWorker.__Delegate_statusStringChanged(onStatusStringChanged);
|
||||
|
||||
System.Console.Out.WriteLine(worker.StatusString);
|
||||
|
||||
System.Console.Out.WriteLine("Working cycle begins...");
|
||||
worker.StatusString = "Working";
|
||||
worker.StatusString = "Lunch Break";
|
||||
worker.StatusString = "Working";
|
||||
worker.StatusString = "Idle";
|
||||
System.Console.Out.WriteLine("Working cycle ends...");
|
||||
}
|
||||
|
||||
private void onStatusStringChanged(string str)
|
||||
{
|
||||
System.Console.Out.WriteLine(str);
|
||||
}
|
||||
|
||||
[STAThread]
|
||||
static void Main(string[] args)
|
||||
{
|
||||
App app = new App();
|
||||
app.Run();
|
||||
}
|
||||
}
|
||||
}
|
||||
</pre>
|
||||
<p> <h2> Walkthrough: .NET/COM Interop with ActiveTQt
|
||||
</h2>
|
||||
<a name="3"></a><p> Fortunately .NET provides a generic wrapper for COM objects, the
|
||||
<em>Runtime Callable Wrapper</em> (RCW). This RCW is a proxy for the
|
||||
COM object and is generated by the CLR when a .NET Framework client
|
||||
activates a COM object. This provides a generic way to reuse COM
|
||||
objects in a .NET Framework project.
|
||||
<p> Making a <a href="tqobject.html">TQObject</a> class into a COM object is easily achieved with
|
||||
ActiveTQt and demonstrated in the <a href="qaxserver-examples.html">examples</a>. The walkthrough will use the TQt classes implemented
|
||||
in those examples, so the first thing to do is to make sure that those
|
||||
examples have been built correctly, e.g. by opening the <a href="qaxserver-demo-multiple.html">demonstration pages</a> in Internet
|
||||
Explorer to verify that the controls are functional.
|
||||
<p> <h3> Starting a Project
|
||||
</h3>
|
||||
<a name="3-1"></a><p> Start Visual Studio.NET, and create a new C# project for writing a
|
||||
Windows application. This will present you with an empty form in
|
||||
Visual Studio's dialog editor. You should see the toolbox, which
|
||||
presents you with a number of available controls and objects in
|
||||
different categories. If you right-click on the toolbox it allows
|
||||
you to add new tabs. We will add the tab "TQt".
|
||||
<p> <h3> Importing TQt Widgets
|
||||
</h3>
|
||||
<a name="3-2"></a><p> The category only has a pointer tool by default, and we have to add
|
||||
the TQt objects we want to use in our form. Right-click on the empty
|
||||
space, and select "Customize". This opens a dialog that has two
|
||||
tabs, "COM Components" and ".NET Framework Components". We used
|
||||
ActiveTQt to wrap TQWidgets into COM objects, so we select the "COM
|
||||
Components" page, and look for the classes we want to use, e.g.
|
||||
"TQPushButton" and "TQAxWidget2".
|
||||
<p> When we select those widgets and close the dialog the two widgets
|
||||
will now be available from the toolbox as grey squares with their
|
||||
name next to it <a href="#footnote4"><sup>(4)</sup></a><a name="footnote-call4"></a> .
|
||||
<p> <h3> Using TQt Widgets
|
||||
</h3>
|
||||
<a name="3-3"></a><p> We can now add an instance of TQAxWidget2 and a <a href="ntqpushbutton.html">TQPushButton</a> to
|
||||
the form. Visual Studio will automatically generate the RCW for the
|
||||
object servers. The TQAxWidget2 instance takes most of the upper
|
||||
part of the form, with the TQPushButton in the lower right corner.
|
||||
<p> In the property editor of Visual Studio we can modify the properties
|
||||
of our controls - TQPushButton exposes the <a href="tqwidget.html">TQWidget</a> API and has many
|
||||
properties, while TQAxWidget2 has only the Visual Studio standard
|
||||
properties in addition to its own property "lineWidth" in the
|
||||
"Miscellaneous" category. The objects are named "axTQPushButton1" and
|
||||
"axTQAxWidget21", and since especially the last name is a bit
|
||||
confusing we rename the objects to "resetButton" and "circleWidget".
|
||||
<p> We can also change the TQt properties, e.g. set the "text" property
|
||||
of the <tt>resetButton</tt> to "Reset", and the "lineWidth" property of the
|
||||
<tt>circleWidget</tt> to 5. We can also put those objects into the layout
|
||||
system that Visual Studio's dialog editor provides, e.g. by setting
|
||||
the anchors of the <tt>circleWidget</tt> to "Left, Top, Right, Bottom", and
|
||||
the anchors of the <tt>resetButton</tt> to "Bottom, Right".
|
||||
<p> Now we can compile and start the project, which will open a user
|
||||
interface with our two TQt widgets. If we can resize the dialog,
|
||||
the widgets will resize appropriately.
|
||||
<p> <h3> Handling TQt Signals
|
||||
</h3>
|
||||
<a name="3-4"></a><p> We will now implement event handlers for the widgets. Select the
|
||||
<tt>circleWidget</tt> and select the "Events" page in the property
|
||||
editor. The widget exposes events because the TQAxWidget2 class has
|
||||
the "StockEvents" attribute set in its class definition. We implement
|
||||
the event handler <tt>circleClicked</tt> for the <tt>ClickEvent</tt> to increase
|
||||
the line width by one for every click:
|
||||
<p>
|
||||
|
||||
<pre> private void circleClicked(object sender, System.EventArgs e)
|
||||
{
|
||||
this.circleWidget.lineWidth++;
|
||||
}
|
||||
</pre>
|
||||
<p> In general we can implement a default event handler by double
|
||||
clicking on the widget in the form, but the default events for
|
||||
our widgets are right now not defined.
|
||||
<p> We will also implement an event handler for the <tt>clicked</tt> signal
|
||||
emitted by <a href="ntqpushbutton.html">TQPushButton</a>. Add the event handler <tt>resetLineWidth</tt> to
|
||||
the <tt>clicked</tt> event, and implement the generated function:
|
||||
<p> <pre> private void resetLineWidth(object sender, System.EventArgs e)
|
||||
{
|
||||
this.circleWidget.lineWidth = 1;
|
||||
this.resetButton.setFocus();
|
||||
}
|
||||
</pre>
|
||||
<p> We reset the property to 1, and also call the <tt>setFocus()</tt> slot
|
||||
to simulate the user style on Windows, where a button grabs focus
|
||||
when you click it (so that you can click it again with the spacebar).
|
||||
<p> If we now compile and run the project we can click on the circle
|
||||
widget to increase its line width, and press the reset button to
|
||||
set the line width back to 1.
|
||||
<p> <h2> Summary
|
||||
</h2>
|
||||
<a name="4"></a><p> Using ActiveTQt as a universal interoperability bridge between the
|
||||
.NET world and the native world of TQt is very easy, and makes it
|
||||
often unnecessary to implement a lot of handwritten wrapper classes.
|
||||
Instead, the <a href="qaxfactory.html">TQAxFactory</a> implementation in the otherwise completely
|
||||
cross-platform TQt project provides the glue that .NET needs to to
|
||||
generate the RCW.
|
||||
<p> If this is not sufficient we can implement our own wrapper classes
|
||||
thanks to the C++ extensions provided by Microsoft.
|
||||
<p> <h3> Limitations
|
||||
</h3>
|
||||
<a name="4-1"></a><p> All the limitations when using ActiveTQt are implied when using this
|
||||
technique to interoperate with .NET, e.g. the datatypes we can use
|
||||
in the APIs can only be those supported by ActiveTQt and COM. However,
|
||||
since this includes subclasses of <a href="tqobject.html">TQObject</a> and <a href="tqwidget.html">TQWidget</a> we can wrap
|
||||
any of our datatypes into a TQObject subclass to make its API
|
||||
available to .NET. This has the positive side effect that the same
|
||||
API is automatically available in <a href="http://www.trolltech.com/products/qsa">TQSA</a>, the cross platform
|
||||
scripting solution for TQt applications, and to COM clients in general.
|
||||
<p> When using the "IJW" method, in priciple the only limitation is the
|
||||
time required to write the wrapper classes and data type conversion
|
||||
functions.
|
||||
<p> <h3> Performance Considerations
|
||||
</h3>
|
||||
<a name="4-2"></a><p> Every call from CLR bytecode to native code implies a small
|
||||
performance hit, and necessary type conversions introduce an
|
||||
additional delay with every layer that exists between the two
|
||||
frameworks. Consequently every approach to mix .NET and native
|
||||
code should try to minimize the communication necessary between
|
||||
the different worlds.
|
||||
<p> As ActiveTQt introduces three layers at once - the RCW, COM and finally
|
||||
ActiveTQt itself - the performance penalty when using the generic
|
||||
TQt/ActiveTQt/COM/RCW/.NET bridge is larger than when using a
|
||||
hand-crafted IJW-wrapper class. The execution speed however is still
|
||||
sufficient for connecting to and modifying interactive elements in a
|
||||
user interface, and as soon as the benefit of using TQt and C++ to
|
||||
implement and compile performance critical algorithms into native code
|
||||
kicks in, ActiveTQt becomes a valid choice for making even non-visual
|
||||
parts of your application accessible to .NET.
|
||||
<p>
|
||||
<hr>
|
||||
<ol> <li><a name="footnote1"></a>
|
||||
The .NET framework provides Platform Invocation
|
||||
Services - P/Invoke - that enable managed code to call native C (not
|
||||
C++) functions located in DLLs directly. The resulting application
|
||||
then becomes partially unmanaged. <a href="#footnote-call1">Back...</a> <li><a name="footnote2"></a>
|
||||
|
||||
You will notice that in the generated code the following line is
|
||||
commented out: <pre>
|
||||
' VB is case insensitive, but our C++ controls are not.
|
||||
' Me.resetButton.enabled = True
|
||||
</pre>
|
||||
|
||||
This line is regenerated without comment whenever you change the
|
||||
dialog, in which case you have to comment it out again to be able
|
||||
to run the project. This is a bug in the original version of
|
||||
Visual Studio.NET, and is fixed in the 2003 edition.
|
||||
<a href="#footnote-call2">Back...</a> <li><a name="footnote3"></a>
|
||||
Indeed, the compiler will in
|
||||
many cases disallow it. <a href="#footnote-call3">Back...</a> <li><a name="footnote4"></a>
|
||||
Icons could be added by modifying the
|
||||
way the controls register themselves. <a href="#footnote-call4">Back...</a></ol>
|
||||
</hr><p>See also <a href="qaxserver-examples.html">The TQAxServer Examples</a>.
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,49 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/examples.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>ActiveTQt Examples</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>ActiveTQt Examples</h1>
|
||||
|
||||
|
||||
The following pages list example programs for using ActiveX controls
|
||||
in a TQt application, and for writing ActiveX controls using TQt.
|
||||
<p> <ul>
|
||||
<li> <a href="qaxcontainer-examples.html">TQAxContainer Examples</a>
|
||||
<li> <a href="qaxserver-examples.html">TQAxServer Examples</a>
|
||||
</ul>
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,74 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/tools/dumpdoc/dumpdoc.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>The DumpDoc Tool</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>The DumpDoc Tool</h1>
|
||||
|
||||
|
||||
|
||||
The <tt>dumpcoc</tt> tool generates TQt-style documentation for any
|
||||
COM object and writes it into the file specified.
|
||||
<p> Call <tt>dumpdoc</tt> with the following command line parameters:
|
||||
<p> <center><table cellpadding="4" cellspacing="2" border="0">
|
||||
<tr bgcolor="#a2c511">
|
||||
<th valign="top">Option
|
||||
<th valign="top">Result
|
||||
<tr bgcolor="#f0f0f0">
|
||||
<td valign="top">-o file
|
||||
<td valign="top">Writes output to <em>file</em>
|
||||
<tr bgcolor="#d0d0d0">
|
||||
<td valign="top">object
|
||||
<td valign="top">Generate documentation for <em>object</em>
|
||||
<tr bgcolor="#f0f0f0">
|
||||
<td valign="top">-v
|
||||
<td valign="top">Print version information
|
||||
<tr bgcolor="#d0d0d0">
|
||||
<td valign="top">-h
|
||||
<td valign="top">Print help
|
||||
</table></center>
|
||||
<p> <em>object</em> must be an object installed on the local machine (ie.
|
||||
remote objects are not supported), and can include subobjects
|
||||
accessible through properties, ie.
|
||||
<tt>Outlook.Application/Session/CurrentUser</tt>
|
||||
<p> The generated file will be an HTML file using TQt documentation
|
||||
style.
|
||||
<p> To build the tool you must first build the
|
||||
<a href="qaxcontainer.html">TQAxContainer</a> library.
|
||||
Then run your make tool in <tt>tools/dumpdoc</tt>.
|
||||
<p>See also <a href="activeqt-tools.html">ActiveTQt Tools</a>.
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,75 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/tools/idc/idc.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>The IDC Tool</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>The IDC Tool</h1>
|
||||
|
||||
|
||||
|
||||
The IDC tool is part of the <a href="activentqt.html#ActiveTQt">ActiveTQt</a> build system and makes
|
||||
it possible to turn any TQt binary into a full COM object server
|
||||
with only a few lines of code.
|
||||
<p> IDC understands the following command line parameters:
|
||||
<p> <center><table cellpadding="4" cellspacing="2" border="0">
|
||||
<tr bgcolor="#a2c511">
|
||||
<th valign="top">Option
|
||||
<th valign="top">Result
|
||||
<tr bgcolor="#f0f0f0">
|
||||
<td valign="top">dll -idl idl -version x.y
|
||||
<td valign="top">Writes the IDL of the server <em>dll</em> to the file <em>idl</em>. The
|
||||
type library wll have version x.y.
|
||||
<tr bgcolor="#d0d0d0">
|
||||
<td valign="top">dll -tlb tlb
|
||||
<td valign="top">Replaces the type library in <em>dll</em> with <em>tlb</em>
|
||||
<tr bgcolor="#f0f0f0">
|
||||
<td valign="top">-v
|
||||
<td valign="top">Print version information
|
||||
<tr bgcolor="#d0d0d0">
|
||||
<td valign="top">-regserver dll
|
||||
<td valign="top">Register the COM server <em>dll</em>
|
||||
<tr bgcolor="#f0f0f0">
|
||||
<td valign="top">-unregserver
|
||||
<td valign="top">Unregister the COM server <em>dll</em>
|
||||
</table></center>
|
||||
<p> It is usually never necessary to invoke IDC manually, as the
|
||||
<tt>qmake</tt> build system takes care of adding the required post
|
||||
processing steps to the build process. See the
|
||||
<a href="qaxserver.html#4">ActiveTQt build system</a>
|
||||
documentation for details.
|
||||
<p>See also <a href="activeqt-tools.html">ActiveTQt Tools</a>.
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,70 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/tools/testcon/testcon.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>An ActiveX Test Container</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>An ActiveX Test Container</h1>
|
||||
|
||||
|
||||
|
||||
This application implements a generic test container for ActiveX
|
||||
controls. You can insert ActiveX controls installed on your
|
||||
system, and execute methods and modify properties. The container
|
||||
will log information about events and property changes as well
|
||||
as debug output in the log window.
|
||||
<p> The GUI has been implemented utilizing the TQt Designer integration
|
||||
of the TQAxContainer module. Parts of the code use internals of the TQt
|
||||
<a href="metaobjects.html#meta-object">meta object</a> and <a href="activentqt.html#ActiveTQt">ActiveTQt</a> framework and are not recommended to be used in
|
||||
application code.
|
||||
<p> Use the application to view the slots, signals and porperties
|
||||
available through the <a href="qaxwidget.html">TQAxWidget</a> class when instantiated with a
|
||||
certain ActiveX, and to test ActiveX controls you implement or
|
||||
want to use in your TQt application.
|
||||
<p> The application can load and execute script files in JavaScript,
|
||||
VBScript, Perl and Python to program the controls loaded. Example
|
||||
script files using the TQAxWidget2 class are available in the <tt>scripts</tt>
|
||||
subdirectory.
|
||||
<p> Note that the qmake project of this example includes a resource file
|
||||
<tt>testcon.rc</tt> with a version resource. This is required by some
|
||||
ActiveX controls (ie. Shockwave ActiveX Controls), which might crash
|
||||
or misbehave otherwise if such version information is missing.
|
||||
<p> To build the tool you must first build the
|
||||
<a href="qaxcontainer.html">TQAxContainer</a> library.
|
||||
Then run your make tool in <tt>tools/testcon</tt> and
|
||||
run the resulting <tt>testcon.exe</tt>.
|
||||
<p>See also <a href="activeqt-tools.html">ActiveTQt Tools</a>.
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,49 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/tools/tools.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>ActiveTQt Tools</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>ActiveTQt Tools</h1>
|
||||
|
||||
|
||||
The following page list tool programs for <a href="activentqt.html#ActiveTQt">ActiveTQt</a>.
|
||||
|
||||
<p><table width="100%">
|
||||
<tr bgcolor=#f0f0f0><td><b><a href="activeqt-tools-dumpdoc.html">The DumpDoc Tool</a></b>
|
||||
<tr bgcolor=#f0f0f0><td><b><a href="activeqt-tools-idc.html">The IDC Tool</a></b>
|
||||
<tr bgcolor=#f0f0f0><td><b><a href="activeqt-tools-testcon.html">An ActiveX Test Container</a></b>
|
||||
</table>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,50 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qaxbindable.h:38 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxAggregated Member List</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Complete Member List for TQAxAggregated</h1>
|
||||
|
||||
<p>This is the complete list of member functions for
|
||||
<a href="qaxaggregated.html">TQAxAggregated</a>, including inherited members.
|
||||
|
||||
<ul>
|
||||
<li><a href="qaxaggregated.html#controllingUnknown">controllingUnknown</a>()
|
||||
<li><a href="qaxaggregated.html#object">object</a>()
|
||||
<li><a href="qaxaggregated.html#queryInterface">queryInterface</a>()
|
||||
<li><a href="qaxaggregated.html#widget">widget</a>()
|
||||
</ul>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,155 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/control/qaxbindable.cpp:185 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxAggregated Class</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQAxAggregated Class Reference<br><small>[<a href="qaxserver.html">TQAxServer module</a>]</small></h1>
|
||||
|
||||
<p>The TQAxAggregated class is an abstract base class for implementations of
|
||||
additional COM interfaces.
|
||||
<a href="#details">More...</a>
|
||||
<p>This class is part of the <b>TQt ActiveTQt Extension</b>.
|
||||
<p><tt>#include <<a href="qaxbindable-h.html">qaxbindable.h</a>></tt>
|
||||
<p><a href="qaxaggregated-members.html">List of all member functions.</a>
|
||||
<h2>Public Members</h2>
|
||||
<ul>
|
||||
<li class=fn>virtual long <a href="#queryInterface"><b>queryInterface</b></a> ( const TQUuid & iid, void ** iface ) = 0</li>
|
||||
</ul>
|
||||
<h2>Protected Members</h2>
|
||||
<ul>
|
||||
<li class=fn>IUnknown * <a href="#controllingUnknown"><b>controllingUnknown</b></a> () const</li>
|
||||
<li class=fn>TQWidget * <a href="#widget"><b>widget</b></a> () const</li>
|
||||
<li class=fn>TQObject * <a href="#object"><b>object</b></a> () const</li>
|
||||
</ul>
|
||||
<hr><a name="details"></a><h2>Detailed Description</h2>
|
||||
<p> This class is defined in the <b>TQt <a href="activentqt.html#ActiveTQt">ActiveTQt</a> Extension</b>, which can be found in the <tt>qt/extensions</tt> directory. It is not included in the main TQt API.
|
||||
<p>
|
||||
|
||||
The TQAxAggregated class is an abstract base class for implementations of
|
||||
additional COM interfaces.
|
||||
|
||||
<p>
|
||||
|
||||
<p> Create a subclass of TQAxAggregated and reimplement
|
||||
<a href="#queryInterface">queryInterface</a>() to support additional COM interfaces. Use
|
||||
multiple inheritance from those COM interfaces. Implement the
|
||||
IUnknown interface of those COM interfaces by delegating the calls
|
||||
to QueryInterface(), AddRef() and Release() to the interface
|
||||
provided by <a href="#controllingUnknown">controllingUnknown</a>().
|
||||
<p> Use the <a href="#widget">widget</a>() method if you need to make calls to the <a href="tqwidget.html">TQWidget</a>
|
||||
implementing the ActiveX control. You must not store that pointer
|
||||
in your subclass (unless you use <a href="ntqguardedptr.html">TQGuardedPtr</a>), as the TQWidget can
|
||||
be destroyed by the ActiveTQt framework at any time.
|
||||
|
||||
<hr><h2>Member Function Documentation</h2>
|
||||
<h3 class=fn>IUnknown * <a name="controllingUnknown"></a>TQAxAggregated::controllingUnknown () const<tt> [protected]</tt>
|
||||
</h3>
|
||||
|
||||
<p> Returns the IUnknown interface of the ActiveX control. Implement
|
||||
the IUnknown interface in your TQAxAggregated subclass to delegate
|
||||
calls to QueryInterface(), AddRef() and Release() to the interface
|
||||
provided by this function.
|
||||
<p> <pre>
|
||||
HRESULT AxImpl::QueryInterface( REFIID iid, void **iface )
|
||||
{
|
||||
return controllingUnknown()->QueryInterface( iid, iface );
|
||||
}
|
||||
|
||||
unsigned long AxImpl::AddRef()
|
||||
{
|
||||
return controllingUnknown()->AddRef();
|
||||
}
|
||||
|
||||
unsigned long AxImpl::Release()
|
||||
{
|
||||
return controllingUnknown()->Release();
|
||||
}
|
||||
</pre>
|
||||
|
||||
<p> The TQAXAGG_IUNKNOWN macro expands to the code above, and you can
|
||||
use it in the class declaration of your subclass.
|
||||
|
||||
<h3 class=fn><a href="tqobject.html">TQObject</a> * <a name="object"></a>TQAxAggregated::object () const<tt> [protected]</tt>
|
||||
</h3>
|
||||
|
||||
<p> Returns a pointer to the <a href="tqobject.html">TQObject</a> subclass implementing the COM object.
|
||||
This function might return 0.
|
||||
<p> <b>Warning:</b>
|
||||
You must not store the returned pointer, unless you use a
|
||||
<a href="ntqguardedptr.html">TQGuardedPtr</a>, since the TQObject can be destroyed by <a href="activentqt.html#ActiveTQt">ActiveTQt</a> at any
|
||||
time.
|
||||
|
||||
<h3 class=fn>long <a name="queryInterface"></a>TQAxAggregated::queryInterface ( const <a href="ntquuid.html">TQUuid</a> & iid, void ** iface )<tt> [pure virtual]</tt>
|
||||
</h3>
|
||||
|
||||
<p> Reimplement this pure virtual function to support additional COM
|
||||
interfaces. Set the value of <em>iface</em> to point to this object to
|
||||
support the interface <em>iid</em>. Note that you must cast the <tt>this</tt> pointer to the appropriate superclass.
|
||||
<p> <pre>
|
||||
long AxImpl::queryInterface( const <a href="ntquuid.html">TQUuid</a> &iid, void **iface )
|
||||
{
|
||||
*iface = 0;
|
||||
if ( iid == IID_ISomeCOMInterface )
|
||||
*iface = (ISomeCOMInterface*)this;
|
||||
else
|
||||
return E_NOINTERFACE;
|
||||
|
||||
AddRef();
|
||||
return S_OK;
|
||||
}
|
||||
</pre>
|
||||
|
||||
<p> Return the standard COM results S_OK (interface is supported) or
|
||||
E_NOINTERFACE (requested interface is not supported).
|
||||
<p> <b>Warning:</b>
|
||||
Even though you must implement the IUnknown interface if you
|
||||
implement any COM interface you must not support the IUnknown
|
||||
interface in your <a href="#queryInterface">queryInterface</a>() implementation.
|
||||
|
||||
<h3 class=fn><a href="tqwidget.html">TQWidget</a> * <a name="widget"></a>TQAxAggregated::widget () const<tt> [protected]</tt>
|
||||
</h3>
|
||||
|
||||
<p> Returns a pointer to the <a href="tqwidget.html">TQWidget</a> subclass implementing the ActiveX control.
|
||||
This function might return 0.
|
||||
<p> <b>Warning:</b>
|
||||
You must not store the returned pointer, unless you use a
|
||||
<a href="ntqguardedptr.html">TQGuardedPtr</a>, since the TQWidget can be destroyed by <a href="activentqt.html#ActiveTQt">ActiveTQt</a> at any
|
||||
time.
|
||||
|
||||
<!-- eof -->
|
||||
<hr><p>
|
||||
This file is part of the <a href="index.html">TQt toolkit</a>.
|
||||
Copyright © 1995-2007
|
||||
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,209 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qaxbase.h:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>qaxbase.h Include File</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>qaxbase.h</h1>
|
||||
|
||||
<p>This is the verbatim text of the qaxbase.h include file. It is provided only for illustration; the copyright remains with Trolltech.
|
||||
<hr>
|
||||
<pre>
|
||||
/****************************************************************************
|
||||
** $Id: qt/qaxbase.h 3.3.8 edited Jan 11 14:46 $
|
||||
**
|
||||
** Declaration of the TQAxBase class
|
||||
**
|
||||
** Copyright (C) 2001-2007 Trolltech ASA. All rights reserved.
|
||||
**
|
||||
** This file is part of the Active TQt integration.
|
||||
**
|
||||
** Licensees holding valid TQt Enterprise Edition
|
||||
** licenses for Windows may use this file in accordance with the TQt Commercial
|
||||
** License Agreement provided with the Software.
|
||||
**
|
||||
** This file is not available for use under any other license without
|
||||
** express written permission from the copyright holder.
|
||||
**
|
||||
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
|
||||
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
||||
**
|
||||
** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
|
||||
** information about TQt Commercial License Agreements.
|
||||
**
|
||||
** Contact info@trolltech.com if any conditions of this licensing are
|
||||
** not clear to you.
|
||||
**
|
||||
**********************************************************************/
|
||||
|
||||
#ifndef UNICODE
|
||||
#define UNICODE
|
||||
#endif
|
||||
|
||||
#ifndef TQAXBASE_H
|
||||
#define TQAXBASE_H
|
||||
|
||||
#include <ntqvariant.h>
|
||||
#include <tqobject.h>
|
||||
|
||||
struct IUnknown;
|
||||
struct TQUuid;
|
||||
class TQAxEventSink;
|
||||
class TQAxObject;
|
||||
class TQAxBasePrivate;
|
||||
|
||||
class TQAxBase
|
||||
{
|
||||
#ifdef Q_QDOC
|
||||
#error "The Symbol Q_QDOC is reserved for documentation purposes."
|
||||
TQ_PROPERTY( TQString control READ control WRITE setControl )
|
||||
#endif
|
||||
public:
|
||||
#ifndef Q_QDOC
|
||||
typedef TQMap<TQCString, TQVariant> PropertyBag;
|
||||
#endif
|
||||
|
||||
TQAxBase( IUnknown *iface = 0 );
|
||||
virtual ~TQAxBase();
|
||||
|
||||
TQString control() const;
|
||||
|
||||
long queryInterface( const TQUuid &, void** ) const;
|
||||
|
||||
TQVariant dynamicCall( const TQCString&, const TQVariant &v1 = TQVariant(),
|
||||
const TQVariant &v2 = TQVariant(),
|
||||
const TQVariant &v3 = TQVariant(),
|
||||
const TQVariant &v4 = TQVariant(),
|
||||
const TQVariant &v5 = TQVariant(),
|
||||
const TQVariant &v6 = TQVariant(),
|
||||
const TQVariant &v7 = TQVariant(),
|
||||
const TQVariant &v8 = TQVariant() );
|
||||
TQVariant dynamicCall( const TQCString&, TQValueList<TQVariant> &vars );
|
||||
TQAxObject *querySubObject( const TQCString &name, const TQVariant &v1 = TQVariant(),
|
||||
const TQVariant &v2 = TQVariant(),
|
||||
const TQVariant &v3 = TQVariant(),
|
||||
const TQVariant &v4 = TQVariant(),
|
||||
const TQVariant &v5 = TQVariant(),
|
||||
const TQVariant &v6 = TQVariant(),
|
||||
const TQVariant &v7 = TQVariant(),
|
||||
const TQVariant &v8 = TQVariant() );
|
||||
|
||||
virtual TQMetaObject *metaObject() const;
|
||||
virtual bool tqt_invoke( int, TQUObject* );
|
||||
virtual bool tqt_property( int, int, TQVariant* );
|
||||
virtual bool tqt_emit( int, TQUObject* ) = 0;
|
||||
virtual const char *className() const = 0;
|
||||
virtual TQObject *qObject() = 0;
|
||||
|
||||
PropertyBag propertyBag() const;
|
||||
void setPropertyBag( const PropertyBag& );
|
||||
|
||||
TQString generateDocumentation();
|
||||
|
||||
virtual bool propertyWritable( const char* ) const;
|
||||
virtual void setPropertyWritable( const char*, bool );
|
||||
|
||||
bool isNull() const;
|
||||
|
||||
TQVariant asVariant() const;
|
||||
|
||||
#ifdef Q_QDOC
|
||||
#error "The Symbol Q_QDOC is reserved for documentation purposes."
|
||||
enum PropertyBag {};
|
||||
signals:
|
||||
void signal(const TQString&,int,void*);
|
||||
void propertyChanged(const TQString&);
|
||||
void exception(int,const TQString&,const TQString&,const TQString&);
|
||||
#endif
|
||||
|
||||
public:
|
||||
virtual void clear();
|
||||
bool setControl( const TQString& );
|
||||
|
||||
void disableMetaObject();
|
||||
void disableClassInfo();
|
||||
void disableEventSink();
|
||||
|
||||
protected:
|
||||
virtual bool initialize( IUnknown** ptr );
|
||||
bool initializeRemote(IUnknown** ptr);
|
||||
bool initializeLicensed(IUnknown** ptr);
|
||||
bool initializeActive(IUnknown** ptr);
|
||||
|
||||
private:
|
||||
bool initializeLicensedHelper(void *factory, const TQString &key, IUnknown **ptr);
|
||||
TQAxBasePrivate *d;
|
||||
|
||||
static TQMetaObject *staticMetaObject() { return 0; }
|
||||
virtual TQMetaObject *parentMetaObject() const = 0;
|
||||
bool internalInvoke( const TQCString &name, void *out, TQVariant var[], TQCString &type );
|
||||
|
||||
TQString ctrl;
|
||||
};
|
||||
|
||||
inline TQString TQAxBase::generateDocumentation()
|
||||
{
|
||||
extern TQString qax_generateDocumentation(TQAxBase *, TQAxBasePrivate *);
|
||||
return qax_generateDocumentation(this, d);
|
||||
}
|
||||
|
||||
#ifndef TQT_NO_DATASTREAM
|
||||
inline TQDataStream &operator >>( TQDataStream &s, TQAxBase &c )
|
||||
{
|
||||
TQAxBase::PropertyBag bag;
|
||||
c.qObject()->blockSignals( TRUE );
|
||||
TQString control;
|
||||
s >> control;
|
||||
c.setControl( control );
|
||||
s >> bag;
|
||||
c.setPropertyBag( bag );
|
||||
c.qObject()->blockSignals( FALSE );
|
||||
|
||||
return s;
|
||||
}
|
||||
|
||||
inline TQDataStream &operator <<( TQDataStream &s, const TQAxBase &c )
|
||||
{
|
||||
TQAxBase::PropertyBag bag = c.propertyBag();
|
||||
s << c.control();
|
||||
s << bag;
|
||||
|
||||
return s;
|
||||
}
|
||||
#endif // TQT_NO_DATASTREAM
|
||||
|
||||
#endif // TQAXBASE_H
|
||||
</pre>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,71 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qaxbase.h:45 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxBase Member List</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Complete Member List for TQAxBase</h1>
|
||||
|
||||
<p>This is the complete list of member functions for
|
||||
<a href="qaxbase.html">TQAxBase</a>, including inherited members.
|
||||
|
||||
<ul>
|
||||
<li><a href="qaxbase.html#TQAxBase">TQAxBase</a>()
|
||||
<li><a href="qaxbase.html#~TQAxBase">~TQAxBase</a>()
|
||||
<li><a href="qaxbase.html#asVariant">asVariant</a>()
|
||||
<li><a href="qaxbase.html#clear">clear</a>()
|
||||
<li><a href="qaxbase.html#control">control</a>()
|
||||
<li><a href="qaxbase.html#disableClassInfo">disableClassInfo</a>()
|
||||
<li><a href="qaxbase.html#disableEventSink">disableEventSink</a>()
|
||||
<li><a href="qaxbase.html#disableMetaObject">disableMetaObject</a>()
|
||||
<li><a href="qaxbase.html#dynamicCall">dynamicCall</a>()
|
||||
<li><a href="qaxbase.html#exception">exception</a>()
|
||||
<li><a href="qaxbase.html#generateDocumentation">generateDocumentation</a>()
|
||||
<li><a href="qaxbase.html#initialize">initialize</a>()
|
||||
<li><a href="qaxbase.html#initializeActive">initializeActive</a>()
|
||||
<li><a href="qaxbase.html#initializeLicensed">initializeLicensed</a>()
|
||||
<li><a href="qaxbase.html#initializeRemote">initializeRemote</a>()
|
||||
<li><a href="qaxbase.html#isNull">isNull</a>()
|
||||
<li><a href="qaxbase.html#propertyBag">propertyBag</a>()
|
||||
<li><a href="qaxbase.html#propertyChanged">propertyChanged</a>()
|
||||
<li><a href="qaxbase.html#propertyWritable">propertyWritable</a>()
|
||||
<li><a href="qaxbase.html#queryInterface">queryInterface</a>()
|
||||
<li><a href="qaxbase.html#querySubObject">querySubObject</a>()
|
||||
<li><a href="qaxbase.html#setControl">setControl</a>()
|
||||
<li><a href="qaxbase.html#setPropertyBag">setPropertyBag</a>()
|
||||
<li><a href="qaxbase.html#setPropertyWritable">setPropertyWritable</a>()
|
||||
<li><a href="qaxbase.html#signal">signal</a>()
|
||||
</ul>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,658 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/container/qaxbase.cpp:556 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxBase Class</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQAxBase Class Reference<br><small>[<a href="qaxcontainer.html">TQAxContainer module</a>]</small></h1>
|
||||
|
||||
<p>The TQAxBase class is an abstract class that provides an API
|
||||
to initalize and access a COM object.
|
||||
<a href="#details">More...</a>
|
||||
<p>This class is part of the <b>TQt ActiveTQt Extension</b>.
|
||||
<p><tt>#include <<a href="qaxbase-h.html">qaxbase.h</a>></tt>
|
||||
<p>Inherited by <a href="qaxobject.html">TQAxObject</a> and <a href="qaxwidget.html">TQAxWidget</a>.
|
||||
<p><a href="qaxbase-members.html">List of all member functions.</a>
|
||||
<h2>Public Members</h2>
|
||||
<ul>
|
||||
<li class=fn><a href="#TQAxBase"><b>TQAxBase</b></a> ( IUnknown * iface = 0 )</li>
|
||||
<li class=fn>virtual <a href="#~TQAxBase"><b>~TQAxBase</b></a> ()</li>
|
||||
<li class=fn>TQString <a href="#control"><b>control</b></a> () const</li>
|
||||
<li class=fn>long <a href="#queryInterface"><b>queryInterface</b></a> ( const TQUuid & uuid, void ** iface ) const</li>
|
||||
<li class=fn>TQVariant <a href="#dynamicCall"><b>dynamicCall</b></a> ( const TQCString & function, const TQVariant & var1 = TQVariant ( ), const TQVariant & var2 = TQVariant ( ), const TQVariant & var3 = TQVariant ( ), const TQVariant & var4 = TQVariant ( ), const TQVariant & var5 = TQVariant ( ), const TQVariant & var6 = TQVariant ( ), const TQVariant & var7 = TQVariant ( ), const TQVariant & var8 = TQVariant ( ) )</li>
|
||||
<li class=fn>TQVariant <a href="#dynamicCall-2"><b>dynamicCall</b></a> ( const TQCString & function, TQValueList<TQVariant> & vars )</li>
|
||||
<li class=fn>TQAxObject * <a href="#querySubObject"><b>querySubObject</b></a> ( const TQCString & name, const TQVariant & var1 = TQVariant ( ), const TQVariant & var2 = TQVariant ( ), const TQVariant & var3 = TQVariant ( ), const TQVariant & var4 = TQVariant ( ), const TQVariant & var5 = TQVariant ( ), const TQVariant & var6 = TQVariant ( ), const TQVariant & var7 = TQVariant ( ), const TQVariant & var8 = TQVariant ( ) )</li>
|
||||
<li class=fn>PropertyBag <a href="#propertyBag"><b>propertyBag</b></a> () const</li>
|
||||
<li class=fn>void <a href="#setPropertyBag"><b>setPropertyBag</b></a> ( const PropertyBag & bag )</li>
|
||||
<li class=fn>TQString <a href="#generateDocumentation"><b>generateDocumentation</b></a> ()</li>
|
||||
<li class=fn>virtual bool <a href="#propertyWritable"><b>propertyWritable</b></a> ( const char * prop ) const</li>
|
||||
<li class=fn>virtual void <a href="#setPropertyWritable"><b>setPropertyWritable</b></a> ( const char * prop, bool ok )</li>
|
||||
<li class=fn>bool <a href="#isNull"><b>isNull</b></a> () const</li>
|
||||
<li class=fn>TQVariant <a href="#asVariant"><b>asVariant</b></a> () const</li>
|
||||
<li class=fn>enum <a href="#PropertyBag-enum"><b>PropertyBag</b></a> { }</li>
|
||||
<li class=fn>virtual void <a href="#clear"><b>clear</b></a> ()</li>
|
||||
<li class=fn>bool <a href="#setControl"><b>setControl</b></a> ( const TQString & )</li>
|
||||
<li class=fn>void <a href="#disableMetaObject"><b>disableMetaObject</b></a> ()</li>
|
||||
<li class=fn>void <a href="#disableClassInfo"><b>disableClassInfo</b></a> ()</li>
|
||||
<li class=fn>void <a href="#disableEventSink"><b>disableEventSink</b></a> ()</li>
|
||||
</ul>
|
||||
<h2>Signals</h2>
|
||||
<ul>
|
||||
<li class=fn>void <a href="#signal"><b>signal</b></a> ( const TQString & name, int argc, void * argv )</li>
|
||||
<li class=fn>void <a href="#propertyChanged"><b>propertyChanged</b></a> ( const TQString & name )</li>
|
||||
<li class=fn>void <a href="#exception"><b>exception</b></a> ( int code, const TQString & source, const TQString & desc, const TQString & help )</li>
|
||||
</ul>
|
||||
<h2>Properties</h2>
|
||||
<ul>
|
||||
<li class=fn>TQString <a href="#control-prop"><b>control</b></a> - the name of the COM object wrapped by this TQAxBase object</li>
|
||||
</ul>
|
||||
<h2>Protected Members</h2>
|
||||
<ul>
|
||||
<li class=fn>virtual bool <a href="#initialize"><b>initialize</b></a> ( IUnknown ** ptr )</li>
|
||||
<li class=fn>bool <a href="#initializeRemote"><b>initializeRemote</b></a> ( IUnknown ** ptr )</li>
|
||||
<li class=fn>bool <a href="#initializeLicensed"><b>initializeLicensed</b></a> ( IUnknown ** ptr )</li>
|
||||
<li class=fn>bool <a href="#initializeActive"><b>initializeActive</b></a> ( IUnknown ** ptr )</li>
|
||||
</ul>
|
||||
<hr><a name="details"></a><h2>Detailed Description</h2>
|
||||
<p> This class is defined in the <b>TQt <a href="activentqt.html#ActiveTQt">ActiveTQt</a> Extension</b>, which can be found in the <tt>qt/extensions</tt> directory. It is not included in the main TQt API.
|
||||
<p>
|
||||
|
||||
<p> The TQAxBase class is an abstract class that provides an API
|
||||
to initalize and access a COM object.
|
||||
|
||||
<p>
|
||||
|
||||
<p> TQAxBase is an abstract class that cannot be used directly, and is
|
||||
instantiated through the subclasses <a href="qaxobject.html">TQAxObject</a> and <a href="qaxwidget.html">TQAxWidget</a>. This
|
||||
class provides the API to access the COM object directly
|
||||
through its IUnknown implementation. If the COM object implements
|
||||
the IDispatch interface, the properties and methods of that object
|
||||
become available as TQt properties and slots.
|
||||
<p> <pre>
|
||||
connect( buttonBack, TQ_SIGNAL(clicked()), webBrowser, TQ_SLOT(GoBack()) );
|
||||
</pre>
|
||||
|
||||
<p> Properties exposed by the object's IDispatch implementation can be
|
||||
read and written through the property system provided by the TQt
|
||||
Object Model (both subclasses are TQObjects, so you can use <a href="tqobject.html#setProperty">setProperty()</a> and <a href="tqobject.html#property">property()</a> as with <a href="tqobject.html">TQObject</a>). Properties
|
||||
with multiple parameters are not supported.
|
||||
<p> <pre>
|
||||
activeX->setProperty( "text", "some text" );
|
||||
int value = activeX->property( "value" );
|
||||
</pre>
|
||||
|
||||
<p> Write-functions for properties and other methods exposed by the
|
||||
object's IDispatch implementation can be called directly using
|
||||
<a href="#dynamicCall">dynamicCall</a>(), or indirectly as slots connected to a signal.
|
||||
<p> <pre>
|
||||
webBrowser->dynamicCall( "GoHome()" );
|
||||
</pre>
|
||||
|
||||
<p> Outgoing events supported by the COM object are emitted as
|
||||
standard TQt signals.
|
||||
<p> <pre>
|
||||
connect( webBrowser, TQ_SIGNAL(TitleChanged(const <a href="tqstring.html">TQString</a>&)),
|
||||
this, TQ_SLOT(setCaption(const <a href="tqstring.html">TQString</a>&)) );
|
||||
</pre>
|
||||
|
||||
<p> TQAxBase transparently converts between COM data types and the
|
||||
equivalent TQt data types. Some COM types have no equivalent TQt data structure.
|
||||
<p> Supported COM datatypes are listed in the first column of following table.
|
||||
The second column is the TQt type that can be used with the <a href="tqobject.html">TQObject</a> property
|
||||
functions. The third column is the TQt type that is used in the prototype of
|
||||
generated signals and slots for in-parameters, and the last column is the TQt
|
||||
type that is used in the prototype of signals and slots for out-parameters.
|
||||
<center><table cellpadding="4" cellspacing="2" border="0">
|
||||
<tr bgcolor="#a2c511">
|
||||
<th valign="top">COM type
|
||||
<th valign="top">TQt property
|
||||
<th valign="top">in-parameter
|
||||
<th valign="top">out-parameter
|
||||
<tr bgcolor="#f0f0f0">
|
||||
<td valign="top">VARIANT_BOOL
|
||||
<td valign="top">bool
|
||||
<td valign="top">bool
|
||||
<td valign="top">bool&
|
||||
<tr bgcolor="#d0d0d0">
|
||||
<td valign="top">BSTR
|
||||
<td valign="top">TQString
|
||||
<td valign="top">const <a href="tqstring.html">TQString</a>&
|
||||
<td valign="top">TQString&
|
||||
<tr bgcolor="#f0f0f0">
|
||||
<td valign="top">char, short, int, long
|
||||
<td valign="top">int
|
||||
<td valign="top">int
|
||||
<td valign="top">int&
|
||||
<tr bgcolor="#d0d0d0">
|
||||
<td valign="top">uchar, ushort, uint, ulong
|
||||
<td valign="top">uint
|
||||
<td valign="top">uint
|
||||
<td valign="top">uint&
|
||||
<tr bgcolor="#f0f0f0">
|
||||
<td valign="top">float, double
|
||||
<td valign="top">double
|
||||
<td valign="top">double
|
||||
<td valign="top">double&
|
||||
<tr bgcolor="#d0d0d0">
|
||||
<td valign="top">DATE
|
||||
<td valign="top">TQDateTime
|
||||
<td valign="top">const <a href="ntqdatetime.html">TQDateTime</a>&
|
||||
<td valign="top">TQDateTime&
|
||||
<tr bgcolor="#f0f0f0">
|
||||
<td valign="top">CY
|
||||
<td valign="top">TQ_LLONG
|
||||
<td valign="top">TQ_LLONG
|
||||
<td valign="top">TQ_LLONG&
|
||||
<tr bgcolor="#d0d0d0">
|
||||
<td valign="top">OLE_COLOR
|
||||
<td valign="top">TQColor
|
||||
<td valign="top">const <a href="ntqcolor.html">TQColor</a>&
|
||||
<td valign="top">TQColor&
|
||||
<tr bgcolor="#f0f0f0">
|
||||
<td valign="top">SAFEARRAY(VARIANT)
|
||||
<td valign="top">TQValueList<TQVariant>
|
||||
<td valign="top">const <a href="tqvaluelist.html">TQValueList</a><TQVariant>&
|
||||
<td valign="top">TQValueList<TQVariant>&
|
||||
<tr bgcolor="#d0d0d0">
|
||||
<td valign="top">SAFEARRAY(BYTE)
|
||||
<td valign="top">TQByteArray
|
||||
<td valign="top">const <a href="qbytearray.html">TQByteArray</a>&
|
||||
<td valign="top">TQByteArray&
|
||||
<tr bgcolor="#f0f0f0">
|
||||
<td valign="top">SAFEARRAY(BSTR)
|
||||
<td valign="top">TQStringList
|
||||
<td valign="top">const <a href="tqstringlist.html">TQStringList</a>&
|
||||
<td valign="top">TQStringList&
|
||||
<tr bgcolor="#d0d0d0">
|
||||
<td valign="top">VARIANT
|
||||
<td valign="top">type-dependent
|
||||
<td valign="top">const <a href="ntqvariant.html">TQVariant</a>&
|
||||
<td valign="top">TQVariant&
|
||||
<tr bgcolor="#f0f0f0">
|
||||
<td valign="top">IFontDisp*
|
||||
<td valign="top">TQFont
|
||||
<td valign="top">const <a href="ntqfont.html">TQFont</a>&
|
||||
<td valign="top">TQFont&
|
||||
<tr bgcolor="#d0d0d0">
|
||||
<td valign="top">IPictureDisp*
|
||||
<td valign="top">TQPixmap
|
||||
<td valign="top">const <a href="ntqpixmap.html">TQPixmap</a>&
|
||||
<td valign="top">TQPixmap&
|
||||
<tr bgcolor="#f0f0f0">
|
||||
<td valign="top">IDispatch*
|
||||
<td valign="top">TQAxObject* (read-only)
|
||||
<td valign="top"><a href="#asVariant">TQAxBase::asVariant</a>()
|
||||
<td valign="top">TQAxObject* (return value)
|
||||
<tr bgcolor="#d0d0d0">
|
||||
<td valign="top">IUnknown*
|
||||
<td valign="top">TQAxObject* (read-only)
|
||||
<td valign="top"><a href="#asVariant">TQAxBase::asVariant</a>()
|
||||
<td valign="top">TQAxObject* (return value)
|
||||
<tr bgcolor="#f0f0f0">
|
||||
<td valign="top">SCODE, DECIMAL
|
||||
<td valign="top"><em>unsupported</em>
|
||||
<td valign="top"><em>unsupported</em>
|
||||
<td valign="top"><em>unsupported</em>
|
||||
</table></center>
|
||||
<p> Supported are also enumerations, and typedefs to supported types.
|
||||
<p> To call the methods of a COM interface described by the following IDL
|
||||
<pre>
|
||||
dispinterface IControl
|
||||
{
|
||||
properties:
|
||||
[id(1)] BSTR text;
|
||||
[id(2)] IFontDisp *font;
|
||||
|
||||
methods:
|
||||
[id(6)] void showColumn( [in] int i );
|
||||
[id(3)] bool addColumn( [in] BSTR t );
|
||||
[id(4)] int fillList( [in, out] SAFEARRAY(VARIANT) *list );
|
||||
[id(5)] IDispatch *item( [in] int i );
|
||||
};
|
||||
</pre>
|
||||
|
||||
use the TQAxBase API like this:
|
||||
<pre>
|
||||
<a href="qaxobject.html">TQAxObject</a> object( "<CLSID>" );
|
||||
|
||||
<a href="tqstring.html">TQString</a> text = object.<a href="tqobject.html#property">property</a>( "text" ).toString();
|
||||
object.<a href="tqobject.html#setProperty">setProperty</a>( "font", TQFont( "Times New Roman", 12 ) );
|
||||
|
||||
connect( this, TQ_SIGNAL(clicked(int)), &object, TQ_SLOT(showColumn(int)) );
|
||||
bool ok = object.<a href="#dynamicCall">dynamicCall</a>( "addColumn(const <a href="tqstring.html">TQString</a>&)", "Column 1" ).toBool();
|
||||
|
||||
<a href="tqvaluelist.html">TQValueList</a><TQVariant> varlist;
|
||||
<a href="tqvaluelist.html">TQValueList</a><TQVariant> parameters;
|
||||
parameters << TQVariant( varlist );
|
||||
int n = object.<a href="#dynamicCall">dynamicCall</a>( "fillList(TQValueList<TQVariant>&)", parameters ).toInt();
|
||||
|
||||
<a href="qaxobject.html">TQAxObject</a> *item = object.querySubItem( "item(int)", 5 );
|
||||
</pre>
|
||||
|
||||
<p> Note that the <a href="tqvaluelist.html">TQValueList</a> the object should fill has to be provided as an
|
||||
element in the parameter list of TQVariants.
|
||||
<p> If you need to access properties or pass parameters of unsupported
|
||||
datatypes you must access the COM object directly through its
|
||||
IDispatch implementation or other interfaces. Those interfaces can be
|
||||
retrieved through <a href="#queryInterface">queryInterface</a>().
|
||||
<p> <pre>
|
||||
IUnknown *iface = 0;
|
||||
activeX->queryInterface( IID_IUnknown, (void**)&iface );
|
||||
if ( iface ) {
|
||||
// use the interface
|
||||
iface->Release();
|
||||
}
|
||||
</pre>
|
||||
|
||||
<p> To get the definition of the COM interfaces you will have to use the header
|
||||
files provided with the component you want to use. Some compilers can also
|
||||
import type libraries using the #import compiler directive. See the component
|
||||
documentation to find out which type libraries you have to import, and how to use
|
||||
them.
|
||||
<p> If you need to react to events that pass parameters of unsupported
|
||||
datatypes you can use the generic signal that delivers the event
|
||||
data as provided by the COM event.
|
||||
|
||||
<hr><h2>Member Type Documentation</h2>
|
||||
<h3 class=fn><a name="PropertyBag-enum"></a>TQAxBase::PropertyBag</h3>
|
||||
|
||||
<p> A <a href="tqmap.html">TQMap</a><TQString,TQVariant> that can store properties as name:value pairs.
|
||||
|
||||
<hr><h2>Member Function Documentation</h2>
|
||||
<h3 class=fn><a name="TQAxBase"></a>TQAxBase::TQAxBase ( IUnknown * iface = 0 )
|
||||
</h3>
|
||||
Creates a TQAxBase object that wraps the COM object <em>iface</em>. If <em>iface</em> is 0 (the default), use <a href="#setControl">setControl</a>() to instantiate a COM
|
||||
object.
|
||||
|
||||
<h3 class=fn><a name="~TQAxBase"></a>TQAxBase::~TQAxBase ()<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Shuts down the COM object and destroys the TQAxBase object.
|
||||
<p> <p>See also <a href="#clear">clear</a>().
|
||||
|
||||
<h3 class=fn><a href="ntqvariant.html">TQVariant</a> <a name="asVariant"></a>TQAxBase::asVariant () const
|
||||
</h3>
|
||||
Returns a <a href="ntqvariant.html">TQVariant</a> that wraps the COM object. The variant can
|
||||
then be used as a parameter in e.g. <a href="#dynamicCall">dynamicCall</a>().
|
||||
|
||||
<h3 class=fn>void <a name="clear"></a>TQAxBase::clear ()<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Disconnects and destroys the COM object.
|
||||
<p> If you reimplement this function you must also reimplement the
|
||||
destructor to call <a href="#clear">clear</a>(), and call this implementation at the
|
||||
end of your clear() function.
|
||||
|
||||
<h3 class=fn><a href="tqstring.html">TQString</a> <a name="control"></a>TQAxBase::control () const
|
||||
</h3><p>Returns the name of the COM object wrapped by this TQAxBase object.
|
||||
See the <a href="qaxbase.html#control-prop">"control"</a> property for details.
|
||||
<h3 class=fn>void <a name="disableClassInfo"></a>TQAxBase::disableClassInfo ()
|
||||
</h3>
|
||||
Disables the class info generation for this ActiveX container. If
|
||||
you don't require any class information about the ActiveX control
|
||||
use this function to speed up the <a href="metaobjects.html#meta-object">meta object</a> generation.
|
||||
<p> Note that this function must be called immediately after
|
||||
construction of the object (without passing an object identifier),
|
||||
and before calling <a href="qaxwidget.html">TQAxWidget</a>->setControl().
|
||||
|
||||
<h3 class=fn>void <a name="disableEventSink"></a>TQAxBase::disableEventSink ()
|
||||
</h3>
|
||||
Disables the event sink implementation for this ActiveX container.
|
||||
If you don't intend to listen to the ActiveX control's events use
|
||||
this function to speed up the <a href="metaobjects.html#meta-object">meta object</a> generation.
|
||||
<p> Some ActiveX controls might be unstable when connected to an event
|
||||
sink. To get OLE events you must use standard COM methods to
|
||||
register your own event sink. Use <a href="#queryInterface">queryInterface</a>() to get access
|
||||
to the raw COM object.
|
||||
<p> Note that this function should be called immediately after
|
||||
construction of the object (without passing an object identifier),
|
||||
and before calling <a href="qaxwidget.html">TQAxWidget</a>->setControl().
|
||||
|
||||
<h3 class=fn>void <a name="disableMetaObject"></a>TQAxBase::disableMetaObject ()
|
||||
</h3>
|
||||
Disables the <a href="metaobjects.html#meta-object">meta object</a> generation for this ActiveX container.
|
||||
This also disables the event sink and class info generation. If
|
||||
you don't intend to use the TQt meta object implementation call
|
||||
this function to speed up the meta object generation.
|
||||
<p> Some ActiveX controls might be unstable when used with OLE
|
||||
automation. Use standard COM methods to use those controls through
|
||||
the COM interfaces provided by <a href="#queryInterface">queryInterface</a>().
|
||||
<p> Note that this function must be called immediately after
|
||||
construction of the object (without passing an object identifier),
|
||||
and before calling <a href="qaxwidget.html">TQAxWidget</a>->setControl().
|
||||
|
||||
<h3 class=fn><a href="ntqvariant.html">TQVariant</a> <a name="dynamicCall"></a>TQAxBase::dynamicCall ( const <a href="ntqcstring.html">TQCString</a> & function, const <a href="ntqvariant.html">TQVariant</a> & var1 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var2 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var3 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var4 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var5 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var6 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var7 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var8 = TQVariant ( ) )
|
||||
</h3>
|
||||
Calls the COM object's method <em>function</em>, passing the
|
||||
parameters <em>var1</em>, <em>var1</em>, <em>var2</em>, <em>var3</em>, <em>var4</em>, <em>var5</em>,
|
||||
<em>var6</em>, <em>var7</em> and <em>var8</em>, and returns the value returned by
|
||||
the method, or an invalid <a href="ntqvariant.html">TQVariant</a> if the method does not return
|
||||
a value or when the function call failed.
|
||||
<p> If <em>function</em> is a method of the object the string must be provided
|
||||
as the full prototype, for example as it would be written in a
|
||||
<a href="tqobject.html#connect">TQObject::connect</a>() call.
|
||||
<pre>
|
||||
activeX->dynamicCall( "Navigate(const <a href="tqstring.html">TQString</a>&)", "www.trolltech.com" );
|
||||
</pre>
|
||||
|
||||
<p> Alternatively a function can be called passing the parameters embedded
|
||||
in the string, e.g. above function can also be invoked using
|
||||
<pre>
|
||||
activeX->dynamicCall("Navigate(\"www.trolltech.com\");
|
||||
</pre>
|
||||
|
||||
All parameters are passed as strings; it depends on the control whether
|
||||
they are interpreted correctly, and is slower than using the prototype
|
||||
with correctly typed parameters.
|
||||
<p> If <em>function</em> is a property the string has to be the name of the
|
||||
property. The property setter is called when <em>var1</em> is a valid TQVariant,
|
||||
otherwise the getter is called.
|
||||
<pre>
|
||||
activeX->dynamicCall( "Value", 5 );
|
||||
<a href="tqstring.html">TQString</a> text = activeX->dynamicCall( "Text" ).toString();
|
||||
</pre>
|
||||
|
||||
Note that it is faster to get and set properties using
|
||||
<a href="tqobject.html#property">TQObject::property</a>() and <a href="tqobject.html#setProperty">TQObject::setProperty</a>().
|
||||
<p> It is only possible to call functions through <a href="#dynamicCall">dynamicCall</a>() that
|
||||
have parameters or return values of datatypes supported by
|
||||
<a href="ntqvariant.html">TQVariant</a>. See the TQAxBase class documentation for a list of
|
||||
supported and unsupported datatypes. If you want to call functions
|
||||
that have unsupported datatypes in the parameter list, use
|
||||
<a href="#queryInterface">queryInterface</a>() to retrieve the appropriate COM interface, and
|
||||
use the function directly.
|
||||
<p> <pre>
|
||||
IWebBrowser2 *webBrowser = 0;
|
||||
activeX->queryInterface( IID_IWebBrowser2, (void**)&webBrowser );
|
||||
if ( webBrowser ) {
|
||||
webBrowser->Navigate2( pvarURL );
|
||||
webBrowser->Release();
|
||||
}
|
||||
</pre>
|
||||
|
||||
<p> This is also more efficient.
|
||||
|
||||
<p>Example: <a href="qaxcontainer-example-qutlook.html#x2720">qutlook/centralwidget.cpp</a>.
|
||||
<h3 class=fn><a href="ntqvariant.html">TQVariant</a> <a name="dynamicCall-2"></a>TQAxBase::dynamicCall ( const <a href="ntqcstring.html">TQCString</a> & function, <a href="tqvaluelist.html">TQValueList</a><TQVariant> & vars )
|
||||
</h3>
|
||||
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
<p> Calls the COM object's method <em>function</em>, passing the
|
||||
parameters in <em>vars</em>, and returns the value returned by
|
||||
the method. If the method does not return a value or when
|
||||
the function call failed this function returns an invalid
|
||||
<a href="ntqvariant.html">TQVariant</a> object.
|
||||
<p> The TQVariant objects in <em>vars</em> are updated when the method has
|
||||
out-parameters.
|
||||
|
||||
<h3 class=fn>void <a name="exception"></a>TQAxBase::exception ( int code, const <a href="tqstring.html">TQString</a> & source, const <a href="tqstring.html">TQString</a> & desc, const <a href="tqstring.html">TQString</a> & help )<tt> [signal]</tt>
|
||||
</h3>
|
||||
|
||||
<p> This signal is emitted when the COM object throws an exception while called using the OLE automation
|
||||
interface IDispatch. <em>code</em>, <em>source</em>, <em>desc</em> and <em>help</em> provide information about the exception as
|
||||
provided by the COM server and can be used to provide useful feedback to the end user. <em>help</em> includes
|
||||
the help file, and the help context ID in brackets, e.g. "filename [id]".
|
||||
|
||||
<h3 class=fn><a href="tqstring.html">TQString</a> <a name="generateDocumentation"></a>TQAxBase::generateDocumentation ()
|
||||
</h3>
|
||||
|
||||
<p> Returns a rich text string with documentation for the
|
||||
wrapped COM object. Dump the string to an HTML-file,
|
||||
or use it in e.g. a <a href="tqtextbrowser.html">TQTextBrowser</a> widget.
|
||||
|
||||
<h3 class=fn>bool <a name="initialize"></a>TQAxBase::initialize ( IUnknown ** ptr )<tt> [virtual protected]</tt>
|
||||
</h3>
|
||||
This virtual function is called by <a href="#setControl">setControl</a>() and creates the
|
||||
requested COM object. <em>ptr</em> is set to the object's IUnknown
|
||||
implementation. The function returns TRUE if the object
|
||||
initialization succeeded; otherwise the function returns FALSE.
|
||||
<p> The default implementation interprets the string returned by
|
||||
<a href="#control">control</a>(), and calls <a href="#initializeRemote">initializeRemote</a>(), <a href="#initializeLicensed">initializeLicensed</a>()
|
||||
or <a href="#initializeActive">initializeActive</a>() if the string matches the respective
|
||||
patterns. If no pattern is matched, or if remote or licensed
|
||||
initialization fails, CoCreateInstance is used directly to create
|
||||
the object.
|
||||
<p> See the <a href="#control-prop">control</a> property documentation for details about
|
||||
supported patterns.
|
||||
<p> The interface returned in <em>ptr</em> must be referenced exactly once
|
||||
when this function returns. The interface provided by e.g.
|
||||
CoCreateInstance is already referenced, and there is no need to
|
||||
reference it again.
|
||||
|
||||
<h3 class=fn>bool <a name="initializeActive"></a>TQAxBase::initializeActive ( IUnknown ** ptr )<tt> [protected]</tt>
|
||||
</h3>
|
||||
Returns an active instance running on the current machine, and returns the
|
||||
IUnknown interface to the running object in <em>ptr</em>. This function returns TRUE
|
||||
if successful, otherwise returns FALSE.
|
||||
<p> This function is called by <a href="#initialize">initialize</a>() if the control string contains the
|
||||
substring "}&".
|
||||
<p> <p>See also <a href="#initialize">initialize</a>().
|
||||
|
||||
<h3 class=fn>bool <a name="initializeLicensed"></a>TQAxBase::initializeLicensed ( IUnknown ** ptr )<tt> [protected]</tt>
|
||||
</h3>
|
||||
Creates an instance of a licensed control, and returns the IUnknown interface
|
||||
to the object in <em>ptr</em>. This functions returns TRUE if successful, otherwise
|
||||
returns FALSE.
|
||||
<p> This function is called by <a href="#initialize">initialize</a>() if the control string contains the
|
||||
substring "}:". The license key needs to follow this substring.
|
||||
<p> <p>See also <a href="#initialize">initialize</a>().
|
||||
|
||||
<h3 class=fn>bool <a name="initializeRemote"></a>TQAxBase::initializeRemote ( IUnknown ** ptr )<tt> [protected]</tt>
|
||||
</h3>
|
||||
Creates the instance on a remote server, and returns the IUnknown interface
|
||||
to the object in <em>ptr</em>. This function returns TRUE if successful, otherwise
|
||||
returns FALSE.
|
||||
<p> This function is called by <a href="#initialize">initialize</a>() if the control string contains the
|
||||
substring "/{". The information about the remote machine needs to be provided
|
||||
in front of the substring.
|
||||
<p> <p>See also <a href="#initialize">initialize</a>().
|
||||
|
||||
<h3 class=fn>bool <a name="isNull"></a>TQAxBase::isNull () const
|
||||
</h3>
|
||||
Returns TRUE if there is no COM object loaded by this wrapper;
|
||||
otherwise return FALSE.
|
||||
<p> <p>See also <a href="#control-prop">control</a>.
|
||||
|
||||
<h3 class=fn><a href="qaxbase.html#PropertyBag-enum">PropertyBag</a> <a name="propertyBag"></a>TQAxBase::propertyBag () const
|
||||
</h3>
|
||||
Returns a name:value map of all the properties exposed by the COM
|
||||
object.
|
||||
<p> This is more efficient than getting multiple properties
|
||||
individually if the COM object supports property bags.
|
||||
<p> <b>Warning:</b> It is not guaranteed that the property bag implementation
|
||||
of the COM object returns all properties, or that the properties
|
||||
returned are the same as those available through the IDispatch
|
||||
interface.
|
||||
|
||||
<h3 class=fn>void <a name="propertyChanged"></a>TQAxBase::propertyChanged ( const <a href="tqstring.html">TQString</a> & name )<tt> [signal]</tt>
|
||||
</h3>
|
||||
|
||||
<p> If the COM object supports property notification, this signal gets
|
||||
emitted when the property called <em>name</em> is changed.
|
||||
|
||||
<h3 class=fn>bool <a name="propertyWritable"></a>TQAxBase::propertyWritable ( const char * prop ) const<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Returns TRUE if the property <em>prop</em> is writable; otherwise
|
||||
returns FALSE. By default, all properties are writable.
|
||||
<p> <b>Warning:</b>
|
||||
Depending on the control implementation this setting might be
|
||||
ignored for some properties.
|
||||
<p> <p>See also <a href="#setPropertyWritable">setPropertyWritable</a>() and <a href="#propertyChanged">propertyChanged</a>().
|
||||
|
||||
<h3 class=fn>long <a name="queryInterface"></a>TQAxBase::queryInterface ( const <a href="ntquuid.html">TQUuid</a> & uuid, void ** iface ) const
|
||||
</h3>
|
||||
Requests the interface <em>uuid</em> from the COM object and sets the
|
||||
value of <em>iface</em> to the provided interface, or to 0 if the
|
||||
requested interface could not be provided.
|
||||
<p> Returns the result of the QueryInterface implementation of the COM object.
|
||||
<p> <p>See also <a href="#control-prop">control</a>.
|
||||
|
||||
<h3 class=fn><a href="qaxobject.html">TQAxObject</a> * <a name="querySubObject"></a>TQAxBase::querySubObject ( const <a href="ntqcstring.html">TQCString</a> & name, const <a href="ntqvariant.html">TQVariant</a> & var1 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var2 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var3 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var4 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var5 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var6 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var7 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var8 = TQVariant ( ) )
|
||||
</h3>
|
||||
Returns a pointer to a <a href="qaxobject.html">TQAxObject</a> wrapping the COM object provided
|
||||
by the method or property <em>name</em>, passing passing the parameters
|
||||
<em>var1</em>, <em>var1</em>, <em>var2</em>, <em>var3</em>, <em>var4</em>, <em>var5</em>, <em>var6</em>,
|
||||
<em>var7</em> and <em>var8</em>.
|
||||
<p> If <em>name</em> is provided by a method the string must include the
|
||||
full function prototype.
|
||||
<p> If <em>name</em> is a property the string must be the name of the property,
|
||||
and <em>var1</em>, ... <em>var8</em> are ignored.
|
||||
<p> The returned TQAxObject is a child of this object (which is either of
|
||||
type TQAxObject or <a href="qaxwidget.html">TQAxWidget</a>), and is deleted when this object is
|
||||
deleted. It is however safe to delete the returned object yourself,
|
||||
and you should do so when you iterate over lists of subobjects.
|
||||
<p> COM enabled applications usually have an object model publishing
|
||||
certain elements of the application as dispatch interfaces. Use
|
||||
this method to navigate the hierarchy of the object model, e.g.
|
||||
<p> <pre>
|
||||
<a href="qaxwidget.html">TQAxWidget</a> outlook( "Outlook.Application" );
|
||||
<a href="qaxobject.html">TQAxObject</a> *session = outlook.<a href="#querySubObject">querySubObject</a>( "Session" );
|
||||
if ( session ) {
|
||||
<a href="qaxobject.html">TQAxObject</a> *defFolder = session-><a href="#querySubObject">querySubObject</a>(
|
||||
"GetDefaultFolder(OlDefaultFolders)",
|
||||
"olFolderContacts" );
|
||||
//...
|
||||
}
|
||||
</pre>
|
||||
|
||||
|
||||
<p>Example: <a href="qaxcontainer-example-qutlook.html#x2721">qutlook/centralwidget.cpp</a>.
|
||||
<h3 class=fn>bool <a name="setControl"></a>TQAxBase::setControl ( const <a href="tqstring.html">TQString</a> & )
|
||||
</h3><p>Sets the name of the COM object wrapped by this TQAxBase object.
|
||||
See the <a href="qaxbase.html#control-prop">"control"</a> property for details.
|
||||
<h3 class=fn>void <a name="setPropertyBag"></a>TQAxBase::setPropertyBag ( const <a href="qaxbase.html#PropertyBag-enum">PropertyBag</a> & bag )
|
||||
</h3>
|
||||
Sets the properties of the COM object to the corresponding values
|
||||
in <em>bag</em>.
|
||||
<p> <b>Warning:</b>
|
||||
You should only set property bags that have been returned by the
|
||||
propertyBag function, as it cannot be guaranteed that the property
|
||||
bag implementation of the COM object supports the same properties
|
||||
that are available through the IDispatch interface.
|
||||
<p> <p>See also <a href="#propertyBag">propertyBag</a>().
|
||||
|
||||
<h3 class=fn>void <a name="setPropertyWritable"></a>TQAxBase::setPropertyWritable ( const char * prop, bool ok )<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Sets the property <em>prop</em> to writable if <em>ok</em> is TRUE, otherwise
|
||||
sets <em>prop</em> to be read-only. By default, all properties are
|
||||
writable.
|
||||
<p> <b>Warning:</b>
|
||||
Depending on the control implementation this setting might be
|
||||
ignored for some properties.
|
||||
<p> <p>See also <a href="#propertyWritable">propertyWritable</a>() and <a href="#propertyChanged">propertyChanged</a>().
|
||||
|
||||
<h3 class=fn>void <a name="signal"></a>TQAxBase::signal ( const <a href="tqstring.html">TQString</a> & name, int argc, void * argv )<tt> [signal]</tt>
|
||||
</h3>
|
||||
|
||||
<p> This generic signal gets emitted when the COM object issues the
|
||||
event <em>name</em>. <em>argc</em> is the number of parameters provided by the
|
||||
event (DISPPARAMS.cArgs), and <em>argv</em> is the pointer to the
|
||||
parameter values (DISPPARAMS.rgvarg). Note that the order of parameter
|
||||
values is turned around, ie. the last element of the array is the first
|
||||
parameter in the function.
|
||||
<p> <pre>
|
||||
void Receiver::slot( const <a href="tqstring.html">TQString</a> &name, int argc, void *argv )
|
||||
{
|
||||
VARIANTARG *params = (VARIANTARG*)argv;
|
||||
if ( name.<a href="tqstring.html#startsWith">startsWith</a>( "BeforeNavigate2(" ) ) {
|
||||
IDispatch *pDisp = params[argc-1].pdispVal;
|
||||
VARIANTARG URL = *params[argc-2].pvarVal;
|
||||
VARIANTARG Flags = *params[argc-3].pvarVal;
|
||||
VARIANTARG TargetFrameName = *params[argc-4].pvarVal;
|
||||
VARIANTARG PostData = *params[argc-5].pvarVal;
|
||||
VARIANTARG Headers = *params[argc-6].pvarVal;
|
||||
bool *Cancel = params[argc-7].pboolVal;
|
||||
}
|
||||
}
|
||||
</pre>
|
||||
|
||||
<p> Use this signal if the event has parameters of unsupported data
|
||||
types. Otherwise, connect directly to the signal <em>name</em>.
|
||||
|
||||
<hr><h2>Property Documentation</h2>
|
||||
<h3 class=fn><a href="tqstring.html">TQString</a> <a name="control-prop"></a>control</h3>
|
||||
<p>This property holds the name of the COM object wrapped by this TQAxBase object.
|
||||
<p>Setting this property initilializes the COM object. Any COM object
|
||||
previously set is shut down.
|
||||
<p> The most efficient way to set this property is by using the
|
||||
registered component's UUID, e.g.
|
||||
<pre>
|
||||
ctrl->setControl( "{8E27C92B-1264-101C-8A2F-040224009C02}" );
|
||||
</pre>
|
||||
|
||||
The second fastest way is to use the registered control's class
|
||||
name (with or without version number), e.g.
|
||||
<pre>
|
||||
ctrl->setControl( "MSCal.Calendar" );
|
||||
</pre>
|
||||
|
||||
The slowest, but easiest way to use is to use the control's full
|
||||
name, e.g.
|
||||
<pre>
|
||||
ctrl->setControl( "Calendar Control 9.0" );
|
||||
</pre>
|
||||
|
||||
<p> If the component's UUID is used the following patterns can be used
|
||||
to initialize the control on a remote machine, to initialize a
|
||||
licensed control or to connect to a running object:
|
||||
<ul>
|
||||
<li> To initialize the control on a different machine use the following
|
||||
pattern:
|
||||
<pre>
|
||||
<domain/username>:<password>@server/{8E27C92B-1264-101C-8A2F-040224009C02}
|
||||
</pre>
|
||||
|
||||
<li> To initialize a licensed control use the following pattern:
|
||||
<pre>
|
||||
{8E27C92B-1264-101C-8A2F-040224009C02}:<LicenseKey>
|
||||
</pre>
|
||||
|
||||
<li> To connect to an already running object use the following pattern:
|
||||
<pre>
|
||||
{8E27C92B-1264-101C-8A2F-040224009C02}&
|
||||
</pre>
|
||||
|
||||
</ul>
|
||||
The first two patterns can be combined, e.g. to initialize a licensed
|
||||
control on a remote machine:
|
||||
<pre>
|
||||
ctrl->setControl("DOMAIN/user:password@server/{8E27C92B-1264-101C-8A2F-040224009C02}:LicenseKey");
|
||||
</pre>
|
||||
|
||||
<p> The control's read function always returns the control's UUID, if provided including the license
|
||||
key, and the name of the server, but not including the username, the domain or the password.
|
||||
|
||||
<p>Set this property's value with <a href="#setControl">setControl</a>() and get this property's value with <a href="#control">control</a>().
|
||||
<!-- eof -->
|
||||
<hr><p>
|
||||
This file is part of the <a href="index.html">TQt toolkit</a>.
|
||||
Copyright © 1995-2007
|
||||
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,133 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qaxbindable.h:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>qaxbindable.h Include File</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>qaxbindable.h</h1>
|
||||
|
||||
<p>This is the verbatim text of the qaxbindable.h include file. It is provided only for illustration; the copyright remains with Trolltech.
|
||||
<hr>
|
||||
<pre>
|
||||
/****************************************************************************
|
||||
** $Id: qt/qaxbindable.h 3.3.8 edited Jan 11 14:46 $
|
||||
**
|
||||
** Declaration of the TQAxBindable class
|
||||
**
|
||||
** Copyright (C) 2001-2007 Trolltech ASA. All rights reserved.
|
||||
**
|
||||
** This file is part of the Active TQt integration.
|
||||
**
|
||||
** Licensees holding valid TQt Enterprise Edition
|
||||
** licenses for Windows may use this file in accordance with the TQt Commercial
|
||||
** License Agreement provided with the Software.
|
||||
**
|
||||
** This file is not available for use under any other license without
|
||||
** express written permission from the copyright holder.
|
||||
**
|
||||
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
|
||||
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
||||
**
|
||||
** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
|
||||
** information about TQt Commercial License Agreements.
|
||||
**
|
||||
** Contact info@trolltech.com if any conditions of this licensing are
|
||||
** not clear to you.
|
||||
**
|
||||
**********************************************************************/
|
||||
|
||||
#ifndef TQAXBINDABLE_H
|
||||
#define TQAXBINDABLE_H
|
||||
|
||||
#include <tqwidget.h>
|
||||
#include <private/qcom_p.h>
|
||||
|
||||
struct IAxServerBase;
|
||||
struct IUnknown;
|
||||
|
||||
class TQAxAggregated
|
||||
{
|
||||
friend class TQAxServerBase;
|
||||
public:
|
||||
virtual long queryInterface( const TQUuid &iid, void **iface ) = 0;
|
||||
|
||||
protected:
|
||||
virtual ~TQAxAggregated();
|
||||
|
||||
IUnknown *controllingUnknown() const
|
||||
{ return controlling_unknown; }
|
||||
TQWidget *widget() const
|
||||
{
|
||||
if ( the_object && the_object->isWidgetType() )
|
||||
return (TQWidget*)the_object;
|
||||
return 0;
|
||||
}
|
||||
TQObject *object() const { return the_object; }
|
||||
|
||||
private:
|
||||
IUnknown *controlling_unknown;
|
||||
TQObject *the_object;
|
||||
};
|
||||
|
||||
#define TQAXAGG_IUNKNOWN \
|
||||
HRESULT WINAPI QueryInterface( REFIID iid, LPVOID *iface ) { \
|
||||
return controllingUnknown()->QueryInterface( iid, iface ); } \
|
||||
ULONG WINAPI AddRef() {return controllingUnknown()->AddRef(); } \
|
||||
ULONG WINAPI Release() {return controllingUnknown()->Release(); } \
|
||||
|
||||
|
||||
class TQAxBindable
|
||||
{
|
||||
friend class TQAxServerBase;
|
||||
public:
|
||||
TQAxBindable();
|
||||
virtual ~TQAxBindable();
|
||||
|
||||
virtual TQAxAggregated *createAggregate();
|
||||
static void reportError( int code, const TQString &src, const TQString &desc, const TQString &help = TQString::null );
|
||||
|
||||
protected:
|
||||
bool requestPropertyChange( const char *property );
|
||||
void propertyChanged( const char *property );
|
||||
|
||||
IUnknown *clientSite() const;
|
||||
|
||||
private:
|
||||
IAxServerBase *activex;
|
||||
};
|
||||
|
||||
#endif // TQAXBINDABLE_H
|
||||
</pre>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,53 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qaxbindable.h:69 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxBindable Member List</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Complete Member List for TQAxBindable</h1>
|
||||
|
||||
<p>This is the complete list of member functions for
|
||||
<a href="qaxbindable.html">TQAxBindable</a>, including inherited members.
|
||||
|
||||
<ul>
|
||||
<li><a href="qaxbindable.html#TQAxBindable">TQAxBindable</a>()
|
||||
<li><a href="qaxbindable.html#~TQAxBindable">~TQAxBindable</a>()
|
||||
<li><a href="qaxbindable.html#clientSite">clientSite</a>()
|
||||
<li><a href="qaxbindable.html#createAggregate">createAggregate</a>()
|
||||
<li><a href="qaxbindable.html#propertyChanged">propertyChanged</a>()
|
||||
<li><a href="qaxbindable.html#reportError">reportError</a>()
|
||||
<li><a href="qaxbindable.html#requestPropertyChange">requestPropertyChange</a>()
|
||||
</ul>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,169 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/control/qaxbindable.cpp:36 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxBindable Class</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQAxBindable Class Reference<br><small>[<a href="qaxserver.html">TQAxServer module</a>]</small></h1>
|
||||
|
||||
<p>The TQAxBindable class provides an interface between a
|
||||
TQWidget and an ActiveX client.
|
||||
<a href="#details">More...</a>
|
||||
<p>This class is part of the <b>TQt ActiveTQt Extension</b>.
|
||||
<p><tt>#include <<a href="qaxbindable-h.html">qaxbindable.h</a>></tt>
|
||||
<p><a href="qaxbindable-members.html">List of all member functions.</a>
|
||||
<h2>Public Members</h2>
|
||||
<ul>
|
||||
<li class=fn><a href="#TQAxBindable"><b>TQAxBindable</b></a> ()</li>
|
||||
<li class=fn>virtual <a href="#~TQAxBindable"><b>~TQAxBindable</b></a> ()</li>
|
||||
<li class=fn>virtual TQAxAggregated * <a href="#createAggregate"><b>createAggregate</b></a> ()</li>
|
||||
</ul>
|
||||
<h2>Static Public Members</h2>
|
||||
<ul>
|
||||
<li class=fn>void <a href="#reportError"><b>reportError</b></a> ( int code, const TQString & src, const TQString & desc, const TQString & context = TQString::null )</li>
|
||||
</ul>
|
||||
<h2>Protected Members</h2>
|
||||
<ul>
|
||||
<li class=fn>bool <a href="#requestPropertyChange"><b>requestPropertyChange</b></a> ( const char * property )</li>
|
||||
<li class=fn>void <a href="#propertyChanged"><b>propertyChanged</b></a> ( const char * property )</li>
|
||||
<li class=fn>IUnknown * <a href="#clientSite"><b>clientSite</b></a> () const</li>
|
||||
</ul>
|
||||
<hr><a name="details"></a><h2>Detailed Description</h2>
|
||||
<p> This class is defined in the <b>TQt <a href="activentqt.html#ActiveTQt">ActiveTQt</a> Extension</b>, which can be found in the <tt>qt/extensions</tt> directory. It is not included in the main TQt API.
|
||||
<p>
|
||||
|
||||
The TQAxBindable class provides an interface between a
|
||||
<a href="tqwidget.html">TQWidget</a> and an ActiveX client.
|
||||
|
||||
<p>
|
||||
|
||||
<p> The functions provided by this class allow an ActiveX control to
|
||||
communicate property changes to a client application. Inherit
|
||||
your control class from both TQWidget (directly or indirectly) and
|
||||
this class to get access to this class's functions. The <a href="moc.html">meta object compiler</a> requires you to inherit from
|
||||
TQWidget <em>first</em>.
|
||||
<p> <pre>
|
||||
class MyActiveX : public <a href="tqwidget.html">TQWidget</a>, public TQAxBindable
|
||||
{
|
||||
<a href="metaobjects.html#TQ_OBJECT">TQ_OBJECT</a>
|
||||
TQ_PROPERTY( int value READ value WRITE setValue )
|
||||
public:
|
||||
MyActiveX( <a href="tqwidget.html">TQWidget</a> *parent = 0, const char *name = 0 );
|
||||
...
|
||||
|
||||
int value() const;
|
||||
void setValue( int );
|
||||
};
|
||||
</pre>
|
||||
|
||||
<p> When implementing the property write function, use
|
||||
<a href="#requestPropertyChange">requestPropertyChange</a>() to get permission from the ActiveX client
|
||||
application to change this property. When the property changes,
|
||||
call <a href="#propertyChanged">propertyChanged</a>() to notify the ActiveX client application
|
||||
about the change. If a fatal error occurs in the control, use the
|
||||
static <a href="#reportError">reportError</a>() function to notify the client.
|
||||
<p> Use the interface returned by <a href="#clientSite">clientSite</a>() to call the ActiveX
|
||||
client. To implement additional COM interfaces in your ActiveX
|
||||
control, reimplement <a href="#createAggregate">createAggregate</a>() to return a new object of a
|
||||
<a href="qaxaggregated.html">TQAxAggregated</a> subclass.
|
||||
|
||||
<hr><h2>Member Function Documentation</h2>
|
||||
<h3 class=fn><a name="TQAxBindable"></a>TQAxBindable::TQAxBindable ()
|
||||
</h3>
|
||||
Constructs an empty TQAxBindable object.
|
||||
|
||||
<h3 class=fn><a name="~TQAxBindable"></a>TQAxBindable::~TQAxBindable ()<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Destroys the TQAxBindable object.
|
||||
|
||||
<h3 class=fn>IUnknown * <a name="clientSite"></a>TQAxBindable::clientSite () const<tt> [protected]</tt>
|
||||
</h3>
|
||||
Returns a pointer to the client site interface for this ActiveX object,
|
||||
or null if no client site has been set.
|
||||
<p> Call QueryInterface() on the returned interface to get the interface you
|
||||
want to call.
|
||||
|
||||
<h3 class=fn><a href="qaxaggregated.html">TQAxAggregated</a> * <a name="createAggregate"></a>TQAxBindable::createAggregate ()<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Reimplement this function when you want to implement additional
|
||||
COM interfaces in the ActiveX control, or when you want to provide
|
||||
alternative implementations of COM interfaces. Return a new object
|
||||
of a <a href="qaxaggregated.html">TQAxAggregated</a> subclass.
|
||||
<p> The default implementation returns the null pointer.
|
||||
|
||||
<h3 class=fn>void <a name="propertyChanged"></a>TQAxBindable::propertyChanged ( const char * property )<tt> [protected]</tt>
|
||||
</h3>
|
||||
Call this function to notify the client that is hosting this
|
||||
ActiveX control that the property <em>property</em> has been changed.
|
||||
<p> This function is usually called at the end of the property's write
|
||||
function.
|
||||
<p> <p>See also <a href="#requestPropertyChange">requestPropertyChange</a>().
|
||||
|
||||
<h3 class=fn>void <a name="reportError"></a>TQAxBindable::reportError ( int code, const <a href="tqstring.html">TQString</a> & src, const <a href="tqstring.html">TQString</a> & desc, const <a href="tqstring.html">TQString</a> & context = TQString::null )<tt> [static]</tt>
|
||||
</h3>
|
||||
|
||||
<p> Reports an error to the client application. <em>code</em> is a
|
||||
control-defined error code. <em>desc</em> is a human-readable description
|
||||
of the error intended for the application user. <em>src</em> is the name
|
||||
of the source for the error, typically the ActiveX server name. <em>context</em> can be the location of a help file with more information
|
||||
about the error. If <em>context</em> ends with a number in brackets,
|
||||
e.g. [12], this number will be interpreted as the context ID in
|
||||
the help file.
|
||||
|
||||
<h3 class=fn>bool <a name="requestPropertyChange"></a>TQAxBindable::requestPropertyChange ( const char * property )<tt> [protected]</tt>
|
||||
</h3>
|
||||
Call this function to request permission to change the property
|
||||
<em>property</em> from the client that is hosting this ActiveX control.
|
||||
Returns TRUE if the client allows the change; otherwise returns
|
||||
FALSE.
|
||||
<p> This function is usually called first in the write function for <em>property</em>, and writing is abandoned if the function returns FALSE.
|
||||
<p> <pre>
|
||||
void MyActiveTQt::setText( const <a href="tqstring.html">TQString</a> &text )
|
||||
{
|
||||
if ( !requestPropertyChange( "text" ) )
|
||||
return;
|
||||
|
||||
// update property
|
||||
|
||||
<a href="#propertyChanged">propertyChanged</a>( "text" );
|
||||
}
|
||||
</pre>
|
||||
|
||||
<p> <p>See also <a href="#propertyChanged">propertyChanged</a>().
|
||||
|
||||
<!-- eof -->
|
||||
<hr><p>
|
||||
This file is part of the <a href="index.html">TQt toolkit</a>.
|
||||
Copyright © 1995-2007
|
||||
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,243 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/qutlook/qutlook.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>In Sync with Outlook</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>In Sync with Outlook</h1>
|
||||
|
||||
|
||||
|
||||
This example is a modified version of the standard
|
||||
<a href="addressbook-example.html">TQt addressbook</a> example.
|
||||
<p> It demonstrates the use of <a href="qaxobject.html">TQAxObject</a> and querySubObject to instantiate and
|
||||
navigate the Outlook Object Model, and the use of the TQt property system to
|
||||
read and write values of items in the Outlook contact folder.
|
||||
<p>
|
||||
|
||||
The modifications in the class declaration of the central widget are
|
||||
a forward declaration of the TQAxObject class and the IDispatch interface,
|
||||
and a new <a href="qlistviewitem.html">TQListViewItem</a> subclass <tt>ABListViewItem</tt> that implements a
|
||||
constructor and a destructor and has a member <tt>contact_item</tt> of type
|
||||
<a href="qaxobject.html">TQAxObject</a>.
|
||||
<pre> class TQAxObject;
|
||||
struct IDispatch;
|
||||
|
||||
class ABListViewItem : public <a href="qlistviewitem.html">TQListViewItem</a>
|
||||
{
|
||||
public:
|
||||
ABListViewItem( <a href="ntqlistview.html">TQListView</a> *listview, TQString firstName, TQString lastName, TQString address, TQString eMail, TQAxObject *contact );
|
||||
~ABListViewItem();
|
||||
|
||||
<a href="qaxobject.html">TQAxObject</a> *contactItem() const;
|
||||
|
||||
private:
|
||||
<a href="qaxobject.html">TQAxObject</a> *contact_item;
|
||||
};
|
||||
</pre>
|
||||
<p> The ABCentralWidget gets a destructor, a new protected function <tt>setupOutlook</tt>,
|
||||
a new protected slot <tt>updateOutlook</tt>, and also three members of type <a href="qaxobject.html">TQAxObject</a>.
|
||||
<pre> void findEntries();
|
||||
|
||||
void updateOutlook();
|
||||
|
||||
protected:
|
||||
void setupTabWidget();
|
||||
void setupListView();
|
||||
void setupOutlook();
|
||||
|
||||
<a href="qaxobject.html">TQAxObject</a> *outlook, *outlookSession, *contactItems;
|
||||
|
||||
<a href="qgridlayout.html">TQGridLayout</a> *mainGrid;
|
||||
</pre>
|
||||
<p>
|
||||
|
||||
The implementation of the ABListViewItem class is trivial:
|
||||
<pre> ABListViewItem::ABListViewItem( <a href="ntqlistview.html">TQListView</a> *listview,
|
||||
<a href="tqstring.html">TQString</a> firstName,
|
||||
<a href="tqstring.html">TQString</a> lastName,
|
||||
<a href="tqstring.html">TQString</a> address,
|
||||
<a href="tqstring.html">TQString</a> eMail,
|
||||
<a href="qaxobject.html">TQAxObject</a> *contact )
|
||||
: <a href="qlistviewitem.html">TQListViewItem</a>( listview, firstName, lastName, address, eMail ), contact_item( contact )
|
||||
{
|
||||
}
|
||||
|
||||
ABListViewItem::~ABListViewItem()
|
||||
{
|
||||
delete contact_item;
|
||||
}
|
||||
|
||||
TQAxObject *ABListViewItem::contactItem() const
|
||||
{
|
||||
return contact_item;
|
||||
}
|
||||
</pre>The ABCentralWidget constructor initializes the <a href="qaxobject.html">TQAxObject</a> pointers to zero and
|
||||
calls the <tt>setupOutlook</tt> function. The ABCentralWidget destructor calls the
|
||||
Logoff method of the outlookSession object.
|
||||
<pre> ABCentralWidget::ABCentralWidget( <a href="tqwidget.html">TQWidget</a> *parent, const char *name )
|
||||
: <a href="tqwidget.html">TQWidget</a>( parent, name ), outlook( 0 ), outlookSession( 0 ), contactItems( 0 )
|
||||
{
|
||||
mainGrid = new <a href="qgridlayout.html">TQGridLayout</a>( this, 2, 1, 5, 5 );
|
||||
|
||||
setupTabWidget();
|
||||
setupListView();
|
||||
setupOutlook();
|
||||
|
||||
<a name="x2722"></a> mainGrid-><a href="qgridlayout.html#setRowStretch">setRowStretch</a>( 0, 0 );
|
||||
mainGrid-><a href="qgridlayout.html#setRowStretch">setRowStretch</a>( 1, 1 );
|
||||
}
|
||||
|
||||
ABCentralWidget::~ABCentralWidget()
|
||||
{
|
||||
if ( outlookSession )
|
||||
outlookSession->dynamicCall( "Logoff()" );
|
||||
}
|
||||
</pre>The <tt>setupOutlook</tt> implementation creates a TQAxObject to wrap the
|
||||
Outlook.Application COM object.
|
||||
<pre> void ABCentralWidget::setupOutlook()
|
||||
{
|
||||
outlook = new <a href="qaxobject.html">TQAxObject</a>( "Outlook.Application", this );
|
||||
</pre>The call to <tt>querySubObject</tt> returns a new <a href="qaxobject.html">TQAxObject</a> wrapper around the
|
||||
"Session" object of the Outlook Object hierarchy. If the call fails for
|
||||
some reason setupOutlook returns, otherwise it calls the "Logon" method
|
||||
of the Session object.
|
||||
<pre> // Get a session object
|
||||
<a name="x2721"></a> outlookSession = outlook-><a href="qaxbase.html#querySubObject">querySubObject</a>( "Session" );
|
||||
if ( !outlookSession )
|
||||
return;
|
||||
// Login; doesn't hurt if you are already running and logged on...
|
||||
outlookSession->dynamicCall( "Logon()" );
|
||||
</pre>The following call to <tt>querySubObject</tt> returns a new TQAxObject wrapper
|
||||
around the default folder for "contacts".
|
||||
<pre> // Get the default folder for contacts
|
||||
<a href="qaxobject.html">TQAxObject</a> *defFolder = outlookSession->querySubObject( "GetDefaultFolder(OlDefaultFolders)", "olFolderContacts" );
|
||||
</pre><tt>querySubObject</tt> is then used again to get the list of all items in the
|
||||
folder. The <tt>connect</tt> statement connects the new ABCentralWidget slot
|
||||
to the signals provided by the "Items" COM object. Finally, it calls the
|
||||
<tt>updateOutlook</tt> function to populate the listview.
|
||||
<pre> // Get all items
|
||||
if ( defFolder ) {
|
||||
contactItems = defFolder-><a href="qaxbase.html#querySubObject">querySubObject</a>( "Items" );
|
||||
<a href="tqobject.html#connect">connect</a>( contactItems, TQ_SIGNAL(ItemAdd(IDispatch*)), this, TQ_SLOT(updateOutlook()) );
|
||||
<a href="tqobject.html#connect">connect</a>( contactItems, TQ_SIGNAL(ItemChange(IDispatch*)), this, TQ_SLOT(updateOutlook()) );
|
||||
<a href="tqobject.html#connect">connect</a>( contactItems, TQ_SIGNAL(ItemRemove()), this, TQ_SLOT(updateOutlook()) );
|
||||
}
|
||||
|
||||
updateOutlook();
|
||||
}
|
||||
</pre>
|
||||
<p> The implementation of the <tt>updateOutlook</tt> slot clears the listview, and uses
|
||||
<tt>querySubObject</tt> to iterate through the list of items. For every item provided a new
|
||||
ABListViewItem object is created and filled with the properties of the item
|
||||
object. The object returned by <tt>querySubObject</tt> is a child of the callee (ie. "contactItems"),
|
||||
but the list view item should take ownership to provide a cleaner relation between
|
||||
entries, so the item has to be removed from its parent object.
|
||||
<pre> void ABCentralWidget::updateOutlook()
|
||||
{
|
||||
<a name="x2725"></a> listView-><a href="ntqlistview.html#clear">clear</a>();
|
||||
if ( !contactItems )
|
||||
return;
|
||||
|
||||
<a href="qaxobject.html">TQAxObject</a> *item = contactItems->querySubObject( "GetFirst()" );
|
||||
while ( item ) {
|
||||
<a name="x2729"></a> <a href="tqstring.html">TQString</a> firstName = item-><a href="tqobject.html#property">property</a>( "FirstName" ).toString();
|
||||
<a href="tqstring.html">TQString</a> lastName = item-><a href="tqobject.html#property">property</a>( "LastName" ).toString();
|
||||
<a href="tqstring.html">TQString</a> address = item-><a href="tqobject.html#property">property</a>( "HomeAddress" ).toString();
|
||||
<a href="tqstring.html">TQString</a> email = item-><a href="tqobject.html#property">property</a>( "Email1Address" ).toString();
|
||||
|
||||
(void)new ABListViewItem( listView, firstName, lastName, address, email, item );
|
||||
// the listviewitem takes ownership
|
||||
<a name="x2727"></a> item-><a href="qlistviewitem.html#parent">parent</a>()->removeChild( item );
|
||||
|
||||
item = contactItems->querySubObject( "GetNext()" );
|
||||
}
|
||||
}
|
||||
</pre>
|
||||
<p> The <tt>addEntry</tt> implementation calls the CreateItem method of the Outlook.Application
|
||||
object to create a new contact item, and creates a new ABListViewItem if the call
|
||||
succeeds.
|
||||
<pre> void ABCentralWidget::addEntry()
|
||||
{
|
||||
<a name="x2724"></a> if ( !iFirstName-><a href="ntqlineedit.html#text">text</a>().isEmpty() || !iLastName-><a href="ntqlineedit.html#text">text</a>().isEmpty() ||
|
||||
!iAddress-><a href="ntqlineedit.html#text">text</a>().isEmpty() || !iEMail-><a href="ntqlineedit.html#text">text</a>().isEmpty() ) {
|
||||
<a href="qaxobject.html">TQAxObject</a> *contactItem = outlook-><a href="qaxbase.html#querySubObject">querySubObject</a>( "CreateItem(OlItemType)", "olContactItem" );
|
||||
if ( contactItem ) {
|
||||
<a name="x2730"></a> contactItem-><a href="tqobject.html#setProperty">setProperty</a>( "FirstName", iFirstName-><a href="ntqlineedit.html#text">text</a>() );
|
||||
contactItem-><a href="tqobject.html#setProperty">setProperty</a>( "LastName", iLastName-><a href="ntqlineedit.html#text">text</a>() );
|
||||
contactItem-><a href="tqobject.html#setProperty">setProperty</a>( "HomeAddress", iAddress-><a href="ntqlineedit.html#text">text</a>() );
|
||||
contactItem-><a href="tqobject.html#setProperty">setProperty</a>( "Email1Address", iEMail-><a href="ntqlineedit.html#text">text</a>() );
|
||||
<a name="x2720"></a> contactItem-><a href="qaxbase.html#dynamicCall">dynamicCall</a>( "Save()" );
|
||||
|
||||
new ABListViewItem( listView, iFirstName-><a href="ntqlineedit.html#text">text</a>(),
|
||||
iLastName-><a href="ntqlineedit.html#text">text</a>(), iAddress-><a href="ntqlineedit.html#text">text</a>(), iEMail-><a href="ntqlineedit.html#text">text</a>(), contactItem );
|
||||
}
|
||||
}
|
||||
|
||||
<a name="x2723"></a> iFirstName-><a href="ntqlineedit.html#setText">setText</a>( "" );
|
||||
iLastName-><a href="ntqlineedit.html#setText">setText</a>( "" );
|
||||
iAddress-><a href="ntqlineedit.html#setText">setText</a>( "" );
|
||||
iEMail-><a href="ntqlineedit.html#setText">setText</a>( "" );
|
||||
}
|
||||
</pre>
|
||||
<p> The <tt>changeEntry</tt> implementation updates the values in the contact item of the current
|
||||
listview item as well as the values of the listview item itself.
|
||||
<pre> void ABCentralWidget::changeEntry()
|
||||
{
|
||||
<a name="x2726"></a> ABListViewItem *item = (ABListViewItem*)listView-><a href="ntqlistview.html#currentItem">currentItem</a>();
|
||||
|
||||
if ( item &&
|
||||
( !iFirstName-><a href="ntqlineedit.html#text">text</a>().isEmpty() || !iLastName-><a href="ntqlineedit.html#text">text</a>().isEmpty() ||
|
||||
!iAddress-><a href="ntqlineedit.html#text">text</a>().isEmpty() || !iEMail-><a href="ntqlineedit.html#text">text</a>().isEmpty() ) ) {
|
||||
|
||||
<a href="qaxobject.html">TQAxObject</a> *contactItem = item->contactItem();
|
||||
contactItem-><a href="tqobject.html#setProperty">setProperty</a>( "FirstName", iFirstName-><a href="ntqlineedit.html#text">text</a>() );
|
||||
contactItem-><a href="tqobject.html#setProperty">setProperty</a>( "LastName", iLastName-><a href="ntqlineedit.html#text">text</a>() );
|
||||
contactItem-><a href="tqobject.html#setProperty">setProperty</a>( "HomeAddress", iAddress-><a href="ntqlineedit.html#text">text</a>() );
|
||||
contactItem-><a href="tqobject.html#setProperty">setProperty</a>( "Email1Address", iEMail-><a href="ntqlineedit.html#text">text</a>() );
|
||||
contactItem-><a href="qaxbase.html#dynamicCall">dynamicCall</a>( "Save()" );
|
||||
|
||||
<a name="x2728"></a> item-><a href="qlistviewitem.html#setText">setText</a>( 0, iFirstName-><a href="ntqlineedit.html#text">text</a>() );
|
||||
item-><a href="qlistviewitem.html#setText">setText</a>( 1, iLastName-><a href="ntqlineedit.html#text">text</a>() );
|
||||
item-><a href="qlistviewitem.html#setText">setText</a>( 2, iAddress-><a href="ntqlineedit.html#text">text</a>() );
|
||||
item-><a href="qlistviewitem.html#setText">setText</a>( 3, iEMail-><a href="ntqlineedit.html#text">text</a>() );
|
||||
}
|
||||
}
|
||||
</pre>
|
||||
<p> To build the example you must first build the <a href="qaxcontainer.html">TQAxContainer</a>
|
||||
library. Then run your make tool in <tt>examples/qutlook</tt> and run the resulting <tt>qutlok.exe</tt>.
|
||||
<p>See also <a href="qaxcontainer-examples.html">The TQAxContainer Examples</a>.
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,128 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/webbrowser/webbrowser.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>A Web Browser</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>A Web Browser</h1>
|
||||
|
||||
|
||||
|
||||
This example utilizes the Microsoft Web Browser ActiveX control
|
||||
to implement a fully functional Web Browser application. The
|
||||
user interface has been developed using the TQt Designer
|
||||
integration of the <a href="qaxwidget.html">TQAxWidget</a> class.
|
||||
<p> The code demonstrates how the TQt application can communicate
|
||||
with the embedded ActiveX controls using signals, slots and the
|
||||
dynamicCall() function. Most signal and slot connections have
|
||||
already been set up within TQt Designer.
|
||||
<p>
|
||||
|
||||
<pre> void MainWindow::init()
|
||||
{
|
||||
pb = new <a href="ntqprogressbar.html">TQProgressBar</a>( statusBar() );
|
||||
<a name="x2513"></a> pb-><a href="ntqprogressbar.html#setPercentageVisible">setPercentageVisible</a>( FALSE );
|
||||
<a name="x2516"></a> pb-><a href="tqwidget.html#hide">hide</a>();
|
||||
statusBar()->addWidget( pb, 0, TRUE );
|
||||
|
||||
connect( WebBrowser, TQ_SIGNAL(ProgressChange(int,int)), this, TQ_SLOT(setProgress(int,int)) );
|
||||
connect( WebBrowser, TQ_SIGNAL(StatusTextChange(const <a href="tqstring.html">TQString</a>&)), statusBar(), TQ_SLOT(message(const <a href="tqstring.html">TQString</a>&)) );
|
||||
|
||||
WebBrowser->dynamicCall( "GoHome()" );
|
||||
}
|
||||
</pre>The init() function is implemented to create a progress bar as
|
||||
the child of the status bar, and to connect Internet Explorer's
|
||||
<tt>ProgressChange()</tt> and <tt>StatusTextChange()</tt> signals to the
|
||||
respective displays.
|
||||
<p> Finally the <tt>GoHome()</tt> function of Internet Explorer is invoked
|
||||
using the <a href="qaxbase.html#dynamicCall">TQAxBase::dynamicCall</a>() dynamicCall() API.
|
||||
<p> <pre> void MainWindow::go()
|
||||
{
|
||||
actionStop->setEnabled( TRUE );
|
||||
WebBrowser->dynamicCall( "Navigate(const <a href="tqstring.html">TQString</a>&)", addressEdit->text() );
|
||||
}
|
||||
</pre>The go() function calls the <tt>NavigateTo()</tt> function of Internet
|
||||
Explorer, passing the text of the address bar as the argument.
|
||||
<p> <pre> void MainWindow::setTitle( const <a href="tqstring.html">TQString</a> &title )
|
||||
{
|
||||
setCaption( "TQt WebBrowser - " + title );
|
||||
}
|
||||
</pre>The setTitle() slot is connected to the TitleChange() signal
|
||||
of Internet Explorer, and updates the caption of the window
|
||||
using the provided title string.
|
||||
<p> <pre> void MainWindow::setProgress( int a, int b )
|
||||
{
|
||||
if ( a <= 0 || b <= 0 ) {
|
||||
pb-><a href="tqwidget.html#hide">hide</a>();
|
||||
return;
|
||||
}
|
||||
pb-><a href="tqwidget.html#show">show</a>();
|
||||
<a name="x2515"></a> pb-><a href="ntqprogressbar.html#setTotalSteps">setTotalSteps</a>( b );
|
||||
<a name="x2514"></a> pb-><a href="ntqprogressbar.html#setProgress">setProgress</a>( a );
|
||||
}
|
||||
|
||||
void MainWindow::setCommandState( int cmd, bool on )
|
||||
{
|
||||
switch ( cmd ) {
|
||||
case 1:
|
||||
actionForward->setEnabled( on );
|
||||
break;
|
||||
case 2:
|
||||
actionBack->setEnabled( on );
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
void MainWindow::navigateBegin()
|
||||
{
|
||||
actionStop->setEnabled( TRUE );
|
||||
}
|
||||
|
||||
void MainWindow::navigateComplete()
|
||||
{
|
||||
actionStop->setEnabled( FALSE );
|
||||
}
|
||||
</pre>The setProgress(), setCommandState(), navigateBegin() and
|
||||
navigateComplete() slots are connected to the respective
|
||||
signals of Internet Explorer and update the user interface.
|
||||
<p> The rest of the implementation is not related to <a href="activentqt.html#ActiveTQt">ActiveTQt</a> and
|
||||
omitted for brevity.
|
||||
<p> To build the example you must first build the
|
||||
<a href="qaxcontainer.html">TQAxContainer</a> library.
|
||||
Then run your make tool in <tt>examples/webbrowser</tt> and
|
||||
run the resulting <tt>webbrowser.exe</tt>.
|
||||
<p>See also <a href="qaxcontainer-examples.html">The TQAxContainer Examples</a>.
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,51 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/examples.doc:13 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>The TQAxContainer Examples</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>The TQAxContainer Examples</h1>
|
||||
|
||||
|
||||
|
||||
The following example programs illustrate the embedding of ActiveX
|
||||
controls using the TQAxContainer module.
|
||||
<p> For more information see the <a href="qaxcontainer.html">TQAxContainer</a> documentation.
|
||||
|
||||
<p><table width="100%">
|
||||
<tr bgcolor=#f0f0f0><td><b><a href="qaxcontainer-example-qutlook.html">In Sync with Outlook</a></b>
|
||||
<tr bgcolor=#f0f0f0><td><b><a href="qaxcontainer-example-webbrowser.html">A Web Browser</a></b>
|
||||
</table>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,188 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/doc/container.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>The TQAxContainer Module</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>The TQAxContainer Module</h1>
|
||||
|
||||
|
||||
<p>
|
||||
<p> <!-- toc -->
|
||||
<ul>
|
||||
<li><a href="#1"> Introduction
|
||||
</a>
|
||||
<li><a href="#2"> Building the library
|
||||
</a>
|
||||
<li><a href="#3"> Using the library
|
||||
</a>
|
||||
<ul>
|
||||
<li><a href="#3-1"> Distributing TQAxContainer applications
|
||||
</a>
|
||||
</ul>
|
||||
<li><a href="#4"> Instantiating COM objects
|
||||
</a>
|
||||
<li><a href="#5"> Accessing the object API
|
||||
</a>
|
||||
<ul>
|
||||
<li><a href="#5-1"> Typical error messages
|
||||
</a>
|
||||
<ul>
|
||||
<li><a href="#5-1-1"> Requested control could not be instantiated
|
||||
</a>
|
||||
<li><a href="#5-1-2"> TQAxBase::internalInvoke: No such method
|
||||
</a>
|
||||
<li><a href="#5-1-3"> Error calling IDispatch member: Non-optional parameter
|
||||
missing
|
||||
</a>
|
||||
<li><a href="#5-1-4"> Error calling IDispatch member: Type mismatch in
|
||||
parameter n
|
||||
</a>
|
||||
<li><a href="#5-1-5"> TQAxScriptManager::call(): No script provides this function
|
||||
</a>
|
||||
</ul>
|
||||
</ul>
|
||||
</ul>
|
||||
<!-- endtoc -->
|
||||
|
||||
<p> <h2> Introduction
|
||||
</h2>
|
||||
<a name="1"></a><p> The TQAxContainer module provides a library implementing a <a href="tqwidget.html">TQWidget</a>
|
||||
subclass, <a href="qaxwidget.html">TQAxWidget</a>, that acts as a container for ActiveX
|
||||
controls, and a <a href="tqobject.html">TQObject</a> subclass, <a href="qaxobject.html">TQAxObject</a>, that can be used to
|
||||
easily access non-visual COM objects. Scripting COM objects embedded
|
||||
using these classes is possible through the <a href="qaxscript.html">TQAxScript</a>, <a href="qaxscriptmanager.html">TQAxScriptManager</a>
|
||||
and <a href="qaxscriptengine.html">TQAxScriptEngine</a> classes.
|
||||
<p> This module is part of the <a href="activentqt.html">ActiveTQt
|
||||
framework</a>. (To make an application into an ActiveX server
|
||||
see the <a href="qaxserver.html">TQAxServer module</a>.)
|
||||
<p> The module consists of six classes
|
||||
<ol type=1>
|
||||
<li> <a href="qaxbase.html">TQAxBase</a> is an abstract class that provides an API to initialize
|
||||
and access a COM/ActiveX object.
|
||||
<li> <a href="qaxobject.html">TQAxObject</a> provides a TQObject that wraps a COM object.
|
||||
<li> <a href="qaxwidget.html">TQAxWidget</a> is a <a href="tqwidget.html">TQWidget</a> that wraps an ActiveX control.
|
||||
<li> <a href="qaxscriptmanager.html">TQAxScriptManager</a>, TQAxScript and TQAxScriptEngine provide an
|
||||
interface to the Windows Script Host.
|
||||
</ol>
|
||||
<p> Some <a href="qaxcontainer-examples.html">example applications</a>
|
||||
that use standard ActiveX controls to provide high level user
|
||||
interface functionality are provided.
|
||||
<p> <h2> Building the library
|
||||
</h2>
|
||||
<a name="2"></a><p> In the <tt>activeqt</tt> directory (usually <tt>TQTDIR/extensions/activeqt</tt>)
|
||||
enter the <tt>container</tt> subdirectory and run <tt>qmake</tt> to generate the
|
||||
makefile, and use the make tool (<tt>nmake</tt> for VC++, <tt>make</tt> for Borland)
|
||||
to build the library. The library <tt>qaxcontainer.lib</tt> will be linked
|
||||
into <tt>TQTDIR/lib</tt>.
|
||||
<p> If you have a shared configuration of TQt enter the <tt>plugin</tt> subdirectory
|
||||
and run <tt>qmake</tt> and your make tool to build a plugin that integrates the
|
||||
<a href="qaxwidget.html">TQAxWidget</a> class into <a href="designer-manual.html">TQt Designer</a>.
|
||||
<p> <h2> Using the library
|
||||
</h2>
|
||||
<a name="3"></a><p> To build TQt applications that can host COM objects and ActiveX controls
|
||||
link the application against the TQAxContainer module by adding
|
||||
<p> <pre>
|
||||
LIBS += qaxcontainer.lib
|
||||
</pre>
|
||||
|
||||
<p> to the application's <tt>.pro</tt> file.
|
||||
<p> <h3> Distributing TQAxContainer applications
|
||||
</h3>
|
||||
<a name="3-1"></a><p> The TQAxContainer library is static, so there is no need to redistribute
|
||||
any additional files when using this module. Note however that the
|
||||
ActiveX server binaries you are using might not be installed on the
|
||||
target system, so you have to ship them with your package and register
|
||||
them during the installation process of your application.
|
||||
<p> <h2> Instantiating COM objects
|
||||
</h2>
|
||||
<a name="4"></a><p> To instantiate a COM object use the <a href="qaxbase.html#setControl">TQAxBase::setControl</a>() API, or pass
|
||||
the name of the object directly into the constructor of the <a href="qaxbase.html">TQAxBase</a>
|
||||
subclass you are using.
|
||||
<p> The control can be specified in a variety of formats, but the fastest
|
||||
and most powerful format is to use the class ID (CLSID) of the object
|
||||
directly. The class ID can be prepended with information about a remote
|
||||
machine that the object should run on, and can include a license key
|
||||
for licensed controls.
|
||||
<p> <h2> Accessing the object API
|
||||
</h2>
|
||||
<a name="5"></a><p> <a href="activentqt.html#ActiveTQt">ActiveTQt</a> provides a TQt API to the COM object, and replaces COM
|
||||
datatypes with TQt equivalents. Use the <tt>dumpdoc</tt> tool to get the
|
||||
documentation of the TQt API for any COM object and it's subobjects.
|
||||
<p> See the <a href="qaxwidget.html">TQAxWidget</a> and <a href="qaxobject.html">TQAxObject</a> API documentation about how to
|
||||
use this class to use ActiveX controls and COM objects in TQt
|
||||
applications. To access the COM object with scripting languages use
|
||||
the <a href="qaxscript.html">TQAxScript</a> class.
|
||||
<p> To call functions of the COM object that can not be accessed via
|
||||
ActiveTQt it is possible to request the COM interface directly using
|
||||
<a href="qaxbase.html#queryInterface">TQAxBase::queryInterface</a>(). To get a C++ definition of the respective
|
||||
interface classes use the <tt>#import</tt> directive with the type library
|
||||
provided with the control.
|
||||
<p> <h3> Typical error messages
|
||||
</h3>
|
||||
<a name="5-1"></a><p> ActiveTQt prints error messages to the debug output when it
|
||||
encounters error situations at runtime. Usually you must run
|
||||
your program in the debugger to see these messages (e.g. in Visual
|
||||
Studio's Debug output).
|
||||
<p> <h4> Requested control could not be instantiated
|
||||
</h4>
|
||||
<a name="5-1-1"></a><p> The control requested in <a href="qaxbase.html#setControl">TQAxBase::setControl</a>() is not installed
|
||||
on this system, or is not accessible for the current user.
|
||||
<p> The control might require administrator rights, or a license key.
|
||||
If the control is licensed, reimplement initialize() and use the
|
||||
COM APIs to call the IClassFactory2 interface functions.
|
||||
<p> <h4> TQAxBase::internalInvoke: No such method
|
||||
</h4>
|
||||
<a name="5-1-2"></a><p> A <tt>dynamicCall()</tt> failed - the function prototype did not
|
||||
match any function available in the object's API.
|
||||
<p> <h4> Error calling IDispatch member: Non-optional parameter
|
||||
missing
|
||||
</h4>
|
||||
<a name="5-1-3"></a><p> A <tt>dynamicCall()</tt> failed - the function prototype was correct,
|
||||
but too few parameters were provided.
|
||||
<p> <h4> Error calling IDispatch member: Type mismatch in
|
||||
parameter n
|
||||
</h4>
|
||||
<a name="5-1-4"></a><p> A <tt>dynamicCall()</tt> failed - the function prototype was correct,
|
||||
but the paramter at index <tt>n</tt> was of the wrong type and could
|
||||
not be coerced to the correct type.
|
||||
<p> <h4> <a href="qaxscriptmanager.html#call">TQAxScriptManager::call</a>(): No script provides this function
|
||||
</h4>
|
||||
<a name="5-1-5"></a><p> You try to call a function that is provided through an engine
|
||||
that doesn't provide introspection (ie. ActivePython or
|
||||
ActivePerl). You need to call the function directly on the
|
||||
respective <a href="qaxscript.html">TQAxScript</a> object.
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,327 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qaxfactory.h:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>qaxfactory.h Include File</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>qaxfactory.h</h1>
|
||||
|
||||
<p>This is the verbatim text of the qaxfactory.h include file. It is provided only for illustration; the copyright remains with Trolltech.
|
||||
<hr>
|
||||
<pre>
|
||||
/****************************************************************************
|
||||
** $Id: qt/qaxfactory.h 3.3.8 edited Jan 11 14:46 $
|
||||
**
|
||||
** Declaration of the TQAxFactory class
|
||||
**
|
||||
** Copyright (C) 2001-2007 Trolltech ASA. All rights reserved.
|
||||
**
|
||||
** This file is part of the Active TQt integration.
|
||||
**
|
||||
** Licensees holding valid TQt Enterprise Edition
|
||||
** licenses for Windows may use this file in accordance with the TQt Commercial
|
||||
** License Agreement provided with the Software.
|
||||
**
|
||||
** This file is not available for use under any other license without
|
||||
** express written permission from the copyright holder.
|
||||
**
|
||||
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
|
||||
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
||||
**
|
||||
** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
|
||||
** information about TQt Commercial License Agreements.
|
||||
**
|
||||
** Contact info@trolltech.com if any conditions of this licensing are
|
||||
** not clear to you.
|
||||
**
|
||||
**********************************************************************/
|
||||
|
||||
#ifndef TQAXFACTORY_H
|
||||
#define TQAXFACTORY_H
|
||||
|
||||
#include <ntqdict.h>
|
||||
#include <ntquuid.h>
|
||||
#include <private/qcom_p.h>
|
||||
#include <ntqmetaobject.h>
|
||||
|
||||
// {22B230F6-8722-4051-ADCB-E7C9CE872EB3}
|
||||
#ifndef IID_QAxFactory
|
||||
#define IID_QAxFactory TQUuid( 0x22b230f6, 0x8722, 0x4051, 0xad, 0xcb, 0xe7, 0xc9, 0xce, 0x87, 0x2e, 0xb3 )
|
||||
#endif
|
||||
|
||||
class TQWidget;
|
||||
class TQMetaObject;
|
||||
class TQSettings;
|
||||
struct IDispatch;
|
||||
|
||||
struct TQAxFactoryInterface : public TQFeatureListInterface
|
||||
{
|
||||
public:
|
||||
#ifndef Q_QDOC
|
||||
virtual TQWidget *create( const TQString &key, TQWidget *parent = 0, const char *name = 0 ) = 0;
|
||||
virtual TQObject *createObject( const TQString &key, TQObject *parent = 0, const char *name = 0 ) = 0;
|
||||
virtual TQMetaObject *metaObject( const TQString &key ) const = 0;
|
||||
virtual bool createObjectWrapper(TQObject *object, IDispatch **wrapper) = 0;
|
||||
|
||||
virtual TQUuid classID( const TQString &key ) const = 0;
|
||||
virtual TQUuid interfaceID( const TQString &key ) const = 0;
|
||||
virtual TQUuid eventsID( const TQString &key ) const = 0;
|
||||
virtual TQUuid typeLibID() const = 0;
|
||||
virtual TQUuid appID() const = 0;
|
||||
|
||||
virtual void registerClass( const TQString &key, TQSettings * ) const = 0;
|
||||
virtual void unregisterClass( const TQString &key, TQSettings * ) const = 0;
|
||||
|
||||
virtual bool validateLicenseKey( const TQString &key, const TQString &licenseKey) const = 0;
|
||||
|
||||
virtual TQString exposeToSuperClass( const TQString &key ) const = 0;
|
||||
virtual bool stayTopLevel( const TQString &key ) const = 0;
|
||||
virtual bool hasStockEvents( const TQString &key ) const = 0;
|
||||
virtual bool isService() const = 0;
|
||||
#endif
|
||||
};
|
||||
|
||||
extern TQAxFactoryInterface *qAxFactory();
|
||||
|
||||
class TQAxFactory : public TQAxFactoryInterface
|
||||
{
|
||||
public:
|
||||
TQAxFactory( const TQUuid &, const TQUuid &);
|
||||
virtual ~TQAxFactory();
|
||||
TQ_REFCOUNT;
|
||||
|
||||
TQRESULT queryInterface( const TQUuid &iid, TQUnknownInterface **iface );
|
||||
|
||||
#ifdef Q_QDOC
|
||||
virtual TQStringList featureList() const = 0;
|
||||
#endif
|
||||
virtual TQWidget *create( const TQString &key, TQWidget *parent = 0, const char *name = 0 );
|
||||
virtual TQObject *createObject( const TQString &key, TQObject *parent = 0, const char *name = 0 );
|
||||
virtual TQMetaObject *metaObject( const TQString &key ) const;
|
||||
virtual bool createObjectWrapper(TQObject *object, IDispatch **wrapper);
|
||||
|
||||
virtual TQUuid classID( const TQString &key ) const;
|
||||
virtual TQUuid interfaceID( const TQString &key ) const;
|
||||
virtual TQUuid eventsID( const TQString &key ) const;
|
||||
|
||||
virtual TQUuid typeLibID() const;
|
||||
virtual TQUuid appID() const;
|
||||
|
||||
virtual void registerClass( const TQString &key, TQSettings * ) const;
|
||||
virtual void unregisterClass( const TQString &key, TQSettings * ) const;
|
||||
|
||||
virtual bool validateLicenseKey( const TQString &key, const TQString &licenseKey) const;
|
||||
|
||||
virtual TQString exposeToSuperClass( const TQString &key ) const;
|
||||
virtual bool stayTopLevel( const TQString &key ) const;
|
||||
virtual bool hasStockEvents( const TQString &key ) const;
|
||||
virtual bool isService() const;
|
||||
|
||||
enum ServerType {
|
||||
SingleInstance,
|
||||
MultipleInstances
|
||||
};
|
||||
|
||||
static bool isServer();
|
||||
static TQString serverDirPath();
|
||||
static TQString serverFilePath();
|
||||
static bool startServer(ServerType type = MultipleInstances);
|
||||
static bool stopServer();
|
||||
|
||||
private:
|
||||
TQUuid typelib;
|
||||
TQUuid app;
|
||||
};
|
||||
|
||||
inline bool TQAxFactory::startServer(ServerType type)
|
||||
{
|
||||
// implementation in qaxservermain.cpp
|
||||
extern bool qax_startServer(ServerType);
|
||||
return qax_startServer(type);
|
||||
}
|
||||
|
||||
inline bool TQAxFactory::stopServer()
|
||||
{
|
||||
// implementation in qaxservermain.cpp
|
||||
extern bool qax_stopServer();
|
||||
return qax_stopServer();
|
||||
}
|
||||
|
||||
#define TQAXFACTORY_EXPORT( IMPL, TYPELIB, APPID ) \
|
||||
TQUnknownInterface *ucm_instantiate() \
|
||||
{ \
|
||||
IMPL *impl = new IMPL( TQUuid(TYPELIB), TQUuid(APPID) ); \
|
||||
TQUnknownInterface* iface = 0; \
|
||||
impl->queryInterface( IID_QUnknown, &iface ); \
|
||||
return iface; \
|
||||
}
|
||||
|
||||
#define TQAXFACTORY_DEFAULT( Class, IIDClass, IIDInterface, IIDEvents, IIDTypeLib, IIDApp ) \
|
||||
class TQAxDefaultFactory : public TQAxFactory \
|
||||
{ \
|
||||
public: \
|
||||
TQAxDefaultFactory( const TQUuid &app, const TQUuid &lib) \
|
||||
: TQAxFactory( app, lib ) {} \
|
||||
TQStringList featureList() const \
|
||||
{ \
|
||||
TQStringList list; \
|
||||
list << #Class; \
|
||||
return list; \
|
||||
} \
|
||||
TQMetaObject *metaObject( const TQString &key ) const \
|
||||
{ \
|
||||
if ( key == #Class ) \
|
||||
return Class::staticMetaObject(); \
|
||||
return 0; \
|
||||
} \
|
||||
TQWidget *create( const TQString &key, TQWidget *parent, const char *name ) \
|
||||
{ \
|
||||
if ( key == #Class ) \
|
||||
return new Class( parent, name ); \
|
||||
return 0; \
|
||||
} \
|
||||
TQUuid classID( const TQString &key ) const \
|
||||
{ \
|
||||
if ( key == #Class ) \
|
||||
return TQUuid( IIDClass ); \
|
||||
return TQUuid(); \
|
||||
} \
|
||||
TQUuid interfaceID( const TQString &key ) const \
|
||||
{ \
|
||||
if ( key == #Class ) \
|
||||
return TQUuid( IIDInterface ); \
|
||||
return TQUuid(); \
|
||||
} \
|
||||
TQUuid eventsID( const TQString &key ) const \
|
||||
{ \
|
||||
if ( key == #Class ) \
|
||||
return TQUuid( IIDEvents ); \
|
||||
return TQUuid(); \
|
||||
} \
|
||||
}; \
|
||||
TQAXFACTORY_EXPORT( TQAxDefaultFactory, IIDTypeLib, IIDApp ) \
|
||||
|
||||
template<class T>
|
||||
class TQAxClass : public TQAxFactory
|
||||
{
|
||||
public:
|
||||
TQAxClass(const TQString &appId, const TQString &libId)
|
||||
: TQAxFactory(appId, libId)
|
||||
{}
|
||||
|
||||
TQMetaObject *metaObject(const TQString &key) const { return T::staticMetaObject(); }
|
||||
TQStringList featureList() const { return TQString(T::staticMetaObject()->className()); }
|
||||
TQWidget *create(const TQString &key, TQWidget *parent, const char *name)
|
||||
{
|
||||
if (key != TQString(T::staticMetaObject()->className())) return 0;
|
||||
if (!qstrcmp(T::staticMetaObject()->classInfo("Creatable", TRUE), "no")) return 0;
|
||||
return new T(parent, name);
|
||||
}
|
||||
};
|
||||
|
||||
#define TQAXFACTORY_BEGIN(IDTypeLib, IDApp) \
|
||||
class TQAxFactoryList : public TQAxFactory \
|
||||
{ \
|
||||
TQStringList factoryKeys; \
|
||||
TQDict<TQAxFactoryInterface> factories; \
|
||||
public: \
|
||||
TQAxFactoryList() \
|
||||
: TQAxFactory(IDApp, IDTypeLib) \
|
||||
{ \
|
||||
factories.setAutoDelete(TRUE); \
|
||||
TQAxFactoryInterface *factory = 0; \
|
||||
TQStringList keys; \
|
||||
TQStringList::Iterator it; \
|
||||
|
||||
#define TQAXCLASS(Class) \
|
||||
factory = new TQAxClass<Class>(appID(), typeLibID()); \
|
||||
keys = factory->featureList(); \
|
||||
for (it = keys.begin(); it != keys.end(); ++it) { \
|
||||
factoryKeys += *it; \
|
||||
factories.insert(*it, factory); \
|
||||
}\
|
||||
|
||||
#define TQAXFACTORY_END() \
|
||||
} \
|
||||
TQStringList featureList() const { return factoryKeys; } \
|
||||
TQWidget *create(const TQString &key, TQWidget *parent, const char *name) { \
|
||||
TQAxFactoryInterface *f = factories[key]; \
|
||||
return f ? f->create(key, parent, name) : 0; \
|
||||
} \
|
||||
TQUuid classID(const TQString &key) { \
|
||||
TQAxFactoryInterface *f = factories[key]; \
|
||||
return f ? f->classID(key) : TQUuid(); \
|
||||
} \
|
||||
TQUuid interfaceID(const TQString &key) { \
|
||||
TQAxFactoryInterface *f = factories[key]; \
|
||||
return f ? f->interfaceID(key) : TQUuid(); \
|
||||
} \
|
||||
TQUuid eventsID(const TQString &key) { \
|
||||
TQAxFactoryInterface *f = factories[key]; \
|
||||
return f ? f->eventsID(key) : TQUuid(); \
|
||||
} \
|
||||
void registerClass( const TQString &key, TQSettings *s ) const { \
|
||||
TQAxFactoryInterface *f = factories[key]; \
|
||||
if (f) f->registerClass(key, s); \
|
||||
} \
|
||||
void unregisterClass( const TQString &key, TQSettings *s ) const { \
|
||||
TQAxFactoryInterface *f = factories[key]; \
|
||||
if (f) f->unregisterClass(key, s); \
|
||||
} \
|
||||
TQString exposeToSuperClass( const TQString &key ) const { \
|
||||
TQAxFactoryInterface *f = factories[key]; \
|
||||
return f ? f->exposeToSuperClass(key) : TQString(); \
|
||||
} \
|
||||
bool stayTopLevel( const TQString &key ) const { \
|
||||
TQAxFactoryInterface *f = factories[key]; \
|
||||
return f ? f->stayTopLevel(key) : FALSE; \
|
||||
} \
|
||||
bool hasStockEvents( const TQString &key ) const { \
|
||||
TQAxFactoryInterface *f = factories[key]; \
|
||||
return f ? f->hasStockEvents(key) : FALSE; \
|
||||
} \
|
||||
}; \
|
||||
TQUnknownInterface *ucm_instantiate() \
|
||||
{ \
|
||||
TQAxFactoryList *impl = new TQAxFactoryList(); \
|
||||
TQUnknownInterface* iface = 0; \
|
||||
impl->queryInterface( IID_QUnknown, &iface ); \
|
||||
return iface; \
|
||||
}
|
||||
|
||||
|
||||
#endif // TQAXFACTORY_H
|
||||
</pre>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,70 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qaxfactory.h:75 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxFactory Member List</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Complete Member List for TQAxFactory</h1>
|
||||
|
||||
<p>This is the complete list of member functions for
|
||||
<a href="qaxfactory.html">TQAxFactory</a>, including inherited members.
|
||||
|
||||
<ul>
|
||||
<li><a href="qaxfactory.html#TQAxFactory">TQAxFactory</a>()
|
||||
<li><a href="qaxfactory.html#~TQAxFactory">~TQAxFactory</a>()
|
||||
<li><a href="qaxfactory.html#appID">appID</a>()
|
||||
<li><a href="qaxfactory.html#classID">classID</a>()
|
||||
<li><a href="qaxfactory.html#create">create</a>()
|
||||
<li><a href="qaxfactory.html#createObject">createObject</a>()
|
||||
<li><a href="qaxfactory.html#createObjectWrapper">createObjectWrapper</a>()
|
||||
<li><a href="qaxfactory.html#eventsID">eventsID</a>()
|
||||
<li><a href="qaxfactory.html#exposeToSuperClass">exposeToSuperClass</a>()
|
||||
<li><a href="qaxfactory.html#featureList">featureList</a>()
|
||||
<li><a href="qaxfactory.html#hasStockEvents">hasStockEvents</a>()
|
||||
<li><a href="qaxfactory.html#interfaceID">interfaceID</a>()
|
||||
<li><a href="qaxfactory.html#isServer">isServer</a>()
|
||||
<li><a href="qaxfactory.html#isService">isService</a>()
|
||||
<li><a href="qaxfactory.html#metaObject">metaObject</a>()
|
||||
<li><a href="qaxfactory.html#registerClass">registerClass</a>()
|
||||
<li><a href="qaxfactory.html#serverDirPath">serverDirPath</a>()
|
||||
<li><a href="qaxfactory.html#serverFilePath">serverFilePath</a>()
|
||||
<li><a href="qaxfactory.html#startServer">startServer</a>()
|
||||
<li><a href="qaxfactory.html#stayTopLevel">stayTopLevel</a>()
|
||||
<li><a href="qaxfactory.html#stopServer">stopServer</a>()
|
||||
<li><a href="qaxfactory.html#typeLibID">typeLibID</a>()
|
||||
<li><a href="qaxfactory.html#unregisterClass">unregisterClass</a>()
|
||||
<li><a href="qaxfactory.html#validateLicenseKey">validateLicenseKey</a>()
|
||||
</ul>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,424 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/control/qaxfactory.cpp:75 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxFactory Class</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQAxFactory Class Reference<br><small>[<a href="qaxserver.html">TQAxServer module</a>]</small></h1>
|
||||
|
||||
<p>The TQAxFactory class defines a factory for the creation of COM components.
|
||||
<a href="#details">More...</a>
|
||||
<p>This class is part of the <b>TQt ActiveTQt Extension</b>.
|
||||
<p><tt>#include <<a href="qaxfactory-h.html">qaxfactory.h</a>></tt>
|
||||
<p><a href="qaxfactory-members.html">List of all member functions.</a>
|
||||
<h2>Public Members</h2>
|
||||
<ul>
|
||||
<li class=fn><a href="#TQAxFactory"><b>TQAxFactory</b></a> ( const TQUuid & libid, const TQUuid & appid )</li>
|
||||
<li class=fn>virtual <a href="#~TQAxFactory"><b>~TQAxFactory</b></a> ()</li>
|
||||
<li class=fn>virtual TQStringList <a href="#featureList"><b>featureList</b></a> () const = 0</li>
|
||||
<li class=fn>virtual TQWidget * <a href="#create"><b>create</b></a> ( const TQString & key, TQWidget * parent = 0, const char * name = 0 )</li>
|
||||
<li class=fn>virtual TQObject * <a href="#createObject"><b>createObject</b></a> ( const TQString & key, TQObject * parent = 0, const char * name = 0 )</li>
|
||||
<li class=fn>virtual TQMetaObject * <a href="#metaObject"><b>metaObject</b></a> ( const TQString & key ) const</li>
|
||||
<li class=fn>virtual bool <a href="#createObjectWrapper"><b>createObjectWrapper</b></a> ( TQObject * object, IDispatch ** wrapper )</li>
|
||||
<li class=fn>virtual TQUuid <a href="#classID"><b>classID</b></a> ( const TQString & key ) const</li>
|
||||
<li class=fn>virtual TQUuid <a href="#interfaceID"><b>interfaceID</b></a> ( const TQString & key ) const</li>
|
||||
<li class=fn>virtual TQUuid <a href="#eventsID"><b>eventsID</b></a> ( const TQString & key ) const</li>
|
||||
<li class=fn>virtual TQUuid <a href="#typeLibID"><b>typeLibID</b></a> () const</li>
|
||||
<li class=fn>virtual TQUuid <a href="#appID"><b>appID</b></a> () const</li>
|
||||
<li class=fn>virtual void <a href="#registerClass"><b>registerClass</b></a> ( const TQString & key, TQSettings * settings ) const</li>
|
||||
<li class=fn>virtual void <a href="#unregisterClass"><b>unregisterClass</b></a> ( const TQString & key, TQSettings * settings ) const</li>
|
||||
<li class=fn>virtual bool <a href="#validateLicenseKey"><b>validateLicenseKey</b></a> ( const TQString & key, const TQString & licenseKey ) const</li>
|
||||
<li class=fn>virtual TQString <a href="#exposeToSuperClass"><b>exposeToSuperClass</b></a> ( const TQString & key ) const</li>
|
||||
<li class=fn>virtual bool <a href="#stayTopLevel"><b>stayTopLevel</b></a> ( const TQString & key ) const</li>
|
||||
<li class=fn>virtual bool <a href="#hasStockEvents"><b>hasStockEvents</b></a> ( const TQString & key ) const</li>
|
||||
<li class=fn>virtual bool <a href="#isService"><b>isService</b></a> () const</li>
|
||||
<li class=fn>enum <a href="#ServerType-enum"><b>ServerType</b></a> { SingleInstance, MultipleInstances }</li>
|
||||
</ul>
|
||||
<h2>Static Public Members</h2>
|
||||
<ul>
|
||||
<li class=fn>bool <a href="#isServer"><b>isServer</b></a> ()</li>
|
||||
<li class=fn>TQString <a href="#serverDirPath"><b>serverDirPath</b></a> ()</li>
|
||||
<li class=fn>TQString <a href="#serverFilePath"><b>serverFilePath</b></a> ()</li>
|
||||
<li class=fn>bool <a href="#startServer"><b>startServer</b></a> ( ServerType type = MultipleInstances )</li>
|
||||
<li class=fn>bool <a href="#stopServer"><b>stopServer</b></a> ()</li>
|
||||
</ul>
|
||||
<hr><a name="details"></a><h2>Detailed Description</h2>
|
||||
<p> This class is defined in the <b>TQt <a href="activentqt.html#ActiveTQt">ActiveTQt</a> Extension</b>, which can be found in the <tt>qt/extensions</tt> directory. It is not included in the main TQt API.
|
||||
<p>
|
||||
|
||||
The TQAxFactory class defines a factory for the creation of COM components.
|
||||
|
||||
<p>
|
||||
|
||||
<!-- index TQAXFACTORY_DEFAULT --><a name="TQAXFACTORY_DEFAULT"></a><!-- index TQAXFACTORY_EXPORT --><a name="TQAXFACTORY_EXPORT"></a><!-- index TQAXFACTORY_BEGIN --><a name="TQAXFACTORY_BEGIN"></a><!-- index TQAXFACTORY_END --><a name="TQAXFACTORY_END"></a><!-- index TQAXCLASS --><a name="TQAXCLASS"></a>
|
||||
<p> Implement this factory once in your ActiveX server to provide
|
||||
information about the components the server can create. If your
|
||||
server supports just a single ActiveX control, you can use the
|
||||
default factory implementation instead of implementing the factory
|
||||
yourself. Use the <a href="qaxfactory.html#TQAXFACTORY_DEFAULT">TQAXFACTORY_DEFAULT</a> macro in any
|
||||
implementation file (e.g. main.cpp) to instantiate and export the
|
||||
default factory:
|
||||
<p> <pre>
|
||||
#include <<a href="qapplication-h.html">ntqapplication.h</a>>
|
||||
#include <<a href="qaxfactory-h.html">qaxfactory.h</a>>
|
||||
|
||||
#include "theactivex.h"
|
||||
|
||||
TQAXFACTORY_DEFAULT(
|
||||
TheActiveX, // widget class
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}", // class ID
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}", // interface ID
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}", // event interface ID
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}", // type library ID
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}" // application ID
|
||||
)
|
||||
</pre>
|
||||
|
||||
<p> If you implement your own factory reimplement the pure virtual
|
||||
functions, provide the unique identifiers for the ActiveX
|
||||
controls, and use the <a href="qaxfactory.html#TQAXFACTORY_EXPORT">TQAXFACTORY_EXPORT</a> macro to instantiate
|
||||
and export it:
|
||||
<p> <pre>
|
||||
TQStringList ActiveTQtFactory::featureList() const
|
||||
{
|
||||
<a href="tqstringlist.html">TQStringList</a> list;
|
||||
list << "ActiveX1";
|
||||
list << "ActiveX2";
|
||||
...
|
||||
return list;
|
||||
}
|
||||
|
||||
TQWidget *ActiveTQtFactory::create( const <a href="tqstring.html">TQString</a> &key, TQWidget *parent, const char *name )
|
||||
{
|
||||
if ( key == "ActiveX1" )
|
||||
return new ActiveX1( parent, name );
|
||||
if ( key == "ActiveX2" )
|
||||
return new ActiveX2( parent, name );
|
||||
...
|
||||
return 0;
|
||||
}
|
||||
|
||||
TQUuid ActiveTQtFactory::classID( const <a href="tqstring.html">TQString</a> &key ) const
|
||||
{
|
||||
if ( key == "ActiveX1" )
|
||||
return "{01234567-89AB-CDEF-0123-456789ABCDEF}";
|
||||
...
|
||||
return TQUuid();
|
||||
}
|
||||
|
||||
TQUuid ActiveTQtFactory::interfaceID( const <a href="tqstring.html">TQString</a> &key ) const
|
||||
{
|
||||
if ( key == "ActiveX1" )
|
||||
return "{01234567-89AB-CDEF-0123-456789ABCDEF}";
|
||||
...
|
||||
return TQUuid();
|
||||
}
|
||||
|
||||
TQUuid ActiveTQtFactory::eventsID( const <a href="tqstring.html">TQString</a> &key ) const
|
||||
{
|
||||
if ( key == "ActiveX1" )
|
||||
return "{01234567-89AB-CDEF-0123-456789ABCDEF}";
|
||||
...
|
||||
return TQUuid();
|
||||
}
|
||||
|
||||
TQAXFACTORY_EXPORT(
|
||||
MyFactory, // factory class
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}", // type library ID
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}" // application ID
|
||||
)
|
||||
</pre>
|
||||
|
||||
<p> If you use the <tt>TQ_CLASSINFO</tt> macro to provide the unique identifiers
|
||||
or other attributes for your class you can use the <a href="qaxfactory.html#TQAXFACTORY_BEGIN">TQAXFACTORY_BEGIN</a>,
|
||||
<a href="qaxfactory.html#TQAXCLASS">TQAXCLASS</a> and <a href="qaxfactory.html#TQAXFACTORY_END">TQAXFACTORY_END</a> macros to expose one or more classes
|
||||
as COM objects.
|
||||
<p> <pre>
|
||||
TQAXFACTORY_BEGIN(
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}", // type library ID
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}" // application ID
|
||||
)
|
||||
TQAXCLASS(Class1)
|
||||
TQAXCLASS(Class2)
|
||||
TQAXFACTORY_END()
|
||||
</pre>
|
||||
|
||||
<p> Only one TQAxFactory implementation may be instantiated and
|
||||
exported by an ActiveX server application. This instance is accessible
|
||||
through the global qAxFactory() function.
|
||||
<p> A factory can also reimplement the <a href="#registerClass">registerClass</a>() and
|
||||
<a href="#unregisterClass">unregisterClass</a>() functions to set additional flags for an ActiveX
|
||||
control in the registry. To limit the number of methods or
|
||||
properties a widget class exposes from its parent classes
|
||||
reimplement <a href="#exposeToSuperClass">exposeToSuperClass</a>().
|
||||
|
||||
<hr><h2>Member Type Documentation</h2>
|
||||
<h3 class=fn><a name="ServerType-enum"></a>TQAxFactory::ServerType</h3>
|
||||
|
||||
<p> This enum specifies the different types of servers that can be
|
||||
started with startServer.
|
||||
<ul>
|
||||
<li><tt>TQAxFactory::SingleInstance</tt> - The server can create only one instance of each
|
||||
supplied class.
|
||||
<li><tt>TQAxFactory::MultipleInstances</tt> - The server can create multiple instances of
|
||||
each supplied class.
|
||||
</ul>
|
||||
<hr><h2>Member Function Documentation</h2>
|
||||
<h3 class=fn><a name="TQAxFactory"></a>TQAxFactory::TQAxFactory ( const <a href="ntquuid.html">TQUuid</a> & libid, const <a href="ntquuid.html">TQUuid</a> & appid )
|
||||
</h3>
|
||||
Constructs a TQAxFactory object that returns <em>libid</em> and <em>appid</em>
|
||||
in the implementation of the respective interface functions.
|
||||
|
||||
<h3 class=fn><a name="~TQAxFactory"></a>TQAxFactory::~TQAxFactory ()<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Destroys the TQAxFactory object.
|
||||
|
||||
<h3 class=fn><a href="ntquuid.html">TQUuid</a> <a name="appID"></a>TQAxFactory::appID () const<tt> [virtual]</tt>
|
||||
</h3>
|
||||
|
||||
<p> Reimplement this function to return the ActiveX server's
|
||||
application identifier.
|
||||
|
||||
<h3 class=fn><a href="ntquuid.html">TQUuid</a> <a name="classID"></a>TQAxFactory::classID ( const <a href="tqstring.html">TQString</a> & key ) const<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Reimplement this function to return the class identifier for each
|
||||
<em>key</em> returned by the <a href="#featureList">featureList</a>() implementation, or an empty
|
||||
<a href="ntquuid.html">TQUuid</a> if this factory doesn't support the value of <em>key</em>.
|
||||
<p> The default implementation interprets <em>key</em> as the class name,
|
||||
and returns the value of the TQ_CLASSINFO entry "ClassID".
|
||||
|
||||
<h3 class=fn><a href="tqwidget.html">TQWidget</a> * <a name="create"></a>TQAxFactory::create ( const <a href="tqstring.html">TQString</a> & key, <a href="tqwidget.html">TQWidget</a> * parent = 0, const char * name = 0 )<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Reimplement this function to return a new widget for <em>key</em>.
|
||||
Propagate <em>parent</em> and <em>name</em> to the <a href="tqwidget.html">TQWidget</a> constructor. Return
|
||||
0 if this factory doesn't support the value of <em>key</em>.
|
||||
<p> The returned widget will be exposed as an ActiveX control, e.g.
|
||||
a COM object that can be embedded as a control into applications.
|
||||
<p> The default implementation returns 0.
|
||||
|
||||
<h3 class=fn><a href="tqobject.html">TQObject</a> * <a name="createObject"></a>TQAxFactory::createObject ( const <a href="tqstring.html">TQString</a> & key, <a href="tqobject.html">TQObject</a> * parent = 0, const char * name = 0 )<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Reimplement this function to return a new object for <em>key</em>.
|
||||
Propagate <em>parent</em> and <em>name</em> to the <a href="tqwidget.html">TQWidget</a> constructor. Return
|
||||
0 if this factory doesn't support the value of <em>key</em>.
|
||||
<p> If the object returned is a TQWidget it will be exposed as an ActiveX
|
||||
control, otherwise the returned object will be exposed as a COM object.
|
||||
<p> The default implementation returns the result <a href="#create">TQAxFactory::create</a>() if
|
||||
<em>parent</em> is 0 or a widget, otherwise returns 0.
|
||||
|
||||
<h3 class=fn>bool <a name="createObjectWrapper"></a>TQAxFactory::createObjectWrapper ( <a href="tqobject.html">TQObject</a> * object, IDispatch ** wrapper )<tt> [virtual]</tt>
|
||||
</h3>
|
||||
|
||||
<p> Reimplement this function to provide the COM object for <em>object</em>
|
||||
in <em>wrapper</em>. Return TRUE if the function was successfull, otherwise
|
||||
return FALSE.
|
||||
<p> The default implementation creates a generic automation wrapper based
|
||||
on the <a href="metaobjects.html#meta-object">meta object</a> information of <em>object</em>.
|
||||
|
||||
<h3 class=fn><a href="ntquuid.html">TQUuid</a> <a name="eventsID"></a>TQAxFactory::eventsID ( const <a href="tqstring.html">TQString</a> & key ) const<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Reimplement this function to return the identifier of the event
|
||||
interface for each <em>key</em> returned by the <a href="#featureList">featureList</a>()
|
||||
implementation, or an empty <a href="ntquuid.html">TQUuid</a> if this factory doesn't support
|
||||
the value of <em>key</em>.
|
||||
<p> The default implementation interprets <em>key</em> as the class name,
|
||||
and returns the value of the TQ_CLASSINFO entry "EventsID".
|
||||
|
||||
<h3 class=fn><a href="tqstring.html">TQString</a> <a name="exposeToSuperClass"></a>TQAxFactory::exposeToSuperClass ( const <a href="tqstring.html">TQString</a> & key ) const<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Reimplement this function to return the name of the super class of
|
||||
<em>key</em> up to which methods and properties should be exposed by the
|
||||
ActiveX control.
|
||||
<p> The default implementation interprets <em>key</em> as the class name,
|
||||
and returns the value of the TQ_CLASSINFO entry "ToSuperClass". If
|
||||
no such value is set the null-string is returned, and the functions
|
||||
and properties of all the super classes including <a href="tqwidget.html">TQWidget</a> will be
|
||||
exposed.
|
||||
<p> To only expose the functions and properties of the class itself,
|
||||
reimplement this function to return <em>key</em>.
|
||||
|
||||
<h3 class=fn><a href="tqstringlist.html">TQStringList</a> <a name="featureList"></a>TQAxFactory::featureList () const<tt> [pure virtual]</tt>
|
||||
</h3>
|
||||
|
||||
<p> Reimplement this function to return a list of the widgets (class
|
||||
names) supported by this factory.
|
||||
|
||||
<h3 class=fn>bool <a name="hasStockEvents"></a>TQAxFactory::hasStockEvents ( const <a href="tqstring.html">TQString</a> & key ) const<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Reimplement this function to return TRUE if the ActiveX control
|
||||
<em>key</em> should support the standard ActiveX events
|
||||
<ul>
|
||||
<li> Click
|
||||
<li> DblClick
|
||||
<li> KeyDown
|
||||
<li> KeyPress
|
||||
<li> KeyUp
|
||||
<li> MouseDown
|
||||
<li> MouseUp
|
||||
<li> MouseMove
|
||||
</ul>
|
||||
<p> The default implementation interprets <em>key</em> as the class name,
|
||||
and returns TRUE if the value of the TQ_CLASSINFO entry "StockEvents"
|
||||
is "yes". Otherwise this function returns FALSE.
|
||||
|
||||
<h3 class=fn><a href="ntquuid.html">TQUuid</a> <a name="interfaceID"></a>TQAxFactory::interfaceID ( const <a href="tqstring.html">TQString</a> & key ) const<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Reimplement this function to return the interface identifier for
|
||||
each <em>key</em> returned by the <a href="#featureList">featureList</a>() implementation, or an
|
||||
empty <a href="ntquuid.html">TQUuid</a> if this factory doesn't support the value of <em>key</em>.
|
||||
<p> The default implementation interprets <em>key</em> as the class name,
|
||||
and returns the value of the TQ_CLASSINFO entry "InterfaceID".
|
||||
|
||||
<h3 class=fn>bool <a name="isServer"></a>TQAxFactory::isServer ()<tt> [static]</tt>
|
||||
</h3>
|
||||
Returns TRUE if the application has been started (by COM) as an ActiveX
|
||||
server, otherwise returns FALSE.
|
||||
<p> <pre>
|
||||
int main( int argc, char**argv )
|
||||
{
|
||||
<a href="ntqapplication.html">TQApplication</a> app( argc, argv );
|
||||
|
||||
if ( !TQAxFactory::isServer() ) {
|
||||
// initialize for stand-alone execution
|
||||
}
|
||||
|
||||
return app.<a href="ntqapplication.html#exec">exec</a>() // standard event processing
|
||||
}
|
||||
</pre>
|
||||
|
||||
|
||||
<h3 class=fn>bool <a name="isService"></a>TQAxFactory::isService () const<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Reimplement this function to return TRUE if the server is
|
||||
running as a persistent service (e.g. an NT service) and should
|
||||
not terminate even when all objects provided have been released.
|
||||
<p> The default implementation returns FALSE.
|
||||
|
||||
<h3 class=fn><a href="ntqmetaobject.html">TQMetaObject</a> * <a name="metaObject"></a>TQAxFactory::metaObject ( const <a href="tqstring.html">TQString</a> & key ) const<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Reimplement this function to return the <a href="ntqmetaobject.html">TQMetaObject</a> corresponding to
|
||||
<em>key</em>, or 0 if this factory doesn't support the value of <em>key</em>.
|
||||
<p> The default implementation returns the TQMetaObject for the class
|
||||
<em>key</em>.
|
||||
|
||||
<h3 class=fn>void <a name="registerClass"></a>TQAxFactory::registerClass ( const <a href="tqstring.html">TQString</a> & key, <a href="ntqsettings.html">TQSettings</a> * settings ) const<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Registers additional values for the class <em>key</em> in the system
|
||||
registry using the <em>settings</em> object. The standard values have
|
||||
already been registed by the framework, but additional values,
|
||||
e.g. implemented categories, can be added in an implementation of
|
||||
this function.
|
||||
<p> <pre>
|
||||
settings->writeEntry( "/CLSID/" + classID(key) + "/Implemented Categories/{00000000-0000-0000-000000000000}/.", TQString::null );
|
||||
</pre>
|
||||
|
||||
<p> If you reimplement this function you must also reimplement
|
||||
<a href="#unregisterClass">unregisterClass</a>() to remove the additional registry values.
|
||||
<p> <p>See also <a href="ntqsettings.html">TQSettings</a>.
|
||||
|
||||
<h3 class=fn><a href="tqstring.html">TQString</a> <a name="serverDirPath"></a>TQAxFactory::serverDirPath ()<tt> [static]</tt>
|
||||
</h3>
|
||||
Returns the directory that contains the server binary.
|
||||
<p> For out-of-process servers this is the same as
|
||||
<a href="ntqapplication.html#applicationDirPath">TQApplication::applicationDirPath</a>(). For in-process servers
|
||||
that function returns the directory that contains the hosting
|
||||
application.
|
||||
|
||||
<h3 class=fn><a href="tqstring.html">TQString</a> <a name="serverFilePath"></a>TQAxFactory::serverFilePath ()<tt> [static]</tt>
|
||||
</h3>
|
||||
Returns the file path of the server binary.
|
||||
<p> For out-of-process servers this is the same as
|
||||
<a href="ntqapplication.html#applicationFilePath">TQApplication::applicationFilePath</a>(). For in-process servers
|
||||
that function returns the file path of the hosting application.
|
||||
|
||||
<h3 class=fn>bool <a name="startServer"></a>TQAxFactory::startServer ( <a href="qaxfactory.html#ServerType-enum">ServerType</a> type = MultipleInstances )<tt> [static]</tt>
|
||||
</h3>
|
||||
|
||||
<p> Starts the COM server with <em>type</em> and returns TRUE if successful,
|
||||
otherwise returns FALSE.
|
||||
<p> Calling this function if the server is already running (or for an
|
||||
in-process server) does nothing and returns TRUE.
|
||||
<p> The server is started automatically with <em>type</em> set to MultipleUse
|
||||
if the server executable has been started with the <tt>-activex</tt>
|
||||
command line parameter.
|
||||
|
||||
<h3 class=fn>bool <a name="stayTopLevel"></a>TQAxFactory::stayTopLevel ( const <a href="tqstring.html">TQString</a> & key ) const<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Reimplement this function to return TRUE if the ActiveX control <em>key</em>
|
||||
should be a top level window, e.g. a dialog. The default implementation
|
||||
returns FALSE.
|
||||
|
||||
<h3 class=fn>bool <a name="stopServer"></a>TQAxFactory::stopServer ()<tt> [static]</tt>
|
||||
</h3>
|
||||
|
||||
<p> Stops the COM server and returns TRUE if successful, otherwise
|
||||
returns FALSE.
|
||||
<p> Calling this function if the server is not running (or for an
|
||||
in-process server) does nothing and returns TRUE.
|
||||
<p> Stopping the server will not invalidate existing objects, but no
|
||||
new objects can be created from the existing server process. Usually
|
||||
COM will start a new server process if additional objects are requested.
|
||||
<p> The server is stopped automatically when the main() function returns.
|
||||
|
||||
<h3 class=fn><a href="ntquuid.html">TQUuid</a> <a name="typeLibID"></a>TQAxFactory::typeLibID () const<tt> [virtual]</tt>
|
||||
</h3>
|
||||
|
||||
<p> Reimplement this function to return the ActiveX server's type
|
||||
library identifier.
|
||||
|
||||
<h3 class=fn>void <a name="unregisterClass"></a>TQAxFactory::unregisterClass ( const <a href="tqstring.html">TQString</a> & key, <a href="ntqsettings.html">TQSettings</a> * settings ) const<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Unregisters any additional values for the class <em>key</em> from the
|
||||
system registry using the <em>settings</em> object.
|
||||
<p> <pre>
|
||||
settings->removeEntry( "/CLSID/" + classID(key) + "/Implemented Categories/{00000000-0000-0000-000000000000}/." );
|
||||
</pre>
|
||||
|
||||
<p> <p>See also <a href="#registerClass">registerClass</a>() and <a href="ntqsettings.html">TQSettings</a>.
|
||||
|
||||
<h3 class=fn>bool <a name="validateLicenseKey"></a>TQAxFactory::validateLicenseKey ( const <a href="tqstring.html">TQString</a> & key, const <a href="tqstring.html">TQString</a> & licenseKey ) const<tt> [virtual]</tt>
|
||||
</h3>
|
||||
Reimplement this function to return TRUE if <em>licenseKey</em> is a valid
|
||||
license for the class <em>key</em>, or if the current machine is licensed.
|
||||
<p> The default implementation returns TRUE if the class <em>key</em> is not
|
||||
licensed (ie. no TQ_CLASSINFO attribute "LicenseKey"), or if
|
||||
<em>licenseKey</em> matches the value of the "LicenseKey" attribute, or
|
||||
if the machine is licensed through a .LIC file with the same filename
|
||||
as this COM server.
|
||||
|
||||
<!-- eof -->
|
||||
<hr><p>
|
||||
This file is part of the <a href="index.html">TQt toolkit</a>.
|
||||
Copyright © 1995-2007
|
||||
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,104 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qaxobject.h:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>qaxobject.h Include File</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>qaxobject.h</h1>
|
||||
|
||||
<p>This is the verbatim text of the qaxobject.h include file. It is provided only for illustration; the copyright remains with Trolltech.
|
||||
<hr>
|
||||
<pre>
|
||||
/****************************************************************************
|
||||
** $Id: qt/qaxobject.h 3.3.8 edited Jan 11 14:46 $
|
||||
**
|
||||
** Declaration of the TQAxObject class
|
||||
**
|
||||
** Copyright (C) 2001-2007 Trolltech ASA. All rights reserved.
|
||||
**
|
||||
** This file is part of the Active TQt integration.
|
||||
**
|
||||
** Licensees holding valid TQt Enterprise Edition
|
||||
** licenses for Windows may use this file in accordance with the TQt Commercial
|
||||
** License Agreement provided with the Software.
|
||||
**
|
||||
** This file is not available for use under any other license without
|
||||
** express written permission from the copyright holder.
|
||||
**
|
||||
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
|
||||
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
||||
**
|
||||
** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
|
||||
** information about TQt Commercial License Agreements.
|
||||
**
|
||||
** Contact info@trolltech.com if any conditions of this licensing are
|
||||
** not clear to you.
|
||||
**
|
||||
**********************************************************************/
|
||||
|
||||
#ifndef UNICODE
|
||||
#define UNICODE
|
||||
#endif
|
||||
|
||||
#ifndef TQAXOBJECT_H
|
||||
#define TQAXOBJECT_H
|
||||
|
||||
#include "qaxbase.h"
|
||||
#include <tqobject.h>
|
||||
|
||||
class TQAxObject : public TQObject, public TQAxBase
|
||||
{
|
||||
friend class TQAxEventSink;
|
||||
public:
|
||||
TQMetaObject *metaObject() const;
|
||||
const char *className() const;
|
||||
void* tqt_cast( const char* );
|
||||
bool tqt_invoke( int, TQUObject* );
|
||||
bool tqt_emit( int, TQUObject* );
|
||||
bool tqt_property( int, int, TQVariant* );
|
||||
TQObject* qObject() { return (TQObject*)this; }
|
||||
|
||||
TQAxObject( TQObject *parent = 0, const char *name = 0 );
|
||||
TQAxObject( const TQString &c, TQObject *parent = 0, const char *name = 0 );
|
||||
TQAxObject( IUnknown *iface, TQObject *parent = 0, const char *name = 0 );
|
||||
~TQAxObject();
|
||||
|
||||
private:
|
||||
TQMetaObject *parentMetaObject() const;
|
||||
};
|
||||
|
||||
#endif //TQAXOBJECT_H
|
||||
</pre>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,113 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qaxobject.h:38 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxObject Member List</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Complete Member List for TQAxObject</h1>
|
||||
|
||||
<p>This is the complete list of member functions for
|
||||
<a href="qaxobject.html">TQAxObject</a>, including inherited members.
|
||||
|
||||
<ul>
|
||||
<li><a href="qaxobject.html#TQAxObject">TQAxObject</a>()
|
||||
<li><a href="qaxobject.html#~TQAxObject">~TQAxObject</a>()
|
||||
<li><a href="qaxbase.html#asVariant">asVariant</a>()
|
||||
<li><a href="tqobject.html#blockSignals">blockSignals</a>()
|
||||
<li><a href="tqobject.html#checkConnectArgs">checkConnectArgs</a>()
|
||||
<li><a href="tqobject.html#child">child</a>()
|
||||
<li><a href="tqobject.html#childEvent">childEvent</a>()
|
||||
<li><a href="tqobject.html#children">children</a>()
|
||||
<li><a href="tqobject.html#className">className</a>()
|
||||
<li><a href="qaxbase.html#clear">clear</a>()
|
||||
<li><a href="tqobject.html#connect">connect</a>()
|
||||
<li><a href="tqobject.html#connectNotify">connectNotify</a>()
|
||||
<li><a href="qaxbase.html#control">control</a>()
|
||||
<li><a href="tqobject.html#customEvent">customEvent</a>()
|
||||
<li><a href="tqobject.html#deleteLater">deleteLater</a>()
|
||||
<li><a href="tqobject.html#destroyed">destroyed</a>()
|
||||
<li><a href="qaxbase.html#disableClassInfo">disableClassInfo</a>()
|
||||
<li><a href="qaxbase.html#disableEventSink">disableEventSink</a>()
|
||||
<li><a href="qaxbase.html#disableMetaObject">disableMetaObject</a>()
|
||||
<li><a href="tqobject.html#disconnect">disconnect</a>()
|
||||
<li><a href="tqobject.html#disconnectNotify">disconnectNotify</a>()
|
||||
<li><a href="tqobject.html#dumpObjectInfo">dumpObjectInfo</a>()
|
||||
<li><a href="tqobject.html#dumpObjectTree">dumpObjectTree</a>()
|
||||
<li><a href="qaxbase.html#dynamicCall">dynamicCall</a>()
|
||||
<li><a href="tqobject.html#event">event</a>()
|
||||
<li><a href="tqobject.html#eventFilter">eventFilter</a>()
|
||||
<li><a href="qaxbase.html#exception">exception</a>()
|
||||
<li><a href="qaxbase.html#generateDocumentation">generateDocumentation</a>()
|
||||
<li><a href="tqobject.html#highPriority">highPriority</a>()
|
||||
<li><a href="tqobject.html#inherits">inherits</a>()
|
||||
<li><a href="qaxbase.html#initialize">initialize</a>()
|
||||
<li><a href="qaxbase.html#initializeActive">initializeActive</a>()
|
||||
<li><a href="qaxbase.html#initializeLicensed">initializeLicensed</a>()
|
||||
<li><a href="qaxbase.html#initializeRemote">initializeRemote</a>()
|
||||
<li><a href="tqobject.html#insertChild">insertChild</a>()
|
||||
<li><a href="tqobject.html#installEventFilter">installEventFilter</a>()
|
||||
<li><a href="tqobject.html#isA">isA</a>()
|
||||
<li><a href="qaxbase.html#isNull">isNull</a>()
|
||||
<li><a href="tqobject.html#isWidgetType">isWidgetType</a>()
|
||||
<li><a href="tqobject.html#killTimer">killTimer</a>()
|
||||
<li><a href="tqobject.html#killTimers">killTimers</a>()
|
||||
<li><a href="tqobject.html#metaObject">metaObject</a>()
|
||||
<li><a href="tqobject.html#name">name</a>()
|
||||
<li><a href="tqobject.html#normalizeSignalSlot">normalizeSignalSlot</a>()
|
||||
<li><a href="tqobject.html#objectTrees">objectTrees</a>()
|
||||
<li><a href="tqobject.html#parent">parent</a>()
|
||||
<li><a href="tqobject.html#property">property</a>()
|
||||
<li><a href="qaxbase.html#propertyBag">propertyBag</a>()
|
||||
<li><a href="qaxbase.html#propertyChanged">propertyChanged</a>()
|
||||
<li><a href="qaxbase.html#propertyWritable">propertyWritable</a>()
|
||||
<li><a href="qaxbase.html#queryInterface">queryInterface</a>()
|
||||
<li><a href="tqobject.html#queryList">queryList</a>()
|
||||
<li><a href="qaxbase.html#querySubObject">querySubObject</a>()
|
||||
<li><a href="tqobject.html#removeChild">removeChild</a>()
|
||||
<li><a href="tqobject.html#removeEventFilter">removeEventFilter</a>()
|
||||
<li><a href="tqobject.html#sender">sender</a>()
|
||||
<li><a href="qaxbase.html#setControl">setControl</a>()
|
||||
<li><a href="tqobject.html#setName">setName</a>()
|
||||
<li><a href="tqobject.html#setProperty">setProperty</a>()
|
||||
<li><a href="qaxbase.html#setPropertyBag">setPropertyBag</a>()
|
||||
<li><a href="qaxbase.html#setPropertyWritable">setPropertyWritable</a>()
|
||||
<li><a href="qaxbase.html#signal">signal</a>()
|
||||
<li><a href="tqobject.html#signalsBlocked">signalsBlocked</a>()
|
||||
<li><a href="tqobject.html#startTimer">startTimer</a>()
|
||||
<li><a href="tqobject.html#timerEvent">timerEvent</a>()
|
||||
<li><a href="tqobject.html#tr">tr</a>()
|
||||
<li><a href="tqobject.html#trUtf8">trUtf8</a>()
|
||||
</ul>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,205 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/container/qaxobject.cpp:33 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxObject Class</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQAxObject Class Reference<br><small>[<a href="qaxcontainer.html">TQAxContainer module</a>]</small></h1>
|
||||
|
||||
<p>The TQAxObject class provides a TQObject that wraps a COM object.
|
||||
<a href="#details">More...</a>
|
||||
<p>This class is part of the <b>TQt ActiveTQt Extension</b>.
|
||||
<p><tt>#include <<a href="qaxobject-h.html">qaxobject.h</a>></tt>
|
||||
<p>Inherits <a href="tqobject.html">TQObject</a> and <a href="qaxbase.html">TQAxBase</a>.
|
||||
<p>Inherited by <a href="qaxscriptengine.html">TQAxScriptEngine</a>.
|
||||
<p><a href="qaxobject-members.html">List of all member functions.</a>
|
||||
<h2>Public Members</h2>
|
||||
<ul>
|
||||
<li class=fn><a href="#TQAxObject"><b>TQAxObject</b></a> ( TQObject * parent = 0, const char * name = 0 )</li>
|
||||
<li class=fn><a href="#TQAxObject-2"><b>TQAxObject</b></a> ( const TQString & c, TQObject * parent = 0, const char * name = 0 )</li>
|
||||
<li class=fn><a href="#TQAxObject-3"><b>TQAxObject</b></a> ( IUnknown * iface, TQObject * parent = 0, const char * name = 0 )</li>
|
||||
<li class=fn><a href="#~TQAxObject"><b>~TQAxObject</b></a> ()</li>
|
||||
</ul>
|
||||
<h2>Important Inherited Members</h2>
|
||||
<ul>
|
||||
<li class=fn>TQVariant <a href="#dynamicCall"><b>dynamicCall</b></a> ( const TQCString & function, const TQVariant & var1 = TQVariant ( ), const TQVariant & var2 = TQVariant ( ), const TQVariant & var3 = TQVariant ( ), const TQVariant & var4 = TQVariant ( ), const TQVariant & var5 = TQVariant ( ), const TQVariant & var6 = TQVariant ( ), const TQVariant & var7 = TQVariant ( ), const TQVariant & var8 = TQVariant ( ) )</li>
|
||||
<li class=fn>TQVariant <a href="#dynamicCall-2"><b>dynamicCall</b></a> ( const TQCString & function, TQValueList<TQVariant> & vars )</li>
|
||||
<li class=fn>TQAxObject * <a href="#querySubObject"><b>querySubObject</b></a> ( const TQCString & name, const TQVariant & var1 = TQVariant ( ), const TQVariant & var2 = TQVariant ( ), const TQVariant & var3 = TQVariant ( ), const TQVariant & var4 = TQVariant ( ), const TQVariant & var5 = TQVariant ( ), const TQVariant & var6 = TQVariant ( ), const TQVariant & var7 = TQVariant ( ), const TQVariant & var8 = TQVariant ( ) )</li>
|
||||
</ul>
|
||||
<hr><a name="details"></a><h2>Detailed Description</h2>
|
||||
<p> This class is defined in the <b>TQt <a href="activentqt.html#ActiveTQt">ActiveTQt</a> Extension</b>, which can be found in the <tt>qt/extensions</tt> directory. It is not included in the main TQt API.
|
||||
<p>
|
||||
|
||||
The TQAxObject class provides a <a href="tqobject.html">TQObject</a> that wraps a COM object.
|
||||
|
||||
<p>
|
||||
|
||||
<p> A TQAxObject can be instantiated as an empty object, with the name
|
||||
of the COM object it should wrap, or with a pointer to the
|
||||
IUnknown that represents an existing COM object. If the COM object
|
||||
implements the IDispatch interface, the properties, methods and
|
||||
events of that object become available as TQt properties, slots and
|
||||
signals. The base class, <a href="qaxbase.html">TQAxBase</a>, provides an API to access the
|
||||
COM object directly through the IUnknown pointer.
|
||||
<p> TQAxObject is a TQObject and can be used as such, e.g. it can be
|
||||
organized in an object hierarchy, receive events and connect to
|
||||
signals and slots.
|
||||
<p> <b>Warning:</b>
|
||||
You can subclass TQAxObject, but you cannot use the <a href="metaobjects.html#TQ_OBJECT">TQ_OBJECT</a> macro
|
||||
in the subclass (the generated <a href="moc.html#moc">moc</a>-file will not compile), so you
|
||||
cannot add further signals, slots or properties. This limitation is
|
||||
due to the metaobject information generated in runtime.
|
||||
To work around this problem, aggregate the TQAxObject as a member of
|
||||
the <a href="tqobject.html">TQObject</a> subclass.
|
||||
<p>
|
||||
<hr><h2>Member Function Documentation</h2>
|
||||
<h3 class=fn><a name="TQAxObject"></a>TQAxObject::TQAxObject ( <a href="tqobject.html">TQObject</a> * parent = 0, const char * name = 0 )
|
||||
</h3>
|
||||
Creates an empty COM object and propagates <em>parent</em> and <em>name</em>
|
||||
to the <a href="tqobject.html">TQObject</a> constructor. To initialize the object, call <a href="qaxbase.html#setControl">setControl</a>.
|
||||
|
||||
<h3 class=fn><a name="TQAxObject-2"></a>TQAxObject::TQAxObject ( const <a href="tqstring.html">TQString</a> & c, <a href="tqobject.html">TQObject</a> * parent = 0, const char * name = 0 )
|
||||
</h3>
|
||||
Creates a TQAxObject that wraps the COM object <em>c</em>. <em>parent</em> and
|
||||
<em>name</em> are propagated to the <a href="tqwidget.html">TQWidget</a> contructor.
|
||||
<p> <p>See also <a href="qaxbase.html#control-prop">control</a>.
|
||||
|
||||
<h3 class=fn><a name="TQAxObject-3"></a>TQAxObject::TQAxObject ( IUnknown * iface, <a href="tqobject.html">TQObject</a> * parent = 0, const char * name = 0 )
|
||||
</h3>
|
||||
Creates a TQAxObject that wraps the COM object referenced by <em>iface</em>. <em>parent</em> and <em>name</em> are propagated to the <a href="tqobject.html">TQObject</a>
|
||||
contructor.
|
||||
|
||||
<h3 class=fn><a name="~TQAxObject"></a>TQAxObject::~TQAxObject ()
|
||||
</h3>
|
||||
Releases the COM object and destroys the TQAxObject,
|
||||
cleaning up all allocated resources.
|
||||
|
||||
<h3 class=fn><a href="ntqvariant.html">TQVariant</a> <a name="dynamicCall"></a>TQAxBase::dynamicCall ( const <a href="ntqcstring.html">TQCString</a> & function, const <a href="ntqvariant.html">TQVariant</a> & var1 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var2 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var3 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var4 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var5 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var6 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var7 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var8 = TQVariant ( ) )
|
||||
</h3>
|
||||
Calls the COM object's method <em>function</em>, passing the
|
||||
parameters <em>var1</em>, <em>var1</em>, <em>var2</em>, <em>var3</em>, <em>var4</em>, <em>var5</em>,
|
||||
<em>var6</em>, <em>var7</em> and <em>var8</em>, and returns the value returned by
|
||||
the method, or an invalid <a href="ntqvariant.html">TQVariant</a> if the method does not return
|
||||
a value or when the function call failed.
|
||||
<p> If <em>function</em> is a method of the object the string must be provided
|
||||
as the full prototype, for example as it would be written in a
|
||||
<a href="tqobject.html#connect">TQObject::connect</a>() call.
|
||||
<pre>
|
||||
activeX->dynamicCall( "Navigate(const <a href="tqstring.html">TQString</a>&)", "www.trolltech.com" );
|
||||
</pre>
|
||||
|
||||
<p> Alternatively a function can be called passing the parameters embedded
|
||||
in the string, e.g. above function can also be invoked using
|
||||
<pre>
|
||||
activeX->dynamicCall("Navigate(\"www.trolltech.com\");
|
||||
</pre>
|
||||
|
||||
All parameters are passed as strings; it depends on the control whether
|
||||
they are interpreted correctly, and is slower than using the prototype
|
||||
with correctly typed parameters.
|
||||
<p> If <em>function</em> is a property the string has to be the name of the
|
||||
property. The property setter is called when <em>var1</em> is a valid TQVariant,
|
||||
otherwise the getter is called.
|
||||
<pre>
|
||||
activeX->dynamicCall( "Value", 5 );
|
||||
<a href="tqstring.html">TQString</a> text = activeX->dynamicCall( "Text" ).toString();
|
||||
</pre>
|
||||
|
||||
Note that it is faster to get and set properties using
|
||||
<a href="tqobject.html#property">TQObject::property</a>() and <a href="tqobject.html#setProperty">TQObject::setProperty</a>().
|
||||
<p> It is only possible to call functions through <a href="qaxbase.html#dynamicCall">dynamicCall</a>() that
|
||||
have parameters or return values of datatypes supported by
|
||||
<a href="ntqvariant.html">TQVariant</a>. See the <a href="qaxbase.html">TQAxBase</a> class documentation for a list of
|
||||
supported and unsupported datatypes. If you want to call functions
|
||||
that have unsupported datatypes in the parameter list, use
|
||||
<a href="qaxbase.html#queryInterface">queryInterface</a>() to retrieve the appropriate COM interface, and
|
||||
use the function directly.
|
||||
<p> <pre>
|
||||
IWebBrowser2 *webBrowser = 0;
|
||||
activeX->queryInterface( IID_IWebBrowser2, (void**)&webBrowser );
|
||||
if ( webBrowser ) {
|
||||
webBrowser->Navigate2( pvarURL );
|
||||
webBrowser->Release();
|
||||
}
|
||||
</pre>
|
||||
|
||||
<p> This is also more efficient.
|
||||
|
||||
<p>Example: <a href="qaxcontainer-example-qutlook.html#x2720">qutlook/centralwidget.cpp</a>.
|
||||
<h3 class=fn><a href="ntqvariant.html">TQVariant</a> <a name="dynamicCall-2"></a>TQAxBase::dynamicCall ( const <a href="ntqcstring.html">TQCString</a> & function, <a href="tqvaluelist.html">TQValueList</a><TQVariant> & vars )
|
||||
</h3>
|
||||
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
<p> Calls the COM object's method <em>function</em>, passing the
|
||||
parameters in <em>vars</em>, and returns the value returned by
|
||||
the method. If the method does not return a value or when
|
||||
the function call failed this function returns an invalid
|
||||
<a href="ntqvariant.html">TQVariant</a> object.
|
||||
<p> The TQVariant objects in <em>vars</em> are updated when the method has
|
||||
out-parameters.
|
||||
|
||||
<h3 class=fn><a href="qaxobject.html">TQAxObject</a> * <a name="querySubObject"></a>TQAxBase::querySubObject ( const <a href="ntqcstring.html">TQCString</a> & name, const <a href="ntqvariant.html">TQVariant</a> & var1 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var2 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var3 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var4 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var5 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var6 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var7 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var8 = TQVariant ( ) )
|
||||
</h3>
|
||||
Returns a pointer to a TQAxObject wrapping the COM object provided
|
||||
by the method or property <em>name</em>, passing passing the parameters
|
||||
<em>var1</em>, <em>var1</em>, <em>var2</em>, <em>var3</em>, <em>var4</em>, <em>var5</em>, <em>var6</em>,
|
||||
<em>var7</em> and <em>var8</em>.
|
||||
<p> If <em>name</em> is provided by a method the string must include the
|
||||
full function prototype.
|
||||
<p> If <em>name</em> is a property the string must be the name of the property,
|
||||
and <em>var1</em>, ... <em>var8</em> are ignored.
|
||||
<p> The returned TQAxObject is a child of this object (which is either of
|
||||
type TQAxObject or <a href="qaxwidget.html">TQAxWidget</a>), and is deleted when this object is
|
||||
deleted. It is however safe to delete the returned object yourself,
|
||||
and you should do so when you iterate over lists of subobjects.
|
||||
<p> COM enabled applications usually have an object model publishing
|
||||
certain elements of the application as dispatch interfaces. Use
|
||||
this method to navigate the hierarchy of the object model, e.g.
|
||||
<p> <pre>
|
||||
<a href="qaxwidget.html">TQAxWidget</a> outlook( "Outlook.Application" );
|
||||
TQAxObject *session = outlook.<a href="qaxbase.html#querySubObject">querySubObject</a>( "Session" );
|
||||
if ( session ) {
|
||||
TQAxObject *defFolder = session-><a href="qaxbase.html#querySubObject">querySubObject</a>(
|
||||
"GetDefaultFolder(OlDefaultFolders)",
|
||||
"olFolderContacts" );
|
||||
//...
|
||||
}
|
||||
</pre>
|
||||
|
||||
|
||||
<p>Example: <a href="qaxcontainer-example-qutlook.html#x2721">qutlook/centralwidget.cpp</a>.
|
||||
<!-- eof -->
|
||||
<hr><p>
|
||||
This file is part of the <a href="index.html">TQt toolkit</a>.
|
||||
Copyright © 1995-2007
|
||||
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,261 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qaxscript.h:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>qaxscript.h Include File</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>qaxscript.h</h1>
|
||||
|
||||
<p>This is the verbatim text of the qaxscript.h include file. It is provided only for illustration; the copyright remains with Trolltech.
|
||||
<hr>
|
||||
<pre>
|
||||
/****************************************************************************
|
||||
** $Id: qt/qaxscript.h 3.3.8 edited Jan 11 14:46 $
|
||||
**
|
||||
** Declaration of the TQAxScriptEngine, TQAxScript and TQAxScriptManager classes
|
||||
**
|
||||
** Copyright (C) 2002-2007 Trolltech ASA. All rights reserved.
|
||||
**
|
||||
** This file is part of the Active TQt integration.
|
||||
**
|
||||
** Licensees holding valid TQt Enterprise Edition
|
||||
** licenses for Windows may use this file in accordance with the TQt Commercial
|
||||
** License Agreement provided with the Software.
|
||||
**
|
||||
** This file is not available for use under any other license without
|
||||
** express written permission from the copyright holder.
|
||||
**
|
||||
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
|
||||
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
||||
**
|
||||
** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
|
||||
** information about TQt Commercial License Agreements.
|
||||
**
|
||||
** Contact info@trolltech.com if any conditions of this licensing are
|
||||
** not clear to you.
|
||||
**
|
||||
**********************************************************************/
|
||||
|
||||
#ifndef TQAXSCRIPT_H
|
||||
#define TQAXSCRIPT_H
|
||||
|
||||
#include <qaxobject.h>
|
||||
|
||||
class TQAxBase;
|
||||
class TQAxScript;
|
||||
class TQAxScriptSite;
|
||||
class TQAxScriptEngine;
|
||||
class TQAxScriptManager;
|
||||
class TQAxScriptManagerPrivate;
|
||||
struct IActiveScript;
|
||||
|
||||
class TQAxScriptEngine : public TQAxObject
|
||||
{
|
||||
public:
|
||||
enum State {
|
||||
Uninitialized = 0,
|
||||
Initialized = 5,
|
||||
Started = 1,
|
||||
Connected = 2,
|
||||
Disconnected = 3,
|
||||
Closed = 4
|
||||
};
|
||||
|
||||
TQAxScriptEngine(const TQString &language, TQAxScript *script);
|
||||
~TQAxScriptEngine();
|
||||
|
||||
bool isValid() const;
|
||||
bool hasIntrospection() const;
|
||||
|
||||
TQString scriptLanguage() const;
|
||||
|
||||
State state() const;
|
||||
void setState(State st);
|
||||
|
||||
void addItem(const TQString &name);
|
||||
|
||||
long queryInterface( const TQUuid &, void** ) const;
|
||||
|
||||
protected:
|
||||
bool initialize(IUnknown** ptr);
|
||||
|
||||
private:
|
||||
TQAxScript *script_code;
|
||||
IActiveScript *engine;
|
||||
|
||||
TQString script_language;
|
||||
};
|
||||
|
||||
class TQAxScript : public TQObject
|
||||
{
|
||||
TQ_OBJECT
|
||||
|
||||
public:
|
||||
enum FunctionFlags {
|
||||
FunctionNames = 0,
|
||||
FunctionSignatures
|
||||
};
|
||||
|
||||
TQAxScript(const TQString &name, TQAxScriptManager *manager);
|
||||
~TQAxScript();
|
||||
|
||||
bool load(const TQString &code, const TQString &language = TQString::null);
|
||||
|
||||
TQStringList functions(FunctionFlags = FunctionNames) const;
|
||||
|
||||
TQString scriptCode() const;
|
||||
TQString scriptName() const;
|
||||
TQAxScriptEngine *scriptEngine() const;
|
||||
|
||||
TQVariant call(const TQString &function, const TQVariant &v1 = TQVariant(),
|
||||
const TQVariant &v2 = TQVariant(),
|
||||
const TQVariant &v3 = TQVariant(),
|
||||
const TQVariant &v4 = TQVariant(),
|
||||
const TQVariant &v5 = TQVariant(),
|
||||
const TQVariant &v6 = TQVariant(),
|
||||
const TQVariant &v7 = TQVariant(),
|
||||
const TQVariant &v8 = TQVariant());
|
||||
TQVariant call(const TQString &function, TQValueList<TQVariant> &arguments);
|
||||
|
||||
signals:
|
||||
void entered();
|
||||
void finished();
|
||||
void finished(const TQVariant &result);
|
||||
void finished(int code, const TQString &source,const TQString &description, const TQString &help);
|
||||
void stateChanged(int state);
|
||||
void error(int code, const TQString &description, int sourcePosition, const TQString &sourceText);
|
||||
|
||||
private:
|
||||
friend class TQAxScriptSite;
|
||||
friend class TQAxScriptEngine;
|
||||
|
||||
void updateObjects();
|
||||
TQAxBase *findObject(const TQString &name);
|
||||
|
||||
TQString script_name;
|
||||
TQString script_code;
|
||||
TQAxScriptManager *script_manager;
|
||||
TQAxScriptEngine *script_engine;
|
||||
TQAxScriptSite *script_site;
|
||||
};
|
||||
|
||||
class TQAxScriptManager : public TQObject
|
||||
{
|
||||
TQ_OBJECT
|
||||
|
||||
public:
|
||||
TQAxScriptManager( TQObject *parent = 0, const char *name = 0 );
|
||||
~TQAxScriptManager();
|
||||
|
||||
void addObject(TQAxBase *object);
|
||||
void addObject(TQObject *object);
|
||||
|
||||
TQStringList functions(TQAxScript::FunctionFlags = TQAxScript::FunctionNames) const;
|
||||
TQStringList scriptNames() const;
|
||||
TQAxScript *script(const TQString &name) const;
|
||||
|
||||
TQAxScript* load(const TQString &code, const TQString &name, const TQString &language);
|
||||
TQAxScript* load(const TQString &file, const TQString &name);
|
||||
|
||||
TQVariant call(const TQString &function, const TQVariant &v1 = TQVariant(),
|
||||
const TQVariant &v2 = TQVariant(),
|
||||
const TQVariant &v3 = TQVariant(),
|
||||
const TQVariant &v4 = TQVariant(),
|
||||
const TQVariant &v5 = TQVariant(),
|
||||
const TQVariant &v6 = TQVariant(),
|
||||
const TQVariant &v7 = TQVariant(),
|
||||
const TQVariant &v8 = TQVariant());
|
||||
TQVariant call(const TQString &function, TQValueList<TQVariant> &arguments);
|
||||
|
||||
static bool registerEngine(const TQString &name, const TQString &extension, const TQString &code = TQString());
|
||||
static TQString scriptFileFilter();
|
||||
|
||||
signals:
|
||||
void error(TQAxScript *script, int code, const TQString &description, int sourcePosition, const TQString &sourceText);
|
||||
|
||||
private slots:
|
||||
void objectDestroyed(TQObject *o);
|
||||
void scriptError(int code, const TQString &description, int sourcePosition, const TQString &sourceText);
|
||||
|
||||
private:
|
||||
friend class TQAxScript;
|
||||
TQAxScriptManagerPrivate *d;
|
||||
|
||||
void updateScript(TQAxScript*);
|
||||
TQAxScript *scriptForFunction(const TQString &function) const;
|
||||
};
|
||||
|
||||
|
||||
// TQAxScript inlines
|
||||
|
||||
inline TQString TQAxScript::scriptCode() const
|
||||
{
|
||||
return script_code;
|
||||
}
|
||||
|
||||
inline TQString TQAxScript::scriptName() const
|
||||
{
|
||||
return script_name;
|
||||
}
|
||||
|
||||
inline TQAxScriptEngine *TQAxScript::scriptEngine() const
|
||||
{
|
||||
return script_engine;
|
||||
}
|
||||
|
||||
// TQAxScriptEngine inlines
|
||||
|
||||
inline bool TQAxScriptEngine::isValid() const
|
||||
{
|
||||
return engine != 0;
|
||||
}
|
||||
|
||||
inline TQString TQAxScriptEngine::scriptLanguage() const
|
||||
{
|
||||
return script_language;
|
||||
}
|
||||
|
||||
// TQAxScriptManager inlines
|
||||
|
||||
inline void TQAxScriptManager::addObject(TQObject *object)
|
||||
{
|
||||
extern TQAxBase *qax_create_object_wrapper(TQObject*);
|
||||
TQAxBase *wrapper = qax_create_object_wrapper(object);
|
||||
addObject(wrapper);
|
||||
}
|
||||
|
||||
#endif // TQAXSCRIPT_H
|
||||
</pre>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,100 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qaxscript.h:78 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxScript Member List</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Complete Member List for TQAxScript</h1>
|
||||
|
||||
<p>This is the complete list of member functions for
|
||||
<a href="qaxscript.html">TQAxScript</a>, including inherited members.
|
||||
|
||||
<ul>
|
||||
<li><a href="qaxscript.html#TQAxScript">TQAxScript</a>()
|
||||
<li><a href="qaxscript.html#~TQAxScript">~TQAxScript</a>()
|
||||
<li><a href="tqobject.html#blockSignals">blockSignals</a>()
|
||||
<li><a href="qaxscript.html#call">call</a>()
|
||||
<li><a href="tqobject.html#checkConnectArgs">checkConnectArgs</a>()
|
||||
<li><a href="tqobject.html#child">child</a>()
|
||||
<li><a href="tqobject.html#childEvent">childEvent</a>()
|
||||
<li><a href="tqobject.html#children">children</a>()
|
||||
<li><a href="tqobject.html#className">className</a>()
|
||||
<li><a href="tqobject.html#connect">connect</a>()
|
||||
<li><a href="tqobject.html#connectNotify">connectNotify</a>()
|
||||
<li><a href="tqobject.html#customEvent">customEvent</a>()
|
||||
<li><a href="tqobject.html#deleteLater">deleteLater</a>()
|
||||
<li><a href="tqobject.html#destroyed">destroyed</a>()
|
||||
<li><a href="tqobject.html#disconnect">disconnect</a>()
|
||||
<li><a href="tqobject.html#disconnectNotify">disconnectNotify</a>()
|
||||
<li><a href="tqobject.html#dumpObjectInfo">dumpObjectInfo</a>()
|
||||
<li><a href="tqobject.html#dumpObjectTree">dumpObjectTree</a>()
|
||||
<li><a href="qaxscript.html#entered">entered</a>()
|
||||
<li><a href="qaxscript.html#error">error</a>()
|
||||
<li><a href="tqobject.html#event">event</a>()
|
||||
<li><a href="tqobject.html#eventFilter">eventFilter</a>()
|
||||
<li><a href="qaxscript.html#finished">finished</a>()
|
||||
<li><a href="qaxscript.html#functions">functions</a>()
|
||||
<li><a href="tqobject.html#highPriority">highPriority</a>()
|
||||
<li><a href="tqobject.html#inherits">inherits</a>()
|
||||
<li><a href="tqobject.html#insertChild">insertChild</a>()
|
||||
<li><a href="tqobject.html#installEventFilter">installEventFilter</a>()
|
||||
<li><a href="tqobject.html#isA">isA</a>()
|
||||
<li><a href="tqobject.html#isWidgetType">isWidgetType</a>()
|
||||
<li><a href="tqobject.html#killTimer">killTimer</a>()
|
||||
<li><a href="tqobject.html#killTimers">killTimers</a>()
|
||||
<li><a href="qaxscript.html#load">load</a>()
|
||||
<li><a href="tqobject.html#metaObject">metaObject</a>()
|
||||
<li><a href="tqobject.html#name">name</a>()
|
||||
<li><a href="tqobject.html#normalizeSignalSlot">normalizeSignalSlot</a>()
|
||||
<li><a href="tqobject.html#objectTrees">objectTrees</a>()
|
||||
<li><a href="tqobject.html#parent">parent</a>()
|
||||
<li><a href="tqobject.html#property">property</a>()
|
||||
<li><a href="tqobject.html#queryList">queryList</a>()
|
||||
<li><a href="tqobject.html#removeChild">removeChild</a>()
|
||||
<li><a href="tqobject.html#removeEventFilter">removeEventFilter</a>()
|
||||
<li><a href="qaxscript.html#scriptCode">scriptCode</a>()
|
||||
<li><a href="qaxscript.html#scriptEngine">scriptEngine</a>()
|
||||
<li><a href="qaxscript.html#scriptName">scriptName</a>()
|
||||
<li><a href="tqobject.html#sender">sender</a>()
|
||||
<li><a href="tqobject.html#setName">setName</a>()
|
||||
<li><a href="tqobject.html#setProperty">setProperty</a>()
|
||||
<li><a href="tqobject.html#signalsBlocked">signalsBlocked</a>()
|
||||
<li><a href="tqobject.html#startTimer">startTimer</a>()
|
||||
<li><a href="qaxscript.html#stateChanged">stateChanged</a>()
|
||||
<li><a href="tqobject.html#timerEvent">timerEvent</a>()
|
||||
<li><a href="tqobject.html#tr">tr</a>()
|
||||
<li><a href="tqobject.html#trUtf8">trUtf8</a>()
|
||||
</ul>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,199 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/container/qaxscript.cpp:593 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxScript Class</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQAxScript Class Reference<br><small>[<a href="qaxcontainer.html">TQAxContainer module</a>]</small></h1>
|
||||
|
||||
<p>The TQAxScript class provides a wrapper around script code.
|
||||
<a href="#details">More...</a>
|
||||
<p>This class is part of the <b>TQt ActiveTQt Extension</b>.
|
||||
<p><tt>#include <<a href="qaxscript-h.html">qaxscript.h</a>></tt>
|
||||
<p>Inherits <a href="tqobject.html">TQObject</a>.
|
||||
<p><a href="qaxscript-members.html">List of all member functions.</a>
|
||||
<h2>Public Members</h2>
|
||||
<ul>
|
||||
<li class=fn>enum <a href="#FunctionFlags-enum"><b>FunctionFlags</b></a> { FunctionNames = 0, FunctionSignatures }</li>
|
||||
<li class=fn><a href="#TQAxScript"><b>TQAxScript</b></a> ( const TQString & name, TQAxScriptManager * manager )</li>
|
||||
<li class=fn><a href="#~TQAxScript"><b>~TQAxScript</b></a> ()</li>
|
||||
<li class=fn>bool <a href="#load"><b>load</b></a> ( const TQString & code, const TQString & language = TQString::null )</li>
|
||||
<li class=fn>TQStringList <a href="#functions"><b>functions</b></a> ( FunctionFlags flags = FunctionNames ) const</li>
|
||||
<li class=fn>TQString <a href="#scriptCode"><b>scriptCode</b></a> () const</li>
|
||||
<li class=fn>TQString <a href="#scriptName"><b>scriptName</b></a> () const</li>
|
||||
<li class=fn>TQAxScriptEngine * <a href="#scriptEngine"><b>scriptEngine</b></a> () const</li>
|
||||
<li class=fn>TQVariant <a href="#call"><b>call</b></a> ( const TQString & function, const TQVariant & var1 = TQVariant ( ), const TQVariant & var2 = TQVariant ( ), const TQVariant & var3 = TQVariant ( ), const TQVariant & var4 = TQVariant ( ), const TQVariant & var5 = TQVariant ( ), const TQVariant & var6 = TQVariant ( ), const TQVariant & var7 = TQVariant ( ), const TQVariant & var8 = TQVariant ( ) )</li>
|
||||
<li class=fn>TQVariant <a href="#call-2"><b>call</b></a> ( const TQString & function, TQValueList<TQVariant> & arguments )</li>
|
||||
</ul>
|
||||
<h2>Signals</h2>
|
||||
<ul>
|
||||
<li class=fn>void <a href="#entered"><b>entered</b></a> ()</li>
|
||||
<li class=fn>void <a href="#finished"><b>finished</b></a> ()</li>
|
||||
<li class=fn>void <a href="#finished-2"><b>finished</b></a> ( const TQVariant & result )</li>
|
||||
<li class=fn>void <a href="#finished-3"><b>finished</b></a> ( int code, const TQString & source, const TQString & description, const TQString & help )</li>
|
||||
<li class=fn>void <a href="#stateChanged"><b>stateChanged</b></a> ( int state )</li>
|
||||
<li class=fn>void <a href="#error"><b>error</b></a> ( int code, const TQString & description, int sourcePosition, const TQString & sourceText )</li>
|
||||
</ul>
|
||||
<hr><a name="details"></a><h2>Detailed Description</h2>
|
||||
<p> This class is defined in the <b>TQt <a href="activentqt.html#ActiveTQt">ActiveTQt</a> Extension</b>, which can be found in the <tt>qt/extensions</tt> directory. It is not included in the main TQt API.
|
||||
<p>
|
||||
|
||||
The TQAxScript class provides a wrapper around script code.
|
||||
|
||||
|
||||
<p> Every instance of the TQAxScript class represents a piece of
|
||||
scripting code in a particular scripting language. The code is
|
||||
loaded into the script engine using <a href="#load">load</a>(). Functions declared
|
||||
in the code can be called using <a href="#call">call</a>().
|
||||
<p> The script provides <a href="#scriptEngine">scriptEngine</a>() provides feedback to the
|
||||
application through signals. The most important signal is the
|
||||
<a href="#error">error</a>() signal. Direct access to the <a href="qaxscriptengine.html">TQAxScriptEngine</a> is provided
|
||||
through the scriptEngine() function.
|
||||
<p> <b>Warning:</b> This class is not available with the bcc5.5 and MingW
|
||||
compilers.
|
||||
|
||||
<hr><h2>Member Type Documentation</h2>
|
||||
<h3 class=fn><a name="FunctionFlags-enum"></a>TQAxScript::FunctionFlags</h3>
|
||||
|
||||
<p> This FunctionFlags enum describes formatting for function introspection.
|
||||
<ul>
|
||||
<li><tt>TQAxScript::FunctionNames</tt> - Only function names are returned.
|
||||
<li><tt>TQAxScript::FunctionSignatures</tt> - Returns the functions with signatures.
|
||||
</ul>
|
||||
<hr><h2>Member Function Documentation</h2>
|
||||
<h3 class=fn><a name="TQAxScript"></a>TQAxScript::TQAxScript ( const <a href="tqstring.html">TQString</a> & name, <a href="qaxscriptmanager.html">TQAxScriptManager</a> * manager )
|
||||
</h3>
|
||||
Constructs a TQAxScript object called <em>name</em> and registers
|
||||
it with the <a href="qaxscriptmanager.html">TQAxScriptManager</a> <em>manager</em>. This is usually done by the
|
||||
TQAxScriptManager class when <a href="qaxscriptmanager.html#load">loading a
|
||||
script</a>.
|
||||
<p> A script should always have a name. A manager is necessary to allow
|
||||
the script code to reference objects in the application. The <em>manager</em>
|
||||
takes ownership of the object.
|
||||
|
||||
<h3 class=fn><a name="~TQAxScript"></a>TQAxScript::~TQAxScript ()
|
||||
</h3>
|
||||
Destroys the object, releasing all allocated resources.
|
||||
|
||||
<h3 class=fn><a href="ntqvariant.html">TQVariant</a> <a name="call"></a>TQAxScript::call ( const <a href="tqstring.html">TQString</a> & function, const <a href="ntqvariant.html">TQVariant</a> & var1 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var2 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var3 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var4 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var5 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var6 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var7 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var8 = TQVariant ( ) )
|
||||
</h3>
|
||||
Calls <em>function</em>, passing the parameters <em>var1</em>, <em>var1</em>,
|
||||
<em>var2</em>, <em>var3</em>, <em>var4</em>, <em>var5</em>, <em>var6</em>, <em>var7</em> and <em>var8</em>
|
||||
as arguments and returns the value returned by the function, or an
|
||||
invalid <a href="ntqvariant.html">TQVariant</a> if the function does not return a value or when
|
||||
the function call failed.
|
||||
<p> See <a href="qaxscriptmanager.html#call">TQAxScriptManager::call</a>() for more information about how to call
|
||||
script functions.
|
||||
|
||||
<h3 class=fn><a href="ntqvariant.html">TQVariant</a> <a name="call-2"></a>TQAxScript::call ( const <a href="tqstring.html">TQString</a> & function, <a href="tqvaluelist.html">TQValueList</a><TQVariant> & arguments )
|
||||
</h3>
|
||||
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
<p> Calls <em>function</em> passing <em>arguments</em> as parameters, and returns
|
||||
the result. Returns when the script's execution has finished.
|
||||
<p> See <a href="qaxscriptmanager.html#call">TQAxScriptManager::call</a>() for more information about how to call
|
||||
script functions.
|
||||
|
||||
<h3 class=fn>void <a name="entered"></a>TQAxScript::entered ()<tt> [signal]</tt>
|
||||
</h3>
|
||||
<p> This signal is emitted when a script engine has started executing code.
|
||||
|
||||
<h3 class=fn>void <a name="error"></a>TQAxScript::error ( int code, const <a href="tqstring.html">TQString</a> & description, int sourcePosition, const <a href="tqstring.html">TQString</a> & sourceText )<tt> [signal]</tt>
|
||||
</h3>
|
||||
|
||||
<p> This signal is emitted when an execution error occured while
|
||||
running a script.
|
||||
<p> <em>code</em>, <em>description</em>, <em>sourcePosition</em> and <em>sourceText</em>
|
||||
contain information about the execution error.
|
||||
|
||||
<h3 class=fn>void <a name="finished"></a>TQAxScript::finished ()<tt> [signal]</tt>
|
||||
</h3>
|
||||
<p> This signal is emitted when a script engine has finished executing code.
|
||||
|
||||
<h3 class=fn>void <a name="finished-2"></a>TQAxScript::finished ( const <a href="ntqvariant.html">TQVariant</a> & result )<tt> [signal]</tt>
|
||||
</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
<p> <em>result</em> contains the script's result. This will be an invalid
|
||||
<a href="ntqvariant.html">TQVariant</a> if the script has no return value.
|
||||
|
||||
<h3 class=fn>void <a name="finished-3"></a>TQAxScript::finished ( int code, const <a href="tqstring.html">TQString</a> & source, const <a href="tqstring.html">TQString</a> & description, const <a href="tqstring.html">TQString</a> & help )<tt> [signal]</tt>
|
||||
</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
<p> <em>code</em>, <em>source</em>, <em>description</em> and <em>help</em> contain exception information
|
||||
when the script terminated.
|
||||
|
||||
<h3 class=fn><a href="tqstringlist.html">TQStringList</a> <a name="functions"></a>TQAxScript::functions ( <a href="qaxscript.html#FunctionFlags-enum">FunctionFlags</a> flags = FunctionNames ) const
|
||||
</h3>
|
||||
Returns a list of all the functions in this script if the respective
|
||||
script engine supports introspection; otherwise returns an empty list.
|
||||
The functions are either provided with full prototypes or only as
|
||||
names, depending on the value of <em>flags</em>.
|
||||
<p> <p>See also <a href="qaxscriptengine.html#hasIntrospection">TQAxScriptEngine::hasIntrospection</a>().
|
||||
|
||||
<h3 class=fn>bool <a name="load"></a>TQAxScript::load ( const <a href="tqstring.html">TQString</a> & code, const <a href="tqstring.html">TQString</a> & language = TQString::null )
|
||||
</h3>
|
||||
Loads the script source <em>code</em> written in language <em>language</em>
|
||||
into the script engine. Returns TRUE if <em>code</em> was successfully
|
||||
entered into the script engine; otherwise returns FALSE.
|
||||
<p> If <em>language</em> is empty (the default) it will be determined
|
||||
heuristically. If <em>code</em> contains the string <tt>End Sub</tt> it will
|
||||
be interpreted as VBScript, otherwise as JScript. Additional
|
||||
scripting languages can be registered using
|
||||
TQAxScript::registerEngine().
|
||||
<p> This function can only be called once for each TQAxScript object,
|
||||
which is done automatically when using <a href="qaxscriptmanager.html#load">TQAxScriptManager::load</a>().
|
||||
|
||||
<h3 class=fn><a href="tqstring.html">TQString</a> <a name="scriptCode"></a>TQAxScript::scriptCode () const
|
||||
</h3>
|
||||
Returns the script's code, or the null-string if no
|
||||
code has been loaded yet.
|
||||
<p> <p>See also <a href="#load">load</a>().
|
||||
|
||||
<h3 class=fn><a href="qaxscriptengine.html">TQAxScriptEngine</a> * <a name="scriptEngine"></a>TQAxScript::scriptEngine () const
|
||||
</h3>
|
||||
Returns a pointer to the script engine.
|
||||
<p> You can use the object returned to connect signals to the
|
||||
script functions, or to access the script engine directly.
|
||||
|
||||
<h3 class=fn><a href="tqstring.html">TQString</a> <a name="scriptName"></a>TQAxScript::scriptName () const
|
||||
</h3>
|
||||
Returns the name of the script.
|
||||
|
||||
<h3 class=fn>void <a name="stateChanged"></a>TQAxScript::stateChanged ( int state )<tt> [signal]</tt>
|
||||
</h3>
|
||||
<p> This signal is emitted when a script engine changes state.
|
||||
<em>state</em> can be any value in the TQAxScriptEngineState enumeration.
|
||||
|
||||
<!-- eof -->
|
||||
<hr><p>
|
||||
This file is part of the <a href="index.html">TQt toolkit</a>.
|
||||
Copyright © 1995-2007
|
||||
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,119 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qaxscript.h:41 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxScriptEngine Member List</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Complete Member List for TQAxScriptEngine</h1>
|
||||
|
||||
<p>This is the complete list of member functions for
|
||||
<a href="qaxscriptengine.html">TQAxScriptEngine</a>, including inherited members.
|
||||
|
||||
<ul>
|
||||
<li><a href="qaxscriptengine.html#TQAxScriptEngine">TQAxScriptEngine</a>()
|
||||
<li><a href="qaxscriptengine.html#~TQAxScriptEngine">~TQAxScriptEngine</a>()
|
||||
<li><a href="qaxscriptengine.html#addItem">addItem</a>()
|
||||
<li><a href="qaxbase.html#asVariant">asVariant</a>()
|
||||
<li><a href="tqobject.html#blockSignals">blockSignals</a>()
|
||||
<li><a href="tqobject.html#checkConnectArgs">checkConnectArgs</a>()
|
||||
<li><a href="tqobject.html#child">child</a>()
|
||||
<li><a href="tqobject.html#childEvent">childEvent</a>()
|
||||
<li><a href="tqobject.html#children">children</a>()
|
||||
<li><a href="tqobject.html#className">className</a>()
|
||||
<li><a href="qaxbase.html#clear">clear</a>()
|
||||
<li><a href="tqobject.html#connect">connect</a>()
|
||||
<li><a href="tqobject.html#connectNotify">connectNotify</a>()
|
||||
<li><a href="qaxbase.html#control">control</a>()
|
||||
<li><a href="tqobject.html#customEvent">customEvent</a>()
|
||||
<li><a href="tqobject.html#deleteLater">deleteLater</a>()
|
||||
<li><a href="tqobject.html#destroyed">destroyed</a>()
|
||||
<li><a href="qaxbase.html#disableClassInfo">disableClassInfo</a>()
|
||||
<li><a href="qaxbase.html#disableEventSink">disableEventSink</a>()
|
||||
<li><a href="qaxbase.html#disableMetaObject">disableMetaObject</a>()
|
||||
<li><a href="tqobject.html#disconnect">disconnect</a>()
|
||||
<li><a href="tqobject.html#disconnectNotify">disconnectNotify</a>()
|
||||
<li><a href="tqobject.html#dumpObjectInfo">dumpObjectInfo</a>()
|
||||
<li><a href="tqobject.html#dumpObjectTree">dumpObjectTree</a>()
|
||||
<li><a href="qaxbase.html#dynamicCall">dynamicCall</a>()
|
||||
<li><a href="tqobject.html#event">event</a>()
|
||||
<li><a href="tqobject.html#eventFilter">eventFilter</a>()
|
||||
<li><a href="qaxbase.html#exception">exception</a>()
|
||||
<li><a href="qaxbase.html#generateDocumentation">generateDocumentation</a>()
|
||||
<li><a href="qaxscriptengine.html#hasIntrospection">hasIntrospection</a>()
|
||||
<li><a href="tqobject.html#highPriority">highPriority</a>()
|
||||
<li><a href="tqobject.html#inherits">inherits</a>()
|
||||
<li><a href="qaxbase.html#initialize">initialize</a>()
|
||||
<li><a href="qaxbase.html#initializeActive">initializeActive</a>()
|
||||
<li><a href="qaxbase.html#initializeLicensed">initializeLicensed</a>()
|
||||
<li><a href="qaxbase.html#initializeRemote">initializeRemote</a>()
|
||||
<li><a href="tqobject.html#insertChild">insertChild</a>()
|
||||
<li><a href="tqobject.html#installEventFilter">installEventFilter</a>()
|
||||
<li><a href="tqobject.html#isA">isA</a>()
|
||||
<li><a href="qaxbase.html#isNull">isNull</a>()
|
||||
<li><a href="qaxscriptengine.html#isValid">isValid</a>()
|
||||
<li><a href="tqobject.html#isWidgetType">isWidgetType</a>()
|
||||
<li><a href="tqobject.html#killTimer">killTimer</a>()
|
||||
<li><a href="tqobject.html#killTimers">killTimers</a>()
|
||||
<li><a href="tqobject.html#metaObject">metaObject</a>()
|
||||
<li><a href="tqobject.html#name">name</a>()
|
||||
<li><a href="tqobject.html#normalizeSignalSlot">normalizeSignalSlot</a>()
|
||||
<li><a href="tqobject.html#objectTrees">objectTrees</a>()
|
||||
<li><a href="tqobject.html#parent">parent</a>()
|
||||
<li><a href="tqobject.html#property">property</a>()
|
||||
<li><a href="qaxbase.html#propertyBag">propertyBag</a>()
|
||||
<li><a href="qaxbase.html#propertyChanged">propertyChanged</a>()
|
||||
<li><a href="qaxbase.html#propertyWritable">propertyWritable</a>()
|
||||
<li><a href="qaxscriptengine.html#queryInterface">queryInterface</a>()
|
||||
<li><a href="tqobject.html#queryList">queryList</a>()
|
||||
<li><a href="qaxbase.html#querySubObject">querySubObject</a>()
|
||||
<li><a href="tqobject.html#removeChild">removeChild</a>()
|
||||
<li><a href="tqobject.html#removeEventFilter">removeEventFilter</a>()
|
||||
<li><a href="qaxscriptengine.html#scriptLanguage">scriptLanguage</a>()
|
||||
<li><a href="tqobject.html#sender">sender</a>()
|
||||
<li><a href="qaxbase.html#setControl">setControl</a>()
|
||||
<li><a href="tqobject.html#setName">setName</a>()
|
||||
<li><a href="tqobject.html#setProperty">setProperty</a>()
|
||||
<li><a href="qaxbase.html#setPropertyBag">setPropertyBag</a>()
|
||||
<li><a href="qaxbase.html#setPropertyWritable">setPropertyWritable</a>()
|
||||
<li><a href="qaxscriptengine.html#setState">setState</a>()
|
||||
<li><a href="qaxbase.html#signal">signal</a>()
|
||||
<li><a href="tqobject.html#signalsBlocked">signalsBlocked</a>()
|
||||
<li><a href="tqobject.html#startTimer">startTimer</a>()
|
||||
<li><a href="qaxscriptengine.html#state">state</a>()
|
||||
<li><a href="tqobject.html#timerEvent">timerEvent</a>()
|
||||
<li><a href="tqobject.html#tr">tr</a>()
|
||||
<li><a href="tqobject.html#trUtf8">trUtf8</a>()
|
||||
</ul>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,146 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/container/qaxscript.cpp:360 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxScriptEngine Class</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQAxScriptEngine Class Reference<br><small>[<a href="qaxcontainer.html">TQAxContainer module</a>]</small></h1>
|
||||
|
||||
<p>The TQAxScriptEngine class provides a wrapper around a script engine.
|
||||
<a href="#details">More...</a>
|
||||
<p>This class is part of the <b>TQt ActiveTQt Extension</b>.
|
||||
<p><tt>#include <<a href="qaxscript-h.html">qaxscript.h</a>></tt>
|
||||
<p>Inherits <a href="qaxobject.html">TQAxObject</a>.
|
||||
<p><a href="qaxscriptengine-members.html">List of all member functions.</a>
|
||||
<h2>Public Members</h2>
|
||||
<ul>
|
||||
<li class=fn>enum <a href="#State-enum"><b>State</b></a> { Uninitialized = 0, Initialized = 5, Started = 1, Connected = 2, Disconnected = 3, Closed = 4 }</li>
|
||||
<li class=fn><a href="#TQAxScriptEngine"><b>TQAxScriptEngine</b></a> ( const TQString & language, TQAxScript * script )</li>
|
||||
<li class=fn><a href="#~TQAxScriptEngine"><b>~TQAxScriptEngine</b></a> ()</li>
|
||||
<li class=fn>bool <a href="#isValid"><b>isValid</b></a> () const</li>
|
||||
<li class=fn>bool <a href="#hasIntrospection"><b>hasIntrospection</b></a> () const</li>
|
||||
<li class=fn>TQString <a href="#scriptLanguage"><b>scriptLanguage</b></a> () const</li>
|
||||
<li class=fn>State <a href="#state"><b>state</b></a> () const</li>
|
||||
<li class=fn>void <a href="#setState"><b>setState</b></a> ( State st )</li>
|
||||
<li class=fn>void <a href="#addItem"><b>addItem</b></a> ( const TQString & name )</li>
|
||||
<li class=fn>long <a href="#queryInterface"><b>queryInterface</b></a> ( const TQUuid & uuid, void ** iface ) const</li>
|
||||
</ul>
|
||||
<hr><a name="details"></a><h2>Detailed Description</h2>
|
||||
<p> This class is defined in the <b>TQt <a href="activentqt.html#ActiveTQt">ActiveTQt</a> Extension</b>, which can be found in the <tt>qt/extensions</tt> directory. It is not included in the main TQt API.
|
||||
<p>
|
||||
|
||||
The TQAxScriptEngine class provides a wrapper around a script engine.
|
||||
|
||||
|
||||
<p> Every instance of the TQAxScriptEngine class represents an interpreter
|
||||
for script code in a particular scripting language. The class is usually
|
||||
not used directly. The <a href="qaxscript.html">TQAxScript</a> and <a href="qaxscriptmanager.html">TQAxScriptManager</a> classes provide
|
||||
convenient functions to handle and call script code.
|
||||
<p> Direct access to the script engine is provided through
|
||||
<a href="#queryInterface">queryInterface</a>().
|
||||
<p> <b>Warning:</b> This class is not available with the bcc5.5 and MingW
|
||||
compilers.
|
||||
|
||||
<hr><h2>Member Type Documentation</h2>
|
||||
<h3 class=fn><a name="State-enum"></a>TQAxScriptEngine::State</h3>
|
||||
|
||||
<p> The State enumeration defines the different states a script
|
||||
engine can be in.
|
||||
<ul>
|
||||
<li><tt>TQAxScriptEngine::Uninitialized</tt> - The script has been created, but not yet initialized
|
||||
<li><tt>TQAxScriptEngine::Initialized</tt> - The script has been initialized, but is not running
|
||||
<li><tt>TQAxScriptEngine::Started</tt> - The script can execute code, but does not yet handle events
|
||||
<li><tt>TQAxScriptEngine::Connected</tt> - The script can execute code and is connected so
|
||||
that it can handle events
|
||||
<li><tt>TQAxScriptEngine::Disconnected</tt> - The script is loaded, but is not connected to
|
||||
event sources
|
||||
<li><tt>TQAxScriptEngine::Closed</tt> - The script has been closed.
|
||||
</ul>
|
||||
<hr><h2>Member Function Documentation</h2>
|
||||
<h3 class=fn><a name="TQAxScriptEngine"></a>TQAxScriptEngine::TQAxScriptEngine ( const <a href="tqstring.html">TQString</a> & language, <a href="qaxscript.html">TQAxScript</a> * script )
|
||||
</h3>
|
||||
Constructs a TQAxScriptEngine object interpreting script code in <em>language</em>
|
||||
provided by the code in <em>script</em>. This is usually done by the <a href="qaxscript.html">TQAxScript</a>
|
||||
class when <a href="qaxscript.html#load">loading a script</a>.
|
||||
<p> Instances of TQAxScriptEngine should always have both a language and a
|
||||
script.
|
||||
|
||||
<h3 class=fn><a name="~TQAxScriptEngine"></a>TQAxScriptEngine::~TQAxScriptEngine ()
|
||||
</h3>
|
||||
Destroys the TQAxScriptEngine object, releasing all allocated
|
||||
resources.
|
||||
|
||||
<h3 class=fn>void <a name="addItem"></a>TQAxScriptEngine::addItem ( const <a href="tqstring.html">TQString</a> & name )
|
||||
</h3>
|
||||
Registers an item with the script engine. Script code can
|
||||
refer to this item using <em>name</em>.
|
||||
|
||||
<h3 class=fn>bool <a name="hasIntrospection"></a>TQAxScriptEngine::hasIntrospection () const
|
||||
</h3>
|
||||
Returns TRUE if the script engine supports introspection;
|
||||
otherwise returns FALSE.
|
||||
|
||||
<h3 class=fn>bool <a name="isValid"></a>TQAxScriptEngine::isValid () const
|
||||
</h3>
|
||||
|
||||
<p> Returns TRUE if the script engine has been initialized
|
||||
correctly; otherwise returns FALSE.
|
||||
|
||||
<h3 class=fn>long <a name="queryInterface"></a>TQAxScriptEngine::queryInterface ( const <a href="ntquuid.html">TQUuid</a> & uuid, void ** iface ) const
|
||||
</h3>
|
||||
Requests the interface <em>uuid</em> from the script engine object and
|
||||
sets the value of <em>iface</em> to the provided interface, or to 0 if
|
||||
the requested interface could not be provided.
|
||||
<p> Returns the result of the QueryInterface implementation of the COM
|
||||
object.
|
||||
|
||||
<h3 class=fn><a href="tqstring.html">TQString</a> <a name="scriptLanguage"></a>TQAxScriptEngine::scriptLanguage () const
|
||||
</h3>
|
||||
Returns the scripting language, for example "VBScript",
|
||||
or "JScript".
|
||||
|
||||
<h3 class=fn>void <a name="setState"></a>TQAxScriptEngine::setState ( <a href="qaxscriptengine.html#State-enum">State</a> st )
|
||||
</h3>
|
||||
Sets the state of the script engine to <em>st</em>.
|
||||
Calling this function is usually not necessary.
|
||||
|
||||
<h3 class=fn><a href="qaxscriptengine.html#State-enum">State</a> <a name="state"></a>TQAxScriptEngine::state () const
|
||||
</h3>
|
||||
Returns the state of the script engine.
|
||||
|
||||
<!-- eof -->
|
||||
<hr><p>
|
||||
This file is part of the <a href="index.html">TQt toolkit</a>.
|
||||
Copyright © 1995-2007
|
||||
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,99 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qaxscript.h:131 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxScriptManager Member List</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Complete Member List for TQAxScriptManager</h1>
|
||||
|
||||
<p>This is the complete list of member functions for
|
||||
<a href="qaxscriptmanager.html">TQAxScriptManager</a>, including inherited members.
|
||||
|
||||
<ul>
|
||||
<li><a href="qaxscriptmanager.html#TQAxScriptManager">TQAxScriptManager</a>()
|
||||
<li><a href="qaxscriptmanager.html#~TQAxScriptManager">~TQAxScriptManager</a>()
|
||||
<li><a href="qaxscriptmanager.html#addObject">addObject</a>()
|
||||
<li><a href="tqobject.html#blockSignals">blockSignals</a>()
|
||||
<li><a href="qaxscriptmanager.html#call">call</a>()
|
||||
<li><a href="tqobject.html#checkConnectArgs">checkConnectArgs</a>()
|
||||
<li><a href="tqobject.html#child">child</a>()
|
||||
<li><a href="tqobject.html#childEvent">childEvent</a>()
|
||||
<li><a href="tqobject.html#children">children</a>()
|
||||
<li><a href="tqobject.html#className">className</a>()
|
||||
<li><a href="tqobject.html#connect">connect</a>()
|
||||
<li><a href="tqobject.html#connectNotify">connectNotify</a>()
|
||||
<li><a href="tqobject.html#customEvent">customEvent</a>()
|
||||
<li><a href="tqobject.html#deleteLater">deleteLater</a>()
|
||||
<li><a href="tqobject.html#destroyed">destroyed</a>()
|
||||
<li><a href="tqobject.html#disconnect">disconnect</a>()
|
||||
<li><a href="tqobject.html#disconnectNotify">disconnectNotify</a>()
|
||||
<li><a href="tqobject.html#dumpObjectInfo">dumpObjectInfo</a>()
|
||||
<li><a href="tqobject.html#dumpObjectTree">dumpObjectTree</a>()
|
||||
<li><a href="qaxscriptmanager.html#error">error</a>()
|
||||
<li><a href="tqobject.html#event">event</a>()
|
||||
<li><a href="tqobject.html#eventFilter">eventFilter</a>()
|
||||
<li><a href="qaxscriptmanager.html#functions">functions</a>()
|
||||
<li><a href="tqobject.html#highPriority">highPriority</a>()
|
||||
<li><a href="tqobject.html#inherits">inherits</a>()
|
||||
<li><a href="tqobject.html#insertChild">insertChild</a>()
|
||||
<li><a href="tqobject.html#installEventFilter">installEventFilter</a>()
|
||||
<li><a href="tqobject.html#isA">isA</a>()
|
||||
<li><a href="tqobject.html#isWidgetType">isWidgetType</a>()
|
||||
<li><a href="tqobject.html#killTimer">killTimer</a>()
|
||||
<li><a href="tqobject.html#killTimers">killTimers</a>()
|
||||
<li><a href="qaxscriptmanager.html#load">load</a>()
|
||||
<li><a href="tqobject.html#metaObject">metaObject</a>()
|
||||
<li><a href="tqobject.html#name">name</a>()
|
||||
<li><a href="tqobject.html#normalizeSignalSlot">normalizeSignalSlot</a>()
|
||||
<li><a href="tqobject.html#objectTrees">objectTrees</a>()
|
||||
<li><a href="tqobject.html#parent">parent</a>()
|
||||
<li><a href="tqobject.html#property">property</a>()
|
||||
<li><a href="tqobject.html#queryList">queryList</a>()
|
||||
<li><a href="qaxscriptmanager.html#registerEngine">registerEngine</a>()
|
||||
<li><a href="tqobject.html#removeChild">removeChild</a>()
|
||||
<li><a href="tqobject.html#removeEventFilter">removeEventFilter</a>()
|
||||
<li><a href="qaxscriptmanager.html#script">script</a>()
|
||||
<li><a href="qaxscriptmanager.html#scriptFileFilter">scriptFileFilter</a>()
|
||||
<li><a href="qaxscriptmanager.html#scriptNames">scriptNames</a>()
|
||||
<li><a href="tqobject.html#sender">sender</a>()
|
||||
<li><a href="tqobject.html#setName">setName</a>()
|
||||
<li><a href="tqobject.html#setProperty">setProperty</a>()
|
||||
<li><a href="tqobject.html#signalsBlocked">signalsBlocked</a>()
|
||||
<li><a href="tqobject.html#startTimer">startTimer</a>()
|
||||
<li><a href="tqobject.html#timerEvent">timerEvent</a>()
|
||||
<li><a href="tqobject.html#tr">tr</a>()
|
||||
<li><a href="tqobject.html#trUtf8">trUtf8</a>()
|
||||
</ul>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,230 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/container/qaxscript.cpp:867 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxScriptManager Class</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQAxScriptManager Class Reference<br><small>[<a href="qaxcontainer.html">TQAxContainer module</a>]</small></h1>
|
||||
|
||||
<p>The TQAxScriptManager class provides a bridge between application objects
|
||||
and script code.
|
||||
<a href="#details">More...</a>
|
||||
<p>This class is part of the <b>TQt ActiveTQt Extension</b>.
|
||||
<p><tt>#include <<a href="qaxscript-h.html">qaxscript.h</a>></tt>
|
||||
<p>Inherits <a href="tqobject.html">TQObject</a>.
|
||||
<p><a href="qaxscriptmanager-members.html">List of all member functions.</a>
|
||||
<h2>Public Members</h2>
|
||||
<ul>
|
||||
<li class=fn><a href="#TQAxScriptManager"><b>TQAxScriptManager</b></a> ( TQObject * parent = 0, const char * name = 0 )</li>
|
||||
<li class=fn><a href="#~TQAxScriptManager"><b>~TQAxScriptManager</b></a> ()</li>
|
||||
<li class=fn>void <a href="#addObject"><b>addObject</b></a> ( TQAxBase * object )</li>
|
||||
<li class=fn>void <a href="#addObject-2"><b>addObject</b></a> ( TQObject * object )</li>
|
||||
<li class=fn>TQStringList <a href="#functions"><b>functions</b></a> ( TQAxScript::FunctionFlags flags = TQAxScript::FunctionNames ) const</li>
|
||||
<li class=fn>TQStringList <a href="#scriptNames"><b>scriptNames</b></a> () const</li>
|
||||
<li class=fn>TQAxScript * <a href="#script"><b>script</b></a> ( const TQString & name ) const</li>
|
||||
<li class=fn>TQAxScript * <a href="#load"><b>load</b></a> ( const TQString & code, const TQString & name, const TQString & language )</li>
|
||||
<li class=fn>TQAxScript * <a href="#load-2"><b>load</b></a> ( const TQString & file, const TQString & name )</li>
|
||||
<li class=fn>TQVariant <a href="#call"><b>call</b></a> ( const TQString & function, const TQVariant & var1 = TQVariant ( ), const TQVariant & var2 = TQVariant ( ), const TQVariant & var3 = TQVariant ( ), const TQVariant & var4 = TQVariant ( ), const TQVariant & var5 = TQVariant ( ), const TQVariant & var6 = TQVariant ( ), const TQVariant & var7 = TQVariant ( ), const TQVariant & var8 = TQVariant ( ) )</li>
|
||||
<li class=fn>TQVariant <a href="#call-2"><b>call</b></a> ( const TQString & function, TQValueList<TQVariant> & arguments )</li>
|
||||
</ul>
|
||||
<h2>Signals</h2>
|
||||
<ul>
|
||||
<li class=fn>void <a href="#error"><b>error</b></a> ( TQAxScript * script, int code, const TQString & description, int sourcePosition, const TQString & sourceText )</li>
|
||||
</ul>
|
||||
<h2>Static Public Members</h2>
|
||||
<ul>
|
||||
<li class=fn>bool <a href="#registerEngine"><b>registerEngine</b></a> ( const TQString & name, const TQString & extension, const TQString & code = TQString ( ) )</li>
|
||||
<li class=fn>TQString <a href="#scriptFileFilter"><b>scriptFileFilter</b></a> ()</li>
|
||||
</ul>
|
||||
<hr><a name="details"></a><h2>Detailed Description</h2>
|
||||
<p> This class is defined in the <b>TQt <a href="activentqt.html#ActiveTQt">ActiveTQt</a> Extension</b>, which can be found in the <tt>qt/extensions</tt> directory. It is not included in the main TQt API.
|
||||
<p>
|
||||
|
||||
The TQAxScriptManager class provides a bridge between application objects
|
||||
and script code.
|
||||
|
||||
|
||||
<p> The TQAxScriptManager acts as a bridge between the COM objects embedded
|
||||
in the TQt application through <a href="qaxobject.html">TQAxObject</a> or <a href="qaxwidget.html">TQAxWidget</a>, and the scripting
|
||||
languages available through the Windows Script technologies, usually JScript
|
||||
and VBScript.
|
||||
<p> Create one TQAxScriptManager for each separate document in your
|
||||
application, and add the COM objects the scripts need to access
|
||||
using <a href="#addObject">addObject</a>(). Then <a href="#load">load</a>() the script sources and invoke the
|
||||
functions using <a href="#call">call</a>().
|
||||
<p> <b>Warning:</b> This class is not available with the bcc5.5 and MingW
|
||||
compilers.
|
||||
|
||||
<hr><h2>Member Function Documentation</h2>
|
||||
<h3 class=fn><a name="TQAxScriptManager"></a>TQAxScriptManager::TQAxScriptManager ( <a href="tqobject.html">TQObject</a> * parent = 0, const char * name = 0 )
|
||||
</h3>
|
||||
Creates a TQAxScriptManager object. <em>parent</em> and <em>name</em> are passed
|
||||
on to the <a href="tqobject.html">TQObject</a> constructor.
|
||||
<p> It is usual to create one TQAxScriptManager for each document in an
|
||||
application.
|
||||
|
||||
<h3 class=fn><a name="~TQAxScriptManager"></a>TQAxScriptManager::~TQAxScriptManager ()
|
||||
</h3>
|
||||
Destroys the objects, releasing all allocated resources.
|
||||
|
||||
<h3 class=fn>void <a name="addObject"></a>TQAxScriptManager::addObject ( <a href="qaxbase.html">TQAxBase</a> * object )
|
||||
</h3>
|
||||
Adds <em>object</em> to the manager. Scripts handled by this
|
||||
manager can access the object in the code using the object's <a href="tqobject.html#name-prop">name</a> property.
|
||||
<p> You must add all the necessary objects before loading any scripts.
|
||||
|
||||
<h3 class=fn>void <a name="addObject-2"></a>TQAxScriptManager::addObject ( <a href="tqobject.html">TQObject</a> * object )
|
||||
</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
<p> Adds a generic COM wrapper for <em>object</em> to the manager. <em>object</em>
|
||||
must be exposed as a COM object using the functionality provided
|
||||
by the <a href="qaxserver.html">TQAxServer module.</a>. Applications
|
||||
using this function you must link against the qaxserver library.
|
||||
|
||||
<h3 class=fn><a href="ntqvariant.html">TQVariant</a> <a name="call"></a>TQAxScriptManager::call ( const <a href="tqstring.html">TQString</a> & function, const <a href="ntqvariant.html">TQVariant</a> & var1 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var2 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var3 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var4 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var5 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var6 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var7 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var8 = TQVariant ( ) )
|
||||
</h3>
|
||||
Calls <em>function</em>, passing the parameters <em>var1</em>, <em>var1</em>,
|
||||
<em>var2</em>, <em>var3</em>, <em>var4</em>, <em>var5</em>, <em>var6</em>, <em>var7</em> and <em>var8</em>
|
||||
as arguments and returns the value returned by the function, or an
|
||||
invalid <a href="ntqvariant.html">TQVariant</a> if the function does not return a value or when
|
||||
the function call failed. The call returns when the script's
|
||||
execution has finished.
|
||||
<p> In most script engines the only supported parameter type is "const
|
||||
TQVariant&", for example, to call a JavaScript function
|
||||
<pre>
|
||||
function setNumber(number)
|
||||
{
|
||||
n = number;
|
||||
}
|
||||
</pre>
|
||||
|
||||
use
|
||||
<pre>
|
||||
<a href="tqvaluelist.html">TQValueList</a> args;
|
||||
args << 5;
|
||||
script->call("setNumber(const <a href="ntqvariant.html">TQVariant</a>&)", args);
|
||||
</pre>
|
||||
|
||||
As with <a href="qaxbase.html#dynamicCall">dynamicCall</a> the
|
||||
parameters can directly be embedded in the function string.
|
||||
<pre>
|
||||
script->call("setNumber(5)");
|
||||
</pre>
|
||||
|
||||
However, this is slower.
|
||||
<p> Functions provided by script engines that don't support
|
||||
introspection are not available and must be called directly
|
||||
using <a href="qaxscript.html#call">TQAxScript::call</a>() on the respective <a href="#script">script</a> object.
|
||||
<p> Note that calling this function can be significantely slower than
|
||||
using <a href="#call">call</a>() on the respective <a href="qaxscript.html">TQAxScript</a> directly.
|
||||
|
||||
<h3 class=fn><a href="ntqvariant.html">TQVariant</a> <a name="call-2"></a>TQAxScriptManager::call ( const <a href="tqstring.html">TQString</a> & function, <a href="tqvaluelist.html">TQValueList</a><TQVariant> & arguments )
|
||||
</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
<p> Calls <em>function</em> passing <em>arguments</em> as parameters, and returns
|
||||
the result. Returns when the script's execution has finished.
|
||||
|
||||
<h3 class=fn>void <a name="error"></a>TQAxScriptManager::error ( <a href="qaxscript.html">TQAxScript</a> * script, int code, const <a href="tqstring.html">TQString</a> & description, int sourcePosition, const <a href="tqstring.html">TQString</a> & sourceText )<tt> [signal]</tt>
|
||||
</h3>
|
||||
|
||||
<p> This signal is emitted when an execution error occured while
|
||||
running <em>script</em>.
|
||||
<p> <em>code</em>, <em>description</em>, <em>sourcePosition</em> and <em>sourceText</em>
|
||||
contain information about the execution error.
|
||||
|
||||
<h3 class=fn><a href="tqstringlist.html">TQStringList</a> <a name="functions"></a>TQAxScriptManager::functions ( <a href="qaxscript.html#FunctionFlags-enum">TQAxScript::FunctionFlags</a> flags = TQAxScript::FunctionNames ) const
|
||||
</h3>
|
||||
Returns a list with all the functions that are available.
|
||||
Functions provided by script engines that don't support
|
||||
introspection are not included in the list.
|
||||
The functions are either provided with full prototypes or
|
||||
only as names, depending on the value of <em>flags</em>.
|
||||
|
||||
<h3 class=fn><a href="qaxscript.html">TQAxScript</a> * <a name="load"></a>TQAxScriptManager::load ( const <a href="tqstring.html">TQString</a> & code, const <a href="tqstring.html">TQString</a> & name, const <a href="tqstring.html">TQString</a> & language )
|
||||
</h3>
|
||||
Loads the script source <em>code</em> using the script engine for <em>language</em>. The script can later be referred to using its <em>name</em>
|
||||
which should not be empty.
|
||||
<p> The function returns a pointer to the script for the given
|
||||
<em>code</em> if the <em>code</em> was loaded successfully; otherwise it
|
||||
returns 0.
|
||||
<p> If <em>language</em> is empty it will be determined heuristically. If <em>code</em> contains the string "End Sub" it will be interpreted as
|
||||
VBScript, otherwise as JScript. Additional script engines can be
|
||||
registered using <a href="#registerEngine">registerEngine</a>().
|
||||
<p> You must add all the objects necessary (using <a href="#addObject">addObject</a>()) <em>before</em> loading any scripts. If <em>code</em> declares a function that is
|
||||
already available (no matter in which language) the first function
|
||||
is overloaded and can no longer be called via <a href="#call">call</a>(); but it will
|
||||
still be available by calling its <a href="#script">script</a>
|
||||
directly.
|
||||
<p> <p>See also <a href="#addObject">addObject</a>(), <a href="#scriptNames">scriptNames</a>(), and <a href="#functions">functions</a>().
|
||||
|
||||
<h3 class=fn><a href="qaxscript.html">TQAxScript</a> * <a name="load-2"></a>TQAxScriptManager::load ( const <a href="tqstring.html">TQString</a> & file, const <a href="tqstring.html">TQString</a> & name )
|
||||
</h3>
|
||||
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
<p> Loads the source code from the <em>file</em>. The script can later be
|
||||
referred to using its <em>name</em> which should not be empty.
|
||||
<p> The function returns a pointer to the script engine for the code
|
||||
in <em>file</em> if <em>file</em> was loaded successfully; otherwise it
|
||||
returns 0.
|
||||
<p> The script engine used is determined from the file's extension. By
|
||||
default ".js" files are interpreted as JScript files, and ".vbs"
|
||||
and ".dsm" files are interpreted as VBScript. Additional script
|
||||
engines can be registered using <a href="#registerEngine">registerEngine</a>().
|
||||
|
||||
<h3 class=fn>bool <a name="registerEngine"></a>TQAxScriptManager::registerEngine ( const <a href="tqstring.html">TQString</a> & name, const <a href="tqstring.html">TQString</a> & extension, const <a href="tqstring.html">TQString</a> & code = TQString ( ) )<tt> [static]</tt>
|
||||
</h3>
|
||||
Registers the script engine called <em>name</em> and returns TRUE if the
|
||||
engine was found; otherwise does nothing and returns FALSE.
|
||||
<p> The script engine will be used when loading files with the given
|
||||
<em>extension</em>, or when loading source code that contains the string
|
||||
<em>code</em>.
|
||||
|
||||
<h3 class=fn><a href="qaxscript.html">TQAxScript</a> * <a name="script"></a>TQAxScriptManager::script ( const <a href="tqstring.html">TQString</a> & name ) const
|
||||
</h3>
|
||||
Returns the script called <em>name</em>.
|
||||
<p> You can use the returned pointer to call functions directly
|
||||
through <a href="qaxscript.html#call">TQAxScript::call</a>(), to access the script engine directly, or
|
||||
to delete and thus unload the script.
|
||||
|
||||
<h3 class=fn><a href="tqstring.html">TQString</a> <a name="scriptFileFilter"></a>TQAxScriptManager::scriptFileFilter ()<tt> [static]</tt>
|
||||
</h3>
|
||||
Returns a file filter listing all the supported script languages.
|
||||
This filter string is convenient for use with <a href="ntqfiledialog.html">TQFileDialog</a>.
|
||||
|
||||
<h3 class=fn><a href="tqstringlist.html">TQStringList</a> <a name="scriptNames"></a>TQAxScriptManager::scriptNames () const
|
||||
</h3>
|
||||
Returns a list with the names of all the scripts.
|
||||
|
||||
<!-- eof -->
|
||||
<hr><p>
|
||||
This file is part of the <a href="index.html">TQt toolkit</a>.
|
||||
Copyright © 1995-2007
|
||||
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,82 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/hierarchy/hierarchy.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQt Widget Hierarchy</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQt Widget Hierarchy</h1>
|
||||
|
||||
|
||||
<p>
|
||||
<script language=javascript>
|
||||
function createSubWidget( form )
|
||||
{
|
||||
ParentWidget.createSubWidget( form.nameEdit.value );
|
||||
}
|
||||
|
||||
function renameSubWidget( form )
|
||||
{
|
||||
var SubWidget = ParentWidget.subWidget( form.nameEdit.value );
|
||||
if ( !SubWidget ) {
|
||||
alert( "No such widget " + form.nameEdit.value + "!" );
|
||||
return;
|
||||
}
|
||||
SubWidget.label = form.labelEdit.value;
|
||||
form.nameEdit.value = SubWidget.label;
|
||||
}
|
||||
|
||||
function setFont( form )
|
||||
{
|
||||
ParentWidget.font = form.fontEdit.value;
|
||||
}
|
||||
</script>
|
||||
|
||||
<p>
|
||||
This widget can have many children!<br>
|
||||
<object ID="ParentWidget" CLASSID="CLSID:d574a747-8016-46db-a07c-b2b4854ee75c"
|
||||
CODEBASE=http://www.trolltech.com/demos/hierarchy.cab>
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
<form>
|
||||
<input type="edit" ID="nameEdit" value = "<enter object name>">
|
||||
<input type="button" value = "Create" onClick="createSubWidget(this.form)">
|
||||
<input type="edit" ID="labelEdit">
|
||||
<input type="button" value = "Rename" onClick="renameSubWidget(this.form)">
|
||||
<br>
|
||||
<input type="edit" ID="fontEdit" value = "MS Sans Serif">
|
||||
<input type="button" value = "Set Font" onClick="setFont(this.form)">
|
||||
</form>
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,50 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/menus/menus.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>Menubar merging</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Menubar merging</h1>
|
||||
|
||||
|
||||
<p><b>This documentation is under development and is subject to change.</b>
|
||||
<p> This example is not full functional at the moment.
|
||||
<p>
|
||||
<object ID="TQMenus" CLASSID="CLSID:4dc3f340-a6f7-44e4-a79b-3e9217695fbd"
|
||||
CODEBASE=http://www.trolltech.com/demos/menusax.cab>
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object>
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,79 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/multiple/multiple.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>Two simple TQt widgets</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Two simple TQt widgets</h1>
|
||||
|
||||
|
||||
<p>
|
||||
<script language=javascript>
|
||||
function setColor( form )
|
||||
{
|
||||
Ax1.fillColor = form.colorEdit.value;
|
||||
}
|
||||
|
||||
function setWidth( form )
|
||||
{
|
||||
Ax2.lineWidth = form.widthEdit.value;
|
||||
}
|
||||
</script>
|
||||
|
||||
<p>
|
||||
This is one <a href="tqwidget.html">TQWidget</a> subclass:<br>
|
||||
<object ID="Ax1" CLASSID="CLSID:1D9928BD-4453-4bdd-903D-E525ED17FDE5"
|
||||
CODEBASE=http://www.trolltech.com/demos/multipleax.cab>
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
<form>
|
||||
Fill Color: <input type="edit" ID="colorEdit" value = "red">
|
||||
<input type="button" value = "Set" onClick="setColor(this.form)">
|
||||
<input type="button" value = "Hide" onClick="Ax1.hide()">
|
||||
<input type="button" value = "Show" onClick="Ax1.show()">
|
||||
</form>
|
||||
|
||||
<p>
|
||||
This is another TQWidget subclass:<br>
|
||||
<object ID="Ax2" CLASSID="CLSID:58139D56-6BE9-4b17-937D-1B1EDEDD5B71"
|
||||
CODEBASE=http://www.trolltech.com/demos/multipleax.cab>
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
<form>
|
||||
Line width: <input type="edit" ID="widthEdit" value = "1">
|
||||
<input type="button" value = "Set" onClick="setWidth(this.form)">
|
||||
</form>
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,68 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/opengl/opengl.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>OpenGL in an HTML page</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>OpenGL in an HTML page</h1>
|
||||
|
||||
|
||||
<p>
|
||||
<SCRIPT LANGUAGE=JavaScript>
|
||||
function setRot( form )
|
||||
{
|
||||
GLBox.setXRotation( form.XEdit.value );
|
||||
GLBox.setYRotation( form.YEdit.value );
|
||||
GLBox.setZRotation( form.ZEdit.value );
|
||||
}
|
||||
</SCRIPT>
|
||||
|
||||
<p>
|
||||
An OpenGL scene:<br>
|
||||
<object ID="GLBox" CLASSID="CLSID:5fd9c22e-ed45-43fa-ba13-1530bb6b03e0"
|
||||
CODEBASE=http://www.trolltech.com/demos/openglax.cab>
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
|
||||
<form>
|
||||
Rotate the scene:<br>
|
||||
X:<input type="edit" ID="XEdit" value="0"><br>
|
||||
Y:<input type="edit" name="YEdit" value="0"><br>
|
||||
Z:<input type="edit" name="ZEdit" value="0"><br>
|
||||
<input type="button" value="Set" onClick="setRot(this.form)">
|
||||
</form>
|
||||
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,80 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/simple/simple.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>A standard ActiveX and the "simple" ActiveTQt widget.</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>A standard ActiveX and the "simple" ActiveTQt widget.</h1>
|
||||
|
||||
|
||||
<p>
|
||||
<object ID="TQSimpleAX" CLASSID="CLSID:DF16845C-92CD-4AAB-A982-EB9840E74669"
|
||||
CODEBASE=http://www.trolltech.com/demos/simpleax.cab>
|
||||
<PARAM NAME="text" VALUE="A simple control">
|
||||
<PARAM NAME="value" VALUE="1">
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object>
|
||||
|
||||
<FORM>
|
||||
<INPUT TYPE="BUTTON" VALUE="About..." onClick="TQSimpleAX.about()">
|
||||
</FORM>
|
||||
|
||||
<object ID="Calendar" CLASSID="CLSID:8E27C92B-1264-101C-8A2F-040224009C02">
|
||||
[Standard Calendar control not available!]
|
||||
<PARAM NAME="day" VALUE="1">
|
||||
</object>
|
||||
|
||||
<FORM>
|
||||
<INPUT TYPE="BUTTON" VALUE="Today" onClick="Calendar.Today()">
|
||||
</FORM>
|
||||
|
||||
<SCRIPT LANGUAGE=VBScript>
|
||||
Sub Calendar_Click()
|
||||
MsgBox( "Calendar Clicked!" )
|
||||
End Sub
|
||||
|
||||
Sub TQSimpleAX_TextChanged( str )
|
||||
document.title = str
|
||||
End Sub
|
||||
</SCRIPT>
|
||||
|
||||
<SCRIPT LANGUAGE=JavaScript>
|
||||
function TQSimpleAX::ValueChanged( Newvalue )
|
||||
{
|
||||
Calendar.Day = Newvalue;
|
||||
}
|
||||
</SCRIPT>
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,62 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/tetrax/tetrax.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>Play Tetrix!</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Play Tetrix!</h1>
|
||||
|
||||
|
||||
<p>
|
||||
<object ID="TQTetrax" width=550 height=370
|
||||
CLASSID="CLSID:852558AD-CBD6-4f07-844C-D1E8983CD6FC"
|
||||
CODEBASE=http://www.trolltech.com/demos/tetrax.cab>
|
||||
<PARAM NAME="score" VALUE="0">
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object>
|
||||
|
||||
<form>
|
||||
<input type="button" value="Start Game..."
|
||||
onClick="TQTetrax.startGame()">
|
||||
</form>
|
||||
|
||||
<SCRIPT LANGUAGE=JavaScript>
|
||||
function TQTetrax::gameOver()
|
||||
{
|
||||
alert( "GameOver!" );
|
||||
}
|
||||
</SCRIPT>
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,92 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/wrapper/wrapper.doc:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>Standard TQt widgets in an HTML page</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Standard TQt widgets in an HTML page</h1>
|
||||
|
||||
|
||||
<p>
|
||||
<SCRIPT LANGUAGE=VBScript>
|
||||
Sub ToolButton_Clicked()
|
||||
RadioButton.text = InputBox( "Enter something", "Wrapper Demo" )
|
||||
End Sub
|
||||
|
||||
Sub PushButton_clicked()
|
||||
MsgBox( "Thank you!" )
|
||||
End Sub
|
||||
|
||||
Sub CheckBox_toggled( state )
|
||||
if state = 0 then
|
||||
CheckBox.text = "Check me!"
|
||||
else
|
||||
CheckBox.text = "Uncheck me!"
|
||||
end if
|
||||
End Sub
|
||||
</SCRIPT>
|
||||
<p>
|
||||
A TQPushButton:<br>
|
||||
<object ID="PushButton" CLASSID="CLSID:2B262458-A4B6-468B-B7D4-CF5FEE0A7092"
|
||||
CODEBASE=http://www.trolltech.com/demos/wrapperax.cab>
|
||||
<PARAM NAME="text" VALUE="Click me!">
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
|
||||
<p>
|
||||
A TQCheckBox:<br>
|
||||
<object ID="CheckBox" CLASSID="CLSID:6E795de9-872d-43cf-a831-496ef9d86c68"
|
||||
CODEBASE=http://www.trolltech.com/demos/wrapperax.cab>
|
||||
<PARAM NAME="text" VALUE="Check me!">
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
|
||||
<p>
|
||||
A TQToolButton:<br>
|
||||
<object ID="ToolButton" CLASSID="CLSID:7c0ffe7a-60c3-4666-bde2-5cf2b54390a1"
|
||||
CODEBASE=http://www.trolltech.com/demos/wrapperax.cab>
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
|
||||
<p>
|
||||
A TQRadioButton:<br>
|
||||
<object ID="RadioButton" CLASSID="CLSID:afcf78c8-446c-409a-93b3-ba2959039189"
|
||||
CODEBASE=http://www.trolltech.com/demos/wrapperax.cab>
|
||||
<PARAM NAME="text" VALUE="Tune me!">
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,262 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/hierarchy/hierarchy.doc:47 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQt Widget Hierarchy (in-process)</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQt Widget Hierarchy (in-process)</h1>
|
||||
|
||||
|
||||
|
||||
The ActiveX control in this example is a <a href="tqwidget.html">TQWidget</a>
|
||||
subclass with child widgets that are accessible as sub types.
|
||||
<p>
|
||||
|
||||
<pre> class TQParentWidget : public <a href="tqwidget.html">TQWidget</a>
|
||||
{
|
||||
<a href="metaobjects.html#TQ_OBJECT">TQ_OBJECT</a>
|
||||
public:
|
||||
TQParentWidget( <a href="tqwidget.html">TQWidget</a> *parent = 0, const char *name = 0, WFlags f = 0 );
|
||||
|
||||
<a href="ntqsize.html">TQSize</a> sizeHint() const;
|
||||
|
||||
public slots:
|
||||
void createSubWidget( const <a href="tqstring.html">TQString</a> &name );
|
||||
|
||||
TQSubWidget *subWidget( const <a href="tqstring.html">TQString</a> &name );
|
||||
|
||||
private:
|
||||
<a href="qvboxlayout.html">TQVBoxLayout</a> *vbox;
|
||||
};
|
||||
</pre>The <tt>TQParentWidget</tt> class provides slots to create a widget
|
||||
with a name, and to return a pointer to a named widget.
|
||||
<p>
|
||||
|
||||
<pre> TQParentWidget::TQParentWidget( <a href="tqwidget.html">TQWidget</a> *parent, const char *name, WFlags f )
|
||||
: <a href="tqwidget.html">TQWidget</a>( parent, name, f )
|
||||
{
|
||||
vbox = new <a href="qvboxlayout.html">TQVBoxLayout</a>( this );
|
||||
<a name="x2649"></a> vbox-><a href="ntqlayout.html#setAutoAdd">setAutoAdd</a>( TRUE );
|
||||
}
|
||||
</pre>The constructor of TQParentWidget creates a vertical box layout.
|
||||
New child widgets are automatically added to the layout.
|
||||
<p> <pre> void TQParentWidget::createSubWidget( const <a href="tqstring.html">TQString</a> &name )
|
||||
{
|
||||
TQSubWidget *sw = new TQSubWidget( this, name );
|
||||
sw->setLabel( name );
|
||||
sw-><a href="tqwidget.html#show">show</a>();
|
||||
}
|
||||
</pre>The <tt>createSubWidget</tt> slot creates a new <tt>TQSubWidget</tt> with
|
||||
the name provided in the parameter, and sets the label to that
|
||||
name. The widget is also shown explicitly.
|
||||
<p> <pre> TQSubWidget *TQParentWidget::subWidget( const <a href="tqstring.html">TQString</a> &name )
|
||||
{
|
||||
return (TQSubWidget*)<a href="tqobject.html#child">child</a>( name, "TQSubWidget" );
|
||||
}
|
||||
</pre>The <tt>subWidget</tt> slot uses the <a href="tqobject.html#child">TQObject::child</a>() function and
|
||||
returns the first child of type <tt>TQSubWidget</tt> that has the requested
|
||||
name.
|
||||
<p>
|
||||
|
||||
<pre> class TQSubWidget : public <a href="tqwidget.html">TQWidget</a>
|
||||
{
|
||||
TQ_OBJECT
|
||||
TQ_PROPERTY( TQString label READ label WRITE setLabel )
|
||||
public:
|
||||
TQSubWidget( <a href="tqwidget.html">TQWidget</a> *parent = 0, const char *name = 0, WFlags f = 0 );
|
||||
|
||||
void setLabel( const <a href="tqstring.html">TQString</a> &text );
|
||||
<a href="tqstring.html">TQString</a> label() const;
|
||||
|
||||
<a href="ntqsize.html">TQSize</a> sizeHint() const;
|
||||
|
||||
protected:
|
||||
void paintEvent( <a href="qpaintevent.html">TQPaintEvent</a> *e );
|
||||
|
||||
private:
|
||||
<a href="tqstring.html">TQString</a> lbl;
|
||||
};
|
||||
</pre>The <tt>TQSubWidget</tt> class has a single string-property <tt>label</tt>,
|
||||
and implements the paintEvent to draw the label.
|
||||
<p>
|
||||
|
||||
<pre> TQSubWidget::TQSubWidget( <a href="tqwidget.html">TQWidget</a> *parent, const char *name, WFlags f )
|
||||
: <a href="tqwidget.html">TQWidget</a>( parent, name, f )
|
||||
{
|
||||
}
|
||||
|
||||
void TQSubWidget::setLabel( const <a href="tqstring.html">TQString</a> &text )
|
||||
{
|
||||
lbl = text;
|
||||
<a href="tqobject.html#setName">setName</a>( text );
|
||||
<a href="tqwidget.html#update">update</a>();
|
||||
}
|
||||
|
||||
TQString TQSubWidget::label() const
|
||||
{
|
||||
return lbl;
|
||||
}
|
||||
|
||||
TQSize TQSubWidget::<a href="tqwidget.html#sizeHint">sizeHint</a>() const
|
||||
{
|
||||
<a href="ntqfontmetrics.html">TQFontMetrics</a> fm( <a href="tqwidget.html#font">font</a>() );
|
||||
return TQSize( fm.<a href="ntqfontmetrics.html#width">width</a>(lbl), fm.<a href="ntqfontmetrics.html#height">height</a>() );
|
||||
}
|
||||
|
||||
void TQSubWidget::<a href="tqwidget.html#paintEvent">paintEvent</a>( <a href="qpaintevent.html">TQPaintEvent</a> * )
|
||||
{
|
||||
<a href="ntqpainter.html">TQPainter</a> painter(this);
|
||||
painter.<a href="ntqpainter.html#setPen">setPen</a>( <a href="tqwidget.html#colorGroup">colorGroup</a>().text() );
|
||||
painter.<a href="ntqpainter.html#drawText">drawText</a>( <a href="tqwidget.html#rect">rect</a>(), AlignCenter, lbl );
|
||||
}
|
||||
</pre>The implementation of the TQSubWidget class is self-explanatory.
|
||||
<p>
|
||||
|
||||
<pre> class ActiveTQtFactory : public <a href="qaxfactory.html">TQAxFactory</a>
|
||||
{
|
||||
public:
|
||||
ActiveTQtFactory( const <a href="ntquuid.html">TQUuid</a> &lib, const <a href="ntquuid.html">TQUuid</a> &app )
|
||||
: <a href="qaxfactory.html">TQAxFactory</a>( lib, app )
|
||||
{}
|
||||
<a href="tqstringlist.html">TQStringList</a> featureList() const
|
||||
{
|
||||
<a href="tqstringlist.html">TQStringList</a> list;
|
||||
list << "TQParentWidget";
|
||||
list << "TQSubWidget";
|
||||
return list;
|
||||
}
|
||||
</pre>The <tt>ActiveTQtFactory</tt> class implements a <a href="qaxfactory.html">TQAxFactory</a>. It returns
|
||||
the class names of all supported types, <tt>TQParentWidget</tt> and
|
||||
<tt>TQSubWidget</tt>, from the <tt>featureList()</tt> reimplementation.
|
||||
<p> <pre> <a href="tqwidget.html">TQWidget</a> *create( const <a href="tqstring.html">TQString</a> &key, TQWidget *parent, const char *name )
|
||||
{
|
||||
if ( key == "TQParentWidget" )
|
||||
return new TQParentWidget( parent, name );
|
||||
|
||||
return 0;
|
||||
}
|
||||
</pre>The factory can however only create objects of the <tt>TQParentWidget</tt>
|
||||
type directly - objects of subtypes can only be created through the
|
||||
interface of <tt>TQParentWidget</tt> objects.
|
||||
<p> <pre> <a href="ntquuid.html">TQUuid</a> classID( const <a href="tqstring.html">TQString</a> &key ) const
|
||||
{
|
||||
if ( key == "TQParentWidget" )
|
||||
return TQUuid( "{d574a747-8016-46db-a07c-b2b4854ee75c}" );
|
||||
if ( key == "TQSubWidget" )
|
||||
return TQUuid( "{850652f4-8f71-4f69-b745-bce241ccdc30}" );
|
||||
|
||||
return TQUuid();
|
||||
}
|
||||
<a href="ntquuid.html">TQUuid</a> interfaceID( const <a href="tqstring.html">TQString</a> &key ) const
|
||||
{
|
||||
if ( key == "TQParentWidget" )
|
||||
return TQUuid( "{4a30719d-d9c2-4659-9d16-67378209f822}" );
|
||||
if ( key == "TQSubWidget" )
|
||||
return TQUuid( "{2d76cc2f-3488-417a-83d6-debff88b3c3f}" );
|
||||
|
||||
return TQUuid();
|
||||
}
|
||||
<a href="ntquuid.html">TQUuid</a> eventsID( const <a href="tqstring.html">TQString</a> &key ) const
|
||||
{
|
||||
if ( key == "TQParentWidget" )
|
||||
return TQUuid( "{aac9f855-c3dc-4cae-b747-c77f4d509f4c}" );
|
||||
if ( key == "TQSubWidget" )
|
||||
return TQUuid( "{25fac47e-c723-4696-8c74-6185903bdf65}" );
|
||||
|
||||
return TQUuid();
|
||||
}
|
||||
</pre>COM however requires the IDs for the interfaces of the sub types as
|
||||
well to be able to marshal calls correctly.
|
||||
<p> <pre> <a href="tqstring.html">TQString</a> exposeToSuperClass( const <a href="tqstring.html">TQString</a> &key ) const
|
||||
{
|
||||
if ( key == "TQSubWidget" )
|
||||
return key;
|
||||
return TQAxFactory::exposeToSuperClass(key);
|
||||
}
|
||||
};
|
||||
</pre>Objects of the <tt>TQSubWidget</tt> type should not expose the full
|
||||
functionality of e.g. <a href="tqwidget.html">TQWidget</a>. Only those properties and slots
|
||||
explicitly declared in the type are accessible.
|
||||
<p> <pre> TQAXFACTORY_EXPORT( ActiveTQtFactory, "{9e626211-be62-4d18-9483-9419358fbb03}", "{75c276de-1df5-451f-a004-e4fa1a587df1}" )
|
||||
</pre>The factory is then exported using the <a href="qaxfactory.html#TQAXFACTORY_EXPORT">TQAXFACTORY_EXPORT</a>
|
||||
macro.
|
||||
<p> To build the example you must first build the <a href="qaxserver.html">TQAxServer</a> library. Then run qmake and your make tool in
|
||||
<tt>examples/multiple</tt>.
|
||||
<p> <hr>
|
||||
<p> The <a href="qaxserver-demo-hierarchy.html">demonstration</a> requires your
|
||||
WebBrowser to support ActiveX controls, and scripting to be enabled.
|
||||
<p>
|
||||
|
||||
<pre> <script language=javascript>
|
||||
function createSubWidget( form )
|
||||
{
|
||||
ParentWidget.createSubWidget( form.nameEdit.value );
|
||||
}
|
||||
|
||||
function renameSubWidget( form )
|
||||
{
|
||||
var SubWidget = ParentWidget.subWidget( form.nameEdit.value );
|
||||
if ( !SubWidget ) {
|
||||
alert( "No such widget " + form.nameEdit.value + "!" );
|
||||
return;
|
||||
}
|
||||
SubWidget.label = form.labelEdit.value;
|
||||
form.nameEdit.value = SubWidget.label;
|
||||
}
|
||||
|
||||
function setFont( form )
|
||||
{
|
||||
ParentWidget.font = form.fontEdit.value;
|
||||
}
|
||||
</script>
|
||||
|
||||
<p>
|
||||
This widget can have many children!<br>
|
||||
<object ID="ParentWidget" CLASSID="CLSID:d574a747-8016-46db-a07c-b2b4854ee75c"
|
||||
CODEBASE=http://www.trolltech.com/demos/hierarchy.cab>
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
<form>
|
||||
<input type="edit" ID="nameEdit" value = "<enter object name>">
|
||||
<input type="button" value = "Create" onClick="createSubWidget(this.form)">
|
||||
<input type="edit" ID="labelEdit">
|
||||
<input type="button" value = "Rename" onClick="renameSubWidget(this.form)">
|
||||
<br>
|
||||
<input type="edit" ID="fontEdit" value = "MS Sans Serif">
|
||||
<input type="button" value = "Set Font" onClick="setFont(this.form)">
|
||||
</form>
|
||||
</pre><p>See also <a href="qaxserver-examples.html">The TQAxServer Examples</a>.
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,59 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/menus/menus.doc:16 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>Menubar merging</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Menubar merging</h1>
|
||||
|
||||
|
||||
|
||||
<p><b>This documentation is under development and is subject to change.</b>
|
||||
<p> This example demonstrates the use of <a href="ntqmenubar.html">TQMenuBar</a> and <a href="ntqstatusbar.html">TQStatusBar</a> in
|
||||
a <a href="ntqmainwindow.html">TQMainWindow</a> to implement an in-place active control.
|
||||
<p> To build the example you must first build the <a href="qaxserver.html">TQAxServer</a> library. Then run qmake and your make tool in
|
||||
<tt>examples/menus</tt>.
|
||||
<p> <hr>
|
||||
<p> The <a href="qaxserver-demo-menus.html">demonstration</a> requires your
|
||||
WebBrowser to support ActiveX controls, and scripting to be enabled.
|
||||
<p>
|
||||
|
||||
<pre> <object ID="TQMenus" CLASSID="CLSID:4dc3f340-a6f7-44e4-a79b-3e9217695fbd"
|
||||
CODEBASE=http://www.trolltech.com/demos/menusax.cab>
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object>
|
||||
</pre><p>See also <a href="qaxserver-examples.html">The TQAxServer Examples</a>.
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,201 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/multiple/multiple.doc:44 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>Two simple TQt widgets (in-process)</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Two simple TQt widgets (in-process)</h1>
|
||||
|
||||
|
||||
|
||||
The ActiveX controls in this example are simple <a href="tqwidget.html">TQWidget</a>
|
||||
subclasses reimplementing the paintEvent() method. The classes use
|
||||
the TQ_CLASSINFO macro to
|
||||
<p> The example demonstrates the use of the TQ_CLASSINFO macro to set
|
||||
<a href="activentqt.html#ActiveTQt">ActiveTQt</a>-specific attributes for <a href="tqobject.html">TQObject</a> sub classes, and the use of
|
||||
the <a href="qaxfactory.html#TQAXFACTORY_BEGIN">TQAXFACTORY_BEGIN</a>, <a href="qaxfactory.html#TQAXCLASS">TQAXCLASS</a> and <a href="qaxfactory.html#TQAXFACTORY_END">TQAXFACTORY_END</a> macros.
|
||||
<p>
|
||||
|
||||
<pre> class TQAxWidget1 : public <a href="tqwidget.html">TQWidget</a>
|
||||
{
|
||||
<a href="metaobjects.html#TQ_OBJECT">TQ_OBJECT</a>
|
||||
TQ_CLASSINFO("ClassID", "{1D9928BD-4453-4bdd-903D-E525ED17FDE5}")
|
||||
TQ_CLASSINFO("InterfaceID", "{99F6860E-2C5A-42ec-87F2-43396F4BE389}")
|
||||
TQ_CLASSINFO("EventsID", "{0A3E9F27-E4F1-45bb-9E47-63099BCCD0E3}")
|
||||
</pre>The class declaration includes the TQ_OBJECT macro to activate TQt's <a href="metaobjects.html#meta-object">meta object</a> system, and sets COM identifiers for the class using the
|
||||
TQ_CLASSINFO macro.
|
||||
<pre> TQ_PROPERTY( TQColor fillColor READ fillColor WRITE setFillColor )
|
||||
public:
|
||||
TQAxWidget1( <a href="tqwidget.html">TQWidget</a> *parent = 0, const char *name = 0, WFlags f = 0 )
|
||||
: <a href="tqwidget.html">TQWidget</a>( parent, name, f ), fill_color( red )
|
||||
{
|
||||
}
|
||||
|
||||
<a href="ntqcolor.html">TQColor</a> fillColor() const
|
||||
{
|
||||
return fill_color;
|
||||
}
|
||||
void setFillColor( const <a href="ntqcolor.html">TQColor</a> &fc )
|
||||
{
|
||||
fill_color = fc;
|
||||
repaint();
|
||||
}
|
||||
|
||||
protected:
|
||||
void paintEvent( <a href="qpaintevent.html">TQPaintEvent</a> *e )
|
||||
{
|
||||
<a href="ntqpainter.html">TQPainter</a> paint( this );
|
||||
<a href="ntqrect.html">TQRect</a> r = rect();
|
||||
<a name="x2544"></a> r.<a href="ntqrect.html#addCoords">addCoords</a>( 10, 10, -10, -10 );
|
||||
<a name="x2543"></a> paint.<a href="ntqpainter.html#fillRect">fillRect</a>( r, fill_color );
|
||||
}
|
||||
|
||||
private:
|
||||
<a href="ntqcolor.html">TQColor</a> fill_color;
|
||||
};
|
||||
</pre>The control draws a filled rectangle. The fill color is exposed as a
|
||||
property using the TQ_PROPERTY macro.
|
||||
<p>
|
||||
|
||||
<pre> class TQAxWidget2 : public <a href="tqwidget.html">TQWidget</a>
|
||||
{
|
||||
TQ_OBJECT
|
||||
TQ_CLASSINFO("ClassID", "{58139D56-6BE9-4b17-937D-1B1EDEDD5B71}")
|
||||
TQ_CLASSINFO("InterfaceID", "{B66280AB-08CC-4dcc-924F-58E6D7975B7D}")
|
||||
TQ_CLASSINFO("EventsID", "{D72BACBA-03C4-4480-B4BB-DE4FE3AA14A0}")
|
||||
TQ_CLASSINFO("ToSuperClass", "TQAxWidget2")
|
||||
TQ_CLASSINFO("StockEvents", "yes")
|
||||
</pre>The declaration of the second control class uses the TQ_CLASSINFO macro
|
||||
to set the COM identifiers as well as additional COM attributes for the
|
||||
class. Objects of that class will not expose the <a href="tqwidget.html">TQWidget</a> API, and provide
|
||||
the ActiveX stock events (ie. Click, KeyDown etc.).
|
||||
<pre> TQ_PROPERTY( int lineWidth READ lineWidth WRITE setLineWidth )
|
||||
public:
|
||||
TQAxWidget2( <a href="tqwidget.html">TQWidget</a> *parent = 0, const char *name = 0, WFlags f = 0 )
|
||||
: <a href="tqwidget.html">TQWidget</a>( parent, name, f ), line_width( 1 )
|
||||
{
|
||||
}
|
||||
|
||||
int lineWidth() const
|
||||
{
|
||||
return line_width;
|
||||
}
|
||||
void setLineWidth( int lw )
|
||||
{
|
||||
line_width = lw;
|
||||
repaint();
|
||||
}
|
||||
|
||||
protected:
|
||||
void paintEvent( <a href="qpaintevent.html">TQPaintEvent</a> *e )
|
||||
{
|
||||
<a href="ntqpainter.html">TQPainter</a> paint( this );
|
||||
<a name="x2546"></a> <a href="ntqpen.html">TQPen</a> pen = paint.<a href="ntqpainter.html#pen">pen</a>();
|
||||
<a name="x2548"></a> pen.<a href="ntqpen.html#setWidth">setWidth</a>( line_width );
|
||||
<a name="x2547"></a> paint.<a href="ntqpainter.html#setPen">setPen</a>( pen );
|
||||
|
||||
<a href="ntqrect.html">TQRect</a> r = rect();
|
||||
<a name="x2549"></a> r.<a href="ntqrect.html#addCoords">addCoords</a>( 10, 10, -10, -10 );
|
||||
<a name="x2545"></a> paint.<a href="ntqpainter.html#drawEllipse">drawEllipse</a>( r );
|
||||
}
|
||||
|
||||
private:
|
||||
int line_width;
|
||||
};
|
||||
</pre>The control draws a circle. The line width is exposed as a property
|
||||
using the TQ_PROPERTY macro.
|
||||
<p> The controls are exposed by the implementation of <a href="qaxfactory.html">TQAxFactory</a> as provided
|
||||
by the TQAXFACTORY_BEGIN and TQAXFACTORY_END macros.
|
||||
|
||||
|
||||
<pre> #include <<a href="qaxfactory-h.html">qaxfactory.h</a>>
|
||||
|
||||
#include "ax1.h"
|
||||
#include "ax2.h"
|
||||
|
||||
TQAXFACTORY_BEGIN("{98DE28B6-6CD3-4e08-B9FA-3D1DB43F1D2F}", "{05828915-AD1C-47ab-AB96-D6AD1E25F0E2}")
|
||||
</pre>The factory is initialied using the TQAXFACTORY_BEGIN macro, providing
|
||||
the IDs for the application and the type library.
|
||||
<pre> TQAXCLASS(TQAxWidget1)
|
||||
TQAXCLASS(TQAxWidget2)
|
||||
</pre>The classes exposed are listed using the TQAXCLASS macro.
|
||||
<pre> TQAXFACTORY_END()
|
||||
</pre>Finally the factory declaration is closed using the TQAXFACTORY_END
|
||||
macro.
|
||||
<p> To build the example you must first build the <a href="qaxserver.html">TQAxServer</a> library. Then run qmake and your make tool in
|
||||
<tt>examples/multiple</tt>.
|
||||
<p> <hr>
|
||||
<p> The <a href="qaxserver-demo-multiple.html">demonstration</a> requires your
|
||||
WebBrowser to support ActiveX controls, and scripting to be enabled.
|
||||
<p>
|
||||
|
||||
<pre> <script language=javascript>
|
||||
function setColor( form )
|
||||
{
|
||||
Ax1.fillColor = form.colorEdit.value;
|
||||
}
|
||||
|
||||
function setWidth( form )
|
||||
{
|
||||
Ax2.lineWidth = form.widthEdit.value;
|
||||
}
|
||||
</script>
|
||||
|
||||
<p>
|
||||
This is one TQWidget subclass:<br>
|
||||
<object ID="Ax1" CLASSID="CLSID:1D9928BD-4453-4bdd-903D-E525ED17FDE5"
|
||||
CODEBASE=http://www.trolltech.com/demos/multipleax.cab>
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
<form>
|
||||
Fill Color: <input type="edit" ID="colorEdit" value = "red">
|
||||
<input type="button" value = "Set" onClick="setColor(this.form)">
|
||||
<input type="button" value = "Hide" onClick="Ax1.hide()">
|
||||
<input type="button" value = "Show" onClick="Ax1.show()">
|
||||
</form>
|
||||
|
||||
<p>
|
||||
This is another TQWidget subclass:<br>
|
||||
<object ID="Ax2" CLASSID="CLSID:58139D56-6BE9-4b17-937D-1B1EDEDD5B71"
|
||||
CODEBASE=http://www.trolltech.com/demos/multipleax.cab>
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
<form>
|
||||
Line width: <input type="edit" ID="widthEdit" value = "1">
|
||||
<input type="button" value = "Set" onClick="setWidth(this.form)">
|
||||
</form>
|
||||
</pre><p>See also <a href="qaxserver-examples.html">The TQAxServer Examples</a>.
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,206 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/opengl/opengl.doc:33 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQt' OpenGL widgets as an ActiveX (executable)</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQt' OpenGL widgets as an ActiveX (executable)</h1>
|
||||
|
||||
|
||||
|
||||
The ActiveX control in this example uses the TQGlWidget class in
|
||||
TQt to render an OpenGL scene in an ActiveX. The control exposes a few
|
||||
methods to change the scene. The example is based on the
|
||||
<a href="opengl-box-example.html">"box" example</a> from the standard
|
||||
TQt distribution.
|
||||
<p> The example demonstrates the use of the default factory and
|
||||
<a href="qaxfactory.html#isServer">TQAxFactory::isServer</a>(), and the implementation of an additional COM
|
||||
interface using <a href="qaxbindable.html">TQAxBindable</a> and <a href="qaxaggregated.html">TQAxAggregated</a>. The server executable
|
||||
can run both as an ActiveX server and as a stand alone application.
|
||||
<p>
|
||||
|
||||
The application uses the default factory as provided by the
|
||||
<a href="qaxfactory.html#TQAXFACTORY_DEFAULT">TQAXFACTORY_DEFAULT</a> macro to expose the <tt>GLBox</tt> widget as an ActiveX
|
||||
control.
|
||||
<pre> #include <<a href="qaxfactory-h.html">qaxfactory.h</a>>
|
||||
|
||||
TQAXFACTORY_DEFAULT( GLBox,
|
||||
"{5fd9c22e-ed45-43fa-ba13-1530bb6b03e0}",
|
||||
"{33b051af-bb25-47cf-a390-5cfd2987d26a}",
|
||||
"{8c996c29-eafa-46ac-a6f9-901951e765b5}",
|
||||
"{2c3c183a-eeda-41a4-896e-3d9c12c3577d}",
|
||||
"{83e16271-6480-45d5-aaf1-3f40b7661ae4}"
|
||||
)
|
||||
</pre>The implementation of <tt>main</tt> initializes the <a href="ntqapplication.html">TQApplication</a> object,
|
||||
and uses <a href="qaxfactory.html#isServer">TQAxFactory::isServer</a>() to determine whether or not it is
|
||||
appropriate to create and show the application interface.
|
||||
<pre> /*
|
||||
The main program is here.
|
||||
*/
|
||||
|
||||
int main( int argc, char **argv )
|
||||
{
|
||||
<a name="x2732"></a> TQApplication::<a href="ntqapplication.html#setColorSpec">setColorSpec</a>( TQApplication::CustomColor );
|
||||
<a href="ntqapplication.html">TQApplication</a> a(argc,argv);
|
||||
|
||||
if ( !TQGLFormat::hasOpenGL() ) {
|
||||
<a href="ntqapplication.html#qWarning">tqWarning</a>( "This system has no OpenGL support. Exiting." );
|
||||
return -1;
|
||||
}
|
||||
|
||||
if ( !TQAxFactory::isServer() ) {
|
||||
GLObjectWindow w;
|
||||
w.<a href="tqwidget.html#resize">resize</a>( 400, 350 );
|
||||
<a name="x2733"></a> a.<a href="ntqapplication.html#setMainWidget">setMainWidget</a>( &w );
|
||||
w.<a href="tqwidget.html#show">show</a>();
|
||||
return a.<a href="ntqapplication.html#exec">exec</a>();
|
||||
}
|
||||
<a name="x2731"></a> return a.<a href="ntqapplication.html#exec">exec</a>();
|
||||
}
|
||||
</pre>
|
||||
<p>
|
||||
|
||||
The <tt>GLBox</tt> class inherits from both the <a href="qglwidget.html">TQGLWidget</a> class to be able
|
||||
to render OpenGL, and from <a href="qaxbindable.html">TQAxBindable</a>.
|
||||
<pre> #include <<a href="qaxbindable-h.html">qaxbindable.h</a>>
|
||||
|
||||
class GLBox : public <a href="qglwidget.html">TQGLWidget</a>,
|
||||
public TQAxBindable
|
||||
{
|
||||
<a href="metaobjects.html#TQ_OBJECT">TQ_OBJECT</a>
|
||||
</pre>The class reimplements the <a href="qaxbindable.html#createAggregate">TQAxBindable::createAggregate</a>() function from <a href="qaxbindable.html">TQAxBindable</a>
|
||||
to return the pointer to a <a href="qaxaggregated.html">TQAxAggregated</a> object.
|
||||
<pre> public:
|
||||
|
||||
GLBox( <a href="tqwidget.html">TQWidget</a>* parent, const char* name );
|
||||
~GLBox();
|
||||
|
||||
<a href="qaxaggregated.html">TQAxAggregated</a> *createAggregate();
|
||||
|
||||
public slots:
|
||||
|
||||
void setXRotation( int degrees );
|
||||
</pre>The rest of the class declaration and the implementation of the OpenGL
|
||||
rendering is identical to the original "box" example.
|
||||
<p>
|
||||
|
||||
The implementation file of the <tt>GLBox</tt> class includes the <tt>objsafe.h</tt>
|
||||
system header, in which the <tt>IObjectSafety</tt> COM interface is defined.
|
||||
<pre> #include <objsafe.h>
|
||||
</pre>A class <tt>ObjectSafetyImpl</tt> is declared using multiple inheritance
|
||||
to subclass the <a href="qaxaggregated.html">TQAxAggregated</a> class, and to implement the IObjectSafety
|
||||
interface.
|
||||
<pre> class ObjectSafetyImpl : public <a href="qaxaggregated.html">TQAxAggregated</a>,
|
||||
public IObjectSafety
|
||||
{
|
||||
public:
|
||||
</pre>The class declares a default constructor, and implements the queryInterface
|
||||
function to support the IObjectSafety interface.
|
||||
<pre> ObjectSafetyImpl() {}
|
||||
|
||||
long queryInterface( const <a href="ntquuid.html">TQUuid</a> &iid, void **iface )
|
||||
{
|
||||
*iface = 0;
|
||||
if ( iid == IID_IObjectSafety )
|
||||
*iface = (IObjectSafety*)this;
|
||||
else
|
||||
return E_NOINTERFACE;
|
||||
|
||||
AddRef();
|
||||
return S_OK;
|
||||
}
|
||||
</pre>Since every COM interface inherits <tt>IUnknown</tt> the <tt>TQAXAGG_IUNKNOWN</tt> macro
|
||||
is used to provide the default implementation of the <tt>IUnknown</tt> interface.
|
||||
The macro is defined to delegate all calls to <tt>QueryInterface</tt>, <tt>AddRef</tt>
|
||||
and <tt>Release</tt> to the interface returned by the controllingUnknown() function.
|
||||
<pre> TQAXAGG_IUNKNOWN;
|
||||
</pre>The implementation of the <tt>IObjectSafety</tt> interface provides the caller
|
||||
with information about supported and enabled safety options, and returns
|
||||
<tt>S_OK</tt> for all calls to indicate that the ActiveX control is safe.
|
||||
<pre> HRESULT WINAPI GetInterfaceSafetyOptions( REFIID riid, DWORD *pdwSupportedOptions, DWORD *pdwEnabledOptions )
|
||||
{
|
||||
*pdwSupportedOptions = INTERFACESAFE_FOR_UNTRUSTED_DATA | INTERFACESAFE_FOR_UNTRUSTED_CALLER;
|
||||
*pdwEnabledOptions = INTERFACESAFE_FOR_UNTRUSTED_DATA | INTERFACESAFE_FOR_UNTRUSTED_CALLER;
|
||||
return S_OK;
|
||||
}
|
||||
HRESULT WINAPI SetInterfaceSafetyOptions( REFIID riid, DWORD pdwSupportedOptions, DWORD pdwEnabledOptions )
|
||||
{
|
||||
return S_OK;
|
||||
}
|
||||
};
|
||||
</pre>The implementation of the <tt>createAggregate()</tt> function just returns a new
|
||||
<tt>ObjectSafetyImpl</tt> object.
|
||||
<pre> TQAxAggregated *GLBox::createAggregate()
|
||||
{
|
||||
return new ObjectSafetyImpl();
|
||||
}
|
||||
</pre>
|
||||
<p> To build the example you must first build the <a href="qaxserver.html">TQAxServer</a> library. Then run qmake and your make tool in
|
||||
<tt>examples/wrapper</tt>.
|
||||
<p> <hr>
|
||||
<p> The <a href="qaxserver-demo-opengl.html">demonstration</a> requires your
|
||||
WebBrowser to support ActiveX controls, and scripting to be enabled.
|
||||
<p> In contrast to the other TQAxServer examples Internet Explorer will not
|
||||
open a dialog box to ask the user whether or not the scripting of the GLBox
|
||||
control should be allowed (the exact browser behaviour depends on the security
|
||||
settings in the Internet Options dialog).
|
||||
<p>
|
||||
|
||||
<pre> <SCRIPT LANGUAGE=JavaScript>
|
||||
function setRot( form )
|
||||
{
|
||||
GLBox.setXRotation( form.XEdit.value );
|
||||
GLBox.setYRotation( form.YEdit.value );
|
||||
GLBox.setZRotation( form.ZEdit.value );
|
||||
}
|
||||
</SCRIPT>
|
||||
|
||||
<p>
|
||||
An OpenGL scene:<br>
|
||||
<object ID="GLBox" CLASSID="CLSID:5fd9c22e-ed45-43fa-ba13-1530bb6b03e0"
|
||||
CODEBASE=http://www.trolltech.com/demos/openglax.cab>
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
|
||||
<form>
|
||||
Rotate the scene:<br>
|
||||
X:<input type="edit" ID="XEdit" value="0"><br>
|
||||
Y:<input type="edit" name="YEdit" value="0"><br>
|
||||
Z:<input type="edit" name="ZEdit" value="0"><br>
|
||||
<input type="button" value="Set" onClick="setRot(this.form)">
|
||||
</form>
|
||||
</pre><p>See also <a href="qaxserver-examples.html">The TQAxServer Examples</a>.
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,182 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/simple/simple.doc:45 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>A simple ActiveTQt control (executable)</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>A simple ActiveTQt control (executable)</h1>
|
||||
|
||||
|
||||
|
||||
The ActiveX control in this example is a layouted <a href="tqwidget.html">TQWidget</a>
|
||||
with a <a href="ntqslider.html">TQSlider</a>, a <a href="ntqlcdnumber.html">TQLCDNumber</a> and a <a href="ntqlineedit.html">TQLineEdit</a>.
|
||||
It provides a signal/slot/property interface to change the
|
||||
values of the slider and the line edit, and to get notified
|
||||
of any property changes.
|
||||
<p> It demonstrates the use of <a href="qaxbindable.html#requestPropertyChange">TQAxBindable::requestPropertyChange</a>()
|
||||
and <a href="qaxbindable.html#propertyChanged">TQAxBindable::propertyChanged</a>(), and the use of the default
|
||||
<a href="qaxfactory.html">TQAxFactory</a> through the <a href="qaxfactory.html#TQAXFACTORY_DEFAULT">TQAXFACTORY_DEFAULT</a> macro.
|
||||
<p>
|
||||
|
||||
<p> The TQt implementation of the ActiveX for this example is
|
||||
<pre> class TQSimpleAX : public <a href="tqwidget.html">TQWidget</a>, public TQAxBindable
|
||||
{
|
||||
<a href="metaobjects.html#TQ_OBJECT">TQ_OBJECT</a>
|
||||
TQ_PROPERTY( TQString text READ text WRITE setText )
|
||||
TQ_PROPERTY( int value READ value WRITE setValue )
|
||||
public:
|
||||
TQSimpleAX( <a href="tqwidget.html">TQWidget</a> *parent = 0, const char *name = 0 )
|
||||
: <a href="tqwidget.html">TQWidget</a>( parent, name )
|
||||
{
|
||||
<a href="qvboxlayout.html">TQVBoxLayout</a> *vbox = new <a href="qvboxlayout.html">TQVBoxLayout</a>( this );
|
||||
|
||||
slider = new <a href="ntqslider.html">TQSlider</a>( 0, 100, 1, 0, TQSlider::Horizontal, this );
|
||||
LCD = new <a href="ntqlcdnumber.html">TQLCDNumber</a>( 3, this );
|
||||
edit = new <a href="ntqlineedit.html">TQLineEdit</a>( this );
|
||||
|
||||
<a name="x2528"></a> connect( slider, TQ_SIGNAL( <a href="ntqslider.html#valueChanged">valueChanged</a>( int ) ), this, TQ_SLOT( setValue(int) ) );
|
||||
<a name="x2523"></a> connect( edit, TQ_SIGNAL(<a href="ntqlineedit.html#textChanged">textChanged</a>(const <a href="tqstring.html">TQString</a>&)), this, TQ_SLOT(setText(const <a href="tqstring.html">TQString</a>&)) );
|
||||
|
||||
vbox-><a href="qboxlayout.html#addWidget">addWidget</a>( slider );
|
||||
vbox-><a href="qboxlayout.html#addWidget">addWidget</a>( LCD );
|
||||
vbox-><a href="qboxlayout.html#addWidget">addWidget</a>( edit );
|
||||
}
|
||||
|
||||
<a href="tqstring.html">TQString</a> text() const
|
||||
{
|
||||
<a name="x2522"></a> return edit-><a href="ntqlineedit.html#text">text</a>();
|
||||
}
|
||||
int value() const
|
||||
{
|
||||
<a name="x2527"></a> return slider-><a href="ntqslider.html#value">value</a>();
|
||||
}
|
||||
|
||||
signals:
|
||||
void someSignal();
|
||||
void valueChanged(int);
|
||||
void textChanged(const <a href="tqstring.html">TQString</a>&);
|
||||
|
||||
public slots:
|
||||
void setText( const <a href="tqstring.html">TQString</a> &string )
|
||||
{
|
||||
if ( !requestPropertyChange( "text" ) )
|
||||
return;
|
||||
|
||||
<a name="x2525"></a> edit-><a href="tqobject.html#blockSignals">blockSignals</a>( TRUE );
|
||||
<a name="x2521"></a> edit-><a href="ntqlineedit.html#setText">setText</a>( string );
|
||||
edit-><a href="tqobject.html#blockSignals">blockSignals</a>( FALSE );
|
||||
emit someSignal();
|
||||
emit textChanged( string );
|
||||
|
||||
propertyChanged( "text" );
|
||||
}
|
||||
void about()
|
||||
{
|
||||
<a name="x2524"></a> TQMessageBox::<a href="ntqmessagebox.html#information">information</a>( this, "About TQSimpleAX", "This is a TQt widget, and this slot has been\n"
|
||||
"called through ActiveX/OLE automation!" );
|
||||
}
|
||||
void setValue( int i )
|
||||
{
|
||||
if ( !requestPropertyChange( "value" ) )
|
||||
return;
|
||||
slider-><a href="tqobject.html#blockSignals">blockSignals</a>( TRUE );
|
||||
<a name="x2526"></a> slider-><a href="ntqslider.html#setValue">setValue</a>( i );
|
||||
slider-><a href="tqobject.html#blockSignals">blockSignals</a>( FALSE );
|
||||
LCD-><a href="ntqlcdnumber.html#display">display</a>( i );
|
||||
emit valueChanged( i );
|
||||
|
||||
propertyChanged( "value" );
|
||||
}
|
||||
|
||||
private:
|
||||
<a href="ntqslider.html">TQSlider</a> *slider;
|
||||
<a href="ntqlcdnumber.html">TQLCDNumber</a> *LCD;
|
||||
<a href="ntqlineedit.html">TQLineEdit</a> *edit;
|
||||
};
|
||||
</pre>
|
||||
<p> The control is exported using the default <a href="qaxfactory.html">TQAxFactory</a>
|
||||
<pre> TQAXFACTORY_DEFAULT(TQSimpleAX,
|
||||
"{DF16845C-92CD-4AAB-A982-EB9840E74669}",
|
||||
"{616F620B-91C5-4410-A74E-6B81C76FFFE0}",
|
||||
"{E1816BBA-BF5D-4A31-9855-D6BA432055FF}",
|
||||
"{EC08F8FC-2754-47AB-8EFE-56A54057F34E}",
|
||||
"{A095BA0C-224F-4933-A458-2DD7F6B85D8F}")
|
||||
</pre>
|
||||
<p> To build the example you must first build the <a href="qaxserver.html">TQAxServer</a> library. Then run qmake and your make tool in
|
||||
<tt>examples/simple</tt>.
|
||||
<p> <hr>
|
||||
<p> The <a href="qaxserver-demo-simple.html">demonstration</a> requires your
|
||||
WebBrowser to support ActiveX controls, and scripting to be enabled.
|
||||
<p> The simple ActiveX control is embedded using the <tt><object></tt> tag.
|
||||
|
||||
|
||||
<pre> <object ID="TQSimpleAX" CLASSID="CLSID:DF16845C-92CD-4AAB-A982-EB9840E74669"
|
||||
CODEBASE=http://www.trolltech.com/demos/simpleax.cab>
|
||||
<PARAM NAME="text" VALUE="A simple control">
|
||||
<PARAM NAME="value" VALUE="1">
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object>
|
||||
</pre>
|
||||
<p> A simple HTML button is connected to the <a href="activentqt.html#ActiveTQt">ActiveTQt</a>'s about() slot.
|
||||
<pre> <FORM>
|
||||
<INPUT TYPE="BUTTON" VALUE="About..." onClick="TQSimpleAX.about()">
|
||||
</FORM>
|
||||
</pre>
|
||||
<p> A second ActiveX control - the standard Calendar Control - is instantiated
|
||||
<pre> <object ID="Calendar" CLASSID="CLSID:8E27C92B-1264-101C-8A2F-040224009C02">
|
||||
[Standard Calendar control not available!]
|
||||
<PARAM NAME="day" VALUE="1">
|
||||
</object>
|
||||
</pre>
|
||||
<p> Events from the ActiveX controls are handled using both Visual Basic Script
|
||||
and JavaScript.
|
||||
<pre> <SCRIPT LANGUAGE=VBScript>
|
||||
Sub Calendar_Click()
|
||||
MsgBox( "Calendar Clicked!" )
|
||||
End Sub
|
||||
|
||||
Sub TQSimpleAX_TextChanged( str )
|
||||
document.title = str
|
||||
End Sub
|
||||
</SCRIPT>
|
||||
<SCRIPT LANGUAGE=JavaScript>
|
||||
function TQSimpleAX::ValueChanged( Newvalue )
|
||||
{
|
||||
Calendar.Day = Newvalue;
|
||||
}
|
||||
</SCRIPT>
|
||||
</pre><p>See also <a href="qaxserver-examples.html">The TQAxServer Examples</a>.
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,124 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/tetrax/tetrax.doc:27 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>A TQt example as a scriptable ActiveX control (executable)</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>A TQt example as a scriptable ActiveX control (executable)</h1>
|
||||
|
||||
|
||||
|
||||
This example shows how to turn an existing TQt application
|
||||
into an ActiveX control server. The ActiveX control is based
|
||||
on the TQt tetrix example.
|
||||
<p> It demonstrates the use of the default factory provied by the
|
||||
<a href="qaxfactory.html#TQAXFACTORY_DEFAULT">TQAXFACTORY_DEFAULT</a> macro, and of <a href="qaxfactory.html#isServer">TQAxFactory::isServer</a>().
|
||||
<p> The code changes for the tetrix GUI are minimal (a property <tt>score</tt>,
|
||||
a signal <tt>gameOver</tt> and a slot <tt>startGame</tt>) and provide a better scripting
|
||||
interface for the use of the control in a web environment.
|
||||
<p> The implementation of the ActiveX server functionality is only in the
|
||||
tetrax.cpp file.
|
||||
|
||||
|
||||
The default implementation of the <a href="qaxfactory.html">TQAxFactory</a> is used through the
|
||||
TQAXFACTORY_DEFAULT macro, and exports the TQTetrax object specifying
|
||||
the five unique IDs required by COM to instantiate and communicate with
|
||||
the server.
|
||||
<pre> #include "qtetrax.h"
|
||||
#include "qdragapp.h"
|
||||
#include "ntqfont.h"
|
||||
|
||||
#include <<a href="qaxfactory-h.html">qaxfactory.h</a>>
|
||||
|
||||
TQAXFACTORY_DEFAULT( TQTetrax,
|
||||
"{852558AD-CBD6-4f07-844C-D1E8983CD6FC}",
|
||||
"{2F5D0068-772C-4d1e-BCD2-D3F6BC7FD315}",
|
||||
"{769F4820-9F28-490f-BA50-5545BD381DCB}",
|
||||
"{5753B1A8-53B9-4abe-8690-6F14EC5CA8D0}",
|
||||
"{DE2F7CE3-CFA7-4938-A9FC-867E2FEB63BA}" )
|
||||
</pre>The <tt>main</tt> entry point method instantiates a <a href="ntqapplication.html">TQApplication</a> object, and
|
||||
creates the GUI only if the program is not running as an ActiveX server (ie.
|
||||
the program has been started by the user, not by COM).
|
||||
<pre> int main( int argc, char **argv )
|
||||
{
|
||||
<a name="x2716"></a> TQApplication::<a href="ntqapplication.html#setColorSpec">setColorSpec</a>( TQApplication::CustomColor );
|
||||
TQDragApplication a(argc,argv);
|
||||
|
||||
TQTetrax *tetrax = 0;
|
||||
if ( !TQAxFactory::isServer() ) {
|
||||
tetrax = new TQTetrax;
|
||||
<a name="x2718"></a> tetrax-><a href="tqwidget.html#setCaption">setCaption</a>("Tetrax");
|
||||
a.<a href="ntqapplication.html#setMainWidget">setMainWidget</a>(tetrax);
|
||||
tetrax-><a href="tqwidget.html#setCaption">setCaption</a>("TQt Example - Tetrax");
|
||||
tetrax-><a href="tqwidget.html#show">show</a>();
|
||||
}
|
||||
</pre>The server enters the application event loop, and destroys the GUI before exiting.
|
||||
<pre> int res = a.<a href="ntqapplication.html#exec">exec</a>();
|
||||
delete tetrax;
|
||||
return res;
|
||||
}
|
||||
</pre>
|
||||
<p> To build the example you must first build the <a href="qaxserver.html">TQAxServer</a> library. Then run qmake and your make tool in
|
||||
<tt>examples/tetrix</tt>.
|
||||
<p> <hr>
|
||||
<p> The <a href="qaxserver-demo-tetrax.html">demonstration</a> requires your
|
||||
Web browser to support ActiveX controls, and scripting to be enabled.
|
||||
<p>
|
||||
|
||||
The "Tetrix" control is embedded using the <tt><object></tt> tag. Note that the
|
||||
dimensions of the control are provided explicitely, as the control itself
|
||||
does not use TQt's layout engine.
|
||||
<pre> <object ID="TQTetrax" width=550 height=370
|
||||
CLASSID="CLSID:852558AD-CBD6-4f07-844C-D1E8983CD6FC"
|
||||
CODEBASE=http://www.trolltech.com/demos/tetrax.cab>
|
||||
<PARAM NAME="score" VALUE="0">
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object>
|
||||
</pre>An HTML button is added to start the game.
|
||||
<pre> <form>
|
||||
<input type="button" value="Start Game..."
|
||||
onClick="TQTetrax.startGame()">
|
||||
</form>
|
||||
</pre>And an event handler for the <tt>gameOver()</tt> event is implemented in JavaScript
|
||||
to display a simple message box.
|
||||
<pre> <SCRIPT LANGUAGE=JavaScript>
|
||||
function TQTetrax::gameOver()
|
||||
{
|
||||
alert( "GameOver!" );
|
||||
}
|
||||
</SCRIPT>
|
||||
</pre><p>See also <a href="qaxserver-examples.html">The TQAxServer Examples</a>.
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,207 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/wrapper/wrapper.doc:57 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>Standard TQt widgets as ActiveX controls (in-process)</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Standard TQt widgets as ActiveX controls (in-process)</h1>
|
||||
|
||||
|
||||
|
||||
The ActiveX controls in this example are the standard button
|
||||
classes <a href="ntqpushbutton.html">TQPushButton</a>, <a href="ntqcheckbox.html">TQCheckBox</a> and <a href="ntqradiobutton.html">TQRadioButton</a> as provided by
|
||||
TQt.
|
||||
<p> It demonstrates how to export existing <a href="tqwidget.html">TQWidget</a> classes as ActiveX
|
||||
controls, and the use of <a href="qaxfactory.html">TQAxFactory</a> together with the <a href="qaxfactory.html#TQAXFACTORY_EXPORT">TQAXFACTORY_EXPORT</a>
|
||||
macro.
|
||||
<p>
|
||||
|
||||
<pre> class ActiveTQtFactory : public <a href="qaxfactory.html">TQAxFactory</a>
|
||||
{
|
||||
public:
|
||||
ActiveTQtFactory( const <a href="ntquuid.html">TQUuid</a> &lib, const <a href="ntquuid.html">TQUuid</a> &app )
|
||||
: <a href="qaxfactory.html">TQAxFactory</a>( lib, app )
|
||||
{}
|
||||
<a href="tqstringlist.html">TQStringList</a> featureList() const
|
||||
{
|
||||
<a href="tqstringlist.html">TQStringList</a> list;
|
||||
list << "TQButton";
|
||||
list << "TQCheckBox";
|
||||
list << "TQRadioButton";
|
||||
list << "TQPushButton";
|
||||
list << "TQToolButton";
|
||||
return list;
|
||||
}
|
||||
<a href="tqwidget.html">TQWidget</a> *create( const <a href="tqstring.html">TQString</a> &key, TQWidget *parent, const char *name )
|
||||
{
|
||||
if ( key == "TQButton" )
|
||||
return new <a href="ntqbutton.html">TQButton</a>( parent, name );
|
||||
if ( key == "TQCheckBox" )
|
||||
return new <a href="ntqcheckbox.html">TQCheckBox</a>( parent, name );
|
||||
if ( key == "TQRadioButton" )
|
||||
return new <a href="ntqradiobutton.html">TQRadioButton</a>( parent, name );
|
||||
if ( key == "TQPushButton" )
|
||||
return new <a href="ntqpushbutton.html">TQPushButton</a>( parent, name );
|
||||
if ( key == "TQToolButton" ) {
|
||||
<a href="ntqtoolbutton.html">TQToolButton</a> *tb = new <a href="ntqtoolbutton.html">TQToolButton</a>( parent, name );
|
||||
<a name="x2518"></a> tb-><a href="ntqbutton.html#setPixmap">setPixmap</a>( TQPixmap(fileopen) );
|
||||
return tb;
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
<a href="ntqmetaobject.html">TQMetaObject</a> *metaObject( const <a href="tqstring.html">TQString</a> &key ) const
|
||||
{
|
||||
if ( key == "TQButton" )
|
||||
return TQButton::staticMetaObject();
|
||||
if ( key == "TQCheckBox" )
|
||||
return TQCheckBox::staticMetaObject();
|
||||
if ( key == "TQRadioButton" )
|
||||
return TQRadioButton::staticMetaObject();
|
||||
if ( key == "TQPushButton" )
|
||||
return TQPushButton::staticMetaObject();
|
||||
if ( key == "TQToolButton" )
|
||||
return TQToolButton::staticMetaObject();
|
||||
|
||||
return 0;
|
||||
}
|
||||
<a href="ntquuid.html">TQUuid</a> classID( const <a href="tqstring.html">TQString</a> &key ) const
|
||||
{
|
||||
if ( key == "TQButton" )
|
||||
return "{23F5012A-7333-43D3-BCA8-836AABC61B4A}";
|
||||
if ( key == "TQCheckBox" )
|
||||
return "{6E795DE9-872D-43CF-A831-496EF9D86C68}";
|
||||
if ( key == "TQRadioButton" )
|
||||
return "{AFCF78C8-446C-409A-93B3-BA2959039189}";
|
||||
if ( key == "TQPushButton" )
|
||||
return "{2B262458-A4B6-468B-B7D4-CF5FEE0A7092}";
|
||||
if ( key == "TQToolButton" )
|
||||
return "{7c0ffe7a-60c3-4666-bde2-5cf2b54390a1}";
|
||||
|
||||
return TQUuid();
|
||||
}
|
||||
<a href="ntquuid.html">TQUuid</a> interfaceID( const <a href="tqstring.html">TQString</a> &key ) const
|
||||
{
|
||||
if ( key == "TQButton" )
|
||||
return "{6DA689FB-928F-423C-8632-678C3D3606DB}";
|
||||
if ( key == "TQCheckBox" )
|
||||
return "{4FD39DD7-2DE0-43C1-A8C2-27C51A052810}";
|
||||
if ( key == "TQRadioButton" )
|
||||
return "{7CC8AE30-206C-48A3-A009-B0A088026C2F}";
|
||||
if ( key == "TQPushButton" )
|
||||
return "{06831CC9-59B6-436A-9578-6D53E5AD03D3}";
|
||||
if ( key == "TQToolButton" )
|
||||
return "{6726080f-d63d-4950-a366-9bf33e5cdf84}";
|
||||
|
||||
return TQUuid();
|
||||
}
|
||||
<a href="ntquuid.html">TQUuid</a> eventsID( const <a href="tqstring.html">TQString</a> &key ) const
|
||||
{
|
||||
if ( key == "TQButton" )
|
||||
return "{73A5D03F-8ADE-4D84-9AE0-A93B4F85A130}";
|
||||
if ( key == "TQCheckBox" )
|
||||
return "{FDB6FFBE-56A3-4E90-8F4D-198488418B3A}";
|
||||
if ( key == "TQRadioButton" )
|
||||
return "{73EE4860-684C-4A66-BF63-9B9EFFA0CBE5}";
|
||||
if ( key == "TQPushButton" )
|
||||
return "{3CC3F17F-EA59-4B58-BBD3-842D467131DD}";
|
||||
if ( key == "TQToolButton" )
|
||||
return "{f4d421fd-4ead-4fd9-8a25-440766939639}";
|
||||
|
||||
return TQUuid();
|
||||
}
|
||||
};
|
||||
</pre>The factory implementation returns the list of supported controls,
|
||||
creates controls on request and provides information about the unique
|
||||
IDs of the COM classes and interfaces for each control.
|
||||
<p> <pre> TQAXFACTORY_EXPORT( ActiveTQtFactory, "{3B756301-0075-4E40-8BE8-5A81DE2426B7}", "{AB068077-4924-406a-BBAF-42D91C8727DD}" )
|
||||
</pre>The factory is exported using the TQAXFACTORY_EXPORT macro.
|
||||
<p> To build the example you must first build the <a href="qaxserver.html">TQAxServer</a> library. Then run qmake and your make tool in
|
||||
<tt>examples/wrapper</tt>.
|
||||
<p> <hr>
|
||||
<p> The <a href="qaxserver-demo-wrapper.html">demonstration</a> requires your
|
||||
WebBrowser to support ActiveX controls, and scripting to be enabled.
|
||||
<p>
|
||||
|
||||
<pre> <SCRIPT LANGUAGE=VBScript>
|
||||
Sub ToolButton_Clicked()
|
||||
RadioButton.text = InputBox( "Enter something", "Wrapper Demo" )
|
||||
End Sub
|
||||
|
||||
Sub PushButton_clicked()
|
||||
MsgBox( "Thank you!" )
|
||||
End Sub
|
||||
|
||||
Sub CheckBox_toggled( state )
|
||||
if state = 0 then
|
||||
CheckBox.text = "Check me!"
|
||||
else
|
||||
CheckBox.text = "Uncheck me!"
|
||||
end if
|
||||
End Sub
|
||||
</SCRIPT>
|
||||
<p>
|
||||
A TQPushButton:<br>
|
||||
<object ID="PushButton" CLASSID="CLSID:2B262458-A4B6-468B-B7D4-CF5FEE0A7092"
|
||||
CODEBASE=http://www.trolltech.com/demos/wrapperax.cab>
|
||||
<PARAM NAME="text" VALUE="Click me!">
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
|
||||
<p>
|
||||
A TQCheckBox:<br>
|
||||
<object ID="CheckBox" CLASSID="CLSID:6E795de9-872d-43cf-a831-496ef9d86c68"
|
||||
CODEBASE=http://www.trolltech.com/demos/wrapperax.cab>
|
||||
<PARAM NAME="text" VALUE="Check me!">
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
|
||||
<p>
|
||||
A TQToolButton:<br>
|
||||
<object ID="ToolButton" CLASSID="CLSID:7c0ffe7a-60c3-4666-bde2-5cf2b54390a1"
|
||||
CODEBASE=http://www.trolltech.com/demos/wrapperax.cab>
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
|
||||
<p>
|
||||
A TQRadioButton:<br>
|
||||
<object ID="RadioButton" CLASSID="CLSID:afcf78c8-446c-409a-93b3-ba2959039189"
|
||||
CODEBASE=http://www.trolltech.com/demos/wrapperax.cab>
|
||||
<PARAM NAME="text" VALUE="Tune me!">
|
||||
[Object not available! Did you forget to build and register the server?]
|
||||
</object><br>
|
||||
</pre><p>See also <a href="qaxserver-examples.html">The TQAxServer Examples</a>.
|
||||
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,58 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/examples/examples.doc:24 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>The TQAxServer Examples</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>The TQAxServer Examples</h1>
|
||||
|
||||
|
||||
|
||||
The following example programs illustrate the development of ActiveX
|
||||
controls using the the TQAxServer module.
|
||||
<p> For more information see the <a href="qaxserver.html">TQAxServer</a>
|
||||
documentation.
|
||||
|
||||
<p><table width="100%">
|
||||
<tr bgcolor=#f0f0f0><td><b><a href="activeqt-dotnet.html">Walkthrough: Using TQt objects in Microsoft .NET</a></b>
|
||||
<tr bgcolor=#f0f0f0><td><b><a href="qaxserver-example-hierarchy.html">TQt Widget Hierarchy (in-process)</a></b>
|
||||
<tr bgcolor=#f0f0f0><td><b><a href="qaxserver-example-menus.html">Menubar merging</a></b>
|
||||
<tr bgcolor=#f0f0f0><td><b><a href="qaxserver-example-multiple.html">Two simple TQt widgets (in-process)</a></b>
|
||||
<tr bgcolor=#f0f0f0><td><b><a href="qaxserver-example-opengl.html">TQt' OpenGL widgets as an ActiveX (executable)</a></b>
|
||||
<tr bgcolor=#f0f0f0><td><b><a href="qaxserver-example-simple.html">A simple ActiveTQt control (executable)</a></b>
|
||||
<tr bgcolor=#f0f0f0><td><b><a href="qaxserver-example-tetrax.html">A TQt example as a scriptable ActiveX control (executable)</a></b>
|
||||
<tr bgcolor=#f0f0f0><td><b><a href="qaxserver-example-wrapper.html">Standard TQt widgets as ActiveX controls (in-process)</a></b>
|
||||
</table>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
File diff suppressed because it is too large
Load Diff
@ -1,121 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qaxwidget.h:1 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>qaxwidget.h Include File</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>qaxwidget.h</h1>
|
||||
|
||||
<p>This is the verbatim text of the qaxwidget.h include file. It is provided only for illustration; the copyright remains with Trolltech.
|
||||
<hr>
|
||||
<pre>
|
||||
/****************************************************************************
|
||||
** $Id: qt/qaxwidget.h 3.3.8 edited Jan 11 14:46 $
|
||||
**
|
||||
** Declaration of the TQAxWidget class
|
||||
**
|
||||
** Copyright (C) 2001-2007 Trolltech ASA. All rights reserved.
|
||||
**
|
||||
** This file is part of the Active TQt integration.
|
||||
**
|
||||
** Licensees holding valid TQt Enterprise Edition
|
||||
** licenses for Windows may use this file in accordance with the TQt Commercial
|
||||
** License Agreement provided with the Software.
|
||||
**
|
||||
** This file is not available for use under any other license without
|
||||
** express written permission from the copyright holder.
|
||||
**
|
||||
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
|
||||
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
||||
**
|
||||
** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
|
||||
** information about TQt Commercial License Agreements.
|
||||
**
|
||||
** Contact info@trolltech.com if any conditions of this licensing are
|
||||
** not clear to you.
|
||||
**
|
||||
**********************************************************************/
|
||||
|
||||
#ifndef TQAXWIDGET_H
|
||||
#define TQAXWIDGET_H
|
||||
|
||||
#include "qaxbase.h"
|
||||
#include <tqwidget.h>
|
||||
|
||||
class TQAxHostWindow;
|
||||
|
||||
class TQAxWidget : public TQWidget, public TQAxBase
|
||||
{
|
||||
public:
|
||||
TQMetaObject *metaObject() const;
|
||||
const char *className() const;
|
||||
void* tqt_cast( const char* );
|
||||
bool tqt_invoke( int, TQUObject* );
|
||||
bool tqt_emit( int, TQUObject* );
|
||||
bool tqt_property( int, int, TQVariant* );
|
||||
TQObject* qObject() { return (TQObject*)this; }
|
||||
|
||||
TQAxWidget( TQWidget* parent = 0, const char* name = 0, WFlags f = 0 );
|
||||
TQAxWidget( const TQString &c, TQWidget *parent = 0, const char *name = 0, WFlags f = 0 );
|
||||
TQAxWidget( IUnknown *iface, TQWidget *parent = 0, const char *name = 0, WFlags f = 0 );
|
||||
~TQAxWidget();
|
||||
|
||||
void clear();
|
||||
|
||||
TQSize sizeHint() const;
|
||||
TQSize minimumSizeHint() const;
|
||||
|
||||
protected:
|
||||
bool initialize( IUnknown** );
|
||||
virtual bool createHostWindow( bool );
|
||||
|
||||
void enabledChange( bool old );
|
||||
void paletteChange( const TQPalette &old );
|
||||
void fontChange( const TQFont &old );
|
||||
void windowActivationChange( bool old );
|
||||
|
||||
void resizeEvent( TQResizeEvent * );
|
||||
virtual bool translateKeyEvent(int message, int keycode) const;
|
||||
private:
|
||||
friend class TQAxHostWindow;
|
||||
|
||||
TQMetaObject *parentMetaObject() const;
|
||||
|
||||
TQAxHostWindow *container;
|
||||
};
|
||||
|
||||
#endif // TQAXWIDGET_H
|
||||
</pre>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,363 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qaxwidget.h:36 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxWidget Member List</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Complete Member List for TQAxWidget</h1>
|
||||
|
||||
<p>This is the complete list of member functions for
|
||||
<a href="qaxwidget.html">TQAxWidget</a>, including inherited members.
|
||||
|
||||
<ul>
|
||||
<li><a href="qaxwidget.html#TQAxWidget">TQAxWidget</a>()
|
||||
<li><a href="qaxwidget.html#~TQAxWidget">~TQAxWidget</a>()
|
||||
<li><a href="tqwidget.html#acceptDrops">acceptDrops</a>()
|
||||
<li><a href="tqwidget.html#adjustSize">adjustSize</a>()
|
||||
<li><a href="qaxbase.html#asVariant">asVariant</a>()
|
||||
<li><a href="tqwidget.html#autoMask">autoMask</a>()
|
||||
<li><a href="tqwidget.html#backgroundBrush">backgroundBrush</a>()
|
||||
<li><a href="tqwidget.html#backgroundColor">backgroundColor</a>()
|
||||
<li><a href="tqwidget.html#backgroundMode">backgroundMode</a>()
|
||||
<li><a href="tqwidget.html#backgroundOrigin">backgroundOrigin</a>()
|
||||
<li><a href="tqwidget.html#backgroundPixmap">backgroundPixmap</a>()
|
||||
<li><a href="tqwidget.html#baseSize">baseSize</a>()
|
||||
<li><a href="tqobject.html#blockSignals">blockSignals</a>()
|
||||
<li><a href="tqwidget.html#caption">caption</a>()
|
||||
<li><a href="tqobject.html#checkConnectArgs">checkConnectArgs</a>()
|
||||
<li><a href="tqobject.html#child">child</a>()
|
||||
<li><a href="tqwidget.html#childAt">childAt</a>()
|
||||
<li><a href="tqobject.html#childEvent">childEvent</a>()
|
||||
<li><a href="tqobject.html#children">children</a>()
|
||||
<li><a href="tqwidget.html#childrenRect">childrenRect</a>()
|
||||
<li><a href="tqwidget.html#childrenRegion">childrenRegion</a>()
|
||||
<li><a href="tqobject.html#className">className</a>()
|
||||
<li><a href="qaxbase.html#clear">clear</a>()
|
||||
<li><a href="tqwidget.html#clearFocus">clearFocus</a>()
|
||||
<li><a href="tqwidget.html#clearMask">clearMask</a>()
|
||||
<li><a href="tqwidget.html#clearWFlags">clearWFlags</a>()
|
||||
<li><a href="tqwidget.html#clipRegion">clipRegion</a>()
|
||||
<li><a href="tqwidget.html#close">close</a>()
|
||||
<li><a href="tqwidget.html#closeEvent">closeEvent</a>()
|
||||
<li><a href="ntqpaintdevice.html#cmd">cmd</a>()
|
||||
<li><a href="tqwidget.html#colorGroup">colorGroup</a>()
|
||||
<li><a href="tqobject.html#connect">connect</a>()
|
||||
<li><a href="tqobject.html#connectNotify">connectNotify</a>()
|
||||
<li><a href="tqwidget.html#constPolish">constPolish</a>()
|
||||
<li><a href="tqwidget.html#contextMenuEvent">contextMenuEvent</a>()
|
||||
<li><a href="qaxbase.html#control">control</a>()
|
||||
<li><a href="tqwidget.html#create">create</a>()
|
||||
<li><a href="qaxwidget.html#createHostWindow">createHostWindow</a>()
|
||||
<li><a href="tqwidget.html#cursor">cursor</a>()
|
||||
<li><a href="tqobject.html#customEvent">customEvent</a>()
|
||||
<li><a href="tqwidget.html#customWhatsThis">customWhatsThis</a>()
|
||||
<li><a href="tqobject.html#deleteLater">deleteLater</a>()
|
||||
<li><a href="tqwidget.html#destroy">destroy</a>()
|
||||
<li><a href="tqobject.html#destroyed">destroyed</a>()
|
||||
<li><a href="qaxbase.html#disableClassInfo">disableClassInfo</a>()
|
||||
<li><a href="qaxbase.html#disableEventSink">disableEventSink</a>()
|
||||
<li><a href="qaxbase.html#disableMetaObject">disableMetaObject</a>()
|
||||
<li><a href="tqobject.html#disconnect">disconnect</a>()
|
||||
<li><a href="tqobject.html#disconnectNotify">disconnectNotify</a>()
|
||||
<li><a href="tqwidget.html#dragEnterEvent">dragEnterEvent</a>()
|
||||
<li><a href="tqwidget.html#dragLeaveEvent">dragLeaveEvent</a>()
|
||||
<li><a href="tqwidget.html#dragMoveEvent">dragMoveEvent</a>()
|
||||
<li><a href="tqwidget.html#drawText">drawText</a>()
|
||||
<li><a href="tqwidget.html#dropEvent">dropEvent</a>()
|
||||
<li><a href="tqobject.html#dumpObjectInfo">dumpObjectInfo</a>()
|
||||
<li><a href="tqobject.html#dumpObjectTree">dumpObjectTree</a>()
|
||||
<li><a href="qaxbase.html#dynamicCall">dynamicCall</a>()
|
||||
<li><a href="tqwidget.html#enabledChange">enabledChange</a>()
|
||||
<li><a href="tqwidget.html#enterEvent">enterEvent</a>()
|
||||
<li><a href="tqwidget.html#erase">erase</a>()
|
||||
<li><a href="tqwidget.html#eraseColor">eraseColor</a>()
|
||||
<li><a href="tqwidget.html#erasePixmap">erasePixmap</a>()
|
||||
<li><a href="tqwidget.html#event">event</a>()
|
||||
<li><a href="tqobject.html#eventFilter">eventFilter</a>()
|
||||
<li><a href="qaxbase.html#exception">exception</a>()
|
||||
<li><a href="tqwidget.html#find">find</a>()
|
||||
<li><a href="tqwidget.html#focusData">focusData</a>()
|
||||
<li><a href="tqwidget.html#focusInEvent">focusInEvent</a>()
|
||||
<li><a href="tqwidget.html#focusNextPrevChild">focusNextPrevChild</a>()
|
||||
<li><a href="tqwidget.html#focusOutEvent">focusOutEvent</a>()
|
||||
<li><a href="tqwidget.html#focusPolicy">focusPolicy</a>()
|
||||
<li><a href="tqwidget.html#focusProxy">focusProxy</a>()
|
||||
<li><a href="tqwidget.html#focusWidget">focusWidget</a>()
|
||||
<li><a href="tqwidget.html#font">font</a>()
|
||||
<li><a href="tqwidget.html#fontChange">fontChange</a>()
|
||||
<li><a href="tqwidget.html#fontInfo">fontInfo</a>()
|
||||
<li><a href="tqwidget.html#fontMetrics">fontMetrics</a>()
|
||||
<li><a href="tqwidget.html#foregroundColor">foregroundColor</a>()
|
||||
<li><a href="tqwidget.html#frameGeometry">frameGeometry</a>()
|
||||
<li><a href="tqwidget.html#frameSize">frameSize</a>()
|
||||
<li><a href="qaxbase.html#generateDocumentation">generateDocumentation</a>()
|
||||
<li><a href="tqwidget.html#geometry">geometry</a>()
|
||||
<li><a href="tqwidget.html#getWFlags">getWFlags</a>()
|
||||
<li><a href="tqwidget.html#grabKeyboard">grabKeyboard</a>()
|
||||
<li><a href="tqwidget.html#grabMouse">grabMouse</a>()
|
||||
<li><a href="ntqpaintdevice.html#handle">handle</a>()
|
||||
<li><a href="tqwidget.html#hasFocus">hasFocus</a>()
|
||||
<li><a href="tqwidget.html#hasMouse">hasMouse</a>()
|
||||
<li><a href="tqwidget.html#hasMouseTracking">hasMouseTracking</a>()
|
||||
<li><a href="tqwidget.html#height">height</a>()
|
||||
<li><a href="tqwidget.html#heightForWidth">heightForWidth</a>()
|
||||
<li><a href="tqwidget.html#hide">hide</a>()
|
||||
<li><a href="tqwidget.html#hideEvent">hideEvent</a>()
|
||||
<li><a href="tqobject.html#highPriority">highPriority</a>()
|
||||
<li><a href="tqwidget.html#icon">icon</a>()
|
||||
<li><a href="tqwidget.html#iconText">iconText</a>()
|
||||
<li><a href="tqwidget.html#iconify">iconify</a>()
|
||||
<li><a href="tqwidget.html#imComposeEvent">imComposeEvent</a>()
|
||||
<li><a href="tqwidget.html#imEndEvent">imEndEvent</a>()
|
||||
<li><a href="tqwidget.html#imStartEvent">imStartEvent</a>()
|
||||
<li><a href="tqobject.html#inherits">inherits</a>()
|
||||
<li><a href="qaxbase.html#initialize">initialize</a>()
|
||||
<li><a href="qaxbase.html#initializeActive">initializeActive</a>()
|
||||
<li><a href="qaxbase.html#initializeLicensed">initializeLicensed</a>()
|
||||
<li><a href="qaxbase.html#initializeRemote">initializeRemote</a>()
|
||||
<li><a href="tqobject.html#insertChild">insertChild</a>()
|
||||
<li><a href="tqobject.html#installEventFilter">installEventFilter</a>()
|
||||
<li><a href="tqobject.html#isA">isA</a>()
|
||||
<li><a href="tqwidget.html#isActiveWindow">isActiveWindow</a>()
|
||||
<li><a href="tqwidget.html#isDesktop">isDesktop</a>()
|
||||
<li><a href="tqwidget.html#isDialog">isDialog</a>()
|
||||
<li><a href="tqwidget.html#isEnabled">isEnabled</a>()
|
||||
<li><a href="tqwidget.html#isEnabledTo">isEnabledTo</a>()
|
||||
<li><a href="tqwidget.html#isEnabledToTLW">isEnabledToTLW</a>()
|
||||
<li><a href="ntqpaintdevice.html#isExtDev">isExtDev</a>()
|
||||
<li><a href="tqwidget.html#isFocusEnabled">isFocusEnabled</a>()
|
||||
<li><a href="tqwidget.html#isFullScreen">isFullScreen</a>()
|
||||
<li><a href="tqwidget.html#isHidden">isHidden</a>()
|
||||
<li><a href="tqwidget.html#isInputMethodEnabled">isInputMethodEnabled</a>()
|
||||
<li><a href="tqwidget.html#isMaximized">isMaximized</a>()
|
||||
<li><a href="tqwidget.html#isMinimized">isMinimized</a>()
|
||||
<li><a href="tqwidget.html#isModal">isModal</a>()
|
||||
<li><a href="qaxbase.html#isNull">isNull</a>()
|
||||
<li><a href="tqwidget.html#isPopup">isPopup</a>()
|
||||
<li><a href="tqwidget.html#isShown">isShown</a>()
|
||||
<li><a href="tqwidget.html#isTopLevel">isTopLevel</a>()
|
||||
<li><a href="tqwidget.html#isUpdatesEnabled">isUpdatesEnabled</a>()
|
||||
<li><a href="tqwidget.html#isVisible">isVisible</a>()
|
||||
<li><a href="tqwidget.html#isVisibleTo">isVisibleTo</a>()
|
||||
<li><a href="tqwidget.html#isVisibleToTLW">isVisibleToTLW</a>()
|
||||
<li><a href="tqobject.html#isWidgetType">isWidgetType</a>()
|
||||
<li><a href="tqwidget.html#keyPressEvent">keyPressEvent</a>()
|
||||
<li><a href="tqwidget.html#keyReleaseEvent">keyReleaseEvent</a>()
|
||||
<li><a href="tqwidget.html#keyboardGrabber">keyboardGrabber</a>()
|
||||
<li><a href="tqobject.html#killTimer">killTimer</a>()
|
||||
<li><a href="tqobject.html#killTimers">killTimers</a>()
|
||||
<li><a href="tqwidget.html#layout">layout</a>()
|
||||
<li><a href="tqwidget.html#leaveEvent">leaveEvent</a>()
|
||||
<li><a href="tqwidget.html#lower">lower</a>()
|
||||
<li><a href="tqwidget.html#macEvent">macEvent</a>()
|
||||
<li><a href="tqwidget.html#mapFrom">mapFrom</a>()
|
||||
<li><a href="tqwidget.html#mapFromGlobal">mapFromGlobal</a>()
|
||||
<li><a href="tqwidget.html#mapFromParent">mapFromParent</a>()
|
||||
<li><a href="tqwidget.html#mapTo">mapTo</a>()
|
||||
<li><a href="tqwidget.html#mapToGlobal">mapToGlobal</a>()
|
||||
<li><a href="tqwidget.html#mapToParent">mapToParent</a>()
|
||||
<li><a href="tqwidget.html#maximumHeight">maximumHeight</a>()
|
||||
<li><a href="tqwidget.html#maximumSize">maximumSize</a>()
|
||||
<li><a href="tqwidget.html#maximumWidth">maximumWidth</a>()
|
||||
<li><a href="tqobject.html#metaObject">metaObject</a>()
|
||||
<li><a href="tqwidget.html#metric">metric</a>()
|
||||
<li><a href="tqwidget.html#microFocusHint">microFocusHint</a>()
|
||||
<li><a href="tqwidget.html#minimumHeight">minimumHeight</a>()
|
||||
<li><a href="tqwidget.html#minimumSize">minimumSize</a>()
|
||||
<li><a href="tqwidget.html#minimumSizeHint">minimumSizeHint</a>()
|
||||
<li><a href="tqwidget.html#minimumWidth">minimumWidth</a>()
|
||||
<li><a href="tqwidget.html#mouseDoubleClickEvent">mouseDoubleClickEvent</a>()
|
||||
<li><a href="tqwidget.html#mouseGrabber">mouseGrabber</a>()
|
||||
<li><a href="tqwidget.html#mouseMoveEvent">mouseMoveEvent</a>()
|
||||
<li><a href="tqwidget.html#mousePressEvent">mousePressEvent</a>()
|
||||
<li><a href="tqwidget.html#mouseReleaseEvent">mouseReleaseEvent</a>()
|
||||
<li><a href="tqwidget.html#move">move</a>()
|
||||
<li><a href="tqwidget.html#moveEvent">moveEvent</a>()
|
||||
<li><a href="tqobject.html#name">name</a>()
|
||||
<li><a href="tqobject.html#normalizeSignalSlot">normalizeSignalSlot</a>()
|
||||
<li><a href="tqobject.html#objectTrees">objectTrees</a>()
|
||||
<li><a href="tqwidget.html#ownCursor">ownCursor</a>()
|
||||
<li><a href="tqwidget.html#ownFont">ownFont</a>()
|
||||
<li><a href="tqwidget.html#ownPalette">ownPalette</a>()
|
||||
<li><a href="tqwidget.html#paintEvent">paintEvent</a>()
|
||||
<li><a href="ntqpaintdevice.html#paintingActive">paintingActive</a>()
|
||||
<li><a href="tqwidget.html#palette">palette</a>()
|
||||
<li><a href="tqwidget.html#paletteBackgroundColor">paletteBackgroundColor</a>()
|
||||
<li><a href="tqwidget.html#paletteBackgroundPixmap">paletteBackgroundPixmap</a>()
|
||||
<li><a href="tqwidget.html#paletteChange">paletteChange</a>()
|
||||
<li><a href="tqwidget.html#paletteForegroundColor">paletteForegroundColor</a>()
|
||||
<li><a href="tqobject.html#parent">parent</a>()
|
||||
<li><a href="tqwidget.html#parentWidget">parentWidget</a>()
|
||||
<li><a href="tqwidget.html#polish">polish</a>()
|
||||
<li><a href="tqwidget.html#pos">pos</a>()
|
||||
<li><a href="tqobject.html#property">property</a>()
|
||||
<li><a href="qaxbase.html#propertyBag">propertyBag</a>()
|
||||
<li><a href="qaxbase.html#propertyChanged">propertyChanged</a>()
|
||||
<li><a href="qaxbase.html#propertyWritable">propertyWritable</a>()
|
||||
<li><a href="qaxbase.html#queryInterface">queryInterface</a>()
|
||||
<li><a href="tqobject.html#queryList">queryList</a>()
|
||||
<li><a href="qaxbase.html#querySubObject">querySubObject</a>()
|
||||
<li><a href="tqwidget.html#qwsEvent">qwsEvent</a>()
|
||||
<li><a href="tqwidget.html#raise">raise</a>()
|
||||
<li><a href="tqwidget.html#recreate">recreate</a>()
|
||||
<li><a href="tqwidget.html#rect">rect</a>()
|
||||
<li><a href="tqwidget.html#releaseKeyboard">releaseKeyboard</a>()
|
||||
<li><a href="tqwidget.html#releaseMouse">releaseMouse</a>()
|
||||
<li><a href="tqobject.html#removeChild">removeChild</a>()
|
||||
<li><a href="tqobject.html#removeEventFilter">removeEventFilter</a>()
|
||||
<li><a href="tqwidget.html#repaint">repaint</a>()
|
||||
<li><a href="tqwidget.html#reparent">reparent</a>()
|
||||
<li><a href="tqwidget.html#resetInputContext">resetInputContext</a>()
|
||||
<li><a href="tqwidget.html#resize">resize</a>()
|
||||
<li><a href="tqwidget.html#resizeEvent">resizeEvent</a>()
|
||||
<li><a href="tqwidget.html#scroll">scroll</a>()
|
||||
<li><a href="tqobject.html#sender">sender</a>()
|
||||
<li><a href="tqwidget.html#setAcceptDrops">setAcceptDrops</a>()
|
||||
<li><a href="tqwidget.html#setActiveWindow">setActiveWindow</a>()
|
||||
<li><a href="tqwidget.html#setAutoMask">setAutoMask</a>()
|
||||
<li><a href="tqwidget.html#setBackgroundColor">setBackgroundColor</a>()
|
||||
<li><a href="tqwidget.html#setBackgroundMode">setBackgroundMode</a>()
|
||||
<li><a href="tqwidget.html#setBackgroundOrigin">setBackgroundOrigin</a>()
|
||||
<li><a href="tqwidget.html#setBackgroundPixmap">setBackgroundPixmap</a>()
|
||||
<li><a href="tqwidget.html#setBaseSize">setBaseSize</a>()
|
||||
<li><a href="tqwidget.html#setCaption">setCaption</a>()
|
||||
<li><a href="qaxbase.html#setControl">setControl</a>()
|
||||
<li><a href="tqwidget.html#setCursor">setCursor</a>()
|
||||
<li><a href="tqwidget.html#setDisabled">setDisabled</a>()
|
||||
<li><a href="tqwidget.html#setEnabled">setEnabled</a>()
|
||||
<li><a href="tqwidget.html#setEraseColor">setEraseColor</a>()
|
||||
<li><a href="tqwidget.html#setErasePixmap">setErasePixmap</a>()
|
||||
<li><a href="tqwidget.html#setFixedHeight">setFixedHeight</a>()
|
||||
<li><a href="tqwidget.html#setFixedSize">setFixedSize</a>()
|
||||
<li><a href="tqwidget.html#setFixedWidth">setFixedWidth</a>()
|
||||
<li><a href="tqwidget.html#setFocus">setFocus</a>()
|
||||
<li><a href="tqwidget.html#setFocusPolicy">setFocusPolicy</a>()
|
||||
<li><a href="tqwidget.html#setFocusProxy">setFocusProxy</a>()
|
||||
<li><a href="tqwidget.html#setFont">setFont</a>()
|
||||
<li><a href="tqwidget.html#setGeometry">setGeometry</a>()
|
||||
<li><a href="tqwidget.html#setHidden">setHidden</a>()
|
||||
<li><a href="tqwidget.html#setIcon">setIcon</a>()
|
||||
<li><a href="tqwidget.html#setIconText">setIconText</a>()
|
||||
<li><a href="tqwidget.html#setInputMethodEnabled">setInputMethodEnabled</a>()
|
||||
<li><a href="tqwidget.html#setKeyCompression">setKeyCompression</a>()
|
||||
<li><a href="tqwidget.html#setMask">setMask</a>()
|
||||
<li><a href="tqwidget.html#setMaximumHeight">setMaximumHeight</a>()
|
||||
<li><a href="tqwidget.html#setMaximumSize">setMaximumSize</a>()
|
||||
<li><a href="tqwidget.html#setMaximumWidth">setMaximumWidth</a>()
|
||||
<li><a href="tqwidget.html#setMicroFocusHint">setMicroFocusHint</a>()
|
||||
<li><a href="tqwidget.html#setMinimumHeight">setMinimumHeight</a>()
|
||||
<li><a href="tqwidget.html#setMinimumSize">setMinimumSize</a>()
|
||||
<li><a href="tqwidget.html#setMinimumWidth">setMinimumWidth</a>()
|
||||
<li><a href="tqwidget.html#setMouseTracking">setMouseTracking</a>()
|
||||
<li><a href="tqobject.html#setName">setName</a>()
|
||||
<li><a href="tqwidget.html#setPalette">setPalette</a>()
|
||||
<li><a href="tqwidget.html#setPaletteBackgroundColor">setPaletteBackgroundColor</a>()
|
||||
<li><a href="tqwidget.html#setPaletteBackgroundPixmap">setPaletteBackgroundPixmap</a>()
|
||||
<li><a href="tqwidget.html#setPaletteForegroundColor">setPaletteForegroundColor</a>()
|
||||
<li><a href="tqobject.html#setProperty">setProperty</a>()
|
||||
<li><a href="qaxbase.html#setPropertyBag">setPropertyBag</a>()
|
||||
<li><a href="qaxbase.html#setPropertyWritable">setPropertyWritable</a>()
|
||||
<li><a href="tqwidget.html#setShown">setShown</a>()
|
||||
<li><a href="tqwidget.html#setSizeIncrement">setSizeIncrement</a>()
|
||||
<li><a href="tqwidget.html#setSizePolicy">setSizePolicy</a>()
|
||||
<li><a href="tqwidget.html#setStyle">setStyle</a>()
|
||||
<li><a href="tqwidget.html#setTabOrder">setTabOrder</a>()
|
||||
<li><a href="tqwidget.html#setUpdatesEnabled">setUpdatesEnabled</a>()
|
||||
<li><a href="tqwidget.html#setWFlags">setWFlags</a>()
|
||||
<li><a href="tqwidget.html#setWindowOpacity">setWindowOpacity</a>()
|
||||
<li><a href="tqwidget.html#setWindowState">setWindowState</a>()
|
||||
<li><a href="tqwidget.html#show">show</a>()
|
||||
<li><a href="tqwidget.html#showEvent">showEvent</a>()
|
||||
<li><a href="tqwidget.html#showFullScreen">showFullScreen</a>()
|
||||
<li><a href="tqwidget.html#showMaximized">showMaximized</a>()
|
||||
<li><a href="tqwidget.html#showMinimized">showMinimized</a>()
|
||||
<li><a href="tqwidget.html#showNormal">showNormal</a>()
|
||||
<li><a href="qaxbase.html#signal">signal</a>()
|
||||
<li><a href="tqobject.html#signalsBlocked">signalsBlocked</a>()
|
||||
<li><a href="tqwidget.html#size">size</a>()
|
||||
<li><a href="tqwidget.html#sizeHint">sizeHint</a>()
|
||||
<li><a href="tqwidget.html#sizeIncrement">sizeIncrement</a>()
|
||||
<li><a href="tqwidget.html#sizePolicy">sizePolicy</a>()
|
||||
<li><a href="tqwidget.html#stackUnder">stackUnder</a>()
|
||||
<li><a href="tqobject.html#startTimer">startTimer</a>()
|
||||
<li><a href="tqwidget.html#style">style</a>()
|
||||
<li><a href="tqwidget.html#styleChange">styleChange</a>()
|
||||
<li><a href="tqwidget.html#tabletEvent">tabletEvent</a>()
|
||||
<li><a href="tqwidget.html#testWFlags">testWFlags</a>()
|
||||
<li><a href="tqobject.html#timerEvent">timerEvent</a>()
|
||||
<li><a href="tqwidget.html#topLevelWidget">topLevelWidget</a>()
|
||||
<li><a href="tqobject.html#tr">tr</a>()
|
||||
<li><a href="tqobject.html#trUtf8">trUtf8</a>()
|
||||
<li><a href="qaxwidget.html#translateKeyEvent">translateKeyEvent</a>()
|
||||
<li><a href="tqwidget.html#unsetCursor">unsetCursor</a>()
|
||||
<li><a href="tqwidget.html#unsetFont">unsetFont</a>()
|
||||
<li><a href="tqwidget.html#unsetPalette">unsetPalette</a>()
|
||||
<li><a href="tqwidget.html#update">update</a>()
|
||||
<li><a href="tqwidget.html#updateGeometry">updateGeometry</a>()
|
||||
<li><a href="tqwidget.html#updateMask">updateMask</a>()
|
||||
<li><a href="tqwidget.html#visibleRect">visibleRect</a>()
|
||||
<li><a href="tqwidget.html#wheelEvent">wheelEvent</a>()
|
||||
<li><a href="tqwidget.html#width">width</a>()
|
||||
<li><a href="tqwidget.html#winEvent">winEvent</a>()
|
||||
<li><a href="tqwidget.html#winId">winId</a>()
|
||||
<li><a href="tqwidget.html#windowActivationChange">windowActivationChange</a>()
|
||||
<li><a href="tqwidget.html#windowOpacity">windowOpacity</a>()
|
||||
<li><a href="tqwidget.html#windowState">windowState</a>()
|
||||
<li><a href="tqwidget.html#x">x</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11AppCells">x11AppCells</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11AppColormap">x11AppColormap</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11AppDefaultColormap">x11AppDefaultColormap</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11AppDefaultVisual">x11AppDefaultVisual</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11AppDepth">x11AppDepth</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11AppDisplay">x11AppDisplay</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11AppDpiX">x11AppDpiX</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11AppDpiY">x11AppDpiY</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11AppRootWindow">x11AppRootWindow</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11AppScreen">x11AppScreen</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11AppVisual">x11AppVisual</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11Cells">x11Cells</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11Colormap">x11Colormap</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11DefaultColormap">x11DefaultColormap</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11DefaultVisual">x11DefaultVisual</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11Depth">x11Depth</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11Display">x11Display</a>()
|
||||
<li><a href="tqwidget.html#x11Event">x11Event</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11Screen">x11Screen</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11SetAppDpiX">x11SetAppDpiX</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11SetAppDpiY">x11SetAppDpiY</a>()
|
||||
<li><a href="ntqpaintdevice.html#x11Visual">x11Visual</a>()
|
||||
<li><a href="tqwidget.html#y">y</a>()
|
||||
</ul>
|
||||
<!-- eof -->
|
||||
<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1,250 +0,0 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||||
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/activeqt/container/qaxwidget.cpp:1336 -->
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<title>TQAxWidget Class</title>
|
||||
<style type="text/css"><!--
|
||||
fn { margin-left: 1cm; text-indent: -1cm; }
|
||||
a:link { color: #004faf; text-decoration: none }
|
||||
a:visited { color: #672967; text-decoration: none }
|
||||
body { background: #ffffff; color: black; }
|
||||
--></style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||||
<tr bgcolor="#E5E5E5">
|
||||
<td valign=center>
|
||||
<a href="index.html">
|
||||
<font color="#004faf">Home</font></a>
|
||||
| <a href="classes.html">
|
||||
<font color="#004faf">All Classes</font></a>
|
||||
| <a href="mainclasses.html">
|
||||
<font color="#004faf">Main Classes</font></a>
|
||||
| <a href="annotated.html">
|
||||
<font color="#004faf">Annotated</font></a>
|
||||
| <a href="groups.html">
|
||||
<font color="#004faf">Grouped Classes</font></a>
|
||||
| <a href="functions.html">
|
||||
<font color="#004faf">Functions</font></a>
|
||||
</td>
|
||||
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQAxWidget Class Reference<br><small>[<a href="qaxcontainer.html">TQAxContainer module</a>]</small></h1>
|
||||
|
||||
<p>The TQAxWidget class is a TQWidget that wraps an ActiveX control.
|
||||
<a href="#details">More...</a>
|
||||
<p>This class is part of the <b>TQt ActiveTQt Extension</b>.
|
||||
<p><tt>#include <<a href="qaxwidget-h.html">qaxwidget.h</a>></tt>
|
||||
<p>Inherits <a href="tqwidget.html">TQWidget</a> and <a href="qaxbase.html">TQAxBase</a>.
|
||||
<p><a href="qaxwidget-members.html">List of all member functions.</a>
|
||||
<h2>Public Members</h2>
|
||||
<ul>
|
||||
<li class=fn><a href="#TQAxWidget"><b>TQAxWidget</b></a> ( TQWidget * parent = 0, const char * name = 0, WFlags f = 0 )</li>
|
||||
<li class=fn><a href="#TQAxWidget-2"><b>TQAxWidget</b></a> ( const TQString & c, TQWidget * parent = 0, const char * name = 0, WFlags f = 0 )</li>
|
||||
<li class=fn><a href="#TQAxWidget-3"><b>TQAxWidget</b></a> ( IUnknown * iface, TQWidget * parent = 0, const char * name = 0, WFlags f = 0 )</li>
|
||||
<li class=fn><a href="#~TQAxWidget"><b>~TQAxWidget</b></a> ()</li>
|
||||
</ul>
|
||||
<h2>Important Inherited Members</h2>
|
||||
<ul>
|
||||
<li class=fn>TQVariant <a href="#dynamicCall"><b>dynamicCall</b></a> ( const TQCString & function, const TQVariant & var1 = TQVariant ( ), const TQVariant & var2 = TQVariant ( ), const TQVariant & var3 = TQVariant ( ), const TQVariant & var4 = TQVariant ( ), const TQVariant & var5 = TQVariant ( ), const TQVariant & var6 = TQVariant ( ), const TQVariant & var7 = TQVariant ( ), const TQVariant & var8 = TQVariant ( ) )</li>
|
||||
<li class=fn>TQVariant <a href="#dynamicCall-2"><b>dynamicCall</b></a> ( const TQCString & function, TQValueList<TQVariant> & vars )</li>
|
||||
<li class=fn>TQAxObject * <a href="#querySubObject"><b>querySubObject</b></a> ( const TQCString & name, const TQVariant & var1 = TQVariant ( ), const TQVariant & var2 = TQVariant ( ), const TQVariant & var3 = TQVariant ( ), const TQVariant & var4 = TQVariant ( ), const TQVariant & var5 = TQVariant ( ), const TQVariant & var6 = TQVariant ( ), const TQVariant & var7 = TQVariant ( ), const TQVariant & var8 = TQVariant ( ) )</li>
|
||||
</ul>
|
||||
<h2>Protected Members</h2>
|
||||
<ul>
|
||||
<li class=fn>virtual bool <a href="#createHostWindow"><b>createHostWindow</b></a> ( bool initialized )</li>
|
||||
<li class=fn>virtual bool <a href="#translateKeyEvent"><b>translateKeyEvent</b></a> ( int message, int keycode ) const</li>
|
||||
</ul>
|
||||
<hr><a name="details"></a><h2>Detailed Description</h2>
|
||||
<p> This class is defined in the <b>TQt <a href="activentqt.html#ActiveTQt">ActiveTQt</a> Extension</b>, which can be found in the <tt>qt/extensions</tt> directory. It is not included in the main TQt API.
|
||||
<p>
|
||||
|
||||
The TQAxWidget class is a <a href="tqwidget.html">TQWidget</a> that wraps an ActiveX control.
|
||||
|
||||
<p>
|
||||
|
||||
<p> A TQAxWidget can be instantiated as an empty object, with the name
|
||||
of the ActiveX control it should wrap, or with an existing
|
||||
interface pointer to the ActiveX control. The ActiveX control's
|
||||
properties, methods and events which only use <a href="qaxbase.html">supported data types</a>, become available as TQt properties,
|
||||
slots and signals. The base class <a href="qaxbase.html">TQAxBase</a> provides an API to
|
||||
access the ActiveX directly through the IUnknown pointer.
|
||||
<p> TQAxWidget is a TQWidget and can be used as such, e.g. it can be
|
||||
organized in a widget hierarchy, receive events or act as an event
|
||||
filter. Standard widget properties, e.g. <a href="tqwidget.html#enabled-prop">enabled</a> are supported, but it depends on the ActiveX
|
||||
control to implement support for ambient properties like e.g.
|
||||
palette or font. TQAxWidget tries to provide the necessary hints.
|
||||
<p> <b>Warning:</b>
|
||||
You can subclass TQAxWidget, but you cannot use the <a href="metaobjects.html#TQ_OBJECT">TQ_OBJECT</a> macro
|
||||
in the subclass (the generated <a href="moc.html#moc">moc</a>-file will not compile), so you
|
||||
cannot add further signals, slots or properties. This limitation
|
||||
is due to the metaobject information generated in runtime. To work
|
||||
around this problem, aggregate the TQAxWidget as a member of the
|
||||
<a href="tqobject.html">TQObject</a> subclass.
|
||||
<p>
|
||||
<hr><h2>Member Function Documentation</h2>
|
||||
<h3 class=fn><a name="TQAxWidget"></a>TQAxWidget::TQAxWidget ( <a href="tqwidget.html">TQWidget</a> * parent = 0, const char * name = 0, WFlags f = 0 )
|
||||
</h3>
|
||||
Creates an empty TQAxWidget widget and propagates <em>parent</em>, <em>name</em> and <em>f</em> to the <a href="tqwidget.html">TQWidget</a> constructor. To initialize a control,
|
||||
call <a href="qaxbase.html#setControl">setControl</a>.
|
||||
|
||||
<h3 class=fn><a name="TQAxWidget-2"></a>TQAxWidget::TQAxWidget ( const <a href="tqstring.html">TQString</a> & c, <a href="tqwidget.html">TQWidget</a> * parent = 0, const char * name = 0, WFlags f = 0 )
|
||||
</h3>
|
||||
Creates an TQAxWidget widget and initializes the ActiveX control <em>c</em>.
|
||||
<em>parent</em>, <em>name</em> and <em>f</em> are propagated to the <a href="tqwidget.html">TQWidget</a> contructor.
|
||||
<p> <p>See also <a href="qaxbase.html#control-prop">control</a>.
|
||||
|
||||
<h3 class=fn><a name="TQAxWidget-3"></a>TQAxWidget::TQAxWidget ( IUnknown * iface, <a href="tqwidget.html">TQWidget</a> * parent = 0, const char * name = 0, WFlags f = 0 )
|
||||
</h3>
|
||||
Creates a TQAxWidget that wraps the COM object referenced by <em>iface</em>.
|
||||
<em>parent</em>, <em>name</em> and <em>f</em> are propagated to the <a href="tqwidget.html">TQWidget</a> contructor.
|
||||
|
||||
<h3 class=fn><a name="~TQAxWidget"></a>TQAxWidget::~TQAxWidget ()
|
||||
</h3>
|
||||
Shuts down the ActiveX control and destroys the TQAxWidget widget,
|
||||
cleaning up all allocated resources.
|
||||
<p> <p>See also <a href="qaxbase.html#clear">clear</a>().
|
||||
|
||||
<h3 class=fn>bool <a name="createHostWindow"></a>TQAxWidget::createHostWindow ( bool initialized )<tt> [virtual protected]</tt>
|
||||
</h3>
|
||||
Creates the client site for the ActiveX control, and returns TRUE if
|
||||
the control could be embedded successfully, otherwise returns FALSE.
|
||||
If <em>initialized</em> is TRUE the control has already been initialized.
|
||||
<p> This function is called by <a href="qaxbase.html#initialize">initialize</a>(). If you reimplement initialize
|
||||
to customize the actual control instantiation, call this function in your
|
||||
reimplementation to have the control embedded by the default client side.
|
||||
Creates the client site for the ActiveX control, and returns TRUE if
|
||||
the control could be embedded successfully, otherwise returns FALSE.
|
||||
|
||||
<h3 class=fn><a href="ntqvariant.html">TQVariant</a> <a name="dynamicCall"></a>TQAxBase::dynamicCall ( const <a href="ntqcstring.html">TQCString</a> & function, const <a href="ntqvariant.html">TQVariant</a> & var1 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var2 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var3 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var4 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var5 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var6 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var7 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var8 = TQVariant ( ) )
|
||||
</h3>
|
||||
Calls the COM object's method <em>function</em>, passing the
|
||||
parameters <em>var1</em>, <em>var1</em>, <em>var2</em>, <em>var3</em>, <em>var4</em>, <em>var5</em>,
|
||||
<em>var6</em>, <em>var7</em> and <em>var8</em>, and returns the value returned by
|
||||
the method, or an invalid <a href="ntqvariant.html">TQVariant</a> if the method does not return
|
||||
a value or when the function call failed.
|
||||
<p> If <em>function</em> is a method of the object the string must be provided
|
||||
as the full prototype, for example as it would be written in a
|
||||
<a href="tqobject.html#connect">TQObject::connect</a>() call.
|
||||
<pre>
|
||||
activeX->dynamicCall( "Navigate(const <a href="tqstring.html">TQString</a>&)", "www.trolltech.com" );
|
||||
</pre>
|
||||
|
||||
<p> Alternatively a function can be called passing the parameters embedded
|
||||
in the string, e.g. above function can also be invoked using
|
||||
<pre>
|
||||
activeX->dynamicCall("Navigate(\"www.trolltech.com\");
|
||||
</pre>
|
||||
|
||||
All parameters are passed as strings; it depends on the control whether
|
||||
they are interpreted correctly, and is slower than using the prototype
|
||||
with correctly typed parameters.
|
||||
<p> If <em>function</em> is a property the string has to be the name of the
|
||||
property. The property setter is called when <em>var1</em> is a valid TQVariant,
|
||||
otherwise the getter is called.
|
||||
<pre>
|
||||
activeX->dynamicCall( "Value", 5 );
|
||||
<a href="tqstring.html">TQString</a> text = activeX->dynamicCall( "Text" ).toString();
|
||||
</pre>
|
||||
|
||||
Note that it is faster to get and set properties using
|
||||
<a href="tqobject.html#property">TQObject::property</a>() and <a href="tqobject.html#setProperty">TQObject::setProperty</a>().
|
||||
<p> It is only possible to call functions through <a href="qaxbase.html#dynamicCall">dynamicCall</a>() that
|
||||
have parameters or return values of datatypes supported by
|
||||
<a href="ntqvariant.html">TQVariant</a>. See the <a href="qaxbase.html">TQAxBase</a> class documentation for a list of
|
||||
supported and unsupported datatypes. If you want to call functions
|
||||
that have unsupported datatypes in the parameter list, use
|
||||
<a href="qaxbase.html#queryInterface">queryInterface</a>() to retrieve the appropriate COM interface, and
|
||||
use the function directly.
|
||||
<p> <pre>
|
||||
IWebBrowser2 *webBrowser = 0;
|
||||
activeX->queryInterface( IID_IWebBrowser2, (void**)&webBrowser );
|
||||
if ( webBrowser ) {
|
||||
webBrowser->Navigate2( pvarURL );
|
||||
webBrowser->Release();
|
||||
}
|
||||
</pre>
|
||||
|
||||
<p> This is also more efficient.
|
||||
|
||||
<p>Example: <a href="qaxcontainer-example-qutlook.html#x2720">qutlook/centralwidget.cpp</a>.
|
||||
<h3 class=fn><a href="ntqvariant.html">TQVariant</a> <a name="dynamicCall-2"></a>TQAxBase::dynamicCall ( const <a href="ntqcstring.html">TQCString</a> & function, <a href="tqvaluelist.html">TQValueList</a><TQVariant> & vars )
|
||||
</h3>
|
||||
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
<p> Calls the COM object's method <em>function</em>, passing the
|
||||
parameters in <em>vars</em>, and returns the value returned by
|
||||
the method. If the method does not return a value or when
|
||||
the function call failed this function returns an invalid
|
||||
<a href="ntqvariant.html">TQVariant</a> object.
|
||||
<p> The TQVariant objects in <em>vars</em> are updated when the method has
|
||||
out-parameters.
|
||||
|
||||
<h3 class=fn><a href="qaxobject.html">TQAxObject</a> * <a name="querySubObject"></a>TQAxBase::querySubObject ( const <a href="ntqcstring.html">TQCString</a> & name, const <a href="ntqvariant.html">TQVariant</a> & var1 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var2 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var3 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var4 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var5 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var6 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var7 = TQVariant ( ), const <a href="ntqvariant.html">TQVariant</a> & var8 = TQVariant ( ) )
|
||||
</h3>
|
||||
Returns a pointer to a <a href="qaxobject.html">TQAxObject</a> wrapping the COM object provided
|
||||
by the method or property <em>name</em>, passing passing the parameters
|
||||
<em>var1</em>, <em>var1</em>, <em>var2</em>, <em>var3</em>, <em>var4</em>, <em>var5</em>, <em>var6</em>,
|
||||
<em>var7</em> and <em>var8</em>.
|
||||
<p> If <em>name</em> is provided by a method the string must include the
|
||||
full function prototype.
|
||||
<p> If <em>name</em> is a property the string must be the name of the property,
|
||||
and <em>var1</em>, ... <em>var8</em> are ignored.
|
||||
<p> The returned TQAxObject is a child of this object (which is either of
|
||||
type TQAxObject or TQAxWidget), and is deleted when this object is
|
||||
deleted. It is however safe to delete the returned object yourself,
|
||||
and you should do so when you iterate over lists of subobjects.
|
||||
<p> COM enabled applications usually have an object model publishing
|
||||
certain elements of the application as dispatch interfaces. Use
|
||||
this method to navigate the hierarchy of the object model, e.g.
|
||||
<p> <pre>
|
||||
TQAxWidget outlook( "Outlook.Application" );
|
||||
<a href="qaxobject.html">TQAxObject</a> *session = outlook.<a href="qaxbase.html#querySubObject">querySubObject</a>( "Session" );
|
||||
if ( session ) {
|
||||
<a href="qaxobject.html">TQAxObject</a> *defFolder = session-><a href="qaxbase.html#querySubObject">querySubObject</a>(
|
||||
"GetDefaultFolder(OlDefaultFolders)",
|
||||
"olFolderContacts" );
|
||||
//...
|
||||
}
|
||||
</pre>
|
||||
|
||||
|
||||
<p>Example: <a href="qaxcontainer-example-qutlook.html#x2721">qutlook/centralwidget.cpp</a>.
|
||||
<h3 class=fn>bool <a name="translateKeyEvent"></a>TQAxWidget::translateKeyEvent ( int message, int keycode ) const<tt> [virtual protected]</tt>
|
||||
</h3>
|
||||
Reimplement this function to pass certain key events to the
|
||||
ActiveX control. <em>message</em> is the Window message identifier
|
||||
specifying the message type (ie. WM_KEYDOWN), and <em>keycode</em> is
|
||||
the virtual keycode (ie. VK_TAB).
|
||||
<p> If the function returns TRUE the key event is passed on to the
|
||||
ActiveX control, which then either processes the event or passes
|
||||
the event on to TQt.
|
||||
<p> If the function returns FALSE the processing of the key event is
|
||||
ignored by <a href="activentqt.html#ActiveTQt">ActiveTQt</a>, ie. the ActiveX control might handle it or
|
||||
not.
|
||||
<p> The default implementation returns TRUE for the following cases:
|
||||
<p> <center><table cellpadding="4" cellspacing="2" border="0">
|
||||
<tr bgcolor="#a2c511">
|
||||
<th valign="top">WM_SYSKEYDOWN
|
||||
<th valign="top">WM_SYSKEYUP
|
||||
<th valign="top">WM_KEYDOWN
|
||||
<tr bgcolor="#f0f0f0">
|
||||
<td valign="top">All keycodes
|
||||
<td valign="top">VK_MENU
|
||||
<td valign="top">VK_TAB, VK_DELETE and all non-arrow-keys in combination with VK_SHIFT,
|
||||
VK_CONTROL or VK_MENU
|
||||
</table></center>
|
||||
<p> This table is the result of experimenting with popular ActiveX controls,
|
||||
ie. Internet Explorer and Microsoft Office applications, but for some
|
||||
controls it might require modification.
|
||||
|
||||
<!-- eof -->
|
||||
<hr><p>
|
||||
This file is part of the <a href="index.html">TQt toolkit</a>.
|
||||
Copyright © 1995-2007
|
||||
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
|
||||
<table width=100% cellspacing=0 border=0><tr>
|
||||
<td>Copyright © 2007
|
||||
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||||
<td align=right><div align=right>TQt 3.3.8</div>
|
||||
</table></div></address></body>
|
||||
</html>
|
||||
@ -1 +0,0 @@
|
||||
.so man3/tqaxaggregated.3qt
|
||||
@ -1 +0,0 @@
|
||||
.so man3/tqaxbase.3qt
|
||||
@ -1 +0,0 @@
|
||||
.so man3/tqaxbindable.3qt
|
||||
@ -1 +0,0 @@
|
||||
.so man3/tqaxfactory.3qt
|
||||
@ -1 +0,0 @@
|
||||
.so man3/tqaxobject.3qt
|
||||
@ -1 +0,0 @@
|
||||
.so man3/tqaxscript.3qt
|
||||
@ -1 +0,0 @@
|
||||
.so man3/tqaxscriptengine.3qt
|
||||
@ -1 +0,0 @@
|
||||
.so man3/tqaxscriptmanager.3qt
|
||||
@ -1 +0,0 @@
|
||||
.so man3/tqaxwidget.3qt
|
||||
@ -1,143 +0,0 @@
|
||||
'\" t
|
||||
.TH QAxAggregated 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
|
||||
QAxAggregated \- Abstract base class for implementations of additional COM interfaces
|
||||
.SH SYNOPSIS
|
||||
This class is part of the \fBQt ActiveQt Extension\fR.
|
||||
.PP
|
||||
\fC#include <qaxbindable.h>\fR
|
||||
.PP
|
||||
.SS "Public Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "virtual long \fBqueryInterface\fR ( const QUuid & iid, void ** iface ) = 0"
|
||||
.br
|
||||
.in -1c
|
||||
.SS "Protected Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "IUnknown * \fBcontrollingUnknown\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "TQWidget * \fBwidget\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "TQObject * \fBobject\fR () const"
|
||||
.br
|
||||
.in -1c
|
||||
.SH DESCRIPTION
|
||||
This class is defined in the \fBQt ActiveQt Extension\fR, which can be found in the \fCqt/extensions\fR directory. It is not included in the main TQt API.
|
||||
.PP
|
||||
The QAxAggregated class is an abstract base class for implementations of additional COM interfaces.
|
||||
.PP
|
||||
Create a subclass of QAxAggregated and reimplement queryInterface() to support additional COM interfaces. Use multiple inheritance from those COM interfaces. Implement the IUnknown interface of those COM interfaces by delegating the calls to QueryInterface(), AddRef() and Release() to the interface provided by controllingUnknown().
|
||||
.PP
|
||||
Use the widget() method if you need to make calls to the TQWidget implementing the ActiveX control. You must not store that pointer in your subclass (unless you use QGuardedPtr), as the TQWidget can be destroyed by the ActiveQt framework at any time.
|
||||
.SH MEMBER FUNCTION DOCUMENTATION
|
||||
.SH "IUnknown * QAxAggregated::controllingUnknown () const\fC [protected]\fR"
|
||||
Returns the IUnknown interface of the ActiveX control. Implement the IUnknown interface in your QAxAggregated subclass to delegate calls to QueryInterface(), AddRef() and Release() to the interface provided by this function.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
HRESULT AxImpl::QueryInterface( REFIID iid, void **iface )
|
||||
.br
|
||||
{
|
||||
.br
|
||||
return controllingUnknown()->QueryInterface( iid, iface );
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.br
|
||||
unsigned long AxImpl::AddRef()
|
||||
.br
|
||||
{
|
||||
.br
|
||||
return controllingUnknown()->AddRef();
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.br
|
||||
unsigned long AxImpl::Release()
|
||||
.br
|
||||
{
|
||||
.br
|
||||
return controllingUnknown()->Release();
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
The QAXAGG_IUNKNOWN macro expands to the code above, and you can use it in the class declaration of your subclass.
|
||||
.SH "TQObject * QAxAggregated::object () const\fC [protected]\fR"
|
||||
Returns a pointer to the TQObject subclass implementing the COM object. This function might return 0.
|
||||
.PP
|
||||
\fBWarning:\fR You must not store the returned pointer, unless you use a QGuardedPtr, since the TQObject can be destroyed by ActiveQt at any time.
|
||||
.SH "long QAxAggregated::queryInterface ( const QUuid & iid, void ** iface )\fC [pure virtual]\fR"
|
||||
Reimplement this pure virtual function to support additional COM interfaces. Set the value of \fIiface\fR to point to this object to support the interface \fIiid\fR. Note that you must cast the \fCthis\fR pointer to the appropriate superclass.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
long AxImpl::queryInterface( const QUuid &iid, void **iface )
|
||||
.br
|
||||
{
|
||||
.br
|
||||
*iface = 0;
|
||||
.br
|
||||
if ( iid == IID_ISomeCOMInterface )
|
||||
.br
|
||||
*iface = (ISomeCOMInterface*)this;
|
||||
.br
|
||||
else
|
||||
.br
|
||||
return E_NOINTERFACE;
|
||||
.br
|
||||
.br
|
||||
AddRef();
|
||||
.br
|
||||
return S_OK;
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
Return the standard COM results S_OK (interface is supported) or E_NOINTERFACE (requested interface is not supported).
|
||||
.PP
|
||||
\fBWarning:\fR Even though you must implement the IUnknown interface if you implement any COM interface you must not support the IUnknown interface in your queryInterface() implementation.
|
||||
.SH "TQWidget * QAxAggregated::widget () const\fC [protected]\fR"
|
||||
Returns a pointer to the TQWidget subclass implementing the ActiveX control. This function might return 0.
|
||||
.PP
|
||||
\fBWarning:\fR
|
||||
You must not store the returned pointer, unless you use a
|
||||
QGuardedPtr, since the TQWidget can be destroyed by ActiveQt at any
|
||||
time.
|
||||
|
||||
.SH "SEE ALSO"
|
||||
.BR http://doc.trolltech.com/qaxaggregated.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 (tqaxaggregated.3qt) and the Qt
|
||||
version (3.3.8).
|
||||
@ -1,561 +0,0 @@
|
||||
'\" t
|
||||
.TH QAxBase 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
|
||||
QAxBase \- Abstract class that provides an API to initalize and access a COM object
|
||||
.SH SYNOPSIS
|
||||
This class is part of the \fBQt ActiveQt Extension\fR.
|
||||
.PP
|
||||
\fC#include <qaxbase.h>\fR
|
||||
.PP
|
||||
Inherited by QAxObject and QAxWidget.
|
||||
.PP
|
||||
.SS "Public Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "\fBQAxBase\fR ( IUnknown * iface = 0 )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual \fB~QAxBase\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "TQString \fBcontrol\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "long \fBqueryInterface\fR ( const QUuid & uuid, void ** iface ) const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QVariant \fBdynamicCall\fR ( const QCString & function, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QVariant \fBdynamicCall\fR ( const QCString & function, TQValueList<QVariant> & vars )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QAxObject * \fBquerySubObject\fR ( const QCString & name, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "PropertyBag \fBpropertyBag\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBsetPropertyBag\fR ( const PropertyBag & bag )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "TQString \fBgenerateDocumentation\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual bool \fBpropertyWritable\fR ( const char * prop ) const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual void \fBsetPropertyWritable\fR ( const char * prop, bool ok )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "bool \fBisNull\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QVariant \fBasVariant\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "enum \fBPropertyBag\fR { }"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual void \fBclear\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "bool \fBsetControl\fR ( const TQString & )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBdisableMetaObject\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBdisableClassInfo\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBdisableEventSink\fR ()"
|
||||
.br
|
||||
.in -1c
|
||||
.SS "Signals"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "void \fBsignal\fR ( const TQString & name, int argc, void * argv )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBpropertyChanged\fR ( const TQString & name )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBexception\fR ( int code, const TQString & source, const TQString & desc, const TQString & help )"
|
||||
.br
|
||||
.in -1c
|
||||
.SS "Properties"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "TQString \fBcontrol\fR - the name of the COM object wrapped by this QAxBase object"
|
||||
.br
|
||||
.in -1c
|
||||
.SS "Protected Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "virtual bool \fBinitialize\fR ( IUnknown ** ptr )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "bool \fBinitializeRemote\fR ( IUnknown ** ptr )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "bool \fBinitializeLicensed\fR ( IUnknown ** ptr )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "bool \fBinitializeActive\fR ( IUnknown ** ptr )"
|
||||
.br
|
||||
.in -1c
|
||||
.SH DESCRIPTION
|
||||
This class is defined in the \fBQt ActiveQt Extension\fR, which can be found in the \fCqt/extensions\fR directory. It is not included in the main TQt API.
|
||||
.PP
|
||||
The QAxBase class is an abstract class that provides an API to initalize and access a COM object.
|
||||
.PP
|
||||
QAxBase is an abstract class that cannot be used directly, and is instantiated through the subclasses QAxObject and QAxWidget. This class provides the API to access the COM object directly through its IUnknown implementation. If the COM object implements the IDispatch interface, the properties and methods of that object become available as TQt properties and slots.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
connect( buttonBack, TQ_SIGNAL(clicked()), webBrowser, TQ_SLOT(GoBack()) );
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
Properties exposed by the object's IDispatch implementation can be read and written through the property system provided by the TQt Object Model (both subclasses are TQObjects, so you can use setProperty() and property() as with TQObject). Properties with multiple parameters are not supported.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
activeX->setProperty( "text", "some text" );
|
||||
.br
|
||||
int value = activeX->property( "value" );
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
Write-functions for properties and other methods exposed by the object's IDispatch implementation can be called directly using dynamicCall(), or indirectly as slots connected to a signal.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
webBrowser->dynamicCall( "GoHome()" );
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
Outgoing events supported by the COM object are emitted as standard TQt signals.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
connect( webBrowser, TQ_SIGNAL(TitleChanged(const TQString&)),
|
||||
.br
|
||||
this, TQ_SLOT(setCaption(const TQString&)) );
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
QAxBase transparently converts between COM data types and the equivalent TQt data types. Some COM types have no equivalent TQt data structure.
|
||||
.PP
|
||||
Supported COM datatypes are listed in the first column of following table. The second column is the TQt type that can be used with the TQObject property functions. The third column is the TQt type that is used in the prototype of generated signals and slots for in-parameters, and the last column is the TQt type that is used in the prototype of signals and slots for out-parameters. <center>.nf
|
||||
.TS
|
||||
l - l. COM type TQt property in-parameter out-parameter VARIANT_BOOL bool bool bool& BSTR TQString const TQString& TQString& char, short, int, long int int int& uchar, ushort, uint, ulong uint uint uint& float, double double double double& DATE QDateTime const QDateTime& QDateTime& CY TQ_LLONG TQ_LLONG TQ_LLONG& OLE_COLOR TQColor const TQColor& TQColor& SAFEARRAY(VARIANT) TQValueList<QVariant> const TQValueList<QVariant>& TQValueList<QVariant>& SAFEARRAY(BYTE) QByteArray const QByteArray& QByteArray& SAFEARRAY(BSTR) TQStringList const TQStringList& TQStringList& VARIANT type-dependent const QVariant& QVariant& IFontDisp* QFont const QFont& QFont& IPictureDisp* QPixmap const QPixmap& QPixmap& IDispatch* QAxObject* (read-only) QAxBase::asVariant() QAxObject* (return value) IUnknown* QAxObject* (read-only) QAxBase::asVariant() QAxObject* (return value) SCODE, DECIMAL \fIunsupported\fR \fIunsupported\fR
|
||||
.TE
|
||||
.fi
|
||||
</center>
|
||||
.PP
|
||||
Supported are also enumerations, and typedefs to supported types.
|
||||
.PP
|
||||
To call the methods of a COM interface described by the following IDL
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
dispinterface IControl
|
||||
.br
|
||||
{
|
||||
.br
|
||||
properties:
|
||||
.br
|
||||
[id(1)] BSTR text;
|
||||
.br
|
||||
[id(2)] IFontDisp *font;
|
||||
.br
|
||||
.br
|
||||
methods:
|
||||
.br
|
||||
[id(6)] void showColumn( [in] int i );
|
||||
.br
|
||||
[id(3)] bool addColumn( [in] BSTR t );
|
||||
.br
|
||||
[id(4)] int fillList( [in, out] SAFEARRAY(VARIANT) *list );
|
||||
.br
|
||||
[id(5)] IDispatch *item( [in] int i );
|
||||
.br
|
||||
};
|
||||
.br
|
||||
.fi
|
||||
use the QAxBase API like this:
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
QAxObject object( "<CLSID>" );
|
||||
.br
|
||||
.br
|
||||
TQString text = object.property( "text" ).toString();
|
||||
.br
|
||||
object.setProperty( "font", QFont( "Times New Roman", 12 ) );
|
||||
.br
|
||||
.br
|
||||
connect( this, TQ_SIGNAL(clicked(int)), &object, TQ_SLOT(showColumn(int)) );
|
||||
.br
|
||||
bool ok = object.dynamicCall( "addColumn(const TQString&)", "Column 1" ).toBool();
|
||||
.br
|
||||
.br
|
||||
TQValueList<QVariant> varlist;
|
||||
.br
|
||||
TQValueList<QVariant> parameters;
|
||||
.br
|
||||
parameters << QVariant( varlist );
|
||||
.br
|
||||
int n = object.dynamicCall( "fillList(TQValueList<QVariant>&)", parameters ).toInt();
|
||||
.br
|
||||
.br
|
||||
QAxObject *item = object.querySubItem( "item(int)", 5 );
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
Note that the TQValueList the object should fill has to be provided as an element in the parameter list of QVariants.
|
||||
.PP
|
||||
If you need to access properties or pass parameters of unsupported datatypes you must access the COM object directly through its IDispatch implementation or other interfaces. Those interfaces can be retrieved through queryInterface().
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
IUnknown *iface = 0;
|
||||
.br
|
||||
activeX->queryInterface( IID_IUnknown, (void**)&iface );
|
||||
.br
|
||||
if ( iface ) {
|
||||
.br
|
||||
// use the interface
|
||||
.br
|
||||
iface->Release();
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
To get the definition of the COM interfaces you will have to use the header files provided with the component you want to use. Some compilers can also import type libraries using the #import compiler directive. See the component documentation to find out which type libraries you have to import, and how to use them.
|
||||
.PP
|
||||
If you need to react to events that pass parameters of unsupported datatypes you can use the generic signal that delivers the event data as provided by the COM event.
|
||||
.SS "Member Type Documentation"
|
||||
.SH "QAxBase::PropertyBag"
|
||||
A TQMap<TQString,QVariant> that can store properties as name:value pairs.
|
||||
.SH MEMBER FUNCTION DOCUMENTATION
|
||||
.SH "QAxBase::QAxBase ( IUnknown * iface = 0 )"
|
||||
Creates a QAxBase object that wraps the COM object \fIiface\fR. If \fIiface\fR is 0 (the default), use setControl() to instantiate a COM object.
|
||||
.SH "QAxBase::~QAxBase ()\fC [virtual]\fR"
|
||||
Shuts down the COM object and destroys the QAxBase object.
|
||||
.PP
|
||||
See also clear().
|
||||
.SH "QVariant QAxBase::asVariant () const"
|
||||
Returns a QVariant that wraps the COM object. The variant can then be used as a parameter in e.g. dynamicCall().
|
||||
.SH "void QAxBase::clear ()\fC [virtual]\fR"
|
||||
Disconnects and destroys the COM object.
|
||||
.PP
|
||||
If you reimplement this function you must also reimplement the destructor to call clear(), and call this implementation at the end of your clear() function.
|
||||
.SH "TQString QAxBase::control () const"
|
||||
Returns the name of the COM object wrapped by this QAxBase object. See the "control" property for details.
|
||||
.SH "void QAxBase::disableClassInfo ()"
|
||||
Disables the class info generation for this ActiveX container. If you don't require any class information about the ActiveX control use this function to speed up the meta object generation.
|
||||
.PP
|
||||
Note that this function must be called immediately after construction of the object (without passing an object identifier), and before calling QAxWidget->setControl().
|
||||
.SH "void QAxBase::disableEventSink ()"
|
||||
Disables the event sink implementation for this ActiveX container. If you don't intend to listen to the ActiveX control's events use this function to speed up the meta object generation.
|
||||
.PP
|
||||
Some ActiveX controls might be unstable when connected to an event sink. To get OLE events you must use standard COM methods to register your own event sink. Use queryInterface() to get access to the raw COM object.
|
||||
.PP
|
||||
Note that this function should be called immediately after construction of the object (without passing an object identifier), and before calling QAxWidget->setControl().
|
||||
.SH "void QAxBase::disableMetaObject ()"
|
||||
Disables the meta object generation for this ActiveX container. This also disables the event sink and class info generation. If you don't intend to use the TQt meta object implementation call this function to speed up the meta object generation.
|
||||
.PP
|
||||
Some ActiveX controls might be unstable when used with OLE automation. Use standard COM methods to use those controls through the COM interfaces provided by queryInterface().
|
||||
.PP
|
||||
Note that this function must be called immediately after construction of the object (without passing an object identifier), and before calling QAxWidget->setControl().
|
||||
.SH "QVariant QAxBase::dynamicCall ( const QCString & function, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
Calls the COM object's method \fIfunction\fR, passing the parameters \fIvar1\fR, \fIvar1\fR, \fIvar2\fR, \fIvar3\fR, \fIvar4\fR, \fIvar5\fR, \fIvar6\fR, \fIvar7\fR and \fIvar8\fR, and returns the value returned by the method, or an invalid QVariant if the method does not return a value or when the function call failed.
|
||||
.PP
|
||||
If \fIfunction\fR is a method of the object the string must be provided as the full prototype, for example as it would be written in a TQObject::connect() call.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
activeX->dynamicCall( "Navigate(const TQString&)", "www.trolltech.com" );
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
Alternatively a function can be called passing the parameters embedded in the string, e.g. above function can also be invoked using
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
activeX->dynamicCall("Navigate(\\"www.trolltech.com\\");
|
||||
.br
|
||||
.fi
|
||||
All parameters are passed as strings; it depends on the control whether they are interpreted correctly, and is slower than using the prototype with correctly typed parameters.
|
||||
.PP
|
||||
If \fIfunction\fR is a property the string has to be the name of the property. The property setter is called when \fIvar1\fR is a valid QVariant, otherwise the getter is called.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
activeX->dynamicCall( "Value", 5 );
|
||||
.br
|
||||
TQString text = activeX->dynamicCall( "Text" ).toString();
|
||||
.br
|
||||
.fi
|
||||
Note that it is faster to get and set properties using TQObject::property() and TQObject::setProperty().
|
||||
.PP
|
||||
It is only possible to call functions through dynamicCall() that have parameters or return values of datatypes supported by QVariant. See the QAxBase class documentation for a list of supported and unsupported datatypes. If you want to call functions that have unsupported datatypes in the parameter list, use queryInterface() to retrieve the appropriate COM interface, and use the function directly.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
IWebBrowser2 *webBrowser = 0;
|
||||
.br
|
||||
activeX->queryInterface( IID_IWebBrowser2, (void**)&webBrowser );
|
||||
.br
|
||||
if ( webBrowser ) {
|
||||
.br
|
||||
webBrowser->Navigate2( pvarURL );
|
||||
.br
|
||||
webBrowser->Release();
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
This is also more efficient.
|
||||
.PP
|
||||
Example: qutlook/centralwidget.cpp.
|
||||
.SH "QVariant QAxBase::dynamicCall ( const QCString & function, TQValueList<QVariant> & vars )"
|
||||
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
.PP
|
||||
Calls the COM object's method \fIfunction\fR, passing the parameters in \fIvars\fR, and returns the value returned by the method. If the method does not return a value or when the function call failed this function returns an invalid QVariant object.
|
||||
.PP
|
||||
The QVariant objects in \fIvars\fR are updated when the method has out-parameters.
|
||||
.SH "void QAxBase::exception ( int code, const TQString & source, const TQString & desc, const TQString & help )\fC [signal]\fR"
|
||||
This signal is emitted when the COM object throws an exception while called using the OLE automation interface IDispatch. \fIcode\fR, \fIsource\fR, \fIdesc\fR and \fIhelp\fR provide information about the exception as provided by the COM server and can be used to provide useful feedback to the end user. \fIhelp\fR includes the help file, and the help context ID in brackets, e.g. "filename [id]".
|
||||
.SH "TQString QAxBase::generateDocumentation ()"
|
||||
Returns a rich text string with documentation for the wrapped COM object. Dump the string to an HTML-file, or use it in e.g. a TQTextBrowser widget.
|
||||
.SH "bool QAxBase::initialize ( IUnknown ** ptr )\fC [virtual protected]\fR"
|
||||
This virtual function is called by setControl() and creates the requested COM object. \fIptr\fR is set to the object's IUnknown implementation. The function returns TRUE if the object initialization succeeded; otherwise the function returns FALSE.
|
||||
.PP
|
||||
The default implementation interprets the string returned by control(), and calls initializeRemote(), initializeLicensed() or initializeActive() if the string matches the respective patterns. If no pattern is matched, or if remote or licensed initialization fails, CoCreateInstance is used directly to create the object.
|
||||
.PP
|
||||
See the control property documentation for details about supported patterns.
|
||||
.PP
|
||||
The interface returned in \fIptr\fR must be referenced exactly once when this function returns. The interface provided by e.g. CoCreateInstance is already referenced, and there is no need to reference it again.
|
||||
.SH "bool QAxBase::initializeActive ( IUnknown ** ptr )\fC [protected]\fR"
|
||||
Returns an active instance running on the current machine, and returns the IUnknown interface to the running object in \fIptr\fR. This function returns TRUE if successful, otherwise returns FALSE.
|
||||
.PP
|
||||
This function is called by initialize() if the control string contains the substring "}&".
|
||||
.PP
|
||||
See also initialize().
|
||||
.SH "bool QAxBase::initializeLicensed ( IUnknown ** ptr )\fC [protected]\fR"
|
||||
Creates an instance of a licensed control, and returns the IUnknown interface to the object in \fIptr\fR. This functions returns TRUE if successful, otherwise returns FALSE.
|
||||
.PP
|
||||
This function is called by initialize() if the control string contains the substring "}:". The license key needs to follow this substring.
|
||||
.PP
|
||||
See also initialize().
|
||||
.SH "bool QAxBase::initializeRemote ( IUnknown ** ptr )\fC [protected]\fR"
|
||||
Creates the instance on a remote server, and returns the IUnknown interface to the object in \fIptr\fR. This function returns TRUE if successful, otherwise returns FALSE.
|
||||
.PP
|
||||
This function is called by initialize() if the control string contains the substring "/{". The information about the remote machine needs to be provided in front of the substring.
|
||||
.PP
|
||||
See also initialize().
|
||||
.SH "bool QAxBase::isNull () const"
|
||||
Returns TRUE if there is no COM object loaded by this wrapper; otherwise return FALSE.
|
||||
.PP
|
||||
See also control.
|
||||
.SH "PropertyBag QAxBase::propertyBag () const"
|
||||
Returns a name:value map of all the properties exposed by the COM object.
|
||||
.PP
|
||||
This is more efficient than getting multiple properties individually if the COM object supports property bags.
|
||||
.PP
|
||||
\fBWarning:\fR It is not guaranteed that the property bag implementation of the COM object returns all properties, or that the properties returned are the same as those available through the IDispatch interface.
|
||||
.SH "void QAxBase::propertyChanged ( const TQString & name )\fC [signal]\fR"
|
||||
If the COM object supports property notification, this signal gets emitted when the property called \fIname\fR is changed.
|
||||
.SH "bool QAxBase::propertyWritable ( const char * prop ) const\fC [virtual]\fR"
|
||||
Returns TRUE if the property \fIprop\fR is writable; otherwise returns FALSE. By default, all properties are writable.
|
||||
.PP
|
||||
\fBWarning:\fR Depending on the control implementation this setting might be ignored for some properties.
|
||||
.PP
|
||||
See also setPropertyWritable() and propertyChanged().
|
||||
.SH "long QAxBase::queryInterface ( const QUuid & uuid, void ** iface ) const"
|
||||
Requests the interface \fIuuid\fR from the COM object and sets the value of \fIiface\fR to the provided interface, or to 0 if the requested interface could not be provided.
|
||||
.PP
|
||||
Returns the result of the QueryInterface implementation of the COM object.
|
||||
.PP
|
||||
See also control.
|
||||
.SH "QAxObject * QAxBase::querySubObject ( const QCString & name, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
Returns a pointer to a QAxObject wrapping the COM object provided by the method or property \fIname\fR, passing passing the parameters \fIvar1\fR, \fIvar1\fR, \fIvar2\fR, \fIvar3\fR, \fIvar4\fR, \fIvar5\fR, \fIvar6\fR, \fIvar7\fR and \fIvar8\fR.
|
||||
.PP
|
||||
If \fIname\fR is provided by a method the string must include the full function prototype.
|
||||
.PP
|
||||
If \fIname\fR is a property the string must be the name of the property, and \fIvar1\fR, ... \fIvar8\fR are ignored.
|
||||
.PP
|
||||
The returned QAxObject is a child of this object (which is either of type QAxObject or QAxWidget), and is deleted when this object is deleted. It is however safe to delete the returned object yourself, and you should do so when you iterate over lists of subobjects.
|
||||
.PP
|
||||
COM enabled applications usually have an object model publishing certain elements of the application as dispatch interfaces. Use this method to navigate the hierarchy of the object model, e.g.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
QAxWidget outlook( "Outlook.Application" );
|
||||
.br
|
||||
QAxObject *session = outlook.querySubObject( "Session" );
|
||||
.br
|
||||
if ( session ) {
|
||||
.br
|
||||
QAxObject *defFolder = session->querySubObject(
|
||||
.br
|
||||
"GetDefaultFolder(OlDefaultFolders)",
|
||||
.br
|
||||
"olFolderContacts" );
|
||||
.br
|
||||
//...
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
Example: qutlook/centralwidget.cpp.
|
||||
.SH "bool QAxBase::setControl ( const TQString & )"
|
||||
Sets the name of the COM object wrapped by this QAxBase object. See the "control" property for details.
|
||||
.SH "void QAxBase::setPropertyBag ( const PropertyBag & bag )"
|
||||
Sets the properties of the COM object to the corresponding values in \fIbag\fR.
|
||||
.PP
|
||||
\fBWarning:\fR You should only set property bags that have been returned by the propertyBag function, as it cannot be guaranteed that the property bag implementation of the COM object supports the same properties that are available through the IDispatch interface.
|
||||
.PP
|
||||
See also propertyBag().
|
||||
.SH "void QAxBase::setPropertyWritable ( const char * prop, bool ok )\fC [virtual]\fR"
|
||||
Sets the property \fIprop\fR to writable if \fIok\fR is TRUE, otherwise sets \fIprop\fR to be read-only. By default, all properties are writable.
|
||||
.PP
|
||||
\fBWarning:\fR Depending on the control implementation this setting might be ignored for some properties.
|
||||
.PP
|
||||
See also propertyWritable() and propertyChanged().
|
||||
.SH "void QAxBase::signal ( const TQString & name, int argc, void * argv )\fC [signal]\fR"
|
||||
This generic signal gets emitted when the COM object issues the event \fIname\fR. \fIargc\fR is the number of parameters provided by the event (DISPPARAMS.cArgs), and \fIargv\fR is the pointer to the parameter values (DISPPARAMS.rgvarg). Note that the order of parameter values is turned around, ie. the last element of the array is the first parameter in the function.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
void Receiver::slot( const TQString &name, int argc, void *argv )
|
||||
.br
|
||||
{
|
||||
.br
|
||||
VARIANTARG *params = (VARIANTARG*)argv;
|
||||
.br
|
||||
if ( name.startsWith( "BeforeNavigate2(" ) ) {
|
||||
.br
|
||||
IDispatch *pDisp = params[argc-1].pdispVal;
|
||||
.br
|
||||
VARIANTARG URL = *params[argc-2].pvarVal;
|
||||
.br
|
||||
VARIANTARG Flags = *params[argc-3].pvarVal;
|
||||
.br
|
||||
VARIANTARG TargetFrameName = *params[argc-4].pvarVal;
|
||||
.br
|
||||
VARIANTARG PostData = *params[argc-5].pvarVal;
|
||||
.br
|
||||
VARIANTARG Headers = *params[argc-6].pvarVal;
|
||||
.br
|
||||
bool *Cancel = params[argc-7].pboolVal;
|
||||
.br
|
||||
}
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
Use this signal if the event has parameters of unsupported data types. Otherwise, connect directly to the signal \fIname\fR.
|
||||
.SS "Property Documentation"
|
||||
.SH "TQString control"
|
||||
This property holds the name of the COM object wrapped by this QAxBase object.
|
||||
.PP
|
||||
Setting this property initilializes the COM object. Any COM object previously set is shut down.
|
||||
.PP
|
||||
The most efficient way to set this property is by using the registered component's UUID, e.g.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
ctrl->setControl( "{8E27C92B-1264-101C-8A2F-040224009C02}" );
|
||||
.br
|
||||
.fi
|
||||
The second fastest way is to use the registered control's class name (with or without version number), e.g.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
ctrl->setControl( "MSCal.Calendar" );
|
||||
.br
|
||||
.fi
|
||||
The slowest, but easiest way to use is to use the control's full name, e.g.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
ctrl->setControl( "Calendar Control 9.0" );
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
If the component's UUID is used the following patterns can be used to initialize the control on a remote machine, to initialize a licensed control or to connect to a running object:
|
||||
.TP
|
||||
To initialize the control on a different machine use the following pattern:
|
||||
.IP
|
||||
.nf
|
||||
.br
|
||||
<domain/username>:<password>@server/{8E27C92B-1264-101C-8A2F-040224009C02}
|
||||
.br
|
||||
.fi
|
||||
.TP
|
||||
To initialize a licensed control use the following pattern:
|
||||
.IP
|
||||
.nf
|
||||
.br
|
||||
{8E27C92B-1264-101C-8A2F-040224009C02}:<LicenseKey>
|
||||
.br
|
||||
.fi
|
||||
.TP
|
||||
To connect to an already running object use the following pattern:
|
||||
.IP
|
||||
.nf
|
||||
.br
|
||||
{8E27C92B-1264-101C-8A2F-040224009C02}&
|
||||
.br
|
||||
.fi
|
||||
The first two patterns can be combined, e.g. to initialize a licensed control on a remote machine:
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
ctrl->setControl("DOMAIN/user:password@server/{8E27C92B-1264-101C-8A2F-040224009C02}:LicenseKey");
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
The control's read function always returns the control's UUID, if provided including the license key, and the name of the server, but not including the username, the domain or the password.
|
||||
.PP
|
||||
Set this property's value with setControl() and get this property's value with control().
|
||||
|
||||
.SH "SEE ALSO"
|
||||
.BR http://doc.trolltech.com/qaxbase.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 (tqaxbase.3qt) and the Qt
|
||||
version (3.3.8).
|
||||
@ -1,152 +0,0 @@
|
||||
'\" t
|
||||
.TH QAxBindable 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
|
||||
QAxBindable \- Interface between a TQWidget and an ActiveX client
|
||||
.SH SYNOPSIS
|
||||
This class is part of the \fBQt ActiveQt Extension\fR.
|
||||
.PP
|
||||
\fC#include <qaxbindable.h>\fR
|
||||
.PP
|
||||
.SS "Public Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "\fBQAxBindable\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual \fB~QAxBindable\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual QAxAggregated * \fBcreateAggregate\fR ()"
|
||||
.br
|
||||
.in -1c
|
||||
.SS "Static Public Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "void \fBreportError\fR ( int code, const TQString & src, const TQString & desc, const TQString & context = TQString::null )"
|
||||
.br
|
||||
.in -1c
|
||||
.SS "Protected Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "bool \fBrequestPropertyChange\fR ( const char * property )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBpropertyChanged\fR ( const char * property )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "IUnknown * \fBclientSite\fR () const"
|
||||
.br
|
||||
.in -1c
|
||||
.SH DESCRIPTION
|
||||
This class is defined in the \fBQt ActiveQt Extension\fR, which can be found in the \fCqt/extensions\fR directory. It is not included in the main TQt API.
|
||||
.PP
|
||||
The QAxBindable class provides an interface between a TQWidget and an ActiveX client.
|
||||
.PP
|
||||
The functions provided by this class allow an ActiveX control to communicate property changes to a client application. Inherit your control class from both TQWidget (directly or indirectly) and this class to get access to this class's functions. The meta object compiler requires you to inherit from TQWidget \fIfirst\fR.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
class MyActiveX : public TQWidget, public QAxBindable
|
||||
.br
|
||||
{
|
||||
.br
|
||||
TQ_OBJECT
|
||||
.br
|
||||
TQ_PROPERTY( int value READ value WRITE setValue )
|
||||
.br
|
||||
public:
|
||||
.br
|
||||
MyActiveX( TQWidget *parent = 0, const char *name = 0 );
|
||||
.br
|
||||
...
|
||||
.br
|
||||
.br
|
||||
int value() const;
|
||||
.br
|
||||
void setValue( int );
|
||||
.br
|
||||
};
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
When implementing the property write function, use requestPropertyChange() to get permission from the ActiveX client application to change this property. When the property changes, call propertyChanged() to notify the ActiveX client application about the change. If a fatal error occurs in the control, use the static reportError() function to notify the client.
|
||||
.PP
|
||||
Use the interface returned by clientSite() to call the ActiveX client. To implement additional COM interfaces in your ActiveX control, reimplement createAggregate() to return a new object of a QAxAggregated subclass.
|
||||
.SH MEMBER FUNCTION DOCUMENTATION
|
||||
.SH "QAxBindable::QAxBindable ()"
|
||||
Constructs an empty QAxBindable object.
|
||||
.SH "QAxBindable::~QAxBindable ()\fC [virtual]\fR"
|
||||
Destroys the QAxBindable object.
|
||||
.SH "IUnknown * QAxBindable::clientSite () const\fC [protected]\fR"
|
||||
Returns a pointer to the client site interface for this ActiveX object, or null if no client site has been set.
|
||||
.PP
|
||||
Call QueryInterface() on the returned interface to get the interface you want to call.
|
||||
.SH "QAxAggregated * QAxBindable::createAggregate ()\fC [virtual]\fR"
|
||||
Reimplement this function when you want to implement additional COM interfaces in the ActiveX control, or when you want to provide alternative implementations of COM interfaces. Return a new object of a QAxAggregated subclass.
|
||||
.PP
|
||||
The default implementation returns the null pointer.
|
||||
.SH "void QAxBindable::propertyChanged ( const char * property )\fC [protected]\fR"
|
||||
Call this function to notify the client that is hosting this ActiveX control that the property \fIproperty\fR has been changed.
|
||||
.PP
|
||||
This function is usually called at the end of the property's write function.
|
||||
.PP
|
||||
See also requestPropertyChange().
|
||||
.SH "void QAxBindable::reportError ( int code, const TQString & src, const TQString & desc, const TQString & context = TQString::null )\fC [static]\fR"
|
||||
Reports an error to the client application. \fIcode\fR is a control-defined error code. \fIdesc\fR is a human-readable description of the error intended for the application user. \fIsrc\fR is the name of the source for the error, typically the ActiveX server name. \fIcontext\fR can be the location of a help file with more information about the error. If \fIcontext\fR ends with a number in brackets, e.g. [12], this number will be interpreted as the context ID in the help file.
|
||||
.SH "bool QAxBindable::requestPropertyChange ( const char * property )\fC [protected]\fR"
|
||||
Call this function to request permission to change the property \fIproperty\fR from the client that is hosting this ActiveX control. Returns TRUE if the client allows the change; otherwise returns FALSE.
|
||||
.PP
|
||||
This function is usually called first in the write function for \fIproperty\fR, and writing is abandoned if the function returns FALSE.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
void MyActiveQt::setText( const TQString &text )
|
||||
.br
|
||||
{
|
||||
.br
|
||||
if ( !requestPropertyChange( "text" ) )
|
||||
.br
|
||||
return;
|
||||
.br
|
||||
.br
|
||||
// update property
|
||||
.br
|
||||
.br
|
||||
propertyChanged( "text" );
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
See also propertyChanged().
|
||||
|
||||
.SH "SEE ALSO"
|
||||
.BR http://doc.trolltech.com/qaxbindable.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 (tqaxbindable.3qt) and the Qt
|
||||
version (3.3.8).
|
||||
@ -1,436 +0,0 @@
|
||||
'\" t
|
||||
.TH QAxFactory 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
|
||||
QAxFactory \- Defines a factory for the creation of COM components
|
||||
.SH SYNOPSIS
|
||||
This class is part of the \fBQt ActiveQt Extension\fR.
|
||||
.PP
|
||||
\fC#include <qaxfactory.h>\fR
|
||||
.PP
|
||||
.SS "Public Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "\fBQAxFactory\fR ( const QUuid & libid, const QUuid & appid )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual \fB~QAxFactory\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual TQStringList \fBfeatureList\fR () const = 0"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual TQWidget * \fBcreate\fR ( const TQString & key, TQWidget * parent = 0, const char * name = 0 )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual TQObject * \fBcreateObject\fR ( const TQString & key, TQObject * parent = 0, const char * name = 0 )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual QMetaObject * \fBmetaObject\fR ( const TQString & key ) const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual bool \fBcreateObjectWrapper\fR ( TQObject * object, IDispatch ** wrapper )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual QUuid \fBclassID\fR ( const TQString & key ) const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual QUuid \fBinterfaceID\fR ( const TQString & key ) const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual QUuid \fBeventsID\fR ( const TQString & key ) const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual QUuid \fBtypeLibID\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual QUuid \fBappID\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual void \fBregisterClass\fR ( const TQString & key, QSettings * settings ) const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual void \fBunregisterClass\fR ( const TQString & key, QSettings * settings ) const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual bool \fBvalidateLicenseKey\fR ( const TQString & key, const TQString & licenseKey ) const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual TQString \fBexposeToSuperClass\fR ( const TQString & key ) const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual bool \fBstayTopLevel\fR ( const TQString & key ) const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual bool \fBhasStockEvents\fR ( const TQString & key ) const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual bool \fBisService\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "enum \fBServerType\fR { SingleInstance, MultipleInstances }"
|
||||
.br
|
||||
.in -1c
|
||||
.SS "Static Public Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "bool \fBisServer\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "TQString \fBserverDirPath\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "TQString \fBserverFilePath\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "bool \fBstartServer\fR ( ServerType type = MultipleInstances )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "bool \fBstopServer\fR ()"
|
||||
.br
|
||||
.in -1c
|
||||
.SH DESCRIPTION
|
||||
This class is defined in the \fBQt ActiveQt Extension\fR, which can be found in the \fCqt/extensions\fR directory. It is not included in the main TQt API.
|
||||
.PP
|
||||
The QAxFactory class defines a factory for the creation of COM components.
|
||||
.PP
|
||||
|
||||
.PP
|
||||
Implement this factory once in your ActiveX server to provide information about the components the server can create. If your server supports just a single ActiveX control, you can use the default factory implementation instead of implementing the factory yourself. Use the QAXFACTORY_DEFAULT macro in any implementation file (e.g. main.cpp) to instantiate and export the default factory:
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
#include <ntqapplication.h>
|
||||
.br
|
||||
#include <qaxfactory.h>
|
||||
.br
|
||||
.br
|
||||
#include "theactivex.h"
|
||||
.br
|
||||
.br
|
||||
QAXFACTORY_DEFAULT(
|
||||
.br
|
||||
TheActiveX, // widget class
|
||||
.br
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}", // class ID
|
||||
.br
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}", // interface ID
|
||||
.br
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}", // event interface ID
|
||||
.br
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}", // type library ID
|
||||
.br
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}" // application ID
|
||||
.br
|
||||
)
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
If you implement your own factory reimplement the pure virtual functions, provide the unique identifiers for the ActiveX controls, and use the QAXFACTORY_EXPORT macro to instantiate and export it:
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
TQStringList ActiveQtFactory::featureList() const
|
||||
.br
|
||||
{
|
||||
.br
|
||||
TQStringList list;
|
||||
.br
|
||||
list << "ActiveX1";
|
||||
.br
|
||||
list << "ActiveX2";
|
||||
.br
|
||||
...
|
||||
.br
|
||||
return list;
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.br
|
||||
TQWidget *ActiveQtFactory::create( const TQString &key, TQWidget *parent, const char *name )
|
||||
.br
|
||||
{
|
||||
.br
|
||||
if ( key == "ActiveX1" )
|
||||
.br
|
||||
return new ActiveX1( parent, name );
|
||||
.br
|
||||
if ( key == "ActiveX2" )
|
||||
.br
|
||||
return new ActiveX2( parent, name );
|
||||
.br
|
||||
...
|
||||
.br
|
||||
return 0;
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.br
|
||||
QUuid ActiveQtFactory::classID( const TQString &key ) const
|
||||
.br
|
||||
{
|
||||
.br
|
||||
if ( key == "ActiveX1" )
|
||||
.br
|
||||
return "{01234567-89AB-CDEF-0123-456789ABCDEF}";
|
||||
.br
|
||||
...
|
||||
.br
|
||||
return QUuid();
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.br
|
||||
QUuid ActiveQtFactory::interfaceID( const TQString &key ) const
|
||||
.br
|
||||
{
|
||||
.br
|
||||
if ( key == "ActiveX1" )
|
||||
.br
|
||||
return "{01234567-89AB-CDEF-0123-456789ABCDEF}";
|
||||
.br
|
||||
...
|
||||
.br
|
||||
return QUuid();
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.br
|
||||
QUuid ActiveQtFactory::eventsID( const TQString &key ) const
|
||||
.br
|
||||
{
|
||||
.br
|
||||
if ( key == "ActiveX1" )
|
||||
.br
|
||||
return "{01234567-89AB-CDEF-0123-456789ABCDEF}";
|
||||
.br
|
||||
...
|
||||
.br
|
||||
return QUuid();
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.br
|
||||
QAXFACTORY_EXPORT(
|
||||
.br
|
||||
MyFactory, // factory class
|
||||
.br
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}", // type library ID
|
||||
.br
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}" // application ID
|
||||
.br
|
||||
)
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
If you use the \fCTQ_CLASSINFO\fR macro to provide the unique identifiers or other attributes for your class you can use the QAXFACTORY_BEGIN, QAXCLASS and QAXFACTORY_END macros to expose one or more classes as COM objects.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
QAXFACTORY_BEGIN(
|
||||
.br
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}", // type library ID
|
||||
.br
|
||||
"{01234567-89AB-CDEF-0123-456789ABCDEF}" // application ID
|
||||
.br
|
||||
)
|
||||
.br
|
||||
QAXCLASS(Class1)
|
||||
.br
|
||||
QAXCLASS(Class2)
|
||||
.br
|
||||
QAXFACTORY_END()
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
Only one QAxFactory implementation may be instantiated and exported by an ActiveX server application. This instance is accessible through the global qAxFactory() function.
|
||||
.PP
|
||||
A factory can also reimplement the registerClass() and unregisterClass() functions to set additional flags for an ActiveX control in the registry. To limit the number of methods or properties a widget class exposes from its parent classes reimplement exposeToSuperClass().
|
||||
.SS "Member Type Documentation"
|
||||
.SH "QAxFactory::ServerType"
|
||||
This enum specifies the different types of servers that can be started with startServer.
|
||||
.TP
|
||||
\fCQAxFactory::SingleInstance\fR - The server can create only one instance of each supplied class.
|
||||
.TP
|
||||
\fCQAxFactory::MultipleInstances\fR - The server can create multiple instances of each supplied class.
|
||||
.SH MEMBER FUNCTION DOCUMENTATION
|
||||
.SH "QAxFactory::QAxFactory ( const QUuid & libid, const QUuid & appid )"
|
||||
Constructs a QAxFactory object that returns \fIlibid\fR and \fIappid\fR in the implementation of the respective interface functions.
|
||||
.SH "QAxFactory::~QAxFactory ()\fC [virtual]\fR"
|
||||
Destroys the QAxFactory object.
|
||||
.SH "QUuid QAxFactory::appID () const\fC [virtual]\fR"
|
||||
Reimplement this function to return the ActiveX server's application identifier.
|
||||
.SH "QUuid QAxFactory::classID ( const TQString & key ) const\fC [virtual]\fR"
|
||||
Reimplement this function to return the class identifier for each \fIkey\fR returned by the featureList() implementation, or an empty QUuid if this factory doesn't support the value of \fIkey\fR.
|
||||
.PP
|
||||
The default implementation interprets \fIkey\fR as the class name, and returns the value of the TQ_CLASSINFO entry "ClassID".
|
||||
.SH "TQWidget * QAxFactory::create ( const TQString & key, TQWidget * parent = 0, const char * name = 0 )\fC [virtual]\fR"
|
||||
Reimplement this function to return a new widget for \fIkey\fR. Propagate \fIparent\fR and \fIname\fR to the TQWidget constructor. Return 0 if this factory doesn't support the value of \fIkey\fR.
|
||||
.PP
|
||||
The returned widget will be exposed as an ActiveX control, e.g. a COM object that can be embedded as a control into applications.
|
||||
.PP
|
||||
The default implementation returns 0.
|
||||
.SH "TQObject * QAxFactory::createObject ( const TQString & key, TQObject * parent = 0, const char * name = 0 )\fC [virtual]\fR"
|
||||
Reimplement this function to return a new object for \fIkey\fR. Propagate \fIparent\fR and \fIname\fR to the TQWidget constructor. Return 0 if this factory doesn't support the value of \fIkey\fR.
|
||||
.PP
|
||||
If the object returned is a TQWidget it will be exposed as an ActiveX control, otherwise the returned object will be exposed as a COM object.
|
||||
.PP
|
||||
The default implementation returns the result QAxFactory::create() if \fIparent\fR is 0 or a widget, otherwise returns 0.
|
||||
.SH "bool QAxFactory::createObjectWrapper ( TQObject * object, IDispatch ** wrapper )\fC [virtual]\fR"
|
||||
Reimplement this function to provide the COM object for \fIobject\fR in \fIwrapper\fR. Return TRUE if the function was successfull, otherwise return FALSE.
|
||||
.PP
|
||||
The default implementation creates a generic automation wrapper based on the meta object information of \fIobject\fR.
|
||||
.SH "QUuid QAxFactory::eventsID ( const TQString & key ) const\fC [virtual]\fR"
|
||||
Reimplement this function to return the identifier of the event interface for each \fIkey\fR returned by the featureList() implementation, or an empty QUuid if this factory doesn't support the value of \fIkey\fR.
|
||||
.PP
|
||||
The default implementation interprets \fIkey\fR as the class name, and returns the value of the TQ_CLASSINFO entry "EventsID".
|
||||
.SH "TQString QAxFactory::exposeToSuperClass ( const TQString & key ) const\fC [virtual]\fR"
|
||||
Reimplement this function to return the name of the super class of \fIkey\fR up to which methods and properties should be exposed by the ActiveX control.
|
||||
.PP
|
||||
The default implementation interprets \fIkey\fR as the class name, and returns the value of the TQ_CLASSINFO entry "ToSuperClass". If no such value is set the null-string is returned, and the functions and properties of all the super classes including TQWidget will be exposed.
|
||||
.PP
|
||||
To only expose the functions and properties of the class itself, reimplement this function to return \fIkey\fR.
|
||||
.SH "TQStringList QAxFactory::featureList () const\fC [pure virtual]\fR"
|
||||
Reimplement this function to return a list of the widgets (class names) supported by this factory.
|
||||
.SH "bool QAxFactory::hasStockEvents ( const TQString & key ) const\fC [virtual]\fR"
|
||||
Reimplement this function to return TRUE if the ActiveX control \fIkey\fR should support the standard ActiveX events
|
||||
.TP
|
||||
Click
|
||||
.TP
|
||||
DblClick
|
||||
.TP
|
||||
KeyDown
|
||||
.TP
|
||||
KeyPress
|
||||
.TP
|
||||
KeyUp
|
||||
.TP
|
||||
MouseDown
|
||||
.TP
|
||||
MouseUp
|
||||
.TP
|
||||
MouseMove
|
||||
.PP
|
||||
The default implementation interprets \fIkey\fR as the class name, and returns TRUE if the value of the TQ_CLASSINFO entry "StockEvents" is "yes". Otherwise this function returns FALSE.
|
||||
.SH "QUuid QAxFactory::interfaceID ( const TQString & key ) const\fC [virtual]\fR"
|
||||
Reimplement this function to return the interface identifier for each \fIkey\fR returned by the featureList() implementation, or an empty QUuid if this factory doesn't support the value of \fIkey\fR.
|
||||
.PP
|
||||
The default implementation interprets \fIkey\fR as the class name, and returns the value of the TQ_CLASSINFO entry "InterfaceID".
|
||||
.SH "bool QAxFactory::isServer ()\fC [static]\fR"
|
||||
Returns TRUE if the application has been started (by COM) as an ActiveX server, otherwise returns FALSE.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
int main( int argc, char**argv )
|
||||
.br
|
||||
{
|
||||
.br
|
||||
QApplication app( argc, argv );
|
||||
.br
|
||||
.br
|
||||
if ( !QAxFactory::isServer() ) {
|
||||
.br
|
||||
// initialize for stand-alone execution
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.br
|
||||
return app.exec() // standard event processing
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.fi
|
||||
.SH "bool QAxFactory::isService () const\fC [virtual]\fR"
|
||||
Reimplement this function to return TRUE if the server is running as a persistent service (e.g. an NT service) and should not terminate even when all objects provided have been released.
|
||||
.PP
|
||||
The default implementation returns FALSE.
|
||||
.SH "QMetaObject * QAxFactory::metaObject ( const TQString & key ) const\fC [virtual]\fR"
|
||||
Reimplement this function to return the QMetaObject corresponding to \fIkey\fR, or 0 if this factory doesn't support the value of \fIkey\fR.
|
||||
.PP
|
||||
The default implementation returns the QMetaObject for the class \fIkey\fR.
|
||||
.SH "void QAxFactory::registerClass ( const TQString & key, QSettings * settings ) const\fC [virtual]\fR"
|
||||
Registers additional values for the class \fIkey\fR in the system registry using the \fIsettings\fR object. The standard values have already been registed by the framework, but additional values, e.g. implemented categories, can be added in an implementation of this function.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
settings->writeEntry( "/CLSID/" + classID(key) + "/Implemented Categories/{00000000-0000-0000-000000000000}/.", TQString::null );
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
If you reimplement this function you must also reimplement unregisterClass() to remove the additional registry values.
|
||||
.PP
|
||||
See also QSettings.
|
||||
.SH "TQString QAxFactory::serverDirPath ()\fC [static]\fR"
|
||||
Returns the directory that contains the server binary.
|
||||
.PP
|
||||
For out-of-process servers this is the same as QApplication::applicationDirPath(). For in-process servers that function returns the directory that contains the hosting application.
|
||||
.SH "TQString QAxFactory::serverFilePath ()\fC [static]\fR"
|
||||
Returns the file path of the server binary.
|
||||
.PP
|
||||
For out-of-process servers this is the same as QApplication::applicationFilePath(). For in-process servers that function returns the file path of the hosting application.
|
||||
.SH "bool QAxFactory::startServer ( ServerType type = MultipleInstances )\fC [static]\fR"
|
||||
Starts the COM server with \fItype\fR and returns TRUE if successful, otherwise returns FALSE.
|
||||
.PP
|
||||
Calling this function if the server is already running (or for an in-process server) does nothing and returns TRUE.
|
||||
.PP
|
||||
The server is started automatically with \fItype\fR set to MultipleUse if the server executable has been started with the \fC-activex\fR command line parameter.
|
||||
.SH "bool QAxFactory::stayTopLevel ( const TQString & key ) const\fC [virtual]\fR"
|
||||
Reimplement this function to return TRUE if the ActiveX control \fIkey\fR should be a top level window, e.g. a dialog. The default implementation returns FALSE.
|
||||
.SH "bool QAxFactory::stopServer ()\fC [static]\fR"
|
||||
Stops the COM server and returns TRUE if successful, otherwise returns FALSE.
|
||||
.PP
|
||||
Calling this function if the server is not running (or for an in-process server) does nothing and returns TRUE.
|
||||
.PP
|
||||
Stopping the server will not invalidate existing objects, but no new objects can be created from the existing server process. Usually COM will start a new server process if additional objects are requested.
|
||||
.PP
|
||||
The server is stopped automatically when the main() function returns.
|
||||
.SH "QUuid QAxFactory::typeLibID () const\fC [virtual]\fR"
|
||||
Reimplement this function to return the ActiveX server's type library identifier.
|
||||
.SH "void QAxFactory::unregisterClass ( const TQString & key, QSettings * settings ) const\fC [virtual]\fR"
|
||||
Unregisters any additional values for the class \fIkey\fR from the system registry using the \fIsettings\fR object.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
settings->removeEntry( "/CLSID/" + classID(key) + "/Implemented Categories/{00000000-0000-0000-000000000000}/." );
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
See also registerClass() and QSettings.
|
||||
.SH "bool QAxFactory::validateLicenseKey ( const TQString & key, const TQString & licenseKey ) const\fC [virtual]\fR"
|
||||
Reimplement this function to return TRUE if \fIlicenseKey\fR is a valid license for the class \fIkey\fR, or if the current machine is licensed.
|
||||
.PP
|
||||
The default implementation returns TRUE if the class \fIkey\fR is not
|
||||
licensed (ie. no TQ_CLASSINFO attribute "LicenseKey"), or if
|
||||
\fIlicenseKey\fR matches the value of the "LicenseKey" attribute, or
|
||||
if the machine is licensed through a .LIC file with the same filename
|
||||
as this COM server.
|
||||
|
||||
.SH "SEE ALSO"
|
||||
.BR http://doc.trolltech.com/qaxfactory.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 (tqaxfactory.3qt) and the Qt
|
||||
version (3.3.8).
|
||||
@ -1,183 +0,0 @@
|
||||
'\" t
|
||||
.TH QAxObject 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
|
||||
QAxObject \- TQObject that wraps a COM object
|
||||
.SH SYNOPSIS
|
||||
This class is part of the \fBQt ActiveQt Extension\fR.
|
||||
.PP
|
||||
\fC#include <qaxobject.h>\fR
|
||||
.PP
|
||||
Inherits TQObject and QAxBase.
|
||||
.PP
|
||||
Inherited by QAxScriptEngine.
|
||||
.PP
|
||||
.SS "Public Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "\fBQAxObject\fR ( TQObject * parent = 0, const char * name = 0 )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "\fBQAxObject\fR ( const TQString & c, TQObject * parent = 0, const char * name = 0 )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "\fBQAxObject\fR ( IUnknown * iface, TQObject * parent = 0, const char * name = 0 )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "\fB~QAxObject\fR ()"
|
||||
.br
|
||||
.in -1c
|
||||
.SS "Important Inherited Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "QVariant \fBdynamicCall\fR ( const QCString & function, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QVariant \fBdynamicCall\fR ( const QCString & function, TQValueList<QVariant> & vars )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QAxObject * \fBquerySubObject\fR ( const QCString & name, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
.br
|
||||
.in -1c
|
||||
.SH DESCRIPTION
|
||||
This class is defined in the \fBQt ActiveQt Extension\fR, which can be found in the \fCqt/extensions\fR directory. It is not included in the main TQt API.
|
||||
.PP
|
||||
The QAxObject class provides a TQObject that wraps a COM object.
|
||||
.PP
|
||||
A QAxObject can be instantiated as an empty object, with the name of the COM object it should wrap, or with a pointer to the IUnknown that represents an existing COM object. If the COM object implements the IDispatch interface, the properties, methods and events of that object become available as TQt properties, slots and signals. The base class, QAxBase, provides an API to access the COM object directly through the IUnknown pointer.
|
||||
.PP
|
||||
QAxObject is a TQObject and can be used as such, e.g. it can be organized in an object hierarchy, receive events and connect to signals and slots.
|
||||
.PP
|
||||
\fBWarning:\fR You can subclass QAxObject, but you cannot use the TQ_OBJECT macro in the subclass (the generated moc-file will not compile), so you cannot add further signals, slots or properties. This limitation is due to the metaobject information generated in runtime. To work around this problem, aggregate the QAxObject as a member of the TQObject subclass.
|
||||
.PP
|
||||
.SH MEMBER FUNCTION DOCUMENTATION
|
||||
.SH "QAxObject::QAxObject ( TQObject * parent = 0, const char * name = 0 )"
|
||||
Creates an empty COM object and propagates \fIparent\fR and \fIname\fR to the TQObject constructor. To initialize the object, call setControl.
|
||||
.SH "QAxObject::QAxObject ( const TQString & c, TQObject * parent = 0, const char * name = 0 )"
|
||||
Creates a QAxObject that wraps the COM object \fIc\fR. \fIparent\fR and \fIname\fR are propagated to the TQWidget contructor.
|
||||
.PP
|
||||
See also control.
|
||||
.SH "QAxObject::QAxObject ( IUnknown * iface, TQObject * parent = 0, const char * name = 0 )"
|
||||
Creates a QAxObject that wraps the COM object referenced by \fIiface\fR. \fIparent\fR and \fIname\fR are propagated to the TQObject contructor.
|
||||
.SH "QAxObject::~QAxObject ()"
|
||||
Releases the COM object and destroys the QAxObject, cleaning up all allocated resources.
|
||||
.SH "QVariant QAxBase::dynamicCall ( const QCString & function, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
Calls the COM object's method \fIfunction\fR, passing the parameters \fIvar1\fR, \fIvar1\fR, \fIvar2\fR, \fIvar3\fR, \fIvar4\fR, \fIvar5\fR, \fIvar6\fR, \fIvar7\fR and \fIvar8\fR, and returns the value returned by the method, or an invalid QVariant if the method does not return a value or when the function call failed.
|
||||
.PP
|
||||
If \fIfunction\fR is a method of the object the string must be provided as the full prototype, for example as it would be written in a TQObject::connect() call.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
activeX->dynamicCall( "Navigate(const TQString&)", "www.trolltech.com" );
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
Alternatively a function can be called passing the parameters embedded in the string, e.g. above function can also be invoked using
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
activeX->dynamicCall("Navigate(\\"www.trolltech.com\\");
|
||||
.br
|
||||
.fi
|
||||
All parameters are passed as strings; it depends on the control whether they are interpreted correctly, and is slower than using the prototype with correctly typed parameters.
|
||||
.PP
|
||||
If \fIfunction\fR is a property the string has to be the name of the property. The property setter is called when \fIvar1\fR is a valid QVariant, otherwise the getter is called.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
activeX->dynamicCall( "Value", 5 );
|
||||
.br
|
||||
TQString text = activeX->dynamicCall( "Text" ).toString();
|
||||
.br
|
||||
.fi
|
||||
Note that it is faster to get and set properties using TQObject::property() and TQObject::setProperty().
|
||||
.PP
|
||||
It is only possible to call functions through dynamicCall() that have parameters or return values of datatypes supported by QVariant. See the QAxBase class documentation for a list of supported and unsupported datatypes. If you want to call functions that have unsupported datatypes in the parameter list, use queryInterface() to retrieve the appropriate COM interface, and use the function directly.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
IWebBrowser2 *webBrowser = 0;
|
||||
.br
|
||||
activeX->queryInterface( IID_IWebBrowser2, (void**)&webBrowser );
|
||||
.br
|
||||
if ( webBrowser ) {
|
||||
.br
|
||||
webBrowser->Navigate2( pvarURL );
|
||||
.br
|
||||
webBrowser->Release();
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
This is also more efficient.
|
||||
.PP
|
||||
Example: qutlook/centralwidget.cpp.
|
||||
.SH "QVariant QAxBase::dynamicCall ( const QCString & function, TQValueList<QVariant> & vars )"
|
||||
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
.PP
|
||||
Calls the COM object's method \fIfunction\fR, passing the parameters in \fIvars\fR, and returns the value returned by the method. If the method does not return a value or when the function call failed this function returns an invalid QVariant object.
|
||||
.PP
|
||||
The QVariant objects in \fIvars\fR are updated when the method has out-parameters.
|
||||
.SH "QAxObject * QAxBase::querySubObject ( const QCString & name, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
Returns a pointer to a QAxObject wrapping the COM object provided by the method or property \fIname\fR, passing passing the parameters \fIvar1\fR, \fIvar1\fR, \fIvar2\fR, \fIvar3\fR, \fIvar4\fR, \fIvar5\fR, \fIvar6\fR, \fIvar7\fR and \fIvar8\fR.
|
||||
.PP
|
||||
If \fIname\fR is provided by a method the string must include the full function prototype.
|
||||
.PP
|
||||
If \fIname\fR is a property the string must be the name of the property, and \fIvar1\fR, ... \fIvar8\fR are ignored.
|
||||
.PP
|
||||
The returned QAxObject is a child of this object (which is either of type QAxObject or QAxWidget), and is deleted when this object is deleted. It is however safe to delete the returned object yourself, and you should do so when you iterate over lists of subobjects.
|
||||
.PP
|
||||
COM enabled applications usually have an object model publishing certain elements of the application as dispatch interfaces. Use this method to navigate the hierarchy of the object model, e.g.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
QAxWidget outlook( "Outlook.Application" );
|
||||
.br
|
||||
QAxObject *session = outlook.querySubObject( "Session" );
|
||||
.br
|
||||
if ( session ) {
|
||||
.br
|
||||
QAxObject *defFolder = session->querySubObject(
|
||||
.br
|
||||
"GetDefaultFolder(OlDefaultFolders)",
|
||||
.br
|
||||
"olFolderContacts" );
|
||||
.br
|
||||
//...
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
Example: qutlook/centralwidget.cpp.
|
||||
|
||||
.SH "SEE ALSO"
|
||||
.BR http://doc.trolltech.com/qaxobject.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 (tqaxobject.3qt) and the Qt
|
||||
version (3.3.8).
|
||||
@ -1,169 +0,0 @@
|
||||
'\" t
|
||||
.TH QAxScript 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
|
||||
QAxScript \- Wrapper around script code
|
||||
.SH SYNOPSIS
|
||||
This class is part of the \fBQt ActiveQt Extension\fR.
|
||||
.PP
|
||||
\fC#include <qaxscript.h>\fR
|
||||
.PP
|
||||
Inherits TQObject.
|
||||
.PP
|
||||
.SS "Public Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "enum \fBFunctionFlags\fR { FunctionNames = 0, FunctionSignatures }"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "\fBQAxScript\fR ( const TQString & name, QAxScriptManager * manager )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "\fB~QAxScript\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "bool \fBload\fR ( const TQString & code, const TQString & language = TQString::null )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "TQStringList \fBfunctions\fR ( FunctionFlags flags = FunctionNames ) const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "TQString \fBscriptCode\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "TQString \fBscriptName\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QAxScriptEngine * \fBscriptEngine\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QVariant \fBcall\fR ( const TQString & function, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QVariant \fBcall\fR ( const TQString & function, TQValueList<QVariant> & arguments )"
|
||||
.br
|
||||
.in -1c
|
||||
.SS "Signals"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "void \fBentered\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBfinished\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBfinished\fR ( const QVariant & result )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBfinished\fR ( int code, const TQString & source, const TQString & description, const TQString & help )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBstateChanged\fR ( int state )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBerror\fR ( int code, const TQString & description, int sourcePosition, const TQString & sourceText )"
|
||||
.br
|
||||
.in -1c
|
||||
.SH DESCRIPTION
|
||||
This class is defined in the \fBQt ActiveQt Extension\fR, which can be found in the \fCqt/extensions\fR directory. It is not included in the main TQt API.
|
||||
.PP
|
||||
The QAxScript class provides a wrapper around script code.
|
||||
.PP
|
||||
Every instance of the QAxScript class represents a piece of scripting code in a particular scripting language. The code is loaded into the script engine using load(). Functions declared in the code can be called using call().
|
||||
.PP
|
||||
The script provides scriptEngine() provides feedback to the application through signals. The most important signal is the error() signal. Direct access to the QAxScriptEngine is provided through the scriptEngine() function.
|
||||
.PP
|
||||
\fBWarning:\fR This class is not available with the bcc5.5 and MingW compilers.
|
||||
.SS "Member Type Documentation"
|
||||
.SH "QAxScript::FunctionFlags"
|
||||
This FunctionFlags enum describes formatting for function introspection.
|
||||
.TP
|
||||
\fCQAxScript::FunctionNames\fR - Only function names are returned.
|
||||
.TP
|
||||
\fCQAxScript::FunctionSignatures\fR - Returns the functions with signatures.
|
||||
.SH MEMBER FUNCTION DOCUMENTATION
|
||||
.SH "QAxScript::QAxScript ( const TQString & name, QAxScriptManager * manager )"
|
||||
Constructs a QAxScript object called \fIname\fR and registers it with the QAxScriptManager \fImanager\fR. This is usually done by the QAxScriptManager class when loading a script.
|
||||
.PP
|
||||
A script should always have a name. A manager is necessary to allow the script code to reference objects in the application. The \fImanager\fR takes ownership of the object.
|
||||
.SH "QAxScript::~QAxScript ()"
|
||||
Destroys the object, releasing all allocated resources.
|
||||
.SH "QVariant QAxScript::call ( const TQString & function, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
Calls \fIfunction\fR, passing the parameters \fIvar1\fR, \fIvar1\fR, \fIvar2\fR, \fIvar3\fR, \fIvar4\fR, \fIvar5\fR, \fIvar6\fR, \fIvar7\fR and \fIvar8\fR as arguments and returns the value returned by the function, or an invalid QVariant if the function does not return a value or when the function call failed.
|
||||
.PP
|
||||
See QAxScriptManager::call() for more information about how to call script functions.
|
||||
.SH "QVariant QAxScript::call ( const TQString & function, TQValueList<QVariant> & arguments )"
|
||||
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
.PP
|
||||
Calls \fIfunction\fR passing \fIarguments\fR as parameters, and returns the result. Returns when the script's execution has finished.
|
||||
.PP
|
||||
See QAxScriptManager::call() for more information about how to call script functions.
|
||||
.SH "void QAxScript::entered ()\fC [signal]\fR"
|
||||
This signal is emitted when a script engine has started executing code.
|
||||
.SH "void QAxScript::error ( int code, const TQString & description, int sourcePosition, const TQString & sourceText )\fC [signal]\fR"
|
||||
This signal is emitted when an execution error occured while running a script.
|
||||
.PP
|
||||
\fIcode\fR, \fIdescription\fR, \fIsourcePosition\fR and \fIsourceText\fR contain information about the execution error.
|
||||
.SH "void QAxScript::finished ()\fC [signal]\fR"
|
||||
This signal is emitted when a script engine has finished executing code.
|
||||
.SH "void QAxScript::finished ( const QVariant & result )\fC [signal]\fR"
|
||||
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
.PP
|
||||
\fIresult\fR contains the script's result. This will be an invalid QVariant if the script has no return value.
|
||||
.SH "void QAxScript::finished ( int code, const TQString & source, const TQString & description, const TQString & help )\fC [signal]\fR"
|
||||
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
.PP
|
||||
\fIcode\fR, \fIsource\fR, \fIdescription\fR and \fIhelp\fR contain exception information when the script terminated.
|
||||
.SH "TQStringList QAxScript::functions ( FunctionFlags flags = FunctionNames ) const"
|
||||
Returns a list of all the functions in this script if the respective script engine supports introspection; otherwise returns an empty list. The functions are either provided with full prototypes or only as names, depending on the value of \fIflags\fR.
|
||||
.PP
|
||||
See also QAxScriptEngine::hasIntrospection().
|
||||
.SH "bool QAxScript::load ( const TQString & code, const TQString & language = TQString::null )"
|
||||
Loads the script source \fIcode\fR written in language \fIlanguage\fR into the script engine. Returns TRUE if \fIcode\fR was successfully entered into the script engine; otherwise returns FALSE.
|
||||
.PP
|
||||
If \fIlanguage\fR is empty (the default) it will be determined heuristically. If \fIcode\fR contains the string \fCEnd Sub\fR it will be interpreted as VBScript, otherwise as JScript. Additional scripting languages can be registered using QAxScript::registerEngine().
|
||||
.PP
|
||||
This function can only be called once for each QAxScript object, which is done automatically when using QAxScriptManager::load().
|
||||
.SH "TQString QAxScript::scriptCode () const"
|
||||
Returns the script's code, or the null-string if no code has been loaded yet.
|
||||
.PP
|
||||
See also load().
|
||||
.SH "QAxScriptEngine * QAxScript::scriptEngine () const"
|
||||
Returns a pointer to the script engine.
|
||||
.PP
|
||||
You can use the object returned to connect signals to the script functions, or to access the script engine directly.
|
||||
.SH "TQString QAxScript::scriptName () const"
|
||||
Returns the name of the script.
|
||||
.SH "void QAxScript::stateChanged ( int state )\fC [signal]\fR"
|
||||
This signal is emitted when a script engine changes state.
|
||||
\fIstate\fR can be any value in the QAxScriptEngineState enumeration.
|
||||
|
||||
.SH "SEE ALSO"
|
||||
.BR http://doc.trolltech.com/qaxscript.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 (tqaxscript.3qt) and the Qt
|
||||
version (3.3.8).
|
||||
@ -1,123 +0,0 @@
|
||||
'\" t
|
||||
.TH QAxScriptEngine 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
|
||||
QAxScriptEngine \- Wrapper around a script engine
|
||||
.SH SYNOPSIS
|
||||
This class is part of the \fBQt ActiveQt Extension\fR.
|
||||
.PP
|
||||
\fC#include <qaxscript.h>\fR
|
||||
.PP
|
||||
Inherits QAxObject.
|
||||
.PP
|
||||
.SS "Public Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "enum \fBState\fR { Uninitialized = 0, Initialized = 5, Started = 1, Connected = 2, Disconnected = 3, Closed = 4 }"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "\fBQAxScriptEngine\fR ( const TQString & language, QAxScript * script )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "\fB~QAxScriptEngine\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "bool \fBisValid\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "bool \fBhasIntrospection\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "TQString \fBscriptLanguage\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "State \fBstate\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBsetState\fR ( State st )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBaddItem\fR ( const TQString & name )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "long \fBqueryInterface\fR ( const QUuid & uuid, void ** iface ) const"
|
||||
.br
|
||||
.in -1c
|
||||
.SH DESCRIPTION
|
||||
This class is defined in the \fBQt ActiveQt Extension\fR, which can be found in the \fCqt/extensions\fR directory. It is not included in the main TQt API.
|
||||
.PP
|
||||
The QAxScriptEngine class provides a wrapper around a script engine.
|
||||
.PP
|
||||
Every instance of the QAxScriptEngine class represents an interpreter for script code in a particular scripting language. The class is usually not used directly. The QAxScript and QAxScriptManager classes provide convenient functions to handle and call script code.
|
||||
.PP
|
||||
Direct access to the script engine is provided through queryInterface().
|
||||
.PP
|
||||
\fBWarning:\fR This class is not available with the bcc5.5 and MingW compilers.
|
||||
.SS "Member Type Documentation"
|
||||
.SH "QAxScriptEngine::State"
|
||||
The State enumeration defines the different states a script engine can be in.
|
||||
.TP
|
||||
\fCQAxScriptEngine::Uninitialized\fR - The script has been created, but not yet initialized
|
||||
.TP
|
||||
\fCQAxScriptEngine::Initialized\fR - The script has been initialized, but is not running
|
||||
.TP
|
||||
\fCQAxScriptEngine::Started\fR - The script can execute code, but does not yet handle events
|
||||
.TP
|
||||
\fCQAxScriptEngine::Connected\fR - The script can execute code and is connected so that it can handle events
|
||||
.TP
|
||||
\fCQAxScriptEngine::Disconnected\fR - The script is loaded, but is not connected to event sources
|
||||
.TP
|
||||
\fCQAxScriptEngine::Closed\fR - The script has been closed.
|
||||
.SH MEMBER FUNCTION DOCUMENTATION
|
||||
.SH "QAxScriptEngine::QAxScriptEngine ( const TQString & language, QAxScript * script )"
|
||||
Constructs a QAxScriptEngine object interpreting script code in \fIlanguage\fR provided by the code in \fIscript\fR. This is usually done by the QAxScript class when loading a script.
|
||||
.PP
|
||||
Instances of QAxScriptEngine should always have both a language and a script.
|
||||
.SH "QAxScriptEngine::~QAxScriptEngine ()"
|
||||
Destroys the QAxScriptEngine object, releasing all allocated resources.
|
||||
.SH "void QAxScriptEngine::addItem ( const TQString & name )"
|
||||
Registers an item with the script engine. Script code can refer to this item using \fIname\fR.
|
||||
.SH "bool QAxScriptEngine::hasIntrospection () const"
|
||||
Returns TRUE if the script engine supports introspection; otherwise returns FALSE.
|
||||
.SH "bool QAxScriptEngine::isValid () const"
|
||||
Returns TRUE if the script engine has been initialized correctly; otherwise returns FALSE.
|
||||
.SH "long QAxScriptEngine::queryInterface ( const QUuid & uuid, void ** iface ) const"
|
||||
Requests the interface \fIuuid\fR from the script engine object and sets the value of \fIiface\fR to the provided interface, or to 0 if the requested interface could not be provided.
|
||||
.PP
|
||||
Returns the result of the QueryInterface implementation of the COM object.
|
||||
.SH "TQString QAxScriptEngine::scriptLanguage () const"
|
||||
Returns the scripting language, for example "VBScript", or "JScript".
|
||||
.SH "void QAxScriptEngine::setState ( State st )"
|
||||
Sets the state of the script engine to \fIst\fR. Calling this function is usually not necessary.
|
||||
.SH "State QAxScriptEngine::state () const"
|
||||
Returns the state of the script engine.
|
||||
|
||||
.SH "SEE ALSO"
|
||||
.BR http://doc.trolltech.com/qaxscriptengine.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 (tqaxscriptengine.3qt) and the Qt
|
||||
version (3.3.8).
|
||||
@ -1,197 +0,0 @@
|
||||
'\" t
|
||||
.TH QAxScriptManager 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
|
||||
QAxScriptManager \- Bridge between application objects and script code
|
||||
.SH SYNOPSIS
|
||||
This class is part of the \fBQt ActiveQt Extension\fR.
|
||||
.PP
|
||||
\fC#include <qaxscript.h>\fR
|
||||
.PP
|
||||
Inherits TQObject.
|
||||
.PP
|
||||
.SS "Public Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "\fBQAxScriptManager\fR ( TQObject * parent = 0, const char * name = 0 )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "\fB~QAxScriptManager\fR ()"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBaddObject\fR ( QAxBase * object )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "void \fBaddObject\fR ( TQObject * object )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "TQStringList \fBfunctions\fR ( QAxScript::FunctionFlags flags = QAxScript::FunctionNames ) const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "TQStringList \fBscriptNames\fR () const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QAxScript * \fBscript\fR ( const TQString & name ) const"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QAxScript * \fBload\fR ( const TQString & code, const TQString & name, const TQString & language )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QAxScript * \fBload\fR ( const TQString & file, const TQString & name )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QVariant \fBcall\fR ( const TQString & function, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QVariant \fBcall\fR ( const TQString & function, TQValueList<QVariant> & arguments )"
|
||||
.br
|
||||
.in -1c
|
||||
.SS "Signals"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "void \fBerror\fR ( QAxScript * script, int code, const TQString & description, int sourcePosition, const TQString & sourceText )"
|
||||
.br
|
||||
.in -1c
|
||||
.SS "Static Public Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "bool \fBregisterEngine\fR ( const TQString & name, const TQString & extension, const TQString & code = TQString ( ) )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "TQString \fBscriptFileFilter\fR ()"
|
||||
.br
|
||||
.in -1c
|
||||
.SH DESCRIPTION
|
||||
This class is defined in the \fBQt ActiveQt Extension\fR, which can be found in the \fCqt/extensions\fR directory. It is not included in the main TQt API.
|
||||
.PP
|
||||
The QAxScriptManager class provides a bridge between application objects and script code.
|
||||
.PP
|
||||
The QAxScriptManager acts as a bridge between the COM objects embedded in the TQt application through QAxObject or QAxWidget, and the scripting languages available through the Windows Script technologies, usually JScript and VBScript.
|
||||
.PP
|
||||
Create one QAxScriptManager for each separate document in your application, and add the COM objects the scripts need to access using addObject(). Then load() the script sources and invoke the functions using call().
|
||||
.PP
|
||||
\fBWarning:\fR This class is not available with the bcc5.5 and MingW compilers.
|
||||
.SH MEMBER FUNCTION DOCUMENTATION
|
||||
.SH "QAxScriptManager::QAxScriptManager ( TQObject * parent = 0, const char * name = 0 )"
|
||||
Creates a QAxScriptManager object. \fIparent\fR and \fIname\fR are passed on to the TQObject constructor.
|
||||
.PP
|
||||
It is usual to create one QAxScriptManager for each document in an application.
|
||||
.SH "QAxScriptManager::~QAxScriptManager ()"
|
||||
Destroys the objects, releasing all allocated resources.
|
||||
.SH "void QAxScriptManager::addObject ( QAxBase * object )"
|
||||
Adds \fIobject\fR to the manager. Scripts handled by this manager can access the object in the code using the object's name property.
|
||||
.PP
|
||||
You must add all the necessary objects before loading any scripts.
|
||||
.SH "void QAxScriptManager::addObject ( TQObject * object )"
|
||||
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
.PP
|
||||
Adds a generic COM wrapper for \fIobject\fR to the manager. \fIobject\fR must be exposed as a COM object using the functionality provided by the QAxServer module.. Applications using this function you must link against the qaxserver library.
|
||||
.SH "QVariant QAxScriptManager::call ( const TQString & function, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
Calls \fIfunction\fR, passing the parameters \fIvar1\fR, \fIvar1\fR, \fIvar2\fR, \fIvar3\fR, \fIvar4\fR, \fIvar5\fR, \fIvar6\fR, \fIvar7\fR and \fIvar8\fR as arguments and returns the value returned by the function, or an invalid QVariant if the function does not return a value or when the function call failed. The call returns when the script's execution has finished.
|
||||
.PP
|
||||
In most script engines the only supported parameter type is "const QVariant&", for example, to call a JavaScript function
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
function setNumber(number)
|
||||
.br
|
||||
{
|
||||
.br
|
||||
n = number;
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.fi
|
||||
use
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
TQValueList args;
|
||||
.br
|
||||
args << 5;
|
||||
.br
|
||||
script->call("setNumber(const QVariant&)", args);
|
||||
.br
|
||||
.fi
|
||||
As with dynamicCall the parameters can directly be embedded in the function string.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
script->call("setNumber(5)");
|
||||
.br
|
||||
.fi
|
||||
However, this is slower.
|
||||
.PP
|
||||
Functions provided by script engines that don't support introspection are not available and must be called directly using QAxScript::call() on the respective script object.
|
||||
.PP
|
||||
Note that calling this function can be significantely slower than using call() on the respective QAxScript directly.
|
||||
.SH "QVariant QAxScriptManager::call ( const TQString & function, TQValueList<QVariant> & arguments )"
|
||||
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
.PP
|
||||
Calls \fIfunction\fR passing \fIarguments\fR as parameters, and returns the result. Returns when the script's execution has finished.
|
||||
.SH "void QAxScriptManager::error ( QAxScript * script, int code, const TQString & description, int sourcePosition, const TQString & sourceText )\fC [signal]\fR"
|
||||
This signal is emitted when an execution error occured while running \fIscript\fR.
|
||||
.PP
|
||||
\fIcode\fR, \fIdescription\fR, \fIsourcePosition\fR and \fIsourceText\fR contain information about the execution error.
|
||||
.SH "TQStringList QAxScriptManager::functions ( QAxScript::FunctionFlags flags = QAxScript::FunctionNames ) const"
|
||||
Returns a list with all the functions that are available. Functions provided by script engines that don't support introspection are not included in the list. The functions are either provided with full prototypes or only as names, depending on the value of \fIflags\fR.
|
||||
.SH "QAxScript * QAxScriptManager::load ( const TQString & code, const TQString & name, const TQString & language )"
|
||||
Loads the script source \fIcode\fR using the script engine for \fIlanguage\fR. The script can later be referred to using its \fIname\fR which should not be empty.
|
||||
.PP
|
||||
The function returns a pointer to the script for the given \fIcode\fR if the \fIcode\fR was loaded successfully; otherwise it returns 0.
|
||||
.PP
|
||||
If \fIlanguage\fR is empty it will be determined heuristically. If \fIcode\fR contains the string "End Sub" it will be interpreted as VBScript, otherwise as JScript. Additional script engines can be registered using registerEngine().
|
||||
.PP
|
||||
You must add all the objects necessary (using addObject()) \fIbefore\fR loading any scripts. If \fIcode\fR declares a function that is already available (no matter in which language) the first function is overloaded and can no longer be called via call(); but it will still be available by calling its script directly.
|
||||
.PP
|
||||
See also addObject(), scriptNames(), and functions().
|
||||
.SH "QAxScript * QAxScriptManager::load ( const TQString & file, const TQString & name )"
|
||||
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
.PP
|
||||
Loads the source code from the \fIfile\fR. The script can later be referred to using its \fIname\fR which should not be empty.
|
||||
.PP
|
||||
The function returns a pointer to the script engine for the code in \fIfile\fR if \fIfile\fR was loaded successfully; otherwise it returns 0.
|
||||
.PP
|
||||
The script engine used is determined from the file's extension. By default ".js" files are interpreted as JScript files, and ".vbs" and ".dsm" files are interpreted as VBScript. Additional script engines can be registered using registerEngine().
|
||||
.SH "bool QAxScriptManager::registerEngine ( const TQString & name, const TQString & extension, const TQString & code = TQString ( ) )\fC [static]\fR"
|
||||
Registers the script engine called \fIname\fR and returns TRUE if the engine was found; otherwise does nothing and returns FALSE.
|
||||
.PP
|
||||
The script engine will be used when loading files with the given \fIextension\fR, or when loading source code that contains the string \fIcode\fR.
|
||||
.SH "QAxScript * QAxScriptManager::script ( const TQString & name ) const"
|
||||
Returns the script called \fIname\fR.
|
||||
.PP
|
||||
You can use the returned pointer to call functions directly through QAxScript::call(), to access the script engine directly, or to delete and thus unload the script.
|
||||
.SH "TQString QAxScriptManager::scriptFileFilter ()\fC [static]\fR"
|
||||
Returns a file filter listing all the supported script languages. This filter string is convenient for use with QFileDialog.
|
||||
.SH "TQStringList QAxScriptManager::scriptNames () const"
|
||||
Returns a list with the names of all the scripts.
|
||||
|
||||
.SH "SEE ALSO"
|
||||
.BR http://doc.trolltech.com/qaxscriptmanager.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 (tqaxscriptmanager.3qt) and the Qt
|
||||
version (3.3.8).
|
||||
@ -1,215 +0,0 @@
|
||||
'\" t
|
||||
.TH QAxWidget 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
|
||||
QAxWidget \- TQWidget that wraps an ActiveX control
|
||||
.SH SYNOPSIS
|
||||
This class is part of the \fBQt ActiveQt Extension\fR.
|
||||
.PP
|
||||
\fC#include <qaxwidget.h>\fR
|
||||
.PP
|
||||
Inherits TQWidget and QAxBase.
|
||||
.PP
|
||||
.SS "Public Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "\fBQAxWidget\fR ( TQWidget * parent = 0, const char * name = 0, WFlags f = 0 )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "\fBQAxWidget\fR ( const TQString & c, TQWidget * parent = 0, const char * name = 0, WFlags f = 0 )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "\fBQAxWidget\fR ( IUnknown * iface, TQWidget * parent = 0, const char * name = 0, WFlags f = 0 )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "\fB~QAxWidget\fR ()"
|
||||
.br
|
||||
.in -1c
|
||||
.SS "Important Inherited Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "QVariant \fBdynamicCall\fR ( const QCString & function, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QVariant \fBdynamicCall\fR ( const QCString & function, TQValueList<QVariant> & vars )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "QAxObject * \fBquerySubObject\fR ( const QCString & name, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
.br
|
||||
.in -1c
|
||||
.SS "Protected Members"
|
||||
.in +1c
|
||||
.ti -1c
|
||||
.BI "virtual bool \fBcreateHostWindow\fR ( bool initialized )"
|
||||
.br
|
||||
.ti -1c
|
||||
.BI "virtual bool \fBtranslateKeyEvent\fR ( int message, int keycode ) const"
|
||||
.br
|
||||
.in -1c
|
||||
.SH DESCRIPTION
|
||||
This class is defined in the \fBQt ActiveQt Extension\fR, which can be found in the \fCqt/extensions\fR directory. It is not included in the main TQt API.
|
||||
.PP
|
||||
The QAxWidget class is a TQWidget that wraps an ActiveX control.
|
||||
.PP
|
||||
A QAxWidget can be instantiated as an empty object, with the name of the ActiveX control it should wrap, or with an existing interface pointer to the ActiveX control. The ActiveX control's properties, methods and events which only use supported data types, become available as TQt properties, slots and signals. The base class QAxBase provides an API to access the ActiveX directly through the IUnknown pointer.
|
||||
.PP
|
||||
QAxWidget is a TQWidget and can be used as such, e.g. it can be organized in a widget hierarchy, receive events or act as an event filter. Standard widget properties, e.g. enabled are supported, but it depends on the ActiveX control to implement support for ambient properties like e.g. palette or font. QAxWidget tries to provide the necessary hints.
|
||||
.PP
|
||||
\fBWarning:\fR You can subclass QAxWidget, but you cannot use the TQ_OBJECT macro in the subclass (the generated moc-file will not compile), so you cannot add further signals, slots or properties. This limitation is due to the metaobject information generated in runtime. To work around this problem, aggregate the QAxWidget as a member of the TQObject subclass.
|
||||
.PP
|
||||
.SH MEMBER FUNCTION DOCUMENTATION
|
||||
.SH "QAxWidget::QAxWidget ( TQWidget * parent = 0, const char * name = 0, WFlags f = 0 )"
|
||||
Creates an empty QAxWidget widget and propagates \fIparent\fR, \fIname\fR and \fIf\fR to the TQWidget constructor. To initialize a control, call setControl.
|
||||
.SH "QAxWidget::QAxWidget ( const TQString & c, TQWidget * parent = 0, const char * name = 0, WFlags f = 0 )"
|
||||
Creates an QAxWidget widget and initializes the ActiveX control \fIc\fR. \fIparent\fR, \fIname\fR and \fIf\fR are propagated to the TQWidget contructor.
|
||||
.PP
|
||||
See also control.
|
||||
.SH "QAxWidget::QAxWidget ( IUnknown * iface, TQWidget * parent = 0, const char * name = 0, WFlags f = 0 )"
|
||||
Creates a QAxWidget that wraps the COM object referenced by \fIiface\fR. \fIparent\fR, \fIname\fR and \fIf\fR are propagated to the TQWidget contructor.
|
||||
.SH "QAxWidget::~QAxWidget ()"
|
||||
Shuts down the ActiveX control and destroys the QAxWidget widget, cleaning up all allocated resources.
|
||||
.PP
|
||||
See also clear().
|
||||
.SH "bool QAxWidget::createHostWindow ( bool initialized )\fC [virtual protected]\fR"
|
||||
Creates the client site for the ActiveX control, and returns TRUE if the control could be embedded successfully, otherwise returns FALSE. If \fIinitialized\fR is TRUE the control has already been initialized.
|
||||
.PP
|
||||
This function is called by initialize(). If you reimplement initialize to customize the actual control instantiation, call this function in your reimplementation to have the control embedded by the default client side. Creates the client site for the ActiveX control, and returns TRUE if the control could be embedded successfully, otherwise returns FALSE.
|
||||
.SH "QVariant QAxBase::dynamicCall ( const QCString & function, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
Calls the COM object's method \fIfunction\fR, passing the parameters \fIvar1\fR, \fIvar1\fR, \fIvar2\fR, \fIvar3\fR, \fIvar4\fR, \fIvar5\fR, \fIvar6\fR, \fIvar7\fR and \fIvar8\fR, and returns the value returned by the method, or an invalid QVariant if the method does not return a value or when the function call failed.
|
||||
.PP
|
||||
If \fIfunction\fR is a method of the object the string must be provided as the full prototype, for example as it would be written in a TQObject::connect() call.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
activeX->dynamicCall( "Navigate(const TQString&)", "www.trolltech.com" );
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
Alternatively a function can be called passing the parameters embedded in the string, e.g. above function can also be invoked using
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
activeX->dynamicCall("Navigate(\\"www.trolltech.com\\");
|
||||
.br
|
||||
.fi
|
||||
All parameters are passed as strings; it depends on the control whether they are interpreted correctly, and is slower than using the prototype with correctly typed parameters.
|
||||
.PP
|
||||
If \fIfunction\fR is a property the string has to be the name of the property. The property setter is called when \fIvar1\fR is a valid QVariant, otherwise the getter is called.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
activeX->dynamicCall( "Value", 5 );
|
||||
.br
|
||||
TQString text = activeX->dynamicCall( "Text" ).toString();
|
||||
.br
|
||||
.fi
|
||||
Note that it is faster to get and set properties using TQObject::property() and TQObject::setProperty().
|
||||
.PP
|
||||
It is only possible to call functions through dynamicCall() that have parameters or return values of datatypes supported by QVariant. See the QAxBase class documentation for a list of supported and unsupported datatypes. If you want to call functions that have unsupported datatypes in the parameter list, use queryInterface() to retrieve the appropriate COM interface, and use the function directly.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
IWebBrowser2 *webBrowser = 0;
|
||||
.br
|
||||
activeX->queryInterface( IID_IWebBrowser2, (void**)&webBrowser );
|
||||
.br
|
||||
if ( webBrowser ) {
|
||||
.br
|
||||
webBrowser->Navigate2( pvarURL );
|
||||
.br
|
||||
webBrowser->Release();
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
This is also more efficient.
|
||||
.PP
|
||||
Example: qutlook/centralwidget.cpp.
|
||||
.SH "QVariant QAxBase::dynamicCall ( const QCString & function, TQValueList<QVariant> & vars )"
|
||||
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||||
.PP
|
||||
Calls the COM object's method \fIfunction\fR, passing the parameters in \fIvars\fR, and returns the value returned by the method. If the method does not return a value or when the function call failed this function returns an invalid QVariant object.
|
||||
.PP
|
||||
The QVariant objects in \fIvars\fR are updated when the method has out-parameters.
|
||||
.SH "QAxObject * QAxBase::querySubObject ( const QCString & name, const QVariant & var1 = QVariant ( ), const QVariant & var2 = QVariant ( ), const QVariant & var3 = QVariant ( ), const QVariant & var4 = QVariant ( ), const QVariant & var5 = QVariant ( ), const QVariant & var6 = QVariant ( ), const QVariant & var7 = QVariant ( ), const QVariant & var8 = QVariant ( ) )"
|
||||
Returns a pointer to a QAxObject wrapping the COM object provided by the method or property \fIname\fR, passing passing the parameters \fIvar1\fR, \fIvar1\fR, \fIvar2\fR, \fIvar3\fR, \fIvar4\fR, \fIvar5\fR, \fIvar6\fR, \fIvar7\fR and \fIvar8\fR.
|
||||
.PP
|
||||
If \fIname\fR is provided by a method the string must include the full function prototype.
|
||||
.PP
|
||||
If \fIname\fR is a property the string must be the name of the property, and \fIvar1\fR, ... \fIvar8\fR are ignored.
|
||||
.PP
|
||||
The returned QAxObject is a child of this object (which is either of type QAxObject or QAxWidget), and is deleted when this object is deleted. It is however safe to delete the returned object yourself, and you should do so when you iterate over lists of subobjects.
|
||||
.PP
|
||||
COM enabled applications usually have an object model publishing certain elements of the application as dispatch interfaces. Use this method to navigate the hierarchy of the object model, e.g.
|
||||
.PP
|
||||
.nf
|
||||
.br
|
||||
QAxWidget outlook( "Outlook.Application" );
|
||||
.br
|
||||
QAxObject *session = outlook.querySubObject( "Session" );
|
||||
.br
|
||||
if ( session ) {
|
||||
.br
|
||||
QAxObject *defFolder = session->querySubObject(
|
||||
.br
|
||||
"GetDefaultFolder(OlDefaultFolders)",
|
||||
.br
|
||||
"olFolderContacts" );
|
||||
.br
|
||||
//...
|
||||
.br
|
||||
}
|
||||
.br
|
||||
.fi
|
||||
.PP
|
||||
Example: qutlook/centralwidget.cpp.
|
||||
.SH "bool QAxWidget::translateKeyEvent ( int message, int keycode ) const\fC [virtual protected]\fR"
|
||||
Reimplement this function to pass certain key events to the ActiveX control. \fImessage\fR is the Window message identifier specifying the message type (ie. WM_KEYDOWN), and \fIkeycode\fR is the virtual keycode (ie. VK_TAB).
|
||||
.PP
|
||||
If the function returns TRUE the key event is passed on to the ActiveX control, which then either processes the event or passes the event on to Qt.
|
||||
.PP
|
||||
If the function returns FALSE the processing of the key event is ignored by ActiveQt, ie. the ActiveX control might handle it or not.
|
||||
.PP
|
||||
The default implementation returns TRUE for the following cases:
|
||||
.PP
|
||||
<center>.nf
|
||||
.TS
|
||||
l - l. WM_SYSKEYDOWN WM_SYSKEYUP WM_KEYDOWN All keycodes VK_MENU
|
||||
.TE
|
||||
.fi
|
||||
</center>
|
||||
.PP
|
||||
This table is the result of experimenting with popular ActiveX controls,
|
||||
ie. Internet Explorer and Microsoft Office applications, but for some
|
||||
controls it might require modification.
|
||||
|
||||
.SH "SEE ALSO"
|
||||
.BR http://doc.trolltech.com/qaxwidget.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 (tqaxwidget.3qt) and the Qt
|
||||
version (3.3.8).
|
||||
@ -1,6 +1,5 @@
|
||||
TEMPLATE = subdirs
|
||||
|
||||
contains( QT_PRODUCT, qt-(enterprise|internal|eval) ) {
|
||||
win32: SUBDIRS = activeqt
|
||||
x11: SUBDIRS = motif
|
||||
}
|
||||
|
||||
Loading…
Reference in new issue