summaryrefslogtreecommitdiffstats
path: root/old/doc/html/qtuitest-widgetfactory.html
diff options
context:
space:
mode:
Diffstat (limited to 'old/doc/html/qtuitest-widgetfactory.html')
-rw-r--r--old/doc/html/qtuitest-widgetfactory.html54
1 files changed, 54 insertions, 0 deletions
diff --git a/old/doc/html/qtuitest-widgetfactory.html b/old/doc/html/qtuitest-widgetfactory.html
new file mode 100644
index 0000000..dc74cad
--- /dev/null
+++ b/old/doc/html/qtuitest-widgetfactory.html
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+ PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<!-- ../../lib/qtuitestwidgetinterface.cpp -->
+<head>
+ <title>WidgetFactory Class Reference</title>
+ <link href="classic.css" rel="stylesheet" type="text/css" />
+</head>
+<body>
+<table border="0" cellpadding="0" cellspacing="0" width="100%">
+<tr>
+<td align="left" valign="top" width="32"><a href="http://qt.nokia.com/"><img src="images/qt-logo.png" align="left" border="0" /></a></td>
+<td width="1">&nbsp;&nbsp;</td><td align="right" valign="top" width="230"></td></tr></table><h1 class="title">WidgetFactory Class Reference<br /><span class="small-subtitle">(QtUiTest::WidgetFactory)<br />[QtUiTestModule]</span>
+</h1>
+<p>The WidgetFactory class provides a factory interface for <a href="qtuitest.html">QtUiTest</a> widget wrapper classes. <a href="#details">More...</a></p>
+<pre> #include &lt;<a href="qtuitest.html">QtUiTest</a>&gt;</pre><p><b>This class is under development and is subject to change.</b></p>
+<ul>
+<li><a href="qtuitest-widgetfactory-members.html">List of all members, including inherited members</a></li>
+</ul>
+<hr />
+<a name="public-functions"></a>
+<h2>Public Functions</h2>
+<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
+<tr><td class="memItemLeft" align="right" valign="top">virtual QObject * </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widgetfactory.html#create">create</a></b> ( QObject * <i>object</i> ) = 0</td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">virtual QObject * </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widgetfactory.html#find">find</a></b> ( QtUiTest::WidgetType <i>type</i> )</td></tr>
+<tr><td class="memItemLeft" align="right" valign="top">virtual QStringList </td><td class="memItemRight" valign="bottom"><b><a href="qtuitest-widgetfactory.html#keys">keys</a></b> () const = 0</td></tr>
+</table>
+<a name="details"></a>
+<hr />
+<h2>Detailed Description</h2>
+<p>The WidgetFactory class provides a factory interface for <a href="qtuitest.html">QtUiTest</a> widget wrapper classes.</p>
+<p>QtUiTest::WidgetFactory is an abstract base class which enables the creation of <a href="qtuitest.html">QtUiTest</a> wrapper objects around Qt/Qt Extended widgets.</p>
+<p>Customizing <a href="qtuitest.html">QtUiTest</a> behaviour for particular widgets is achieved by implementing one or more test widget classes which inherit from one or more <a href="qtuitest.html">QtUiTest</a> widget interfaces, subclassing QtUiTest::WidgetFactory, reimplementing the pure virtual <a href="qtuitest-widgetfactory.html#keys">keys</a>() and <a href="qtuitest-widgetfactory.html#create">create</a>() functions to create instances of the custom test widget classes, and exporting the factory class using the Q_EXPORT_PLUGIN2() macro.</p>
+<hr />
+<h2>Member Function Documentation</h2>
+<h3 class="fn"><a name="create"></a>QObject * WidgetFactory::create ( QObject * <i>object</i> )&nbsp;&nbsp;<tt> [pure virtual]</tt></h3>
+<p>Attempts to create a test widget to wrap <i>object</i>. Returns the created test widget. Returns 0 if this factory does not support wrapping <i>object</i>.</p>
+<p>The returned object is suitable for use with <a href="qtuitest.html">qtuitest_cast</a>.</p>
+<p>This function will only be called for objects which inherit one of the classes returned by <a href="qtuitest-widgetfactory.html#keys">keys</a>().</p>
+<h3 class="fn"><a name="find"></a>QObject * WidgetFactory::find ( <a href="qtuitest.html#WidgetType-enum">QtUiTest::WidgetType</a> <i>type</i> )&nbsp;&nbsp;<tt> [virtual]</tt></h3>
+<p>Returns a widget or test widget of <i>type</i>, or 0 if none can be found.</p>
+<p>Reimplement this function to provide custom behaviour for QtUiTest::findWidget(). For example, if a custom soft menu widget is being used rather than the shipped ContextLabel class, this function must be reimplemented to return a pointer to the custom widget.</p>
+<p>The base implementation always returns 0.</p>
+<h3 class="fn"><a name="keys"></a>QStringList WidgetFactory::keys () const&nbsp;&nbsp;<tt> [pure virtual]</tt></h3>
+<p>Returns the list of C++ class names this factory can generate test widgets for.</p>
+<p>Note that returning a class from this function does not guarantee that the factory will always be able to generate a test widget for that class.</p>
+<p /><address><hr /><div align="center">
+<table width="100%" cellspacing="0" border="0"><tr class="address">
+<td width="30%" align="left">Copyright &copy; 2009 Nokia Corporation and/or its subsidiary(-ies)</td>
+<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>
+<td width="30%" align="right"><div align="right">QtUiTest</div></td>
+</tr></table></div></address></body>
+</html>