#include <QApplication>

 CApaApplication *myApplicationFactory();

 QSize MyWidget::sizeHint() const
 {
     return QSize(80, 25).expandedTo(QApplication::globalStrut());
 }

 if ((startPos - currentPos).manhattanLength() >=
         QApplication::startDragDistance())
     startTheDrag();

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

QApplication::QApplication ( int & argc, char ** argv )

Инициализирует оконную систему и создаёт объект приложения с argc параметрами командной строки в argv.

Предупреждение: Данные, упомянутые в argc и argv, должны быть допустимыми в течение всего срока жизни объекта QApplication. Кроме того, argc должен быть больше, чем ноль, а argv должен содержать как минимум одну действительную символьную строку.

Глобальный указатель qApp ссылается на этот объект приложения. Должен быть создан только один объект приложения.

Этот объект приложения должен быть создан перед любыми устройствами рисования (включая виджеты, растровые и битовые изображения и т.д.).

Замечание: argc и argv могут быть изменены, поскольку Qt удаляет параметры командной строки, которые распознаёт.

Отладочные параметры Qt (недоступны, если Qt была скомпилирована без определения флага QT_DEBUG):

• -nograb, сообщает Qt, что она никогда не должна захватывать мышь или клавиатуру.
• -dograb (только под X11), работа под отладчиком может вызвать неявный -nograb, используйте -dograb для переопределения.
• -sync (только под X11), переключает в синхронный режим для отладки.

Для более детальных пояснений смотрите Техники отладки.

Все программы Qt автоматически поддерживают следующие параметры командной строки:

• -style= style, устанавливает стиль ГПИ приложения. Возможные значения: motif, windows и platinum. Если вы собрали Qt с дополнительными стилями или имеете дополнительные стили как подключаемые модули, то они будут доступны через параметр -style командной строки.
• -style style, то же самое, что и перечисленная выше.
• -stylesheet= stylesheet, устанавливает таблицу стилей styleSheet приложения. Значение должно быть путём к файлу, содержащему таблицу стилей. Замечание: Относительные URL в файле таблицы стилей рассчитываются относительно пути файла таблицы стилей.
• -stylesheet stylesheet, то же самое, что и перечисленная выше.
• -session= session, восстанавливает приложение из более раннего сеанса session.
• -session session, то же самое, что и перечисленная выше.
• -widgetcount, печать отладочного сообщения по завершении о количестве виджетов, оставшихся неразрушенными, и максимальном количестве виджетов, существовавших в одно и то же время
• -reverse, устанавливает направление компоновки приложения в Qt::RightToLeft
• -graphicssystem, устанавливает средство, которое будет использовано для экранных виджетов и QPixmap. Доступные параметры: raster и opengl.
• -qmljsdebugger=, активизирует отладчик QML/JS с указанным портом. Значение должно быть в формате port:1234[,block], где block является опциональным и заставит приложение ждать подсоединения отладчика.

Версия X11 Qt поддерживает некоторые традиционные для X11 параметры командной строки:

• -display display, устанавливает X-дисплей (по умолчанию $DISPLAY).
• -geometry geometry, устанавливает геометрию клиента для первого окна, которое будет отображено.
• -fn или -font font, определяет шрифт приложения. Шрифт должен быть указан при помощи логического описания X-шрифтов. Заметьте, что этот параметр игнорируется, когда Qt собран с включённой поддержкой fontconfig.
• -bg или -background color, устанавливает фоновый цвет и палитру приложения по умолчанию (светлые и тёмные оттенки рассчитываются).
• -fg или -foreground color, устанавливает цвет переднего плана по умолчанию.
• -btn или -button color, устанавливает цвет кнопок по умолчанию.
• -name name, устанавливает название приложения.
• -title title, устанавливает заголовок приложения.
• -visual TrueColor, заставляет приложение использовать отображение TrueColor на 8-битных дисплеях.
• -ncols count, ограничивает количество цветов, выделяемых в цветовом кубе на 8-битных дисплеях, если приложение использует спецификацию цвета QApplication::ManyColor. Если количество count равно 216, то используется цветовой куб 6x6x6 (т.е. 6 уровней красного, 6 - зелёного и 6 - синего); для других значений используется куб, приблизительно пропорциональный 2x3x1.
• -cmap, заставляет приложение установить частную цветовую карту на 8-битных дисплеях.
• -im, устанавливает сервер метода ввода (эквивалентно установке переменной окружения XMODIFIERS)
• -inputstyle, определяет, как вводимые данные будут вставляться в заданный виджет, например, onTheSpot заставляет вводимые данные появляться непосредственно в виджете в то время как overTheSpot заставляет ввод появляться в поле, плавающем над виджетом, и не вставляться до тех пор, пока редактирование не завершено.

Замечания X11

Если QApplication не удаётся открыть X11-дисплей, то он завершает процесс. Это поведение согласуется с большинством приложений X11.

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

QApplication::QApplication ( int & argc, char ** argv, bool GUIenabled )

Создаёт объект приложения с argc параметрами командной строки в argv. Если GUIenabled равен true, то создаётся приложение с ГПИ, в противном случае создаётся приложение без ГПИ (консольное).

Предупреждение: Данные, упомянутые в argc и argv, должны быть допустимыми в течение всего срока жизни объекта QApplication. Кроме того, argc должен быть больше, чем ноль, а argv должен содержать как минимум одну действительную символьную строку.

