vaikene.ee Git - evaf/blob - src/plugins/SdiWindow/isdiwindow.h

   1 /**
   2  * @file SdiWindow/isdiwindow.h
   3  * @brief eVaf SDI window interface
   4  * @author Enar Vaikene
   5  *
   6  * Copyright (c) 2011 Enar Vaikene
   7  *
   8  * This file is part of the eVaf C++ cross-platform application development framework.
   9  *
  10  * This file can be used under the terms of the GNU General Public License
  11  * version 3.0 as published by the Free Software Foundation and appearing in
  12  * the file LICENSE included in the packaging of this file. Please review the
  13  * the following information to ensure the GNU General Public License version
  14  * 3.0 requirements will be met: http://www.gnu.org/copyleft/gpl.html.
  15  *
  16  * Alternatively, this file may be used in accordance with the Commercial License
  17  * Agreement provided with the Software.
  18  */
  19
  20 #ifndef __SDIWINDOW_ISDIWINDOW_H
  21 #  define __SDIWINDOW_ISDIWINDOW_H
  22
  23 #include "libsdiwindow.h"
  24
  25 #include <QString>
  26 #include <QtPlugin>
  27
  28 class QWidget;
  29 class QLayout;
  30
  31 namespace eVaf {
  32 namespace SdiWindow {
  33
  34 /**
  35  * Main window interface for eVaf applications implementing the Single Document Interface.
  36  *
  37  * The iSdiWindow interface provides access to the SDI main window. The SDI main window is
  38  * an empty window that the application can fill with widgets.
  39  */
  40 struct SDIWINDOW_EXPORT iSdiWindow
  41 {
  42     /**
  43      * Returns the iSdiWindow interface instance
  44      * @return The iSdiWindow interface or zero if not available
  45      *
  46      * This function returns the global iSdiWindow interface instance. Using this function
  47      * is not mandatory and modules can use the iRegistry interface instead. Using the iRegistry
  48      * interface has the advantage that modules do not need to link against this library.
  49      */
  50     static iSdiWindow * instance();
  51
  52     /**
  53      * Adds the widget to the end of the main window layout
  54      * @param widget The widget
  55      *
  56      * This function adds the widget to the end of the main window layout.
  57      */
  58     virtual void addWidget(QWidget * widget) = 0;
  59
  60     /**
  61      * Adds the layout to the end of the main window layout
  62      * @param layout The layout
  63      *
  64      * This function adds the new layout to the end of the main window layout.
  65      */
  66     virtual void addLayout(QLayout * layout) = 0;
  67
  68 };
  69
  70 } // namespace eVaf::SdiWindow
  71 } // namespace eVaf
  72
  73 Q_DECLARE_INTERFACE(eVaf::SdiWindow::iSdiWindow, "eVaf.SdiWindow.iSdiWindow/1.0")
  74
  75 #endif // isdiwindow.h