From d796c9dd933ab96ec83b9a634feedd5d32e1ba3f Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Tue, 8 Nov 2011 12:31:36 -0600 Subject: Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731 --- doc/html/qaction-application-example.html | 438 ++++++++++++++++++++++++++++++ 1 file changed, 438 insertions(+) create mode 100644 doc/html/qaction-application-example.html (limited to 'doc/html/qaction-application-example.html') diff --git a/doc/html/qaction-application-example.html b/doc/html/qaction-application-example.html new file mode 100644 index 000000000..c166a8d9a --- /dev/null +++ b/doc/html/qaction-application-example.html @@ -0,0 +1,438 @@ + + + + + +A Complete Application Window with Actions + + + + + + + +

A Complete Application Window with Actions

+ + +

The TQAction class provides a way of associating user input from different +user interface elements with abstract high level actions. This approach makes +it easy to customize applications for different types of users. +

This example program is just like the +application example, +but uses TQAction to build the menu and the toolbar. +

Header file: +

/****************************************************************************
+** $Id: qt/application.h   3.3.8   edited Jan 11 14:36 $
+**
+** Copyright (C) 1992-2007 Trolltech ASA.  All rights reserved.
+**
+** This file is part of an example program for TQt.  This example
+** program may be used, distributed and modified without limitation.
+**
+*****************************************************************************/
+
+#ifndef APPLICATION_H
+#define APPLICATION_H
+
+#include <qmainwindow.h>
+
+class TQTextEdit;
+
+class ApplicationWindow: public TQMainWindow
+{
+    Q_OBJECT
+
+public:
+    ApplicationWindow();
+    ~ApplicationWindow();
+
+protected:
+    void closeEvent( TQCloseEvent* );
+
+private slots:
+    void newDoc();
+    void choose();
+    void load( const TQString &fileName );
+    void save();
+    void saveAs();
+    void print();
+
+    void about();
+    void aboutTQt();
+
+private:
+    TQPrinter *printer;
+    TQTextEdit *e;
+    TQString filename;
+};
+
+
+#endif
+

+ +

Implementation: +