Установите GUIenabled в false для программ без графического пользовательского интерфейса, которые должны работать без оконной системы.

В X11 оконная система инициализируется, если GUIenabled равен true. Если GUIenabled равен false, то приложение не подсоединяется к X-серверу. В Windows и Mac OS оконная система в настоящее время всегда инициализируется, независимо от значения GUIenabled. Это может измениться в будущих версиях Qt.

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

 int main(int argc, char **argv)
 {
 #ifdef Q_WS_X11
     bool useGUI = getenv("DISPLAY") != 0;
 #else
     bool useGUI = true;
 #endif
     QApplication app(argc, argv, useGUI);

     if (useGUI) {
        // запуск версии с ГПИ
        ...
     } else {
        // запуск версии без ГПИ
        ...
     }
     return app.exec();
 }

QApplication::QApplication ( int & argc, char ** argv, Type type )

Создаёт объект приложения с argc параметрами командной строки в argv.

Предупреждение: Данные, упомянутые в argc и argv, должны быть допустимыми в течение всего срока жизни объекта QApplication. Кроме того, argc должен быть больше, чем ноль, а argv должен содержать как минимум одну действительную символьную строку.

Qt для встраиваемых Linux-систем, получая QApplication::GuiServer для типа type, делает это приложение сервером (эквивалентно запуску с параметром -qws).

QApplication::QApplication ( Display * display, Qt::HANDLE visual = 0, Qt::HANDLE colormap = 0 )

Создаёт приложение при наличии уже открытого дисплея display. Если visual и colormap не равны нулю, то приложение будет использовать эти значения в качестве контекстов Visual и Colormap по умолчанию.

Предупреждение: Qt поддерживает только отображение TrueColor как глубину, большую, чем 8 бит на пиксел.

Эта функция доступна только под X11.

QApplication::QApplication ( Display * display, int & argc, char ** argv, Qt::HANDLE visual = 0, Qt::HANDLE colormap = 0 )

Создаёт приложение при наличии уже открытого дисплея display и использует argc параметров командной строки из argv. Если visual и colormap не равны нулю, то приложение будет использовать эти значения в качестве контекстов Visual и Colormap по умолчанию.

Предупреждение: Qt поддерживает только отображение TrueColor как глубину, большую, чем 8 бит на пиксел.

Эта функция доступна только под X11.

QApplication::QApplication ( QApplication::QS60MainApplicationFactory factory, int & argc, char ** argv )

Создаёт приложение при помощи фабрики приложения, заданной в factory, и использует argc параметров командной строки из argv. factory может завершиться (leaving), но ошибка будет преобразована в стандартное исключение.

Эта функция доступна только в S60.

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

QApplication::~QApplication () [virtual]

Очищает все ресурсы оконной системы, которые были выделены этим приложением. Устанавливает глобальную переменную qApp в 0.

void QApplication::aboutQt () [static slot]

Отображает простое окно сообщения о Qt. Сообщение включает номер версии Qt, используемой приложением.

Это полезно для включения в меню Справка приложения, как показано в примере "Menus".

Эта функция является вспомогательным слотом для QMessageBox::aboutQt().

void QApplication::aboutToReleaseGpuResources () [signal]

Этот сигнал посылается, когда приложение собирается освободить все ресурсы GPU, связанные с контекстами, принадлежащими приложению.

Этот сигнал особенно полезен, если ваше приложение выделило ресурсы GPU напрямую, в обход Qt, и должно выполнить некоторую очистку в последнюю секунду.

Предупреждение: Этот сигнал посылается только в Symbian.

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

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

void QApplication::aboutToUseGpuResources () [signal]

Этот сигнал посылается, когда приложение собирается использовать ресурсы GPU.

Этот сигнал особенно полезен, если приложению необходимо знать, когда станут доступны ресурсы GPU.

Предупреждение: Этот сигнал посылается только в Symbian.

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

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

QWidget * QApplication::activeModalWidget () [static]

Возвращает активный модальный виджет.

Модальный виджет - это специальный виджет верхнего уровня, унаследованный от QDialog, в котором параметр модальности конструктора установлен в true. Модальный виджет должен быть закрыт перед тем, как пользователь сможет продолжить работу с другими частями программы.

Модальные виджеты организованы с стек. Эта функция возвращает активный модальный виджет вверху стека.

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

QWidget * QApplication::activePopupWidget () [static]

Возвращает активный всплывающий виджет.

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

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

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

QWidget * QApplication::activeWindow () [static]

Возвращает окно приложения верхнего уровня, которое имеет клавиатурный фокус ввода, или 0, если у приложения нет окон, имеющих фокус. Активное окно activeWindow() может существовать, даже если нет виджета с фокусом focusWidget(), например, если в окне нет виджетов, принимающих события от клавиатуры.

Смотрите также setActiveWindow(), QWidget::setFocus(), QWidget::hasFocus() и focusWidget().

void QApplication::alert ( QWidget * widget, int msec = 0 ) [static]

Отображает предупреждение для виджета widget, если окно не является активным. Предупреждение отображается msec миллисекунд. Если msec равен нулю (по умолчанию), то предупреждение отображается неопределённое время до тех пор, пока окно снова не станет активным.

В настоящее время эта функция ничего не делает в Qt для встраиваемых Linux-систем.

В Mac OS X это работает больше на уровне приложения и заставляет пиктограмму приложения подпрыгивать в панели Dock.

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

