Класс QStatusBar

Класс QStatusBar предоставляет горизонтальную строку состояния, подходящую для отображения информации о состоянии. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Свойства

• sizeGripEnabled : bool

• 59 свойств унаследовано от QWidget
• 1 свойство унаследовано от QObject

Открытые функции

• 214 открытых функций унаследовано от QWidget
• 31 открытая функция унаследовано от QObject
• 14 открытых функций унаследовано от QPaintDevice

Открытые слоты

• 19 открытых слотов унаследовано от QWidget
• 1 открытый слот унаследовано от QObject

Сигналы

• 3 сигнала унаследовано от QWidget
• 2 сигнала унаследовано от QObject

Статические открытые члены

• 5 статических открытых членов унаследовано от QWidget
• 9 статических открытых членов унаследовано от QObject

Защищённые функции

Переопределённые защищённые функции

• 35 защищённых функций унаследовано от QWidget
• 9 защищённых функций унаследовано от QObject
• 1 защищённая функция унаследовано от QPaintDevice

Дополнительные унаследованные члены

• 1 защищённый слот унаследовано от QWidget

Подробное описание

Класс QStatusBar предоставляет горизонтальную строку состояния, подходящую для отображения информации о состоянии.

Каждый индикатор состояния относится к одной из трёх категорий:

• Временный - кратковременно занимает большую часть строки состояния. Используется, например, для объяснения всплывающих подсказок или пунктов меню.
• Обычный - занимает часть строки состояния и может быть скрыт временными сообщениями. Используется, например, для отображения номера страницы и строки в текстовом редакторе.
• Постоянный - никогда не скрывается. Используется для важных индикаций режима, например, некоторые приложения помещают индикатор Caps Lock в строку состояния.

QStatusBar позволяет отображать все три типа индикаторов.

Как правило, запрос функциональности строки состояния происходит в связи с объектом QMainWindow. QMainWindow предоставляет главное окно приложения с меню, панелями инструментов, вкладками и строкой состояния вокруг большого центрального виджета. Строку состояния можно получить с помощью функции QMainWindow::statusBar() и заменить с помощью функции QMainWindow::setStatusBar().

Используйте слот showMessage(), чтобы отобразить временное сообщение:

void MainWindow::createStatusBar()
{
    statusBar()->showMessage(tr("Ready"));
}

Чтобы удалить временное сообщение, используйте слот clearMessage() или установите ограничение по времени при вызове showMessage(). Например:

void MainWindow::print()
{
#if QT_CONFIG(printdialog)
    QTextDocument *document = textEdit->document();
    QPrinter printer;

    QPrintDialog dlg(&printer, this);
    if (dlg.exec() != QDialog::Accepted) {
        return;
    }

    document->print(&printer);
    statusBar()->showMessage(tr("Ready"), 2000);
#endif
}

Используйте функцию currentMessage(), чтобы получить текущее отображаемое временное сообщение. Класс QStatusBar также предоставляет сигнал messageChanged(), который генерируется при каждом изменении временного сообщения состояния.

Обычные и постоянные сообщения отображаются путём создания небольшого виджета (QLabel, QProgressBar или даже QToolButton), а затем добавления его в строку состояния с помощью функции addWidget() или addPermanentWidget(). Используйте функцию removeWidget() для удаления таких сообщений из строки состояния.

statusBar()->addWidget(new MyReadWriteIndication);

По умолчанию QStatusBar предоставляет QSizeGrip в правом нижнем углу. Вы можете отключить его, используя функцию setSizeGripEnabled(). Используйте функцию isSizeGripEnabled() для определения текущего состояния маркёра размера.

См. также QMainWindow, QStatusTipEvent, Справочник по проектированию пользовательского интерфейса: Строка состояния и Пример приложения.

Документация по членам-функциям

QStatusBar::QStatusBar(QWidget *parent = nullptr)

Создаёт строку состояния с маркёром размера и заданным parent.

См. также setSizeGripEnabled().

[virtual] QStatusBar::~QStatusBar()

Удаляет эту строку состояния и освобождает все выделенные ресурсы и дочерние виджеты.

void QStatusBar::addPermanentWidget(QWidget *widget, int stretch = 0)

