You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
kshowmail/doc/html/classKFeedbackQuestionList....

340 lines
17 KiB

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>kshowmail: KFeedbackQuestionList Class Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.0 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li id="current"><a href="classes.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="dirs.html"><span>Directories</span></a></li>
</ul></div>
<div class="tabs">
<ul>
<li><a href="classes.html"><span>Alphabetical&nbsp;List</span></a></li>
<li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
<li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
</ul></div>
<h1>KFeedbackQuestionList Class Reference</h1><!-- doxytag: class="KFeedbackQuestionList" --><code>#include &lt;<a class="el" href="kfeedback_8h-source.html">kfeedback.h</a>&gt;</code>
<p>
<a href="classKFeedbackQuestionList-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Signals</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKFeedbackQuestionList.html#7eb8b8f5254845e7a559b3da1fa34ba4">checkComplete</a> ()</td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKFeedbackQuestionList.html#c666871537387a102c9f6372aa8875e8">KFeedbackQuestionList</a> (TQWidget *parent)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKFeedbackQuestionList.html#b467b667cbd906403af3222ab7a3e602">~KFeedbackQuestionList</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKFeedbackQuestionList.html#5834cfcbdf74ac1d8762c037dc492291">isComplete</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">TQString&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKFeedbackQuestionList.html#f31a9d0c7b6f06cfca9f76ccba5743f0">result</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classKFeedbackQuestion.html">KFeedbackQuestion</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKFeedbackQuestionList.html#7c043c6ca2c63fae277e7b43fcb8d145">addQuestion</a> (const TQString &amp;text, const TQString &amp;id, bool exclusiveAnswer=true, bool required=false)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKFeedbackQuestionList.html#9408bbc813e69ef33693cffa0ddd7c91">addYesNoQuestion</a> (const TQString &amp;text, const TQString &amp;id, bool required=false)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classKFeedbackQuestion.html">KFeedbackQuestion</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKFeedbackQuestionList.html#37589f00f7f3e9c544780be24e122f21">firstQuestion</a> () const</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKFeedbackQuestionList.html#9c8ed9fbb0f64a8748806f3850d2db14">questionAnswered</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classKFeedbackQuestionList.html#3a0c308081a834c24cdd576a694174dd">questionAdded</a> (<a class="el" href="classKFeedbackQuestion.html">KFeedbackQuestion</a> *question)</td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
List of feedback questions presented in a TQListView widget.
<p>
<p>
Definition at line <a class="el" href="kfeedback_8h-source.html#l00187">187</a> of file <a class="el" href="kfeedback_8h-source.html">kfeedback.h</a>.<hr><h2>Constructor &amp; Destructor Documentation</h2>
<a class="anchor" name="c666871537387a102c9f6372aa8875e8"></a><!-- doxytag: member="KFeedbackQuestionList::KFeedbackQuestionList" ref="c666871537387a102c9f6372aa8875e8" args="(TQWidget *parent)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KFeedbackQuestionList::KFeedbackQuestionList </td>
<td>(</td>
<td class="paramtype">TQWidget *&nbsp;</td>
<td class="paramname"> <em>parent</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Constructor.
<p>
Definition at line <a class="el" href="kfeedback_8cpp-source.html#l00239">239</a> of file <a class="el" href="kfeedback_8cpp-source.html">kfeedback.cpp</a>.
</div>
</div><p>
<a class="anchor" name="b467b667cbd906403af3222ab7a3e602"></a><!-- doxytag: member="KFeedbackQuestionList::~KFeedbackQuestionList" ref="b467b667cbd906403af3222ab7a3e602" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KFeedbackQuestionList::~KFeedbackQuestionList </td>
<td>(</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Destructor.
<p>
Definition at line <a class="el" href="kfeedback_8cpp-source.html#l00247">247</a> of file <a class="el" href="kfeedback_8cpp-source.html">kfeedback.cpp</a>.
</div>
</div><p>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="5834cfcbdf74ac1d8762c037dc492291"></a><!-- doxytag: member="KFeedbackQuestionList::isComplete" ref="5834cfcbdf74ac1d8762c037dc492291" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KFeedbackQuestionList::isComplete </td>
<td>(</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns whether or not this question list is answered satisfactorily, i.e. if all questions marked as "required" are answered.
<p>
Definition at line <a class="el" href="kfeedback_8cpp-source.html#l00254">254</a> of file <a class="el" href="kfeedback_8cpp-source.html">kfeedback.cpp</a>.
<p>
References <a class="el" href="kfeedback_8h-source.html#l00247">firstQuestion()</a>, <a class="el" href="kfeedback_8cpp-source.html#l00368">KFeedbackQuestion::isAnswered()</a>, <a class="el" href="kfeedback_8h-source.html#l00319">KFeedbackQuestion::isRequired()</a>, and <a class="el" href="kfeedback_8h-source.html#l00362">KFeedbackQuestion::nextQuestion()</a>.
<p>
Referenced by <a class="el" href="kfeedback_8cpp-source.html#l00229">KFeedbackForm::readyToSend()</a>.
</div>
</div><p>
<a class="anchor" name="f31a9d0c7b6f06cfca9f76ccba5743f0"></a><!-- doxytag: member="KFeedbackQuestionList::result" ref="f31a9d0c7b6f06cfca9f76ccba5743f0" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">TQString KFeedbackQuestionList::result </td>
<td>(</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The result of all answered questions in ASCII.
<p>
Definition at line <a class="el" href="kfeedback_8cpp-source.html#l00270">270</a> of file <a class="el" href="kfeedback_8cpp-source.html">kfeedback.cpp</a>.
<p>
References <a class="el" href="kfeedback_8h-source.html#l00247">firstQuestion()</a>, <a class="el" href="kfeedback_8h-source.html#l00362">KFeedbackQuestion::nextQuestion()</a>, and <a class="el" href="kfeedback_8cpp-source.html#l00402">KFeedbackQuestion::result()</a>.
<p>
Referenced by <a class="el" href="kfeedback_8cpp-source.html#l00153">KFeedbackForm::sendMail()</a>.
</div>
</div><p>
<a class="anchor" name="7c043c6ca2c63fae277e7b43fcb8d145"></a><!-- doxytag: member="KFeedbackQuestionList::addQuestion" ref="7c043c6ca2c63fae277e7b43fcb8d145" args="(const TQString &amp;text, const TQString &amp;id, bool exclusiveAnswer=true, bool required=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classKFeedbackQuestion.html">KFeedbackQuestion</a> * KFeedbackQuestionList::addQuestion </td>
<td>(</td>
<td class="paramtype">const TQString &amp;&nbsp;</td>
<td class="paramname"> <em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const TQString &amp;&nbsp;</td>
<td class="paramname"> <em>id</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool&nbsp;</td>
<td class="paramname"> <em>exclusiveAnswer</em> = <code>true</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool&nbsp;</td>
<td class="paramname"> <em>required</em> = <code>false</code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Add a yes/no question to the list.<p>
'text' is the text the user will see (in his native language).<p>
'id' is what will be sent with the feedback mail, thus it should be unique within the application, yet human readable (preferably English) and not contain any weird characters that might confuse scripts that are later used to automatically parse those mails. Examples: "would_recommend_to_a_friend"<p>
Set 'required' to 'true' if answering this question is required to successfully complete this form.<p>
Returns a pointer to this question so you can add answers.
<p>
Definition at line <a class="el" href="kfeedback_8cpp-source.html#l00288">288</a> of file <a class="el" href="kfeedback_8cpp-source.html">kfeedback.cpp</a>.
<p>
Referenced by <a class="el" href="kshowmailfeedback_8cpp-source.html#l00023">KShowMailApp::slotSendFeedbackMail()</a>.
</div>
</div><p>
<a class="anchor" name="9408bbc813e69ef33693cffa0ddd7c91"></a><!-- doxytag: member="KFeedbackQuestionList::addYesNoQuestion" ref="9408bbc813e69ef33693cffa0ddd7c91" args="(const TQString &amp;text, const TQString &amp;id, bool required=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KFeedbackQuestionList::addYesNoQuestion </td>
<td>(</td>
<td class="paramtype">const TQString &amp;&nbsp;</td>
<td class="paramname"> <em>text</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const TQString &amp;&nbsp;</td>
<td class="paramname"> <em>id</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool&nbsp;</td>
<td class="paramname"> <em>required</em> = <code>false</code></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Add a yes/no question to the list.
<p>
Definition at line <a class="el" href="kfeedback_8cpp-source.html#l00303">303</a> of file <a class="el" href="kfeedback_8cpp-source.html">kfeedback.cpp</a>.
<p>
References <a class="el" href="kfeedback_8cpp-source.html#l00360">KFeedbackQuestion::addAnswer()</a>.
<p>
Referenced by <a class="el" href="kshowmailfeedback_8cpp-source.html#l00023">KShowMailApp::slotSendFeedbackMail()</a>.
</div>
</div><p>
<a class="anchor" name="37589f00f7f3e9c544780be24e122f21"></a><!-- doxytag: member="KFeedbackQuestionList::firstQuestion" ref="37589f00f7f3e9c544780be24e122f21" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classKFeedbackQuestion.html">KFeedbackQuestion</a>* KFeedbackQuestionList::firstQuestion </td>
<td>(</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns the first question of that list. Use KFeedbackQuestion::next() to get the next one.
<p>
Definition at line <a class="el" href="kfeedback_8h-source.html#l00247">247</a> of file <a class="el" href="kfeedback_8h-source.html">kfeedback.h</a>.
<p>
Referenced by <a class="el" href="kfeedback_8cpp-source.html#l00254">isComplete()</a>, and <a class="el" href="kfeedback_8cpp-source.html#l00270">result()</a>.
</div>
</div><p>
<a class="anchor" name="9c8ed9fbb0f64a8748806f3850d2db14"></a><!-- doxytag: member="KFeedbackQuestionList::questionAnswered" ref="9c8ed9fbb0f64a8748806f3850d2db14" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KFeedbackQuestionList::questionAnswered </td>
<td>(</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Notify the list that another question has been answered. Emits the <a class="el" href="classKFeedbackQuestionList.html#7eb8b8f5254845e7a559b3da1fa34ba4">checkComplete()</a> signal when all required questions are answered.
<p>
Definition at line <a class="el" href="kfeedback_8cpp-source.html#l00318">318</a> of file <a class="el" href="kfeedback_8cpp-source.html">kfeedback.cpp</a>.
<p>
Referenced by <a class="el" href="kfeedback_8cpp-source.html#l00491">KFeedbackAnswer::stateChange()</a>.
</div>
</div><p>
<a class="anchor" name="3a0c308081a834c24cdd576a694174dd"></a><!-- doxytag: member="KFeedbackQuestionList::questionAdded" ref="3a0c308081a834c24cdd576a694174dd" args="(KFeedbackQuestion *question)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KFeedbackQuestionList::questionAdded </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classKFeedbackQuestion.html">KFeedbackQuestion</a> *&nbsp;</td>
<td class="paramname"> <em>question</em> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Notify the list that another question has been added. Emits the <a class="el" href="classKFeedbackQuestionList.html#7eb8b8f5254845e7a559b3da1fa34ba4">checkComplete()</a> signal when a required question is added.
<p>
Definition at line <a class="el" href="kfeedback_8cpp-source.html#l00324">324</a> of file <a class="el" href="kfeedback_8cpp-source.html">kfeedback.cpp</a>.
<p>
References <a class="el" href="kfeedback_8h-source.html#l00319">KFeedbackQuestion::isRequired()</a>.
<p>
Referenced by <a class="el" href="kfeedback_8cpp-source.html#l00336">KFeedbackQuestion::KFeedbackQuestion()</a>.
</div>
</div><p>
<a class="anchor" name="7eb8b8f5254845e7a559b3da1fa34ba4"></a><!-- doxytag: member="KFeedbackQuestionList::checkComplete" ref="7eb8b8f5254845e7a559b3da1fa34ba4" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KFeedbackQuestionList::checkComplete </td>
<td>(</td>
<td class="paramname"> </td>
<td>&nbsp;)&nbsp;</td>
<td width="100%"><code> [signal]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Emitted when all required questions are answered.
<p>
Referenced by <a class="el" href="kfeedback_8cpp-source.html#l00324">questionAdded()</a>, and <a class="el" href="kfeedback_8cpp-source.html#l00318">questionAnswered()</a>.
</div>
</div><p>
<hr>The documentation for this class was generated from the following files:<ul>
<li>kshowmail/<a class="el" href="kfeedback_8h-source.html">kfeedback.h</a><li>kshowmail/<a class="el" href="kfeedback_8cpp-source.html">kfeedback.cpp</a></ul>
<hr size="1"><address style="align: right;"><small>Generated on Thu Jul 5 19:36:09 2007 for kshowmail by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.0 </small></address>
</body>
</html>