В X11 это окно будет помечено как "требующее внимания" ("demands attention"), окно не должно быть скрыто (т.е. на нём не должен быть вызвана hide(), а оно должно быть видимо при какой-то сортировке), чтобы это сработало.

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

QWidgetList QApplication::allWidgets () [static]

Возвращает список всех виджетов в приложении.

Список пустой (QList::isEmpty()), если виджетов нет.

Замечание: Некоторые виджеты могут быть скрыты.

Пример:

 void updateAllWidgets()
 {
     foreach (QWidget *widget, QApplication::allWidgets())
         widget->update();
 }

Смотрите также topLevelWidgets() и QWidget::isVisible().

void QApplication::beep () [static]

Издаёт звонок, используя громкость и звук по умолчанию. Эта функция не доступна в Qt для встраиваемых Linux-систем.

void QApplication::changeOverrideCursor ( const QCursor & cursor ) [static]

Изменяет текущее активное приложение, переопределяя курсор на cursor.

Эта функция не имеет эффекта, если не была вызвана setOverrideCursor().

Смотрите также setOverrideCursor(), overrideCursor(), restoreOverrideCursor() и QWidget::setCursor().

QClipboard * QApplication::clipboard () [static]

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

Замечание: Объект QApplication должен быть создан перед доступом к буферу обмена.

void QApplication::closeAllWindows () [static slot]

Закрывает все окна верхнего уровня.

Эта функция особенно полезна для большого количества окон верхнего уровня. Она может быть, например, соединена с элементом Exit в меню File:

     exitAct = new QAction(tr("E&xit"), this);
     exitAct->setShortcuts(QKeySequence::Quit);
     exitAct->setStatusTip(tr("Exit the application"));
     connect(exitAct, SIGNAL(triggered()), qApp, SLOT(closeAllWindows()));

Окна закрываются в произвольном порядке, пока одно окно не принимает событие закрытия. Приложение завершается, когда будет успешно закрыто последнее окно; это может быть отключено путём установки quitOnLastWindowClosed в false.

Смотрите также quitOnLastWindowClosed, lastWindowClosed(), QWidget::close(), QWidget::closeEvent(), lastWindowClosed(), quit(), topLevelWidgets() и QWidget::isWindow().

int QApplication::colorSpec () [static]

Возвращает цветовую спецификацию.

Смотрите также QApplication::setColorSpec().

void QApplication::commitData ( QSessionManager & manager ) [virtual]

Эта функция имеет дело с управлением сессиями. Она вызывается, когда QSessionManager хочет, чтобы приложение сохранило все свои данные.

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

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

Предупреждение: В этой функции невозможно никакое взаимодействие с пользователем, если вы явно не запросили у менеджера разрешения. Для получения подробной информации и примеров использования смотрите QSessionManager::allowsInteraction() и QSessionManager::allowsErrorInteraction().

Реализация по умолчанию запрашивает взаимодействие и отправляет событие закрытия всем видимым виджетам верхнего уровня. Если какое-либо из событий было отклонено, то отключение отменяется.

Смотрите также isSessionRestored(), sessionId(), saveState() и Управление сессиями.

void QApplication::commitDataRequest ( QSessionManager & manager ) [signal]

Этот сигнал имеет дело с управлением сессиями. Он посылается, когда QSessionManager хочет, чтобы приложение сохранило все его данные.

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

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

Предупреждение: В этом сигнале невозможно никакое взаимодействие с пользователем, если вы явно не запросили у менеджера разрешения. Для получения подробной информации и примеров использования смотрите QSessionManager::allowsInteraction() и QSessionManager::allowsErrorInteraction().

Замечание: Вы должны использовать Qt::DirectConnection, когда подключаетесь к этому сигналу.

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

Смотрите также isSessionRestored(), sessionId(), saveState() и Управление сессиями.

QDesktopWidget * QApplication::desktop () [static]

Возвращает виджет рабочего стола (также называемый корневым окном).

Рабочий стол может состоять из нескольких экранов, так что было бы некорректно, например, пытаться центрировать какой-то виджет по геометрии рабочего стола. QDesktopWidget имеет различные функции для получения полезных геометрий рабочего стола, такие, как QDesktopWidget::screenGeometry() и QDesktopWidget::availableGeometry().

В X11 он также позволяет рисовать на рабочем столе.

bool QApplication::desktopSettingsAware () [static]

Возвращает true, если Qt настроена на использование стандартных цветов, шрифтов и т.д.; в противном случае возвращает false. Значение по умолчанию - true.

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

bool QApplication::event ( QEvent * e ) [virtual protected]

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

int QApplication::exec () [static]

Входит в главный цикл обработки событий и ждёт до тех пор, пока не будет вызвана exit(), затем возвращает значение, которое было установлено в exit() (которое равно 0, если exit() вызвана через quit()).

Эту функцию необходимо вызвать, чтобы начать обработку событий. Главный цикл обработки событий принимает события от оконной системы и отправляет их виджетам приложения.

Обычно не может происходить никакого взаимодействия с пользователем до вызова exec(). В особых случаях до вызова exec() могут быть использованы модальные виджеты, такие как QMessageBox, поскольку модальные виджеты вызывают exec() для запуска локального цикла обработки событий.

Чтобы подготовить ваше приложение для обработки во время простоя, т.е. выполнения специальной функции в то время, как нет никаких событий, используйте QTimer с таймаутом 0. Более продвинутые схемы обработки бездействия могут быть достигнуты с помощью processEvents().

