#include <QMainWindow>

 void MainWindow::createMenus()
 {
     fileMenu = menuBar()->addMenu(tr("&File"));
     fileMenu->addAction(newAct);
     fileMenu->addAction(openAct);
     fileMenu->addAction(saveAct);

 void MainWindow::createToolBars()
 {
     fileToolBar = addToolBar(tr("File"));
     fileToolBar->addAction(newAct);

     QDockWidget *dockWidget = new QDockWidget(tr("Dock Widget"), this);
     dockWidget->setAllowedAreas(Qt::LeftDockWidgetArea |
                                 Qt::RightDockWidgetArea);
     dockWidget->setWidget(dockWidgetContents);
     addDockWidget(Qt::LeftDockWidgetArea, dockWidget);

Описание функций-членов

QMainWindow::QMainWindow ( QWidget * parent = 0, Qt::WindowFlags flags = 0 )

Конструирует QMainWindow с родителем parent и определенными флагами flags.

QMainWindow сам устанавливает флаг Qt::Window, и поэтому всегда будет создана как виджет верхнего уровня.

QMainWindow::~QMainWindow ()

Уничтожает главное окно.

void QMainWindow::addDockWidget ( Qt::DockWidgetArea area, QDockWidget * dockwidget )

Добавляет заданный прикрепляемый виджет (dockwidget) в определённую область area.

void QMainWindow::addDockWidget ( Qt::DockWidgetArea area, QDockWidget * dockwidget, Qt::Orientation orientation )

Добавляет прикрепляемый виджет dockwidget в заданную область area в направлении, задаваемом orientation.

void QMainWindow::addToolBar ( Qt::ToolBarArea area, QToolBar * toolbar )

Добавляет панель инструментов toolbar в определённую область area, главного окна. Панель toolbar размещается в конце текущего блока панелей (т.е. строки) Если панель toolbar уже находится под управлением главного окна, то она только переместится в область area.

Смотрите также insertToolBar(), addToolBarBreak() и insertToolBarBreak().

void QMainWindow::addToolBar ( QToolBar * toolbar )

Это перегруженная функция.

Эквивалентно вызову addToolBar(Qt::TopToolBarArea, toolbar)

QToolBar * QMainWindow::addToolBar ( const QString & title )

Это перегруженная функция.

Создаёт объект QToolBar, устанавливая его заголовок в title, и вставляет его в верхнюю область панелей инструментов.

Смотрите также setWindowTitle().

void QMainWindow::addToolBarBreak ( Qt::ToolBarArea area = Qt::TopToolBarArea )

Добавляет разрыв панели инструментов в заданную область area после всех других объектов, присутствующих в данный момент.

QWidget * QMainWindow::centralWidget () const

Возвращает центральный виджет главного окна. Эта функция вернёт ноль, если центральный виджет не был установлен.

Смотрите также setCentralWidget().

void QMainWindow::contextMenuEvent ( QContextMenuEvent * event ) [virtual protected]

Переопределено из QWidget::contextMenuEvent().

Qt::DockWidgetArea QMainWindow::corner ( Qt::Corner corner ) const

Возвращает область прикрепления, которая занимает указанный угол corner.

Смотрите также setCorner().

QMenu * QMainWindow::createPopupMenu () [virtual]

Возвращает всплывающее меню, содержащее отмечаемые записи для панелей инструментов и прикрепляемых виджетов имеющиеся в главном окне. Если панели инструментов и прикрепляемые виджеты отсутствуют, эта функция возвращает нулевой указатель.

По умолчанию эта функция вызывается главным окном, когда пользователь активирует контекстное меню, обычно щелчком правой кнопкой мыши на панели инструментов или прикрепляемом виджете.

Если вы хотите создать собственное всплывающее меню, переопределите эту функцию и верните вновь созданное всплывающее меню. Владение всплывающим меню передается вызвавшему объекту.

Смотрите также addDockWidget(), addToolBar() и menuBar().

Qt::DockWidgetArea QMainWindow::dockWidgetArea ( QDockWidget * dockwidget ) const

Возвращает область Qt::DockWidgetArea, в которой содержится dockwidget. Если dockwidget не был добавлен в главное окно, эта функция вернет Qt::NoDockWidgetArea.

Смотрите также addDockWidget(), splitDockWidget() и Qt::DockWidgetArea.

bool QMainWindow::event ( QEvent * event ) [virtual protected]

Переопределено от QObject::event().

void QMainWindow::iconSizeChanged ( const QSize & iconSize ) [signal]

Этот сигнал посылается, когда изменяется размер значков, использующихся в окне. Новый размер значков передается в iconSize.

Вы можете соединить этот сигнал с другими компонентами, чтобы помочь вашему приложению сохранять надлежащий вид.

Смотрите также setIconSize().

void QMainWindow::insertToolBar ( QToolBar * before, QToolBar * toolbar )

Вставляет панель инструментов toolbar перед панелью before, в область, занимаемую панелью before. Например, если принято размещать элементы слева направо, то toolbar будет размещена слева от панели инструментов before, в горизонтальной области.

Смотрите также insertToolBarBreak(), addToolBar() и addToolBarBreak().

void QMainWindow::insertToolBarBreak ( QToolBar * before )

Вставляет разрыв перед панелью before.

QMenuBar * QMainWindow::menuBar () const

Возвращает панель меню для главного окна. Эта функция создает и возвращает пустую панель меню, если панель не существует.

Если вы хотите, чтобы все окна в Mac-приложении использовали общую панель меню, не используйте эту функцию, чтобы создавать её, потому что панель меню, созданная здесь будет иметь этот экземпляр QMainWindow в качестве родителя. Вместо этого, вы должны создать панель меню не имеющую родителя, которую вы можете, затем, сделать общей среди всех Mac-окон. Создайте панель меню без родителя таким способом:

 QMenuBar *menuBar = new QMenuBar(0);

Смотрите также setMenuBar().

QWidget * QMainWindow::menuWidget () const

Возвращает панель меню для главного окна. Эта функция возвращает null, если панель меню еще не создана.

Эта функция была введена в Qt 4.2.

Смотрите также setMenuWidget().

void QMainWindow::removeDockWidget ( QDockWidget * dockwidget )

Удаляет dockwidget из компоновщика главного окна и скрывает его. Заметьте, что dockwidget не удаляется.

void QMainWindow::removeToolBar ( QToolBar * toolbar )

Удаляет панель инструментов toolbar из компоновщика главного окна и скрывает его. Заметьте, что toolbar не удаляется.

void QMainWindow::removeToolBarBreak ( QToolBar * before )

[FIXME] Удаляет разрыв панели инструментов, вставленный перед панелью before.

bool QMainWindow::restoreDockWidget ( QDockWidget * dockwidget )

Восстанавливает состояние dockwidget, если он создан после вызова функции restoreState(). Возвращает true, если состояние было восстановлено; в противном случае возвращает false.

Смотрите также restoreState() и saveState().

bool QMainWindow::restoreState ( const QByteArray & state, int version = 0 )

Восстанавливает состояние state панелей инструментов и прикрепляемых виджетов этого главного окна. Номер версии (version) сравнивается с тем, что сохранен в state. Если они не соответствуют, состояние главного окна остаётся неизменным, и эта функция вернёт false; в противном случае, состояние восстанавливается, и эта функция вернёт true.

Для восстановления геометрии, сохраненной с использованием QSettings, вы можете использовать примерно такой код:

 void MainWindow::readSettings()
 {
     QSettings settings("MyCompany", "MyApp");
     restoreGeometry(settings.value("myWidget/geometry").toByteArray());
     restoreState(settings.value("myWidget/windowState").toByteArray());
 }

Смотрите также saveState(), QWidget::saveGeometry(), QWidget::restoreGeometry() и restoreDockWidget().

QByteArray QMainWindow::saveState ( int version = 0 ) const

Сохраняет текущее состояние панелей инструментов и прикрепляемых виджетов главного окна. Номер версии (version) сохраняется как часть данных.

Свойство objectName используется для идентификации каждого QToolBar и QDockWidget. Вы должны быть уверены, что это свойство уникально для каждого QToolBar'а и QDockWidget'а, которые вы добавляете в QMainWindow

Для восстановления сохраненного состояния, передайте возвращённое значение и номер версии (version) в функцию restoreState().

Для сохранения геометрии при закрытии окна вы можете реализовать событие закрытия, например, так:

 void MyMainWindow::closeEvent(QCloseEvent *event)
 {
     QSettings settings("MyCompany", "MyApp");
     settings.setValue("geometry", saveGeometry());
     settings.setValue("windowState", saveState());
     QMainWindow::closeEvent(event);
 }

Смотрите также restoreState(), QWidget::saveGeometry() и QWidget::restoreGeometry().

void QMainWindow::setCentralWidget ( QWidget * widget )

Устанавливает заданный виджет (widget), в качестве центрального виджета главного окна.

Замечание: QMainWindow становится владельцем объекта, на который указывает widget, и удаляет его в соответствующий момент.

Смотрите также centralWidget().

void QMainWindow::setCorner ( Qt::Corner corner, Qt::DockWidgetArea area )

Устанавливает заданную область (area) прикрепления виджета, чтобы занять указанный угол corner.

Смотрите также corner().

void QMainWindow::setMenuBar ( QMenuBar * menuBar )

Устанавливает в главном окне панель меню menuBar.

Замечание: QMainWindow становится владельцем объекта, на который указывает menuBar, и удаляет его в соответствующий момент.

Смотрите также menuBar().

void QMainWindow::setMenuWidget ( QWidget * menuBar )

Устанавливает в главном окне панель меню menuBar.

QMainWindow становится владельцем объекта, на который указывает menuBar, и удаляет его в соответствующий момент.

Эта функция была введена в Qt 4.2.

Смотрите также menuWidget().

void QMainWindow::setStatusBar ( QStatusBar * statusbar )

Устанавливает в главном окне строку состояния statusbar.

Установка строки состояния в 0 удалит её из главного окна. Замечание: QMainWindow становится владельцем объекта, на который указывает statusbar, и удаляет его в соответствующий момент.

Смотрите также statusBar().

void QMainWindow::setTabPosition ( Qt::DockWidgetAreas areas, QTabWidget::TabPosition tabPosition )

Устанавливает позицию вкладки для заданного присоединяемого виджета areas равной заданной tabPosition. По умолчанию все области пристыковки показывают свои вкладки внизу.

Замечание: Опция присоединения VerticalTabs заменяет позиции вкладки, установленной этим методом.

Эта функция была введена в Qt 4.5.

Смотрите также tabPosition() и setTabShape().

void QMainWindow::splitDockWidget ( QDockWidget * first, QDockWidget * second, Qt::Orientation orientation )

Разделяет пространство, охватываемое прикрепляемым виджетом first на две части, перемещает прикрепляемый виджет first в первую часть, а прикрепляемый виджет second во вторую часть.

Аргумент orientation определяет, как разделяется пространство: Qt::Horizontal разделяет пространство второго виджета справа от первого; Qt::Vertical разделяет пространство второго виджета ниже первого.

Замечание: если first в данный момент прикреплен в виде вкладки, то second будет добавлен как новая вкладка, а не как сосед виджета first. Это происходит из-за того, что одна вкладка может содержать только один прикрепляемый виджет.

Замечание: Qt::LayoutDirection влияет на порядок расположения прикрепляемых виджетов в двух частях разделённой области. Когда разрешена компоновка с расположением справа налево, размещение прикрепляемых виджетов осуществляется в обратную сторону.

Смотрите также tabifyDockWidget(), addDockWidget() и removeDockWidget().

QStatusBar * QMainWindow::statusBar () const

Возвращает строку состояния главного окна. Эта функция создает и возвращает пустую строку состояния, если она не существует.

Смотрите также setStatusBar().

QTabWidget::TabPosition QMainWindow::tabPosition ( Qt::DockWidgetArea area ) const

Возвращает позицию вкладки для area.

Замечание: Опция присоединения VerticalTabs заменяет позиции вкладки, возвращаемые этой функцией.

Эта функция была введена в Qt 4.5.

Смотрите также setTabPosition() и tabShape().

QList<QDockWidget *> QMainWindow::tabifiedDockWidgets ( QDockWidget * dockwidget ) const

Возвращает присоединяемые виджеты, чьи вкладки изменяются вместе с dockwidget.

Эта функция была введена в Qt 4.5.

Смотрите также tabifyDockWidget().

void QMainWindow::tabifyDockWidget ( QDockWidget * first, QDockWidget * second )

Помещает прикрепляемый виджет second над виджетом first, создавая в главном окне область прикрепления со вкладками.

Смотрите также tabifiedDockWidgets().

Qt::ToolBarArea QMainWindow::toolBarArea ( QToolBar * toolbar ) const

Возвращает Qt::ToolBarArea для toolbar. Если панель toolbar не была добавлена в главное окно, эта функция вернет Qt::NoToolBarArea.

Смотрите также addToolBar(), addToolBarBreak() и Qt::ToolBarArea.

bool QMainWindow::toolBarBreak ( QToolBar * toolbar ) const

Возвращает, имеется ли разрыв перед панелью toolbar.

Смотрите также addToolBarBreak() и insertToolBarBreak().

void QMainWindow::toolButtonStyleChanged ( Qt::ToolButtonStyle toolButtonStyle ) [signal]

Этот сигнал посылается, когда меняется стиль, используемый для кнопок панели инструментов. Новый стиль передается в параметре toolButtonStyle.

Вы можете соединить этот сигнал с другими компонентами, чтобы помочь вашему приложению сохранять надлежащий вид.

Смотрите также setToolButtonStyle().