<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>AlbumShaper: FilePreview Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.6.2 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>FilePreview Class Reference</h1><!-- doxytag: class="FilePreview" --><!-- doxytag: inherits="QWidget,QFilePreview" -->
<p><code>#include <<a class="el" href="addPhotosDialog_8h_source.html">addPhotosDialog.h</a>></code></p>
<div class="dynheader">
Inheritance diagram for FilePreview:</div>
<div class="dynsection">
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<div class="dynheader">
Collaboration diagram for FilePreview:</div>
<div class="dynsection">
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classFilePreview-members.html">List of all members.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilePreview.html#adbc18ed317e28adeed02779527168d9f">FilePreview</a> (<a class="el" href="classQWidget.html">QWidget</a> *parent=0)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilePreview.html#a92c81c8fe975be2d2b385274b13414ea">~FilePreview</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">QSize </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilePreview.html#ab007946217dd7efc63b0e2ffdc88ecc9">minimumSizeHint</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilePreview.html#a284b8e2753fea14cbd6c9f037082c72c">previewUrl</a> (const QUrl &)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">declared to make base class happy. we'll use an updatePreview function instead <a href="#a284b8e2753fea14cbd6c9f037082c72c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilePreview.html#adeef143a0e947ab5a45835e1a3062602">updatePreview</a> (const QString &path)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">call this function to update the file preview <a href="#adeef143a0e947ab5a45835e1a3062602"></a><br/></td></tr>
<tr><td colspan="2"><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilePreview.html#a4011d44115502e66f28e1b9b5d866ca2">customEvent</a> (<a class="el" href="classQCustomEvent.html">QCustomEvent</a> *e)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">handle update events that come from the <a class="el" href="classGeneratePreviewThread.html">GeneratePreviewThread</a> <a href="#a4011d44115502e66f28e1b9b5d866ca2"></a><br/></td></tr>
<tr><td colspan="2"><h2>Private Attributes</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classQLabel.html">QLabel</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilePreview.html#a93c12f19e09638dd16f4df9acc5a93ef">filePreview</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">preview of last selected file <a href="#a93c12f19e09638dd16f4df9acc5a93ef"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classQLabel.html">QLabel</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilePreview.html#a88cefa8ce11426e930e473142d940ad1">fileDetails</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">details about last selected file <a href="#a88cefa8ce11426e930e473142d940ad1"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGeneratePreviewThread.html">GeneratePreviewThread</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilePreview.html#abc98931b02f0a31e2cb17bf3da3e3e07">generatorThread</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">a worker thread that actually generates the file preview image and details information that is displayed. <a href="#abc98931b02f0a31e2cb17bf3da3e3e07"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Definition at line <a class="el" href="addPhotosDialog_8h_source.html#l00055">55</a> of file <a class="el" href="addPhotosDialog_8h_source.html">addPhotosDialog.h</a>.</p>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="adbc18ed317e28adeed02779527168d9f"></a><!-- doxytag: member="FilePreview::FilePreview" ref="adbc18ed317e28adeed02779527168d9f" args="(QWidget *parent=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">FilePreview::FilePreview </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classQWidget.html">QWidget</a> * </td>
<td class="paramname"> <em>parent</em> = <code>0</code></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Definition at line <a class="el" href="addPhotosDialog_8cpp_source.html#l00173">173</a> of file <a class="el" href="addPhotosDialog_8cpp_source.html">addPhotosDialog.cpp</a>.</p>
<p>References <a class="el" href="addPhotosDialog_8h_source.html#l00077">fileDetails</a>, <a class="el" href="addPhotosDialog_8h_source.html#l00074">filePreview</a>, and <a class="el" href="addPhotosDialog_8h_source.html#l00082">generatorThread</a>.</p>
<p><div class="fragment"><pre class="fragment"><a name="l00173"></a>00173 : <a class="code" href="classQWidget.html">QWidget</a>(parent)
<a name="l00174"></a>00174 {
<a name="l00175"></a>00175 <span class="comment">//create widgets for display preview image and details</span>
<a name="l00176"></a>00176 <a class="code" href="classFilePreview.html#a93c12f19e09638dd16f4df9acc5a93ef" title="preview of last selected file">filePreview</a> = <span class="keyword">new</span> <a class="code" href="classQLabel.html">QLabel</a>( <span class="keyword">this</span> );
<a name="l00177"></a>00177 <a class="code" href="classFilePreview.html#a88cefa8ce11426e930e473142d940ad1" title="details about last selected file">fileDetails</a> = <span class="keyword">new</span> <a class="code" href="classQLabel.html">QLabel</a>( <span class="keyword">this</span> );
<a name="l00178"></a>00178
<a name="l00179"></a>00179 QGridLayout* grid = <span class="keyword">new</span> QGridLayout( <span class="keyword">this</span>, 4, 3 );
<a name="l00180"></a>00180 grid->setRowStretch( 0, 1 );
<a name="l00181"></a>00181 grid->addWidget( <a class="code" href="classFilePreview.html#a93c12f19e09638dd16f4df9acc5a93ef" title="preview of last selected file">filePreview</a>, 1, 1, Qt::AlignHCenter );
<a name="l00182"></a>00182 grid->addWidget( <a class="code" href="classFilePreview.html#a88cefa8ce11426e930e473142d940ad1" title="details about last selected file">fileDetails</a>, 2, 1, Qt::AlignHCenter );
<a name="l00183"></a>00183 grid->setRowStretch( 3, 1 );
<a name="l00184"></a>00184
<a name="l00185"></a>00185 grid->setColStretch( 0, 1 );
<a name="l00186"></a>00186 grid->setColStretch( 2, 1 );
<a name="l00187"></a>00187
<a name="l00188"></a>00188 <span class="comment">//create a generator thread that will be used for actually generating </span>
<a name="l00189"></a>00189 <span class="comment">//preview images and constructing details strings</span>
<a name="l00190"></a>00190 <a class="code" href="classFilePreview.html#abc98931b02f0a31e2cb17bf3da3e3e07" title="a worker thread that actually generates the file preview image and details information...">generatorThread</a> = <span class="keyword">new</span> <a class="code" href="classGeneratePreviewThread.html">GeneratePreviewThread</a>(<span class="keyword">this</span>);
<a name="l00191"></a>00191 }
</pre></div></p>
</div>
</div>
<a class="anchor" id="a92c81c8fe975be2d2b385274b13414ea"></a><!-- doxytag: member="FilePreview::~FilePreview" ref="a92c81c8fe975be2d2b385274b13414ea" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">FilePreview::~FilePreview </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Definition at line <a class="el" href="addPhotosDialog_8cpp_source.html#l00193">193</a> of file <a class="el" href="addPhotosDialog_8cpp_source.html">addPhotosDialog.cpp</a>.</p>
<p>References <a class="el" href="addPhotosDialog_8h_source.html#l00082">generatorThread</a>.</p>
<p><div class="fragment"><pre class="fragment"><a name="l00194"></a>00194 {
<a name="l00195"></a>00195 <span class="comment">//make sure generator thread is done!</span>
<a name="l00196"></a>00196 <a class="code" href="classFilePreview.html#abc98931b02f0a31e2cb17bf3da3e3e07" title="a worker thread that actually generates the file preview image and details information...">generatorThread</a>->wait();
<a name="l00197"></a>00197 <span class="keyword">delete</span> <a class="code" href="classFilePreview.html#abc98931b02f0a31e2cb17bf3da3e3e07" title="a worker thread that actually generates the file preview image and details information...">generatorThread</a>;
<a name="l00198"></a>00198 <a class="code" href="classFilePreview.html#abc98931b02f0a31e2cb17bf3da3e3e07" title="a worker thread that actually generates the file preview image and details information...">generatorThread</a> = NULL;
<a name="l00199"></a>00199 }
</pre></div></p>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a4011d44115502e66f28e1b9b5d866ca2"></a><!-- doxytag: member="FilePreview::customEvent" ref="a4011d44115502e66f28e1b9b5d866ca2" args="(QCustomEvent *e)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void FilePreview::customEvent </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classQCustomEvent.html">QCustomEvent</a> * </td>
<td class="paramname"> <em>e</em></td>
<td> ) </td>
<td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>handle update events that come from the <a class="el" href="classGeneratePreviewThread.html">GeneratePreviewThread</a> </p>
<p>Definition at line <a class="el" href="addPhotosDialog_8cpp_source.html#l00207">207</a> of file <a class="el" href="addPhotosDialog_8cpp_source.html">addPhotosDialog.cpp</a>.</p>
<p>References <a class="el" href="addPhotosDialog_8h_source.html#l00077">fileDetails</a>, <a class="el" href="addPhotosDialog_8h_source.html#l00074">filePreview</a>, <a class="el" href="addPhotosDialog_8cpp_source.html#l00053">UpdatePreviewEvent::getDetails()</a>, <a class="el" href="addPhotosDialog_8cpp_source.html#l00050">UpdatePreviewEvent::getImage()</a>, and <a class="el" href="addPhotosDialog_8cpp_source.html#l00033">UPDATE_PREVIEW_DETAILS</a>.</p>
<p><div class="fragment"><pre class="fragment"><a name="l00208"></a>00208 {
<a name="l00209"></a>00209 <span class="comment">//handle UpdatePrevewEvents that are sent from the worker thread</span>
<a name="l00210"></a>00210 <span class="comment">//by update the preview image and details that are shown</span>
<a name="l00211"></a>00211 <span class="keywordflow">if</span> ( e->type() == <a class="code" href="addPhotosDialog_8cpp.html#a52b0ff50913ad7c63e38a078a3e72a86">UPDATE_PREVIEW_DETAILS</a> )
<a name="l00212"></a>00212 {
<a name="l00213"></a>00213 <a class="code" href="classUpdatePreviewEvent.html">UpdatePreviewEvent</a>* upe = (<a class="code" href="classUpdatePreviewEvent.html">UpdatePreviewEvent</a>*)e;
<a name="l00214"></a>00214
<a name="l00215"></a>00215 <span class="keywordflow">if</span>( !upe-><a class="code" href="classUpdatePreviewEvent.html#a4daef240d90dff70d9a0d2b999e5bd66">getImage</a>().isNull() )
<a name="l00216"></a>00216 {
<a name="l00217"></a>00217 QPixmap scaledPixmap;
<a name="l00218"></a>00218 scaledPixmap.convertFromImage( upe-><a class="code" href="classUpdatePreviewEvent.html#a4daef240d90dff70d9a0d2b999e5bd66">getImage</a>() );
<a name="l00219"></a>00219 <a class="code" href="classFilePreview.html#a93c12f19e09638dd16f4df9acc5a93ef" title="preview of last selected file">filePreview</a>->setPixmap( scaledPixmap );
<a name="l00220"></a>00220 }
<a name="l00221"></a>00221
<a name="l00222"></a>00222 <a class="code" href="classFilePreview.html#a88cefa8ce11426e930e473142d940ad1" title="details about last selected file">fileDetails</a>->setText( upe-><a class="code" href="classUpdatePreviewEvent.html#a54909fc8f3acf59b1c7bc855559b7a6e">getDetails</a>() );
<a name="l00223"></a>00223 }
<a name="l00224"></a>00224 }
</pre></div></p>
</div>
</div>
<a class="anchor" id="ab007946217dd7efc63b0e2ffdc88ecc9"></a><!-- doxytag: member="FilePreview::minimumSizeHint" ref="ab007946217dd7efc63b0e2ffdc88ecc9" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">QSize FilePreview::minimumSizeHint </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Definition at line <a class="el" href="addPhotosDialog_8cpp_source.html#l00201">201</a> of file <a class="el" href="addPhotosDialog_8cpp_source.html">addPhotosDialog.cpp</a>.</p>
<p>References <a class="el" href="addPhotosDialog_8cpp_source.html#l00031">MIN_HEIGHT</a>, and <a class="el" href="addPhotosDialog_8cpp_source.html#l00030">MIN_WIDTH</a>.</p>
<p><div class="fragment"><pre class="fragment"><a name="l00202"></a>00202 {
<a name="l00203"></a>00203 QFontMetrics fm( font() );
<a name="l00204"></a>00204 <span class="keywordflow">return</span> QSize(<a class="code" href="addPhotosDialog_8cpp.html#ad3ee0cc681d736cb6d41c4ebb04c0ae4">MIN_WIDTH</a>, <a class="code" href="addPhotosDialog_8cpp.html#a1610a21b358c3531db64b3208fa70e5b">MIN_HEIGHT</a> + 2*fm.height() );
<a name="l00205"></a>00205 }
</pre></div></p>
</div>
</div>
<a class="anchor" id="a284b8e2753fea14cbd6c9f037082c72c"></a><!-- doxytag: member="FilePreview::previewUrl" ref="a284b8e2753fea14cbd6c9f037082c72c" args="(const QUrl &)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void FilePreview::previewUrl </td>
<td>(</td>
<td class="paramtype">const QUrl & </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>declared to make base class happy. we'll use an updatePreview function instead </p>
<p>Definition at line <a class="el" href="addPhotosDialog_8h_source.html#l00063">63</a> of file <a class="el" href="addPhotosDialog_8h_source.html">addPhotosDialog.h</a>.</p>
<p><div class="fragment"><pre class="fragment"><a name="l00063"></a>00063 {}
</pre></div></p>
</div>
</div>
<a class="anchor" id="adeef143a0e947ab5a45835e1a3062602"></a><!-- doxytag: member="FilePreview::updatePreview" ref="adeef143a0e947ab5a45835e1a3062602" args="(const QString &path)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void FilePreview::updatePreview </td>
<td>(</td>
<td class="paramtype">const QString & </td>
<td class="paramname"> <em>path</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>call this function to update the file preview </p>
<p>Definition at line <a class="el" href="addPhotosDialog_8cpp_source.html#l00226">226</a> of file <a class="el" href="addPhotosDialog_8cpp_source.html">addPhotosDialog.cpp</a>.</p>
<p>References <a class="el" href="addPhotosDialog_8h_source.html#l00082">generatorThread</a>, and <a class="el" href="addPhotosDialog_8cpp_source.html#l00072">GeneratePreviewThread::start()</a>.</p>
<p>Referenced by <a class="el" href="addPhotosDialog_8cpp_source.html#l00275">AddPhotosDialog::updatePreview()</a>.</p>
<p><div class="fragment"><pre class="fragment"><a name="l00227"></a>00227 {
<a name="l00228"></a>00228 <span class="comment">//handle requests to update the preview information by asking</span>
<a name="l00229"></a>00229 <span class="comment">//the generator thread to handle them. by using</span>
<a name="l00230"></a>00230 <span class="comment">//an auxiallary thread we can process requests very quickly while</span>
<a name="l00231"></a>00231 <span class="comment">//any current work being done to generate an image preview continues</span>
<a name="l00232"></a>00232 <span class="keywordflow">if</span>( <a class="code" href="classFilePreview.html#abc98931b02f0a31e2cb17bf3da3e3e07" title="a worker thread that actually generates the file preview image and details information...">generatorThread</a> != NULL)
<a name="l00233"></a>00233 {
<a name="l00234"></a>00234 <a class="code" href="classFilePreview.html#abc98931b02f0a31e2cb17bf3da3e3e07" title="a worker thread that actually generates the file preview image and details information...">generatorThread</a>-><a class="code" href="classGeneratePreviewThread.html#a29affa3f16c4b04522de227d68ac2450">start</a>( filename );
<a name="l00235"></a>00235 }
<a name="l00236"></a>00236 }
</pre></div></p>
</div>
</div>
<hr/><h2>Member Data Documentation</h2>
<a class="anchor" id="a88cefa8ce11426e930e473142d940ad1"></a><!-- doxytag: member="FilePreview::fileDetails" ref="a88cefa8ce11426e930e473142d940ad1" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classQLabel.html">QLabel</a>* <a class="el" href="classFilePreview.html#a88cefa8ce11426e930e473142d940ad1">FilePreview::fileDetails</a><code> [private]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>details about last selected file </p>
<p>Definition at line <a class="el" href="addPhotosDialog_8h_source.html#l00077">77</a> of file <a class="el" href="addPhotosDialog_8h_source.html">addPhotosDialog.h</a>.</p>
<p>Referenced by <a class="el" href="addPhotosDialog_8cpp_source.html#l00207">customEvent()</a>, and <a class="el" href="addPhotosDialog_8cpp_source.html#l00173">FilePreview()</a>.</p>
</div>
</div>
<a class="anchor" id="a93c12f19e09638dd16f4df9acc5a93ef"></a><!-- doxytag: member="FilePreview::filePreview" ref="a93c12f19e09638dd16f4df9acc5a93ef" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classQLabel.html">QLabel</a>* <a class="el" href="classFilePreview.html#a93c12f19e09638dd16f4df9acc5a93ef">FilePreview::filePreview</a><code> [private]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>preview of last selected file </p>
<p>Definition at line <a class="el" href="addPhotosDialog_8h_source.html#l00074">74</a> of file <a class="el" href="addPhotosDialog_8h_source.html">addPhotosDialog.h</a>.</p>
<p>Referenced by <a class="el" href="addPhotosDialog_8cpp_source.html#l00207">customEvent()</a>, and <a class="el" href="addPhotosDialog_8cpp_source.html#l00173">FilePreview()</a>.</p>
</div>
</div>
<a class="anchor" id="abc98931b02f0a31e2cb17bf3da3e3e07"></a><!-- doxytag: member="FilePreview::generatorThread" ref="abc98931b02f0a31e2cb17bf3da3e3e07" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGeneratePreviewThread.html">GeneratePreviewThread</a>* <a class="el" href="classFilePreview.html#abc98931b02f0a31e2cb17bf3da3e3e07">FilePreview::generatorThread</a><code> [private]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>a worker thread that actually generates the file preview image and details information that is displayed. </p>
<p>Definition at line <a class="el" href="addPhotosDialog_8h_source.html#l00082">82</a> of file <a class="el" href="addPhotosDialog_8h_source.html">addPhotosDialog.h</a>.</p>
<p>Referenced by <a class="el" href="addPhotosDialog_8cpp_source.html#l00173">FilePreview()</a>, <a class="el" href="addPhotosDialog_8cpp_source.html#l00226">updatePreview()</a>, and <a class="el" href="addPhotosDialog_8cpp_source.html#l00193">~FilePreview()</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="addPhotosDialog_8h_source.html">addPhotosDialog.h</a></li>
<li><a class="el" href="addPhotosDialog_8cpp_source.html">addPhotosDialog.cpp</a></li>
</ul>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.2 </small></address>
</body>
</html>