Мы рекомендуем вам подсоединять код очистки к сигналу aboutToQuit(), вместо размещения его в функции main() вашего приложения. Это необходимо потому, что на некоторых платформах вызов QApplication::exec() может не вернуть управление. Например, на платформе Windows, когда пользователь выходит из системы, система завершает процесс после того, как Qt закрывает все окна верхнего уровня. Следовательно, нет никаких гарантий, что у приложения будет время для выхода их его цикла обработки событий и выполнения кода в конце функции main(), после вызова QApplication::exec().

Смотрите также quitOnLastWindowClosed, quit(), exit(), processEvents() и QCoreApplication::exec().

void QApplication::focusChanged ( QWidget * old, QWidget * now ) [signal]

Этот сигнал посылается, когда виджет, имеющий фокус ввода с клавиатуры, изменяется со старого old на текущий now, поскольку пользователь нажал клавишу Tab, щёлкнул на виджете или изменил активное окно. Как old, так и now могут быть нулевыми указателями.

Сигнал посылается после того, как оба виджета были уведомлены об изменении посредством QFocusEvent.

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

Смотрите также QWidget::setFocus(), QWidget::clearFocus() и Qt::FocusReason.

QWidget * QApplication::focusWidget () [static]

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

Смотрите также QWidget::setFocus(), QWidget::hasFocus(), activeWindow() и focusChanged().

QFont QApplication::font () [static]

Возвращает шрифт приложения по умолчанию.

Смотрите также setFont(), fontMetrics() и QWidget::font().

QFont QApplication::font ( const QWidget * widget ) [static]

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

Возвращает шрифт по умолчанию для виджета widget.

Смотрите также fontMetrics() и QWidget::setFont().

QFont QApplication::font ( const char * className ) [static]

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

Возвращает шрифт виджета с заданным именем класса className.

Смотрите также setFont() и QWidget::font().

void QApplication::fontDatabaseChanged () [signal]

Этот сигнал посылается, когда шрифт приложения загружается или удаляется.

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

Смотрите также QFontDatabase::addApplicationFont(), QFontDatabase::addApplicationFontFromData(), QFontDatabase::removeAllApplicationFonts() и QFontDatabase::removeApplicationFont().

QFontMetrics QApplication::fontMetrics () [static]

Возвращает метрики шрифта дисплея (экрана) для заданного шрифта приложения.

Смотрите также font(), setFont(), QWidget::fontMetrics() и QPainter::fontMetrics().

QInputContext * QApplication::inputContext () const

Возвращает экземпляр QInputContext, используемый приложением.

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

bool QApplication::isEffectEnabled ( Qt::UIEffect effect ) [static]

Возвращает true, если эффект effect включён; в противном случае возвращает false.

По умолчанию Qt пытается использовать настройки рабочего стола. Чтобы предотвратить это, вызовите setDesktopSettingsAware(false).

Замечание: Все эффекты отключены на экранах, работающих с менее, чем 16-битной глубиной цвета.

Смотрите также setEffectEnabled() и Qt::UIEffect.

bool QApplication::isLeftToRight () [static]

Возвращает true, если направление компоновки приложения равно Qt::LeftToRight; в противном случае возвращает false.

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

bool QApplication::isRightToLeft () [static]

Возвращает true, если направление компоновки приложения равно Qt::RightToLeft; в противном случае возвращает false.

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

bool QApplication::isSessionRestored () const

Возвращает true, если приложение было восстановлено из более ранней сессии; в противном случае возвращает false.

Смотрите также sessionId(), commitData() и saveState().

Qt::LayoutDirection QApplication::keyboardInputDirection () [static]

Возвращает текущее направление ввода с клавиатуры.

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

QLocale QApplication::keyboardInputLocale () [static]

Возвращает текущую локаль ввода с клавиатуры.

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

Qt::KeyboardModifiers QApplication::keyboardModifiers () [static]

Возвращает текущее состояние клавиш-модификаторов на клавиатуре. Текущее состояние обновляется синхронно, как только очередь событий освобождается от событий, которые самопроизвольно изменяют состояние клавиатуры (события QEvent::KeyPress и QEvent::KeyRelease).

Следует отметить, что она не может отразить фактическое состояние клавиш на устройстве ввода во время вызова, но скорее отражает модификаторы, о которых было сообщено в последний раз в одном из вышеуказанных событий. Если никакие клавиши не удерживаются, то возвращается Qt::NoModifier.

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

bool QApplication::keypadNavigationEnabled () [static]

Эта функция устарела.

Возвращает true, если Qt настроена на использование дополнительной клавиатуры для навигации; в противном случае возвращает false. Значение по умолчанию равно true на Symbian и false на других платформах.

Это свойство доступно только в Qt для встраиваемых Linux-систем, Symbian и Windows CE.

Замечание: На Windows CE это свойство по умолчанию выключено для mkspec сенсорных устройств. Для включения навигации с дополнительной клавиатуры соберите Qt с определением QT_KEYPAD_NAVIGATION.

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

void QApplication::lastWindowClosed () [signal]

Этот сигнал посылается из QApplication::exec(), когда закрывается последнее видимое первичное окно (т.е. окно без родителя) с установленным свойством Qt::WA_QuitOnClose.

По умолчанию

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

Это свойство может быть отключено установкой quitOnLastWindowClosed в false.

Смотрите также QWidget::close().

bool QApplication::macEventFilter ( EventHandlerCallRef caller, EventRef event ) [virtual]