/****************************************************************************
+** $Id: qt/application.cpp   3.3.8   edited Jan 11 14:36 $
+**
+** Copyright (C) 1992-2007 Trolltech ASA.  All rights reserved.
+**
+** This file is part of an example program for TQt.  This example
+** program may be used, distributed and modified without limitation.
+**
+*****************************************************************************/
+
+#include "application.h"
+
+#include <qimage.h>
+#include <qpixmap.h>
+#include <qtoolbar.h>
+#include <qtoolbutton.h>
+#include <qpopupmenu.h>
+#include <qmenubar.h>
+#include <qtextedit.h>
+#include <qfile.h>
+#include <qfiledialog.h>
+#include <qstatusbar.h>
+#include <qmessagebox.h>
+#include <qprinter.h>
+#include <qapplication.h>
+#include <qaccel.h>
+#include <qtextstream.h>
+#include <qpainter.h>
+#include <qpaintdevicemetrics.h>
+#include <qwhatsthis.h>
+#include <qaction.h>
+#include <qsimplerichtext.h>
+
+#include "filesave.xpm"
+#include "fileopen.xpm"
+#include "fileprint.xpm"
+
+
+ApplicationWindow::ApplicationWindow()
+    : TQMainWindow( 0, "example application main window", WDestructiveClose )
+{
+    printer = new TQPrinter( TQPrinter::HighResolution );
+
+    TQAction * fileNewAction;
+    TQAction * fileOpenAction;
+    TQAction * fileSaveAction, * fileSaveAsAction, * filePrintAction;
+    TQAction * fileCloseAction, * fileQuitAction;
+
+    fileNewAction = new TQAction( "&New", CTRL+Key_N, this, "new" );
+    connect( fileNewAction, SIGNAL( activated() ) , this,
+             SLOT( newDoc() ) );
+
+    fileOpenAction = new TQAction( TQPixmap( fileopen ), "&Open...",
+                                  CTRL+Key_O, this, "open" );
+    connect( fileOpenAction, SIGNAL( activated() ) , this, SLOT( choose() ) );
+
+    const char * fileOpenText = "<p><img source=\"fileopen\"> "
+                     "Click this button to open a <em>new file</em>. <br>"
+                     "You can also select the <b>Open</b> command "
+                     "from the <b>File</b> menu.</p>";
+    TQMimeSourceFactory::defaultFactory()->setPixmap( "fileopen",
+                          fileOpenAction->iconSet().pixmap() );
+    fileOpenAction->setWhatsThis( fileOpenText );
+
+    fileSaveAction = new TQAction( TQPixmap( filesave ),
+                                  "&Save", CTRL+Key_S, this, "save" );
+    connect( fileSaveAction, SIGNAL( activated() ) , this, SLOT( save() ) );
+
+    const char * fileSaveText = "<p>Click this button to save the file you "
+                     "are editing. You will be prompted for a file name.\n"
+                     "You can also select the <b>Save</b> command "
+                     "from the <b>File</b> menu.</p>";
+    fileSaveAction->setWhatsThis( fileSaveText );
+
+    fileSaveAsAction = new TQAction( "Save File As", "Save &As...", 0,  this,
+                                    "save as" );
+    connect( fileSaveAsAction, SIGNAL( activated() ) , this,
+             SLOT( saveAs() ) );
+    fileSaveAsAction->setWhatsThis( fileSaveText );
+
+    filePrintAction = new TQAction( "Print File", TQPixmap( fileprint ),
+                                   "&Print...", CTRL+Key_P, this, "print" );
+    connect( filePrintAction, SIGNAL( activated() ) , this,
+             SLOT( print() ) );
+
+    const char * filePrintText = "Click this button to print the file you "
+                     "are editing.\n You can also select the Print "
+                     "command from the File menu.";
+    filePrintAction->setWhatsThis( filePrintText );
+
+    fileCloseAction = new TQAction( "Close", "&Close", CTRL+Key_W, this,
+                                   "close" );
+    connect( fileCloseAction, SIGNAL( activated() ) , this,
+             SLOT( close() ) );
+
+    fileQuitAction = new TQAction( "Quit", "&Quit", CTRL+Key_Q, this,
+                                  "tquit" );
+    connect( fileQuitAction, SIGNAL( activated() ) , qApp,
+             SLOT( closeAllWindows() ) );
+
+    // populate a tool bar with some actions
+
+    TQToolBar * fileTools = new TQToolBar( this, "file operations" );
+    fileTools->setLabel( "File Operations" );
+    fileOpenAction->addTo( fileTools );
+    fileSaveAction->addTo( fileTools );
+    filePrintAction->addTo( fileTools );
+    (void)TQWhatsThis::whatsThisButton( fileTools );
+
+
+    // populate a menu with all actions
+
+    TQPopupMenu * file = new TQPopupMenu( this );
+    menuBar()->insertItem( "&File", file );
+    fileNewAction->addTo( file );
+    fileOpenAction->addTo( file );
+    fileSaveAction->addTo( file );
+    fileSaveAsAction->addTo( file );
+    file->insertSeparator();
+    filePrintAction->addTo( file );
+    file->insertSeparator();
+    fileCloseAction->addTo( file );
+    fileQuitAction->addTo( file );
+
+
+    menuBar()->insertSeparator();
+
+    // add a help menu
+
+    TQPopupMenu * help = new TQPopupMenu( this );
+    menuBar()->insertItem( "&Help", help );
+    help->insertItem( "&About", this, SLOT(about()), Key_F1 );
+    help->insertItem( "About &TQt", this, SLOT(aboutTQt()) );
+    help->insertSeparator();
+    help->insertItem( "What's &This", this, SLOT(whatsThis()),
+                      SHIFT+Key_F1 );
+
+
+    // create and define the central widget
+
+    e = new TQTextEdit( this, "editor" );
+    e->setFocus();
+    setCentralWidget( e );
+    statusBar()->message( "Ready", 2000 );
+
+    resize( 450, 600 );
+}
+
+
+ApplicationWindow::~ApplicationWindow()
+{
+    delete printer;
+}
+
+
+
+void ApplicationWindow::newDoc()
+{
+    ApplicationWindow *ed = new ApplicationWindow;
+    ed->show();
+}
+
+void ApplicationWindow::choose()
+{
+    TQString fn = TQFileDialog::getOpenFileName( TQString::null, TQString::null,
+                                               this);
+    if ( !fn.isEmpty() )
+        load( fn );
+    else
+        statusBar()->message( "Loading aborted", 2000 );
+}
+
+
+void ApplicationWindow::load( const TQString &fileName )
+{
+    TQFile f( fileName );
+    if ( !f.open( IO_ReadOnly ) )
+        return;
+
+    TQTextStream ts( &f );
+    e->setText( ts.read() );
+    e->setModified( FALSE );
+    setCaption( fileName );
+    statusBar()->message( "Loaded document " + fileName, 2000 );
+}
+
+
+void ApplicationWindow::save()
+{
+    if ( filename.isEmpty() ) {
+        saveAs();
+        return;
+    }
+
+    TQString text = e->text();
+    TQFile f( filename );
+    if ( !f.open( IO_WriteOnly ) ) {
+        statusBar()->message( TQString("Could not write to %1").arg(filename),
+                              2000 );
+        return;
+    }
+
+    TQTextStream t( &f );
+    t << text;
+    f.close();
+
+    e->setModified( FALSE );
+
+    setCaption( filename );
+
+    statusBar()->message( TQString( "File %1 saved" ).arg( filename ), 2000 );
+}
+
+
+void ApplicationWindow::saveAs()
+{
+    TQString fn = TQFileDialog::getSaveFileName( TQString::null, TQString::null,
+                                               this );
+    if ( !fn.isEmpty() ) {
+        filename = fn;
+        save();
+    } else {
+        statusBar()->message( "Saving aborted", 2000 );
+    }
+}
+
+
+void ApplicationWindow::print()
+{
+    printer->setFullPage( TRUE );
+    if ( printer->setup(this) ) {               // printer dialog
+        statusBar()->message( "Printing..." );
+        TQPainter p;
+        if( !p.begin( printer ) ) {               // paint on printer
+            statusBar()->message( "Printing aborted", 2000 );
+            return;
+        }
+
+        TQPaintDeviceMetrics metrics( p.device() );
+        int dpiy = metrics.logicalDpiY();
+        int margin = (int) ( (2/2.54)*dpiy ); // 2 cm margins
+        TQRect view( margin, margin, metrics.width() - 2*margin, metrics.height() - 2*margin );
+        TQSimpleRichText richText( TQStyleSheet::convertFromPlainText(e->text()),
+                                  TQFont(),
+                                  e->context(),
+                                  e->styleSheet(),
+                                  e->mimeSourceFactory(),
+                                  view.height() );
+        richText.setWidth( &p, view.width() );
+        int page = 1;
+        do {
+            richText.draw( &p, margin, margin, view, colorGroup() );
+            view.moveBy( 0, view.height() );
+            p.translate( 0 , -view.height() );
+            p.drawText( view.right() - p.fontMetrics().width( TQString::number( page ) ),
+                        view.bottom() + p.fontMetrics().ascent() + 5, TQString::number( page ) );
+            if ( view.top() - margin >= richText.height() )
+                break;
+            printer->newPage();
+            page++;
+        } while (TRUE);
+
+        statusBar()->message( "Printing completed", 2000 );
+    } else {
+        statusBar()->message( "Printing aborted", 2000 );
+    }
+}
+
+void ApplicationWindow::closeEvent( TQCloseEvent* ce )
+{
+    if ( !e->isModified() ) {
+        ce->accept();
+        return;
+    }
+
+    switch( TQMessageBox::information( this, "TQt Application Example",
+                                      "The document has been changed since "
+                                      "the last save.",
+                                      "Save Now", "Cancel", "Leave Anyway",
+                                      0, 1 ) ) {
+    case 0:
+        save();
+        ce->accept();
+        break;
+    case 1:
+    default: // just for sanity
+        ce->ignore();
+        break;
+    case 2:
+        ce->accept();
+        break;
+    }
+}
+
+
+void ApplicationWindow::about()
+{
+    TQMessageBox::about( this, "TQt Application Example",
+                        "This example demonstrates simple use of "
+                        "TQMainWindow,\nTQMenuBar and TQToolBar.");
+}
+
+
+void ApplicationWindow::aboutTQt()
+{
+    TQMessageBox::aboutTQt( this, "TQt Application Example" );
+}
+

+ +

Main: +

/****************************************************************************
+** $Id: qt/main.cpp   3.3.8   edited Jan 11 14:36 $
+**
+** Copyright (C) 1992-2007 Trolltech ASA.  All rights reserved.
+**
+** This file is part of an example program for TQt.  This example
+** program may be used, distributed and modified without limitation.
+**
+*****************************************************************************/
+
+#include <qapplication.h>
+#include "application.h"
+
+int main( int argc, char ** argv ) {
+    TQApplication a( argc, argv );
+    ApplicationWindow * mw = new ApplicationWindow();
+    mw->setCaption( "Document 1" );
+    mw->show();
+    a.connect( &a, SIGNAL(lastWindowClosed()), &a, SLOT(tquit()) );
+    return a.exec();
+}
+

+ +