<html> <head> <link rel="stylesheet" href="page.css" type="text/css"> <title>fox-toolkit.org - Documentation</title> </head> <body bgcolor=#ffffff link=#990033 vlink=#990033 alink=#990033 text=#000000> <font face='verdana,sans-serif' size=2 > <!---- TOPIC TITLE WITH LOGO---> <table border=0 cellpadding= cellspacing=2 width=100% ><tr><td><a href='http://www.fox-toolkit.org/doc.html'><img src='../art/foxlogo_small.jpg' border=0></a></td><td width=100% valign=bottom><font face='verdana,sans-serif' size=2 ><b> <a class="qindex" href="index.html">Main Page</a> <a class="qindex" href="hierarchy.html">Class Hierarchy</a> <a class="qindex" href="classes.html">Alphabetical List</a> <a class="qindex" href="annotated.html">Compound List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a> <br><img src='../art/line.gif' width=100% height=1></b></font></td></tr></table> <p> <!--- TOPIC TITLE WITH LOGO ---> <!-- Generated by Doxygen 1.3.3 --> <h1>FX::FXRecentFiles Class Reference</h1>The recent files object manages a most recently used (MRU) file list by means of the standard system registry. <a href="#_details">More...</a> <p> <code>#include <<a class="el" href="FXRecentFiles_8h-source.html">FXRecentFiles.h</a>></code> <p> <p>Inheritance diagram for FX::FXRecentFiles: <p><center><img src="classFX_1_1FXRecentFiles.png" usemap="#FX::FXRecentFiles_map" border="0" alt=""></center> <map name="FX::FXRecentFiles_map"> <area href="classFX_1_1FXObject.html" alt="FX::FXObject" shape="rect" coords="0,0,118,24"> </map> <a href="classFX_1_1FXRecentFiles-members.html">List of all members.</a><table border=0 cellpadding=0 cellspacing=0> <tr><td></td></tr> <tr><td colspan=2><br><h2>Public Types</h2></td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>enum </td><td class="memItemRight" valign=bottom>{ <br> <b>ID_CLEAR</b>, <br> <b>ID_ANYFILES</b>, <br> <b>ID_FILE_1</b>, <br> <b>ID_FILE_2</b>, <br> <b>ID_FILE_3</b>, <br> <b>ID_FILE_4</b>, <br> <b>ID_FILE_5</b>, <br> <b>ID_FILE_6</b>, <br> <b>ID_FILE_7</b>, <br> <b>ID_FILE_8</b>, <br> <b>ID_FILE_9</b>, <br> <b>ID_FILE_10</b> <br> }</td></tr> <tr><td colspan=2><br><h2>Public Member Functions</h2></td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top> </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a0">FXRecentFiles</a> ()</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top> </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a1">FXRecentFiles</a> (const <a class="el" href="classFX_1_1FXString.html">FXString</a> &gp, <a class="el" href="classFX_1_1FXObject.html">FXObject</a> *tgt=NULL, FXSelector sel=0)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>void </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a2">setMaxFiles</a> (FXint mx)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>FXint </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a3">getMaxFiles</a> () const</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>void </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a4">setGroupName</a> (const <a class="el" href="classFX_1_1FXString.html">FXString</a> &name)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="classFX_1_1FXString.html">FXString</a> </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a5">getGroupName</a> () const</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>void </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a6">setTarget</a> (<a class="el" href="classFX_1_1FXObject.html">FXObject</a> *t)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="classFX_1_1FXObject.html">FXObject</a> * </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a7">getTarget</a> () const</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>void </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a8">setSelector</a> (FXSelector sel)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>FXSelector </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a9">getSelector</a> () const</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top><a class="el" href="classFX_1_1FXString.html">FXString</a> </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a10">getFile</a> (FXint index) const</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>void </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a11">setFile</a> (FXint index, const <a class="el" href="classFX_1_1FXString.html">FXString</a> &filename)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>void </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a12">appendFile</a> (const <a class="el" href="classFX_1_1FXString.html">FXString</a> &filename)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>void </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a13">removeFile</a> (const <a class="el" href="classFX_1_1FXString.html">FXString</a> &filename)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>void </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a14">clear</a> ()</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>virtual void </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a15">save</a> (<a class="el" href="classFX_1_1FXStream.html">FXStream</a> &store) const</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>virtual void </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a16">load</a> (<a class="el" href="classFX_1_1FXStream.html">FXStream</a> &store)</td></tr> <tr><td class="memItemLeft" nowrap align=right valign=top>virtual </td><td class="memItemRight" valign=bottom><a class="el" href="classFX_1_1FXRecentFiles.html#a17">~FXRecentFiles</a> ()</td></tr> </table> <hr><a name="_details"></a><h2>Detailed Description</h2> The recent files object manages a most recently used (MRU) file list by means of the standard system registry. <p> When connected to a widget, like a menu command, the recent files object updates the menu commands label to the associated recent file name; when the menu command is invoked, the recent file object sends its target a SEL_COMMAND message with the message data set to the associated file name, of the type const char*. When adding or removing file names, the recent files object automatically updates the system registry to record these changes. <p> <hr><h2>Constructor & Destructor Documentation</h2> <a name="a0" doxytag="FX::FXRecentFiles::FXRecentFiles"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> FX::FXRecentFiles::FXRecentFiles </td> <td class="md" valign="top">( </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Make new Recent Files Group with default groupname. <p> </td> </tr> </table> <a name="a1" doxytag="FX::FXRecentFiles::FXRecentFiles"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> FX::FXRecentFiles::FXRecentFiles </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">const <a class="el" href="classFX_1_1FXString.html">FXString</a> & </td> <td class="mdname" nowrap> <em>gp</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap><a class="el" href="classFX_1_1FXObject.html">FXObject</a> * </td> <td class="mdname" nowrap> <em>tgt</em> = NULL, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>FXSelector </td> <td class="mdname" nowrap> <em>sel</em> = 0</td> </tr> <tr> <td></td> <td class="md">) </td> <td class="md" colspan="2"></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Make new Recent Files Group with groupname gp. <p> </td> </tr> </table> <a name="a17" doxytag="FX::FXRecentFiles::~FXRecentFiles"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> virtual FX::FXRecentFiles::~<a class="el" href="classFX_1_1FXRecentFiles.html">FXRecentFiles</a> </td> <td class="md" valign="top">( </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap><code> [virtual]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Destructor. <p> </td> </tr> </table> <hr><h2>Member Function Documentation</h2> <a name="a2" doxytag="FX::FXRecentFiles::setMaxFiles"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> void FX::FXRecentFiles::setMaxFiles </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">FXint </td> <td class="mdname1" valign="top" nowrap> <em>mx</em> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap><code> [inline]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Change number of files we're tracking. <p> </td> </tr> </table> <a name="a3" doxytag="FX::FXRecentFiles::getMaxFiles"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> FXint FX::FXRecentFiles::getMaxFiles </td> <td class="md" valign="top">( </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> const<code> [inline]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Return the maximum number of files being tracked. <p> </td> </tr> </table> <a name="a4" doxytag="FX::FXRecentFiles::setGroupName"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> void FX::FXRecentFiles::setGroupName </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">const <a class="el" href="classFX_1_1FXString.html">FXString</a> & </td> <td class="mdname1" valign="top" nowrap> <em>name</em> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap><code> [inline]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Set group name. <p> </td> </tr> </table> <a name="a5" doxytag="FX::FXRecentFiles::getGroupName"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> <a class="el" href="classFX_1_1FXString.html">FXString</a> FX::FXRecentFiles::getGroupName </td> <td class="md" valign="top">( </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> const<code> [inline]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Return group name. <p> </td> </tr> </table> <a name="a6" doxytag="FX::FXRecentFiles::setTarget"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> void FX::FXRecentFiles::setTarget </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top"><a class="el" href="classFX_1_1FXObject.html">FXObject</a> * </td> <td class="mdname1" valign="top" nowrap> <em>t</em> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap><code> [inline]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Change the target. <p> </td> </tr> </table> <a name="a7" doxytag="FX::FXRecentFiles::getTarget"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> <a class="el" href="classFX_1_1FXObject.html">FXObject</a>* FX::FXRecentFiles::getTarget </td> <td class="md" valign="top">( </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> const<code> [inline]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Get the target. <p> </td> </tr> </table> <a name="a8" doxytag="FX::FXRecentFiles::setSelector"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> void FX::FXRecentFiles::setSelector </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">FXSelector </td> <td class="mdname1" valign="top" nowrap> <em>sel</em> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap><code> [inline]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Change the message. <p> </td> </tr> </table> <a name="a9" doxytag="FX::FXRecentFiles::getSelector"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> FXSelector FX::FXRecentFiles::getSelector </td> <td class="md" valign="top">( </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> const<code> [inline]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Return the message id. <p> </td> </tr> </table> <a name="a10" doxytag="FX::FXRecentFiles::getFile"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> <a class="el" href="classFX_1_1FXString.html">FXString</a> FX::FXRecentFiles::getFile </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">FXint </td> <td class="mdname1" valign="top" nowrap> <em>index</em> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> const</td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Obtain the filename at index. <p> </td> </tr> </table> <a name="a11" doxytag="FX::FXRecentFiles::setFile"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> void FX::FXRecentFiles::setFile </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">FXint </td> <td class="mdname" nowrap> <em>index</em>, </td> </tr> <tr> <td></td> <td></td> <td class="md" nowrap>const <a class="el" href="classFX_1_1FXString.html">FXString</a> & </td> <td class="mdname" nowrap> <em>filename</em></td> </tr> <tr> <td></td> <td class="md">) </td> <td class="md" colspan="2"></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Change the filename at index. <p> </td> </tr> </table> <a name="a12" doxytag="FX::FXRecentFiles::appendFile"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> void FX::FXRecentFiles::appendFile </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">const <a class="el" href="classFX_1_1FXString.html">FXString</a> & </td> <td class="mdname1" valign="top" nowrap> <em>filename</em> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Append a file. <p> </td> </tr> </table> <a name="a13" doxytag="FX::FXRecentFiles::removeFile"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> void FX::FXRecentFiles::removeFile </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top">const <a class="el" href="classFX_1_1FXString.html">FXString</a> & </td> <td class="mdname1" valign="top" nowrap> <em>filename</em> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Remove a file. <p> </td> </tr> </table> <a name="a14" doxytag="FX::FXRecentFiles::clear"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> void FX::FXRecentFiles::clear </td> <td class="md" valign="top">( </td> <td class="mdname1" valign="top" nowrap> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Clear the list of files. <p> </td> </tr> </table> <a name="a15" doxytag="FX::FXRecentFiles::save"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> virtual void FX::FXRecentFiles::save </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top"><a class="el" href="classFX_1_1FXStream.html">FXStream</a> & </td> <td class="mdname1" valign="top" nowrap> <em>store</em> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap> const<code> [virtual]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Save to a stream. <p> <p> Reimplemented from <a class="el" href="classFX_1_1FXObject.html#a3">FX::FXObject</a>. </td> </tr> </table> <a name="a16" doxytag="FX::FXRecentFiles::load"></a><p> <table class="mdTable" width="100%" cellpadding="2" cellspacing="0"> <tr> <td class="mdRow"> <table cellpadding="0" cellspacing="0" border="0"> <tr> <td class="md" nowrap valign="top"> virtual void FX::FXRecentFiles::load </td> <td class="md" valign="top">( </td> <td class="md" nowrap valign="top"><a class="el" href="classFX_1_1FXStream.html">FXStream</a> & </td> <td class="mdname1" valign="top" nowrap> <em>store</em> </td> <td class="md" valign="top"> ) </td> <td class="md" nowrap><code> [virtual]</code></td> </tr> </table> </td> </tr> </table> <table cellspacing=5 cellpadding=0 border=0> <tr> <td> </td> <td> <p> Load from a stream. <p> <p> Reimplemented from <a class="el" href="classFX_1_1FXObject.html#a4">FX::FXObject</a>. </td> </tr> </table> </font> <!--- COPYRIGHT --> <p> <table width=100% cellpadding=0 cellspacing=0><tr><td width=100% valign=top id=HEADLINE align=right> <img src='../art/line.gif' width=100% height=1><font size=-1> Copyright © 1997-2004 Jeroen van der Zijp</font> </td></tr></table> </p> <!--- COPYRIGHT --> </body> </html>