Предупреждение: Эта виртуальная функция используется только под Mac OS X и ведёт себя по разному в зависимости от того, основывается Qt на Carbon или Cocoa.

Для Carbon-порта, если вы создаёте приложение, которое наследуется от QApplication, и переопределяете эту функцию, то вы получаете прямой доступ ко всем событиям Carbon, которые регистрирует Qt от Max OS X с этой функцией, вызываемой с параметрами caller и event.

Для Cocoa-порта, если вы создаёте приложение, которое наследуется от QApplication, и переопределяете эту функцию, то вы получаете прямой доступ ко всем событиям Cocoa, которые получает Qt от Max OS X с этой функцией, вызываемой с параметрами caller и event, являющимся указателем NSEvent:

NSEvent *e = reinterpret_cast<NSEvent *>(event);

Верните true, если вы хотите остановить обработку события. Верните false для нормальной диспетчеризации события. Реализация по умолчанию возвращает false.

Qt::MouseButtons QApplication::mouseButtons () [static]

Возвращает текущее состояние кнопок мыши. Текущее состояние обновляется синхронно, как только очередь событий освобождается от событий, которые самопроизвольно изменяют состояние мыши (события QEvent::MouseButtonPress и QEvent::MouseButtonRelease).

Следует отметить, что она не может отразить фактическое состояние кнопок на устройстве ввода во время вызова, но скорее отражает кнопки мыши, о которых было сообщено в последний раз в одном из вышеуказанных событий. Если никакие кнопки не удерживаются, то возвращается Qt::NoButton.

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

Qt::NavigationMode QApplication::navigationMode () [static]

Возвращает используемый вид перемещения фокуса ввода в Qt.

Это свойство доступно только в Qt для встраиваемых Linux-систем, Symbian и Windows CE.

Замечание: На Windows CE это свойство по умолчанию выключено для mkspec сенсорных устройств. Для включения навигации с дополнительной клавиатуры соберите Qt с определением QT_KEYPAD_NAVIGATION.

Замечание: На Symbian режимом по умолчанию является Qt::NavigationModeNone для сенсорных устройств и Qt::NavigationModeKeypadDirectional.

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

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

bool QApplication::notify ( QObject * receiver, QEvent * e ) [virtual]

Переопределено от QCoreApplication::notify().

QCursor * QApplication::overrideCursor () [static]

Возвращает активный переопределённый курсор приложения.

Эта функция возвращает 0, если курсор приложения не был определён (т.е. внутренний стек курсоров пуст).

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

QPalette QApplication::palette () [static]

Возвращает палитру приложения.

Смотрите также setPalette() и QWidget::palette().

QPalette QApplication::palette ( const QWidget * widget ) [static]

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

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

Смотрите также setPalette() и QWidget::palette().

QPalette QApplication::palette ( const char * className ) [static]

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

Возвращает палитру для виджета с заданным именем класса className.

Смотрите также setPalette() и QWidget::palette().

Qt::KeyboardModifiers QApplication::queryKeyboardModifiers () [static]

Запрашивает и возвращает состояние клавиш-модификаторов на клавиатуре. В отличие от keyboardModifiers этот метод возвращает фактические клавиши, нажатые на устройстве ввода во время вызова метода.

Он не полагается на события нажатия клавиш, полученных этим процессом, что позволяет проверить модификаторы во время перемещения окна, например. Заметьте, что в большинстве случаев вы должны использовать keyboardModifiers(), которая быстрее и более точна, поскольку она содержит состояние модификаторов на момент обработки текущего полученного события.

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

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

QDecoration & QApplication::qwsDecoration () [static]

Возвращает используемый для украшения окон QWSDecoration.

Предупреждение: Этот метод не является переносимым. Он доступен только в Qt для встраиваемых Linux-систем.

Смотрите также QDecoration.

bool QApplication::qwsEventFilter ( QWSEvent * event ) [virtual]

Эта виртуальная функция реализована только в Qt для встраиваемых Linux-систем.

Если вы создаёте приложение, которое наследуется от QApplication, и переопределяете эту функцию, то вы получаете прямой доступ ко всем событиям QWS (Q Window System), которые поступают из основного процесса QWS. События передаются в параметре event.

Верните true, если вы хотите остановить обработку события. Верните false для нормальной диспетчеризации события. Реализация по умолчанию возвращает false.

void QApplication::qwsSetCustomColors ( QRgb * colorTable, int start, int numColors )

Устанавливает пользовательскую таблицу цветов в Qt для встраиваемых Linux-систем.

Qt для встраиваемых Linux-систем на 8-битных дисплеях выделяет стандартный 216-цветный куб. Оставшиеся 40 цветов могут быть использованы для настройки пользовательской таблицы цветов в основном процессе QWS перед подключением любых клиентов.

Цветовая таблица colorTable - это массив до 40 пользовательских цветов. start - это начальный индекс (0-39), а numColors - количество цветов для установки (1-40).

Этот метод не является переносимым. Он доступен только в Qt для встраиваемых Linux-систем.

Замечание: Пользовательские цвета не будут использоваться драйвером экрана по умолчанию. Для того чтобы использовать новые цвета, реализуйте пользовательский экранный драйвер или используйте QDirectPainter.

void QApplication::qwsSetDecoration ( QDecoration * decoration ) [static]

Устанавливает производный класс QDecoration, чтобы использовать для украшения окон, используемых Qt для встраиваемых Linux-систем, заданным оформлением decoration.