Добавляет данный widget постоянно в эту строку состояния, переродив виджет, если он не является уже дочерним элементом этого объекта QStatusBar. Параметр stretch используется для вычисления подходящего размера для данного widget при увеличении и уменьшении строки состояния. Значение по умолчанию для параметра stretch равно 0, т.е. виджету выделяется минимальное пространство.

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

См. также insertPermanentWidget(), removeWidget() и addWidget().

void QStatusBar::addWidget(QWidget *widget, int stretch = 0)

Добавляет данный widget в эту строку состояния, переродив виджет, если он не является уже дочерним элементом этого объекта QStatusBar. Параметр stretch используется для вычисления подходящего размера для данного widget при увеличении и уменьшении строки состояния. Значение по умолчанию для параметра stretch равно 0, т.е. виджету выделяется минимальное пространство.

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

См. также insertWidget(), removeWidget() и addPermanentWidget().

[slot] void QStatusBar::clearMessage()

Удаляет любое временное отображаемое сообщение.

См. также currentMessage(), showMessage() и removeWidget().

QString QStatusBar::currentMessage() const

Возвращает текущее временное сообщение, отображаемое, или пустую строку, если такое сообщение отсутствует.

См. также showMessage().

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

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

[protected] void QStatusBar::hideOrShow()

Обеспечивает, что правильные виджеты отображаются.

Используется функциями showMessage() и clearMessage().

int QStatusBar::insertPermanentWidget(int index, QWidget *widget, int stretch = 0)

Вставляет данный widget в указанный index постоянно в эту строку состояния, переродив виджет, если он не является уже дочерним элементом этого объекта QStatusBar. Если index выходит за пределы допустимого диапазона, виджет добавляется в конец (в этом случае возвращается фактический индекс виджета).

Параметр stretch используется для вычисления подходящего размера для данного widget при увеличении и уменьшении строки состояния. Значение по умолчанию для параметра stretch равно 0, т.е. виджету выделяется минимальное пространство.

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

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

См. также addPermanentWidget(), removeWidget() и addWidget().

int QStatusBar::insertWidget(int index, QWidget *widget, int stretch = 0)

Вставляет данный widget в указанный index в эту строку состояния, переродив виджет, если он не является уже дочерним элементом этого объекта QStatusBar. Если index выходит за пределы допустимого диапазона, виджет добавляется в конец (в этом случае возвращается фактический индекс виджета).

Параметр stretch используется для вычисления подходящего размера для данного widget при увеличении и уменьшении строки состояния. Значение по умолчанию для параметра stretch равно 0, т.е. виджету выделяется минимальное пространство.

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

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

См. также addWidget(), removeWidget() и addPermanentWidget().

[signal] void QStatusBar::messageChanged(const QString &message)

Этот сигнал излучается всякий раз, когда временное сообщение состояния изменяется. Новое временное сообщение передается в параметре message, которое является пустой строкой, когда сообщение удалено.

См. также showMessage() и clearMessage().

[override virtual protected] void QStatusBar::paintEvent(QPaintEvent *event)

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

Отображает временное сообщение, если это необходимо, в ответ на событие рисования event.

[protected] void QStatusBar::reformat()

Изменяет внешний вид строки состояния с учетом изменений элементов.

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

void QStatusBar::removeWidget(QWidget *widget)

Удаляет указанный widget из строки состояния.

Примечание: Эта функция не удаляет виджет, а скрывает его. Чтобы добавить виджет снова, необходимо вызвать обе функции addWidget() и show().

См. также addWidget(), addPermanentWidget() и clearMessage().

[override virtual protected] void QStatusBar::resizeEvent(QResizeEvent *e)

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

[override virtual protected] void QStatusBar::showEvent(QShowEvent *)

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

[slot] void QStatusBar::showMessage(const QString &message, int timeout = 0)

Скрывает обычные индикаторы состояния и отображает данное message в течение заданного количества миллисекунд (timeout). Если timeout равен 0 (значение по умолчанию), message отображается до тех пор, пока не будет вызван слот clearMessage() или пока снова не будет вызван слот showMessage() для изменения сообщения.

Обратите внимание, что showMessage() вызывается для отображения временных пояснений к подсказкам инструментов, поэтому указание timeout в 0 недостаточно для отображения постоянного сообщения.

См. также messageChanged(), currentMessage() и clearMessage().