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.
588 lines
29 KiB
588 lines
29 KiB
<!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/doc/tutorial2.doc:349 -->
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
|
<title>Presenting the GUI</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>Presenting the GUI</h1>
|
|
|
|
|
|
<p>
|
|
<p> <center><img src="chart-main2.png" alt="The chart application"></center>
|
|
<p> The <tt>chart</tt> application provides access to options via menus and
|
|
toolbar buttons arranged around a central widget, a CanvasView, in a
|
|
conventional document-centric style.
|
|
<p> (Extracts from <tt>chartform.h</tt>.)
|
|
<p>
|
|
|
|
<pre> class ChartForm: public <a href="ntqmainwindow.html">TQMainWindow</a>
|
|
{
|
|
<a href="metaobjects.html#TQ_OBJECT">TQ_OBJECT</a>
|
|
public:
|
|
enum { MAX_ELEMENTS = 100 };
|
|
enum { MAX_RECENTFILES = 9 }; // Must not exceed 9
|
|
enum ChartType { PIE, VERTICAL_BAR, HORIZONTAL_BAR };
|
|
enum AddValuesType { NO, YES, AS_PERCENTAGE };
|
|
|
|
ChartForm( const <a href="ntqstring.html">TQString</a>& filename );
|
|
~ChartForm();
|
|
|
|
int chartType() { return m_chartType; }
|
|
void setChanged( bool changed = TRUE ) { m_changed = changed; }
|
|
void drawElements();
|
|
|
|
<a href="ntqpopupmenu.html">TQPopupMenu</a> *optionsMenu; // Why public? See canvasview.cpp
|
|
|
|
protected:
|
|
virtual void closeEvent( <a href="qcloseevent.html">TQCloseEvent</a> * );
|
|
|
|
private slots:
|
|
void fileNew();
|
|
void fileOpen();
|
|
void fileOpenRecent( int index );
|
|
void fileSave();
|
|
void fileSaveAs();
|
|
void fileSaveAsPixmap();
|
|
void filePrint();
|
|
void fileQuit();
|
|
void optionsSetData();
|
|
void updateChartType( <a href="ntqaction.html">TQAction</a> *action );
|
|
void optionsSetFont();
|
|
void optionsSetOptions();
|
|
void helpHelp();
|
|
void helpAbout();
|
|
void helpAboutTQt();
|
|
void saveOptions();
|
|
|
|
private:
|
|
void init();
|
|
void load( const <a href="ntqstring.html">TQString</a>& filename );
|
|
bool okToClear();
|
|
void drawPieChart( const double scales[], double total, int count );
|
|
void drawVerticalBarChart( const double scales[], double total, int count );
|
|
void drawHorizontalBarChart( const double scales[], double total, int count );
|
|
|
|
<a href="ntqstring.html">TQString</a> valueLabel( const <a href="ntqstring.html">TQString</a>& label, double value, double total );
|
|
void updateRecentFiles( const <a href="ntqstring.html">TQString</a>& filename );
|
|
void updateRecentFilesMenu();
|
|
void setChartType( ChartType chartType );
|
|
|
|
<a href="ntqpopupmenu.html">TQPopupMenu</a> *fileMenu;
|
|
<a href="ntqaction.html">TQAction</a> *optionsPieChartAction;
|
|
<a href="ntqaction.html">TQAction</a> *optionsHorizontalBarChartAction;
|
|
<a href="ntqaction.html">TQAction</a> *optionsVerticalBarChartAction;
|
|
<a href="ntqstring.html">TQString</a> m_filename;
|
|
<a href="ntqstringlist.html">TQStringList</a> m_recentFiles;
|
|
<a href="ntqcanvas.html">TQCanvas</a> *m_canvas;
|
|
CanvasView *m_canvasView;
|
|
bool m_changed;
|
|
ElementVector m_elements;
|
|
<a href="ntqprinter.html">TQPrinter</a> *m_printer;
|
|
ChartType m_chartType;
|
|
AddValuesType m_addValues;
|
|
int m_decimalPlaces;
|
|
<a href="ntqfont.html">TQFont</a> m_font;
|
|
};
|
|
</pre>
|
|
<p> We create a <tt>ChartForm</tt> subclass of <a href="ntqmainwindow.html">TQMainWindow</a>. Our subclass uses
|
|
the <a href="metaobjects.html#TQ_OBJECT">TQ_OBJECT</a> macro to support TQt's <a href="signalsandslots.html">signals and slots</a> mechanism.
|
|
<p> The public interface is very small; the type of chart being displayed
|
|
can be retrieved, the chart can be marked 'changed' (so that the user
|
|
will be prompted to save on exit), and the chart can be asked to draw
|
|
itself (drawElements()). We've also made the options menu public
|
|
because we are also going to use this menu as the canvas view's
|
|
context menu.
|
|
<p> <center><table cellpadding="4" cellspacing="2" border="0">
|
|
<tr bgcolor="#f0f0f0">
|
|
<td valign="top">The <a href="ntqcanvas.html">TQCanvas</a> class is used for drawing 2D vector graphics. The
|
|
<a href="qcanvasview.html">TQCanvasView</a> class is used to present a view of a canvas in an
|
|
application's GUI. All our drawing operations take place on the
|
|
canvas; but events (e.g. mouse clicks) take place on the canvas view.
|
|
</table></center>
|
|
<p> Each action is represented by a private slot, e.g. <tt>fileNew()</tt>, <tt>optionsSetData()</tt>, etc. We also have quite a number of private
|
|
functions and data members; we'll look at all these as we go through
|
|
the implementation.
|
|
<p> For the sake of convenience and compilation speed the chart form's
|
|
implementation is split over three files, <tt>chartform.cpp</tt> for the
|
|
GUI, <tt>chartform_canvas.cpp</tt> for the canvas handling and <tt>chartform_files.cpp</tt> for the file handling. We'll review each in turn.
|
|
<p> <h2> The Chart Form GUI
|
|
</h2>
|
|
<a name="1"></a><p> (Extracts from <tt>chartform.cpp</tt>.)
|
|
<p>
|
|
|
|
<pre> #include "images/file_new.xpm"
|
|
#include "images/file_open.xpm"
|
|
</pre><pre> #include "images/options_piechart.xpm"
|
|
</pre>
|
|
<p> All the images used by <tt>chart</tt> have been created as <tt>.xpm</tt> files
|
|
which we've placed in the <tt>images</tt> subdirectory.
|
|
<p> <h2> The Constructor
|
|
</h2>
|
|
<a name="2"></a><p> <pre> ChartForm::ChartForm( const <a href="ntqstring.html">TQString</a>& filename )
|
|
: <a href="ntqmainwindow.html">TQMainWindow</a>( 0, 0, WDestructiveClose )
|
|
</pre><tt>...</tt>
|
|
<pre> <a href="ntqaction.html">TQAction</a> *fileNewAction;
|
|
<a href="ntqaction.html">TQAction</a> *fileOpenAction;
|
|
<a href="ntqaction.html">TQAction</a> *fileSaveAction;
|
|
</pre>
|
|
<p> For each user action we declare a <a href="ntqaction.html">TQAction</a> pointer. Some actions are
|
|
declared in the header file because they need to be referred to
|
|
outside of the constructor.
|
|
<p> <center><table cellpadding="4" cellspacing="2" border="0">
|
|
<tr bgcolor="#d0d0d0">
|
|
<td valign="top">Most user actions are suitable as both menu items and as toolbar
|
|
buttons. TQt allows us to create a single TQAction which can be added to
|
|
both a menu and a toolbar. This approach ensures that menu items and
|
|
toolbar buttons stay in sync and saves duplicating code.
|
|
</table></center>
|
|
<p> <pre> fileNewAction = new <a href="ntqaction.html">TQAction</a>(
|
|
"New Chart", TQPixmap( file_new ),
|
|
"&New", CTRL+Key_N, this, "new" );
|
|
<a href="ntqobject.html#connect">connect</a>( fileNewAction, SIGNAL( <a href="ntqaction.html#activated">activated</a>() ), this, SLOT( fileNew() ) );
|
|
</pre>
|
|
<p> When we construct an action we give it a name, an optional icon, a
|
|
menu text, and an accelerator short-cut key (or 0 if no accelerator is
|
|
required). We also make it a child of the form (by passing <tt>this</tt>).
|
|
When the user clicks a toolbar button or clicks a menu option the <tt>activated()</tt> signal is emitted. We connect() this signal to the
|
|
action's slot, in the snippet shown above, to fileNew().
|
|
<p> The chart types are all mutually exclusive: you can have a pie chart
|
|
<em>or</em> a vertical bar chart <em>or</em> a horizontal bar chart. This means
|
|
that if the user selects the pie chart menu option, the pie chart
|
|
toolbar button must be automatically selected too, and the other chart
|
|
menu options and toolbar buttons must be automatically unselected.
|
|
This behaviour is achieved by creating a <a href="qactiongroup.html">TQActionGroup</a> and placing the
|
|
chart type actions in the group.
|
|
<p> <pre> <a href="qactiongroup.html">TQActionGroup</a> *chartGroup = new <a href="qactiongroup.html">TQActionGroup</a>( this ); // Connected later
|
|
chartGroup-><a href="qactiongroup.html#setExclusive">setExclusive</a>( TRUE );
|
|
</pre>
|
|
<p> The action group becomes a child of the form (<tt>this</tt>) and the
|
|
exlusive behaviour is achieved by the setExclusive() call.
|
|
<p> <pre> optionsPieChartAction = new <a href="ntqaction.html">TQAction</a>(
|
|
"Pie Chart", TQPixmap( options_piechart ),
|
|
"&Pie Chart", CTRL+Key_I, chartGroup, "pie chart" );
|
|
optionsPieChartAction-><a href="ntqaction.html#setToggleAction">setToggleAction</a>( TRUE );
|
|
</pre>
|
|
<p> Each action in the group is created in the same way as other actions,
|
|
except that the action's parent is the group rather than the form.
|
|
Because our chart type actions have an on/off state we call
|
|
setToggleAction(TRUE) for each of them. Note that we do not connect
|
|
the actions; instead, later on, we will connect the group to a slot
|
|
that will cause the canvas to redraw.
|
|
<p> <center><table cellpadding="4" cellspacing="2" border="0">
|
|
<tr bgcolor="#f0f0f0">
|
|
<td valign="top">Why haven't we connected the group straight away? Later in the
|
|
constructor we will read the user's options, one of which is the chart
|
|
type. We will then set the chart type accordingly. But at that point
|
|
we still won't have created a canvas or have any data, so all we want
|
|
to do is toggle the canvas type toolbar buttons, but not actually draw
|
|
the (at this point non-existent) canvas. <em>After</em> we have set the
|
|
canvas type we will connect the group.
|
|
</table></center>
|
|
<p> Once we've created all our user actions we can create the toolbars and
|
|
menu options that will allow the user to invoke them.
|
|
<p> <pre> <a href="ntqtoolbar.html">TQToolBar</a>* fileTools = new <a href="ntqtoolbar.html">TQToolBar</a>( this, "file operations" );
|
|
fileTools-><a href="ntqtoolbar.html#setLabel">setLabel</a>( "File Operations" );
|
|
fileNewAction-><a href="ntqaction.html#addTo">addTo</a>( fileTools );
|
|
fileOpenAction-><a href="ntqaction.html#addTo">addTo</a>( fileTools );
|
|
fileSaveAction-><a href="ntqaction.html#addTo">addTo</a>( fileTools );
|
|
</pre><tt>...</tt>
|
|
<pre> fileMenu = new <a href="ntqpopupmenu.html">TQPopupMenu</a>( this );
|
|
<a href="ntqmainwindow.html#menuBar">menuBar</a>()->insertItem( "&File", fileMenu );
|
|
fileNewAction-><a href="ntqaction.html#addTo">addTo</a>( fileMenu );
|
|
fileOpenAction-><a href="ntqaction.html#addTo">addTo</a>( fileMenu );
|
|
fileSaveAction-><a href="ntqaction.html#addTo">addTo</a>( fileMenu );
|
|
</pre>
|
|
<p> Toolbar actions and menu options are easily created from TQActions.
|
|
<p> As a convenience to our users we will restore the last window position
|
|
and size and list their recently used files. This is achieved by
|
|
writing out their settings when the application is closed and reading
|
|
them back when we construct the form.
|
|
<p> <pre> <a href="ntqsettings.html">TQSettings</a> settings;
|
|
settings.<a href="ntqsettings.html#insertSearchPath">insertSearchPath</a>( TQSettings::Windows, WINDOWS_REGISTRY );
|
|
int windowWidth = settings.<a href="ntqsettings.html#readNumEntry">readNumEntry</a>( APP_KEY + "WindowWidth", 460 );
|
|
int windowHeight = settings.<a href="ntqsettings.html#readNumEntry">readNumEntry</a>( APP_KEY + "WindowHeight", 530 );
|
|
int windowX = settings.<a href="ntqsettings.html#readNumEntry">readNumEntry</a>( APP_KEY + "WindowX", -1 );
|
|
int windowY = settings.<a href="ntqsettings.html#readNumEntry">readNumEntry</a>( APP_KEY + "WindowY", -1 );
|
|
setChartType( ChartType(
|
|
settings.<a href="ntqsettings.html#readNumEntry">readNumEntry</a>( APP_KEY + "ChartType", int(PIE) ) ) );
|
|
</pre><pre> m_font = TQFont( "Helvetica", 18, TQFont::Bold );
|
|
m_font.fromString(
|
|
settings.<a href="ntqsettings.html#readEntry">readEntry</a>( APP_KEY + "Font", m_font.toString() ) );
|
|
for ( int i = 0; i < MAX_RECENTFILES; ++i ) {
|
|
<a href="ntqstring.html">TQString</a> filename = settings.<a href="ntqsettings.html#readEntry">readEntry</a>( APP_KEY + "File" +
|
|
TQString::<a href="ntqstring.html#number">number</a>( i + 1 ) );
|
|
if ( !filename.<a href="ntqstring.html#isEmpty">isEmpty</a>() )
|
|
m_recentFiles.push_back( filename );
|
|
}
|
|
if ( m_recentFiles.count() )
|
|
updateRecentFilesMenu();
|
|
</pre>
|
|
<p> The <a href="ntqsettings.html">TQSettings</a> class handles user settings in a platform-independent
|
|
way. We simply read and write settings, leaving TQSettings to handle
|
|
the platform dependencies. The insertSearchPath() call does nothing
|
|
except under Windows so does not have to be <tt>#ifdef</tt>ed.
|
|
<p> We use readNumEntry() calls to obtain the chart form's last size and
|
|
position, providing default values if this is the first time it has
|
|
been run. The chart type is retrieved as an integer and cast to a
|
|
ChartType enum value. We create a default label font and then read the
|
|
"Font" setting, using the default we have just created if necessary.
|
|
<p> Although TQSettings can handle string lists we've chosen to store each
|
|
recently used file as a separate entry to make it easier to hand edit
|
|
the settings. We attempt to read each possible file entry ("File1" to
|
|
"File9"), and add each non-empty entry to the list of recently used
|
|
files. If there are one or more recently used files we update the File
|
|
menu by calling updateRecentFilesMenu(); (we'll review this later on).
|
|
<p> <pre> <a href="ntqobject.html#connect">connect</a>( chartGroup, SIGNAL( <a href="qactiongroup.html#selected">selected</a>(TQAction*) ),
|
|
this, SLOT( updateChartType(TQAction*) ) );
|
|
</pre>
|
|
<p> Now that we have set the chart type (when we read it in as a user
|
|
setting) it is safe to connect the chart group to our
|
|
updateChartType() slot.
|
|
<p> <pre> <a href="ntqwidget.html#resize">resize</a>( windowWidth, windowHeight );
|
|
if ( windowX != -1 || windowY != -1 )
|
|
<a href="ntqwidget.html#move">move</a>( windowX, windowY );
|
|
</pre>
|
|
<p> And now that we know the window size and position we can resize and
|
|
move the chart form's window accordingly.
|
|
<p> <pre> m_canvas = new <a href="ntqcanvas.html">TQCanvas</a>( this );
|
|
m_canvas-><a href="ntqcanvas.html#resize">resize</a>( <a href="ntqwidget.html#width">width</a>(), height() );
|
|
m_canvasView = new CanvasView( m_canvas, &m_elements, this );
|
|
<a href="ntqmainwindow.html#setCentralWidget">setCentralWidget</a>( m_canvasView );
|
|
m_canvasView-><a href="ntqwidget.html#show">show</a>();
|
|
</pre>
|
|
<p> We create a new <a href="ntqcanvas.html">TQCanvas</a> and set its size to that of the chart form
|
|
window's client area. We also create a <tt>CanvasView</tt> (our own subclass
|
|
of <a href="qcanvasview.html">TQCanvasView</a>) to display the TQCanvas. We make the canvas view the
|
|
chart form's main widget and show it.
|
|
<p> <pre> if ( !filename.<a href="ntqstring.html#isEmpty">isEmpty</a>() )
|
|
load( filename );
|
|
else {
|
|
init();
|
|
m_elements[0].set( 20, red, 14, "Red" );
|
|
m_elements[1].set( 70, cyan, 2, "Cyan", darkGreen );
|
|
m_elements[2].set( 35, blue, 11, "Blue" );
|
|
m_elements[3].set( 55, yellow, 1, "Yellow", darkBlue );
|
|
m_elements[4].set( 80, magenta, 1, "Magenta" );
|
|
drawElements();
|
|
}
|
|
</pre>
|
|
<p> If we have a file to load we load it; otherwise we initialise our
|
|
elements vector and draw a sample chart.
|
|
<p> <pre> <a href="ntqmainwindow.html#statusBar">statusBar</a>()->message( "Ready", 2000 );
|
|
</pre>
|
|
<p> It is <em>vital</em> that we call statusBar() in the constructor, since the
|
|
call ensures that a status bar is created for this main window.
|
|
<p> <h3> init()
|
|
</h3>
|
|
<a name="2-1"></a><p> <pre> void ChartForm::init()
|
|
{
|
|
<a href="ntqwidget.html#setCaption">setCaption</a>( "Chart" );
|
|
m_filename = <a href="ntqstring.html#TQString-null">TQString::null</a>;
|
|
m_changed = FALSE;
|
|
|
|
m_elements[0] = Element( Element::INVALID, red );
|
|
m_elements[1] = Element( Element::INVALID, cyan );
|
|
m_elements[2] = Element( Element::INVALID, blue );
|
|
</pre><tt>...</tt>
|
|
<p> We use an init() function because we want to initialise the canvas and
|
|
the elements (in the <tt>m_elements</tt> <tt>ElementVector</tt>) when the form is
|
|
constructed, and also whenever the user loads an existing data set or
|
|
creates a new data set.
|
|
<p> We reset the caption and set the current filename to TQString::null. We
|
|
also populate the elements vector with invalid elements. This isn't
|
|
necessary, but giving each element a different color is more
|
|
convenient for the user since when they enter values each one will
|
|
already have a unique color (which they can change of course).
|
|
<p> <h2> The File Handling Actions
|
|
</h2>
|
|
<a name="3"></a><p> <h3> okToClear()
|
|
</h3>
|
|
<a name="3-1"></a><p> <pre> bool ChartForm::okToClear()
|
|
{
|
|
if ( m_changed ) {
|
|
<a href="ntqstring.html">TQString</a> msg;
|
|
if ( m_filename.isEmpty() )
|
|
msg = "Unnamed chart ";
|
|
else
|
|
msg = TQString( "Chart '%1'\n" ).arg( m_filename );
|
|
msg += "has been changed.";
|
|
|
|
int x = TQMessageBox::<a href="ntqmessagebox.html#information">information</a>( this, "Chart -- Unsaved Changes",
|
|
msg, "&Save", "Cancel", "&Abandon",
|
|
0, 1 );
|
|
switch( x ) {
|
|
case 0: // Save
|
|
fileSave();
|
|
break;
|
|
case 1: // Cancel
|
|
default:
|
|
return FALSE;
|
|
case 2: // Abandon
|
|
break;
|
|
}
|
|
}
|
|
|
|
return TRUE;
|
|
}
|
|
</pre>
|
|
<p> The okToClear() function is used to prompt the user to save their
|
|
values if they have any unsaved data. It is used by several other
|
|
functions.
|
|
<p> <h3> fileNew()
|
|
</h3>
|
|
<a name="3-2"></a><p>
|
|
|
|
<pre> void ChartForm::fileNew()
|
|
{
|
|
if ( okToClear() ) {
|
|
init();
|
|
drawElements();
|
|
}
|
|
}
|
|
</pre>
|
|
<p> When the user invokes the fileNew() action we call okToClear() to give
|
|
them the opportunity to save any unsaved data. If they either save or
|
|
abandon or have no unsaved data we re-initialise the elements vector
|
|
and draw the default chart.
|
|
<p> <center><table cellpadding="4" cellspacing="2" border="0">
|
|
<tr bgcolor="#d0d0d0">
|
|
<td valign="top">Should we also have invoked optionsSetData() to pop up the dialog
|
|
through which the user can create and edit values, colors etc? You
|
|
could try running the application as it is, and then try it having
|
|
added a call to optionsSetData() and see which you prefer.
|
|
</table></center>
|
|
<p> <h3> fileOpen()
|
|
</h3>
|
|
<a name="3-3"></a><p> <pre> void ChartForm::fileOpen()
|
|
{
|
|
if ( !okToClear() )
|
|
return;
|
|
|
|
<a href="ntqstring.html">TQString</a> filename = TQFileDialog::<a href="ntqfiledialog.html#getOpenFileName">getOpenFileName</a>(
|
|
TQString::null, "Charts (*.cht)", this,
|
|
"file open", "Chart -- File Open" );
|
|
<a name="x2567"></a> if ( !filename.<a href="ntqstring.html#isEmpty">isEmpty</a>() )
|
|
load( filename );
|
|
else
|
|
<a href="ntqmainwindow.html#statusBar">statusBar</a>()->message( "File Open abandoned", 2000 );
|
|
}
|
|
</pre>
|
|
<p> We check that it is okToClear(). If it is we use the static
|
|
<a href="ntqfiledialog.html#getOpenFileName">TQFileDialog::getOpenFileName</a>() function to get the name of the file
|
|
the user wishes to load. If we get a filename we call load().
|
|
<p> <h3> fileSaveAs()
|
|
</h3>
|
|
<a name="3-4"></a><p> <pre> void ChartForm::fileSaveAs()
|
|
{
|
|
<a href="ntqstring.html">TQString</a> filename = TQFileDialog::<a href="ntqfiledialog.html#getSaveFileName">getSaveFileName</a>(
|
|
TQString::null, "Charts (*.cht)", this,
|
|
"file save as", "Chart -- File Save As" );
|
|
if ( !filename.<a href="ntqstring.html#isEmpty">isEmpty</a>() ) {
|
|
int answer = 0;
|
|
<a name="x2563"></a> if ( TQFile::<a href="ntqfile.html#exists">exists</a>( filename ) )
|
|
<a name="x2566"></a> answer = TQMessageBox::<a href="ntqmessagebox.html#warning">warning</a>(
|
|
this, "Chart -- Overwrite File",
|
|
TQString( "Overwrite\n\'%1\'?" ).
|
|
arg( filename ),
|
|
"&Yes", "&No", TQString::null, 1, 1 );
|
|
if ( answer == 0 ) {
|
|
m_filename = filename;
|
|
updateRecentFiles( filename );
|
|
fileSave();
|
|
return;
|
|
}
|
|
}
|
|
<a href="ntqmainwindow.html#statusBar">statusBar</a>()->message( "Saving abandoned", 2000 );
|
|
}
|
|
</pre>
|
|
<p> This function calls the static <a href="ntqfiledialog.html#getSaveFileName">TQFileDialog::getSaveFileName</a>() to get
|
|
the name of the file to save the data in. If the file exists we use a
|
|
<a href="ntqmessagebox.html#warning">TQMessageBox::warning</a>() to notify the user and give them the option of
|
|
abandoning the save. If the file is to be saved we update the recently
|
|
opened files list and call fileSave() (covered in <a href="tutorial2-07.html">File Handling</a>) to perform the save.
|
|
<p> <h2> Managing a list of Recently Opened Files
|
|
</h2>
|
|
<a name="4"></a><p>
|
|
|
|
<pre> <a href="ntqstringlist.html">TQStringList</a> m_recentFiles;
|
|
</pre>
|
|
<p> We hold the list of recently opened files in a string list.
|
|
<p>
|
|
|
|
<pre> void ChartForm::updateRecentFilesMenu()
|
|
{
|
|
for ( int i = 0; i < MAX_RECENTFILES; ++i ) {
|
|
if ( fileMenu-><a href="ntqmenudata.html#findItem">findItem</a>( i ) )
|
|
fileMenu-><a href="ntqmenudata.html#removeItem">removeItem</a>( i );
|
|
if ( i < int(m_recentFiles.count()) )
|
|
fileMenu-><a href="ntqmenudata.html#insertItem">insertItem</a>( TQString( "&%1 %2" ).
|
|
arg( i + 1 ).arg( m_recentFiles[i] ),
|
|
this, SLOT( fileOpenRecent(int) ),
|
|
0, i );
|
|
}
|
|
}
|
|
</pre>
|
|
<p> This function is called (usually via updateRecentFiles()) whenever the
|
|
user opens an existing file or saves a new file. For each file in the
|
|
string list we insert a new menu item. We prefix each filename with an
|
|
underlined number from <u>1</u> to <u>9</u> to support keyboard access
|
|
(e.g. <tt>Alt+F, 2</tt> to open the second file in the list). We give the
|
|
menu item an id which is the same as the index position of the item in
|
|
the string list, and connect each menu item to the fileOpenRecent()
|
|
slot. The old file menu items are deleted at the same time by going
|
|
through each possible recent file menu item id. This works because the
|
|
other file menu items had ids created by TQt (all of which are < 0);
|
|
whereas the menu items we're creating all have ids >= 0.
|
|
<p>
|
|
|
|
<pre> void ChartForm::updateRecentFiles( const <a href="ntqstring.html">TQString</a>& filename )
|
|
{
|
|
if ( m_recentFiles.find( filename ) != m_recentFiles.end() )
|
|
return;
|
|
|
|
m_recentFiles.push_back( filename );
|
|
if ( m_recentFiles.count() > MAX_RECENTFILES )
|
|
m_recentFiles.pop_front();
|
|
|
|
updateRecentFilesMenu();
|
|
}
|
|
</pre>
|
|
<p> This is called when the user opens an existing file or saves a new
|
|
file. If the file is already in the list it simply returns. Otherwise
|
|
the file is added to the end of the list and if the list is too large
|
|
(> 9 files) the first (oldest) is removed. updateRecentFilesMenu() is
|
|
then called to recreate the list of recently used files in the File
|
|
menu.
|
|
<p>
|
|
|
|
<pre> void ChartForm::fileOpenRecent( int index )
|
|
{
|
|
if ( !okToClear() )
|
|
return;
|
|
|
|
load( m_recentFiles[index] );
|
|
}
|
|
</pre>
|
|
<p> When the user selects a recently opened file the fileOpenRecent() slot
|
|
is called with the menu id of the file they have selected. Because we
|
|
made the file menu ids equal to the files' index positions in the
|
|
<tt>m_recentFiles</tt> list we can simply load the file indexed by the menu
|
|
item id.
|
|
<p> <h2> Quiting
|
|
</h2>
|
|
<a name="5"></a><p> <pre> void ChartForm::fileQuit()
|
|
{
|
|
if ( okToClear() ) {
|
|
saveOptions();
|
|
tqApp-><a href="ntqapplication.html#exit">exit</a>( 0 );
|
|
}
|
|
}
|
|
</pre>
|
|
<p> When the user quits we give them the opportunity to save any unsaved
|
|
data (okToClear()) then save their options, e.g. window size and
|
|
position, chart type, etc., before terminating.
|
|
<p> <pre> void ChartForm::saveOptions()
|
|
{
|
|
<a href="ntqsettings.html">TQSettings</a> settings;
|
|
settings.<a href="ntqsettings.html#insertSearchPath">insertSearchPath</a>( TQSettings::Windows, WINDOWS_REGISTRY );
|
|
settings.<a href="ntqsettings.html#writeEntry">writeEntry</a>( APP_KEY + "WindowWidth", width() );
|
|
settings.<a href="ntqsettings.html#writeEntry">writeEntry</a>( APP_KEY + "WindowHeight", height() );
|
|
settings.<a href="ntqsettings.html#writeEntry">writeEntry</a>( APP_KEY + "WindowX", x() );
|
|
settings.<a href="ntqsettings.html#writeEntry">writeEntry</a>( APP_KEY + "WindowY", y() );
|
|
settings.<a href="ntqsettings.html#writeEntry">writeEntry</a>( APP_KEY + "ChartType", int(m_chartType) );
|
|
settings.<a href="ntqsettings.html#writeEntry">writeEntry</a>( APP_KEY + "AddValues", int(m_addValues) );
|
|
settings.<a href="ntqsettings.html#writeEntry">writeEntry</a>( APP_KEY + "Decimals", m_decimalPlaces );
|
|
settings.<a href="ntqsettings.html#writeEntry">writeEntry</a>( APP_KEY + "Font", m_font.toString() );
|
|
for ( int i = 0; i < int(m_recentFiles.count()); ++i )
|
|
settings.<a href="ntqsettings.html#writeEntry">writeEntry</a>( APP_KEY + "File" + TQString::number( i + 1 ),
|
|
m_recentFiles[i] );
|
|
}
|
|
</pre>
|
|
<p> Saving the user's options using <a href="ntqsettings.html">TQSettings</a> is straight-forward.
|
|
<p> <h2> Custom Dialogs
|
|
</h2>
|
|
<a name="6"></a><p> We want the user to be able to set some options manually and to create
|
|
and edit values, value colors, etc.
|
|
<p>
|
|
|
|
<pre> void ChartForm::optionsSetOptions()
|
|
{
|
|
OptionsForm *optionsForm = new OptionsForm( this );
|
|
optionsForm->chartTypeComboBox->setCurrentItem( m_chartType );
|
|
optionsForm-><a href="ntqwidget.html#setFont">setFont</a>( m_font );
|
|
</pre><pre> if ( optionsForm-><a href="ntqdialog.html#exec">exec</a>() ) {
|
|
setChartType( ChartType(
|
|
optionsForm->chartTypeComboBox->currentItem()) );
|
|
m_font = optionsForm-><a href="ntqwidget.html#font">font</a>();
|
|
</pre><pre> drawElements();
|
|
}
|
|
delete optionsForm;
|
|
}
|
|
</pre>
|
|
<p> The form for setting options is provided by our custom <tt>OptionsForm</tt>
|
|
covered in <a href="tutorial2-09.html">Setting Options</a>. The
|
|
options form is a standard "dumb" dialog: we create an instance, set
|
|
all its GUI elements to the relevant settings, and if the user clicked
|
|
"OK" (exec() returns a true value) we read back settings from the GUI
|
|
elements.
|
|
<p>
|
|
|
|
<pre> void ChartForm::optionsSetData()
|
|
{
|
|
SetDataForm *setDataForm = new SetDataForm( &m_elements, m_decimalPlaces, this );
|
|
if ( setDataForm-><a href="ntqdialog.html#exec">exec</a>() ) {
|
|
m_changed = TRUE;
|
|
drawElements();
|
|
}
|
|
delete setDataForm;
|
|
}
|
|
</pre>
|
|
<p> The form for creating and editing chart data is provided by our custom
|
|
<tt>SetDataForm</tt> covered in <a href="tutorial2-08.html">Taking Data</a>.
|
|
This form is a "smart" dialog. We pass in the data structure we want
|
|
to work on, and the dialog handles the presentation of the data
|
|
structure itself. If the user clicks "OK" the dialog will update the
|
|
data structure and exec() will return a true value. All we need to do
|
|
in optionsSetData() if the user changed the data is mark the chart as
|
|
changed and call drawElements() to redraw the chart with the new and
|
|
updated data.
|
|
<p> <p align="right">
|
|
<a href="tutorial2-04.html">« Mainly Easy</a> |
|
|
<a href="tutorial2.html">Contents</a> |
|
|
<a href="tutorial2-06.html">Canvas Control »</a>
|
|
</p>
|
|
<p>
|
|
<!-- 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>
|