Этот метод не является переносимым. Он доступен только в Qt для встраиваемых Linux-систем.

Смотрите также QDecoration.

QDecoration * QApplication::qwsSetDecoration ( const QString & decoration ) [static]

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

Запрашивает объект QDecoration для оформления decoration из QDecorationFactory.

Строка должна быть одной из QDecorationFactory::keys(). Ключи нечувствительны к регистру.

Более поздний вызов конструктора QApplication переопределит запрошенный стиль, если в параметрах командной строки будет указана опция "-style".

Возвращает 0, если принято неизвестное оформление decoration, в противном случае возвращённый объект QStyle будет установлен как стиль ГПИ приложения.

void QApplication::restoreOverrideCursor () [static]

Отменяет последний setOverrideCursor().

Если setOverrideCursor() был вызван дважды, то вызов restoreOverrideCursor() активирует первый установленный курсор. Вызов этой функции во второй раз восстанавливает исходный курсор виджетов.

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

void QApplication::saveState ( QSessionManager & manager ) [virtual]

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

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

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

Предупреждение: В этой функции невозможно никакое взаимодействие с пользователем, если вы явно не запросили у менеджера разрешения. Для получения подробной информации смотрите QSessionManager::allowsInteraction() и QSessionManager::allowsErrorInteraction().

Смотрите также isSessionRestored(), sessionId(), commitData() и Управление сессиями.

void QApplication::saveStateRequest ( QSessionManager & manager ) [signal]

Этот сигнал имеет дело с управлением сессиями. Вызывается, когда менеджер сессии хочет, чтобы приложение сохранило своё состояние для будущих сессий.

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

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

Предупреждение: В этой функции невозможно никакое взаимодействие с пользователем, если вы явно не запросили у менеджера разрешения. Для получения подробной информации смотрите QSessionManager::allowsInteraction() и QSessionManager::allowsErrorInteraction().

Замечание: Вы должны использовать Qt::DirectConnection, когда подключаетесь к этому сигналу.

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

Смотрите также isSessionRestored(), sessionId(), commitData() и Управление сессиями.

QString QApplication::sessionId () const

Возвращает текущий идентификатор сессии.

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

Смотрите также isSessionRestored(), sessionKey(), commitData() и saveState().

QString QApplication::sessionKey () const

Возвращает ключ сессии в текущей сессии.

Если приложение было восстановлено из более ранней сессии, то этот ключ является таким же, что и в предыдущей сессии.

Ключ сессии изменяется с каждым вызовом commitData() или saveState().

Смотрите также isSessionRestored(), sessionId(), commitData() и saveState().

void QApplication::setActiveWindow ( QWidget * active ) [static]

Устанавливает активным окном виджет active в ответ на системное событие. Эта функция вызывается из платформо-зависимых обработчиков событий.

Предупреждение: Эта функция не устанавливает фокус ввода с клавиатуры в активный виджет. Вызывайте вместо этого QWidget::activateWindow().

Она устанавливает атрибуты activeWindow() и focusWidget() и посылает корректные события WindowActivate/WindowDeactivate и FocusIn/FocusOut всем связанным виджетам. Затем окно будет перерисовано в активном состоянии (например, курсор в поле ввода будет мигать) и для него будут включены всплывающие подсказки.

Смотрите также activeWindow() и QWidget::activateWindow().

void QApplication::setColorSpec ( int spec ) [static]

Устанавливает цветовую спецификацию для приложения в spec.

Цветовая спецификация управляет тем, как приложение выделяет цвета, когда оно выполняется на дисплее с ограниченным количеством цетов, например, на 8-битном / 256-цветном дисплее.

Цветовая спецификация должна быть установлена до того, как вы создадите объект QApplication.

Опции:

• QApplication::NormalColor. Это стратегия выделения цвета по умолчанию. Используйте этот параметр, если ваше приложение использует кнопки, меню, текст и растровые изображения с небольшим количеством цветов. С этим параметром приложение использует глобальные системные цвета. Это отлично работает для большинства приложений под X11, но на платформе Windows это может вызвать размывание нестандартных цветов.
• QApplication::CustomColor. Используйте этот параметр, если вашему приложению необходимо малое количество пользовательских цветов. Под X11 этот параметр такой же, как и NormalColor. Под Windows Qt создаёт палитру Windows и выделяет цвета по запросу.
• QApplication::ManyColor. Используйте этот параметр, если ваше приложение очень жадное до цветов, например, оно требует тысяч цветов.
  Под X11 эффектом является:
  • Для 256-цветных дисплеев, которые имеют в лучшем случае 256 действительно отображаемых цветов, используется отображение по умолчанию, а цвета выбираются из цветового куба. Цветовой куб - это 6x6x6 (216 цветов) "Веб-палитра" (красный, зелёный и синий компоненты всегда имеют одно из следующих значений: 0x00, 0x33, 0x66, 0x99, 0xCC или 0xFF), но количество цветов может быть изменено с помощью параметра -ncols. Пользователь может заставить приложение использовать действительно видимые цвета с помощью параметра -visual.
  • Для 256-цветных дисплеев, которые имеют более 256 действительно видимых цветов, используется это отображение. Например, у X-серверов Silicon Graphics X это свойство. Они предоставляют 8-битное отображение по умолчанию, но могут предоставить полноцветное отображение по запросу.

  В Windows Qt создаёт палитру Windows и заполняет её цветовым кубом.

Учтите, что выбор CustomColor и ManyColor может привести к высвечиванию цветовой карты: приложение переднего плана получает (большинство) из доступных цветов, в то время как фоновые окна будут выглядеть менее привлекательно.

Пример:

 int main(int argc, char *argv[])
 {
     QApplication::setColorSpec(QApplication::ManyColor);
     QApplication app(argc, argv);
     ...
     return app.exec();
 }

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

void QApplication::setDesktopSettingsAware ( bool on ) [static]

Устанавливает, должен ли Qt использовать стандартные системные цвета, шрифты и т.д., в on. По умолчанию это равно true.

Эта функция должна вызываться перед созданием объекта QApplication, подобно этому:

 int main(int argc, char *argv[])
 {
     QApplication::setDesktopSettingsAware(false);
     QApplication app(argc, argv);
     ...
     return app.exec();
 }

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

void QApplication::setEffectEnabled ( Qt::UIEffect effect, bool enable = true ) [static]

Включает эффект effect пользовательского интерфейса, если enable равно true, в противном случае эффект не будет использоваться.

Замечание: Все эффекты отключены на экранах, работающих с менее, чем 16-битной глубиной цвета.

Смотрите также isEffectEnabled(), Qt::UIEffect и setDesktopSettingsAware().

void QApplication::setFont ( const QFont & font, const char * className = 0 ) [static]

Изменяет шрифт приложения по умолчанию на шрифт font. Если передано имя класса className, то изменения применяются только к классам, которые унаследованы от className (по данным QObject::inherits()).

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

Предупреждение: Не используйте эту функцию в сочетании с Таблицами стилей Qt. Шрифт приложения может быть настроен при помощи свойства таблицы стилей "font". Для установки жирного шрифта для всех QPushButton установите таблицу стилей styleSheet() приложения как "QPushButton { font: bold }"

Смотрите также font(), fontMetrics() и QWidget::setFont().

void QApplication::setGraphicsSystem ( const QString & system ) [static]

Устанавливает графическую серверную часть (backend) по умолчанию в system, которая будет использоваться для наэкранных виджетов и QPixmap. Доступные системы - "native", "raster" и "opengl".

Есть несколько способов установить графический сервер (backend), в порядке убывания приоритета:

• переключатель командной строки приложения -graphicssystem
• QApplication::setGraphicsSystem()
• переменная окружения QT_GRAPHICSSYSTEM
• переключатель конфигурации Qt -graphicssystem

Если переключатель наивысшего приоритета устанавливает недопустимое имя, то ошибка будет проигнорирована и будет установлен сервер по умолчанию.

Предупреждение: Эта функция эффективна только перед вызовом конструктора QApplication.

Замечание: Параметр "opengl" в настоящее время экспериментальный.

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

void QApplication::setInputContext ( QInputContext * inputContext )

Эта функция заменяет экземпляр QInputContext, используемый приложением, на inputContext.

Qt становится владельцем заданного inputContext

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

void QApplication::setNavigationMode ( Qt::NavigationMode mode ) [static]

Устанавливает вид навигации фокуса ввода, который должен использовать Qt, в режим mode.

Это свойство доступно только в Qt для встраиваемых Linux-систем, Symbian и Windows CE.

Замечание: На Windows CE это свойство по умолчанию выключено для mkspec сенсорных устройств. Для включения навигации с дополнительной клавиатуры соберите Qt с определением QT_KEYPAD_NAVIGATION.

Замечание: В Symbian установка режима в Qt::NavigationModeCursorAuto включит виртуальный курсор мыши на несенсорных устройствах, которые управляются клавишами курсора, если нет аналогового устройства указателя. На других платформах и на сенсорных устройствах оно имеет тот же самый смысл, что и Qt::NavigationModeNone.

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

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

void QApplication::setOverrideCursor ( const QCursor & cursor ) [static]

Устанавливает переопределённый курсор приложения в cursor.

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

Этот курсор будет отображаться во всех виджетах приложения до тех пор, пока не будет вызвана restoreOverrideCursor() или другая setOverrideCursor().

Курсоры приложения сохраняются во внутреннем стеке. setOverrideCursor() помещает курсор в стек, а restoreOverrideCursor() возвращает активный курсор из стека. changeOverrideCursor() изменяет текущий активный переопределённый курсор приложения.

Каждая setOverrideCursor() должна в конечном счёте сопровождаться соответствующей restoreOverrideCursor(), в противном случае стек никогда не будет очищен.

Пример:

 QApplication::setOverrideCursor(QCursor(Qt::WaitCursor));
 calculateHugeMandelbrot();              // время ланча...
 QApplication::restoreOverrideCursor();

Смотрите также overrideCursor(), restoreOverrideCursor(), changeOverrideCursor() и QWidget::setCursor().

void QApplication::setPalette ( const QPalette & palette, const char * className = 0 ) [static]

Изменяет палитру приложения по умолчанию на палитру palette.

Если принято имя класса className, то изменения применяются только к виджетам, которые унаследованы от className (по данным QObject::inherits()). Если className оставлен равным 0, то изменение влияет на все виджеты, отвергая таким образом любые предыдущие установки специфичных для классов палитр.

Палитра может быть изменена в соответствии с текущим стилем ГПИ в QStyle::polish().

Предупреждение: Не используйте эту функцию в сочетании с Таблицами стилей Qt. Когда используются таблицы стилей, палитра виджета может установить "цвет" (color), "цвет фона" (background-color), "цвет выделения" (selection-color), "цвет выделенного фона" (selection-background-color) и "дополнительный цвет фона" (alternate-background-color).

Замечание: Некоторые стили не используют палитру для всех отображений, например, если они используют собственные механизмы темы. Это случай стилей Windows XP, Windows Vista и Mac OS X.

Смотрите также QWidget::setPalette(), palette() и QStyle::polish().

void QApplication::setStyle ( QStyle * style ) [static]

Устанавливает стиль ГПИ приложения в стиль style. Владение объектом стиля передаётся QApplication, так что QApplication удалит объект стиля при выходе из приложения или при установке нового стиля, в то время как родителем старого стиля все ещё является объект приложения.

Пример использования:

 QApplication::setStyle(new QWindowsStyle);

Когда приложение переключает стили, палитра цветов устанавливается обратно в начальные цвета или в системные по умолчанию. Это необходимо, поскольку некоторые стили должны адаптировать цветовую палитру, чтобы быть полностью совместимыми с руководством по стилю.

Установка стиля перед тем, как была установлена палитра, т.е. перед созданием QApplication, заставит приложение использовать QStyle::standardPalette() для палитры.

Предупреждение: Таблицы стилей Qt в настоящее время не поддерживаются для пользовательских подклассов QStyle. Мы планируем вернуться к этому в одном из следующих релизов.

Смотрите также style(), QStyle, setPalette() и desktopSettingsAware().

QStyle * QApplication::setStyle ( const QString & style ) [static]

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

Возвращает объект QStyle для стиля style из QStyleFactory.

Строка должна быть одной из QStyleFactory::keys(), обычно одна из "windows", "motif", "cde", "plastique", "windowsxp" или "macintosh". Имена стилей нечувствительны к регистру.

Возвращает 0, если передан неизвестный стиль style, в противном случае возвращённый объект QStyle устанавливается как стиль ГПИ приложения.

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

QStyle * QApplication::style () [static]

Возвращает объект стиля приложения.

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

bool QApplication::symbianEventFilter ( const QSymbianEvent * event ) [virtual]

Предупреждение: Эта виртуальная функция доступна только в Symbian.

Если вы создаёте приложение, которое наследуется от QApplication, и переопределяете эту функцию, то вы получаете прямой доступ к событиям, которые поступают из Symbian. События передаются в параметре event.

Верните true, если вы хотите остановить обработку события. Верните false для нормальной диспетчеризации события. Реализация по умолчанию возвращает false и ничего не делает с событием event.

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

int QApplication::symbianProcessEvent ( const QSymbianEvent * event )

Предупреждение: Эта функция доступна только в Symbian.

Эта функция обрабатывает отдельное событие event Symbian. Она возвращает 1, если событие было обработано, 0, если событие event не было обработано, и -1, если событие не было обработано, поскольку событие неизвестно Qt.

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

void QApplication::syncX () [static]

Синхронизируется с X-сервером в реализации X11. Обычно это занимает некоторое время. Ничего не делает на других платформах.

QWidget * QApplication::topLevelAt ( const QPoint & point ) [static]

Возвращает виджет верхнего уровня в заданной точке point; возвращает 0, если нет такого виджета.

QWidget * QApplication::topLevelAt ( int x, int y ) [static]

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

Возвращает виджет верхнего уровня в точке (x, y); возвращает 0, если нет такого виджета.

QWidgetList QApplication::topLevelWidgets () [static]

Возвращает список виджетов (окон) верхнего уровня в приложении.

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

Пример:

 void showAllHiddenTopLevelWidgets()
 {
     foreach (QWidget *widget, QApplication::topLevelWidgets()) {
         if (widget->isHidden())
             widget->show();
     }
 }

Смотрите также allWidgets(), QWidget::isWindow() и QWidget::isHidden().

Type QApplication::type () [static]

Возвращает тип приложения (Tty, GuiClient или GuiServer). Тип устанавливается при создании объекта QApplication.

QWidget * QApplication::widgetAt ( const QPoint & point ) [static]

Возвращает виджет в глобальной экранной позиции point или 0, если там нет виджета Qt.

Эта функция может быть медленной.

Смотрите также QCursor::pos(), QWidget::grabMouse() и QWidget::grabKeyboard().

QWidget * QApplication::widgetAt ( int x, int y ) [static]

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

Возвращает виджет в глобальной экранной позиции (x, y) или 0, если там нет виджета Qt.

bool QApplication::x11EventFilter ( XEvent * event ) [virtual]

Предупреждение: Эта виртуальная функция реализована только под X11.

Если вы создаёте приложение, которое наследуется от QApplication, и переопределяете эту функцию, то вы получаете прямой доступ к событиям, которые поступают из X-сервера. События передаются в параметре event.

Верните true, если вы хотите остановить обработку события. Верните false для нормальной диспетчеризации события. Реализация по умолчанию возвращает false.

Это только непосредственно адресуемые сообщения, которые фильтруются. Вы должны установить фильтр событий непосредственно на диспетчер событий, который возвращается QAbstractEventDispatcher::instance(), для обработки всех системных событий.

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

int QApplication::x11ProcessEvent ( XEvent * event )

Эта функция выполняет основную обработку отдельных X-событий event, обычно направляя события Qt в правильном направлении.

Она возвращает 1, если событие прошло специальную обработку, 0, если событие event прошло нормальную обработку, и -1, если событие event было для неопределённого виджета.

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