Пространство имен Qt

Пространство имен Qt содержит различные идентификаторы, используемые в библиотеке Qt. Подробнее...

• Устаревшие члены

Типы

Функции

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

Пространство имен Qt содержит различные идентификаторы, используемые в библиотеке Qt.

Документация по типам

перечисление Qt::AlignmentFlagфлаги Qt::Alignment

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

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

Горизонтальные флаги:

Вертикальные флаги:

Можно использовать только один из горизонтальных флагов за раз. Есть один двумерный флаг:

Можно использовать не более одного горизонтального и одного вертикального флага за раз. Qt::AlignCenter учитывается как для горизонтального, так и для вертикального выравнивания.

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

Маски:

Сочетания флагов, которые приводят к конфликтам, имеют неопределённое значение.

Тип Alignment — это псевдоним для QFlags<AlignmentFlag>. Он хранит результат побитового ИЛИ комбинации значений AlignmentFlag.

перечисление Qt::AnchorPoint

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

См. также QGraphicsAnchorLayout.

перечисление Qt::ApplicationAttribute

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

Следующие значения устарели или недействительны:

перечисление Qt::ApplicationStateфлаги Qt::ApplicationStates

Этот тип перечисления используется для указания текущего состояния приложения.

Состояния:

Это перечисление было добавлено или изменено в Qt 5.1.

Тип ApplicationStates — это typedef для QFlags<ApplicationState>. Он хранит логическое ИЛИ комбинацию значений ApplicationState.

enum Qt::ArrowType

enum Qt::AspectRatioMode

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

См. также QSize::scale() и QImage::scaled().

enum Qt::Axis

Этот тип перечисления определяет три значения для представления трех осей в декартовой системе координат.

См. также QTransform::rotate() и QTransform::rotateRadians().

enum Qt::BGMode

Режим фона:

enum Qt::BrushStyle

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

См. также QBrush.

перечисление Qt::CaseSensitivity

перечисление Qt::CheckState

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

См. также QCheckBox, Qt::ItemFlags и Qt::ItemDataRole.

перечисление Qt::ChecksumType

Это перечисление описывает возможные стандарты, используемые функцией qChecksum().

Этот перечисление был введен или изменен в Qt 5.9.

enum Qt::ClipOperation

enum Qt::ConnectionType

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

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

QObject::connect: Cannot queue arguments of type 'MyType'

Вызовите qRegisterMetaType(), чтобы зарегистрировать тип данных перед установлением соединения.

При использовании сигналов и слотов с несколькими потоками см. Сигналы и слоты через потоки.

См. также Поддержка потоков в Qt, QObject::connect(), qRegisterMetaType(), и Q_DECLARE_METATYPE().

enum Qt::ContextMenuPolicy

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

enum Qt::CoordinateSystem

Этот перечисление определяет систему координат.

Это перечисление было добавлено или изменено в Qt 4.6.

enum Qt::Corner

Этот тип перечисления определяет угол прямоугольника:

enum Qt::CursorMoveStyle

Это перечисление описывает стиль перемещения курсора текста. Варианты:

enum Qt::CursorShape

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

Стандартный стрелочный курсор является по умолчанию для виджетов в нормальном состоянии.

Константа	Значение	Описание
Qt::ArrowCursor	0	Стандартный курсор стрелки.
Qt::UpArrowCursor	1	Стрелка, направленная вверх к верхней части экрана.
Qt::CrossCursor	2	Курсор перекрестия, обычно используется для точного выбора точки на экране пользователем.
Qt::WaitCursor	3	Курсор песочных часов или часов, обычно отображается во время операций, которые не позволяют пользователю взаимодействовать с приложением.
Qt::IBeamCursor	4	Курсор в виде каретки или I-луча, указывает, что виджет может принимать и отображать ввод текста.
Qt::SizeVerCursor	5	Курсор, используемый для элементов, используемых для вертикального изменения размера окон верхнего уровня.
Qt::SizeHorCursor	6	Курсор, используемый для элементов, используемых для горизонтального изменения размера окон верхнего уровня.
Qt::SizeBDiagCursor	7	Курсор, используемый для элементов, используемых для диагонального изменения размера окон верхнего уровня в их верхнем правом и нижнем левом углах.
Qt::SizeFDiagCursor	8	Курсор, используемый для элементов, используемых для диагонального изменения размера окон верхнего уровня в их верхнем левом и нижнем правом углах.
Qt::SizeAllCursor	9	Курсор, используемый для элементов, используемых для изменения размера окон верхнего уровня в любом направлении.
Qt::BlankCursor	10	Пустой/невидимый курсор, обычно используется, когда необходимо скрыть форму курсора.
Qt::SplitVCursor	11	Курсор, используемый для вертикальных разделителей, указывающий, что ручку можно перетаскивать по горизонтали для изменения использования доступного пространства.
Qt::SplitHCursor	12	Курсор, используемый для горизонтальных разделителей, указывающий, что ручку можно перетаскивать по вертикали для изменения использования доступного пространства.
Qt::PointingHandCursor	13	Курсор с рукой, обычно используемый для нажимаемых элементов, таких как гиперссылки.
Qt::ForbiddenCursor	14	Курсор с зачёркнутым кругом, обычно используется во время операций перетаскивания для указания того, что перетаскиваемое содержимое нельзя поместить на определенные виджеты или в определенные области.
Qt::OpenHandCursor	17	Курсор, представляющий открытую руку, обычно используется для указания того, что область под курсором является видимой частью холста, по которому пользователь может нажимать и перетаскивать, чтобы прокручивать вокруг.
Qt::ClosedHandCursor	18	Курсор, представляющий закрытую руку, обычно используется для указания того, что выполняется операция перетаскивания, связанная с прокруткой.
Qt::WhatsThisCursor	15	Стрелка с вопросительным знаком, обычно используется для указания наличия справки "Что это?" для виджета.
Qt::BusyCursor	16	Курсор в виде песочных часов или часов, обычно отображается во время операций, которые позволяют пользователю взаимодействовать с приложением, в то время как они выполняются в фоновом режиме.
Qt::DragMoveCursor	20	Курсор, обычно используемый при перетаскивании элемента.

enum Qt::DateFormat

Примечание: Для форматов ISODate каждый Y, M и D представляет собой отдельную цифру года, месяца и дня, используемых для указания даты. Каждый H, M и S представляет собой отдельную цифру часа, минуты и секунды, используемых для указания времени. Наличие литерала T используется для разделения даты и времени, если оба указаны.

enum Qt::DayOfWeek

enum Qt::DockWidgetAreaflags Qt::DockWidgetAreas

Тип DockWidgetAreas — это псевдоним для QFlags<DockWidgetArea>. Он хранит результат объединения по битовому ИЛИ значений DockWidgetArea.

enum Qt::DropActionflags Qt::DropActions

Тип DropActions — это псевдоним для QFlags<DropAction>. Он хранит результат объединения по битовому ИЛИ значений DropAction.

enum Qt::Edgeflags Qt::Edges

Этот перечисление определяет край прямоугольника:

Это перечисление было введено или изменено в Qt 5.1.

Тип Edges — это псевдоним для QFlags<Edge>. Он хранит результат объединения по битовому ИЛИ значений Edge.

enum Qt::EnterKeyType

Это можно использовать для изменения внешнего вида клавиши Ввод на виртуальной клавиатуре.

Примечание: Не все значения поддерживаются на всех платформах. Для неподдерживаемых значений будет использоваться стандартная клавиша.

Этот перечисление был введен или изменен в Qt 5.6.

enum Qt::EventPriority

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

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

enum CustomEventPriority
{
    // An important event
    ImportantEventPriority = Qt::HighEventPriority,

    // A more important event
    MoreImportantEventPriority = ImportantEventPriority + 1,

    // A critical event
    CriticalEventPriority = 100 * MoreImportantEventPriority,

    // Not that important
    StatusEventPriority = Qt::LowEventPriority,

    // These are less important than Status events
    IdleProcessingDoneEventPriority = StatusEventPriority - 1
};

См. также QCoreApplication::postEvent().

enum Qt::FillRule

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

enum Qt::FindChildOptionflags Qt::FindChildOptions

Тип FindChildOptions является псевдонимом для QFlags<FindChildOption>. Он хранит логическое ИЛИ комбинацию значений FindChildOption.

перечисление Qt::FocusPolicy

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

перечисление Qt::FocusReason

Это перечисление указывает причину изменения фокуса. Оно будет передано в QWidget::setFocus и может быть получено в QFocusEvent, отправленном виджету при изменении фокуса.

См. также Фокус клавиатуры в виджетах.

перечисление Qt::GestureFlagфлаги Qt::GestureFlags

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

Этот перечисление был введён или изменён в Qt 4.6.

Тип GestureFlags является псевдонимом для QFlags<GestureFlag>. Он хранит результат побитового ИЛИ комбинации значений GestureFlag.

См. также QWidget::grabGesture() и QGraphicsObject::grabGesture().

перечисление Qt::GestureState

Этот тип перечисления описывает состояние жеста.

Этот перечисление был введён или изменён в Qt 4.6.

См. также QGesture.

перечисление Qt::GestureType

Этот тип перечисления описывает стандартные жесты.

Пользовательские жесты регистрируются функцией QGestureRecognizer::registerRecognizer(), которая генерирует пользовательский идентификатор жеста со значением флага Qt::CustomGesture.

Этот перечисление был введён или изменён в Qt 4.6.

См. также QGesture, QWidget::grabGesture(), и QGraphicsObject::grabGesture().

перечисление Qt::GlobalColor

Предопределённые объекты QColor в Qt:

См. также QColor.

typedef Qt::HANDLE

Тип дескриптора для системных объектов, определён как void * на всех платформах.

enum Qt::HitTestAccuracy

Этот перечисление содержит типы точности, которые могут быть использованы классом QTextDocument при проверке нажатий мыши на текстовые документы.

enum Qt::ImageConversionFlagflags Qt::ImageConversionFlags

Варианты, помеченные "(по умолчанию)", устанавливаются, если не включены другие значения из списка (поскольку значения по умолчанию равны нулю):

Предпочтение цвета/монохроматического (не учитывается для QBitmap):

Предпочтение режима побайтовой обработки:

Предпочтение режима побайтовой обработки для 1-битовых альфа-масок:

Предпочтение сопоставления цветов по сравнению с побайтовой обработкой:

Тип ImageConversionFlags является типом-синонимом для QFlags<ImageConversionFlag>. Он хранит результат побитового ИЛИ комбинации значений ImageConversionFlag.

enum Qt::InputMethodHintflags Qt::InputMethodHints

Флаги, которые изменяют поведение:

Флаги, ограничивающие ввод (исключающие флаги):

Маски:

Примечание: Если несколько исключающих флагов объединены с помощью операции OR, результирующий набор символов будет состоять из объединения указанных наборов. Например, указание ImhNumbersOnly и ImhUppercaseOnly даст набор, состоящий из цифр и заглавных букв.

Тип InputMethodHints является typedef для QFlags<InputMethodHint>. Он хранит комбинацию значений InputMethodHint, объединенных с помощью операции OR.

См. также QGraphicsItem::inputMethodHints().

enum Qt::InputMethodQueryflags Qt::InputMethodQueries

Маски:

Тип InputMethodQueries — это псевдоним для QFlags<InputMethodQuery>. Он хранит объединение значений InputMethodQuery по оператору OR.

См. такжеQInputMethodQueryEvent.

enum Qt::ItemDataRole

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

Общие роли (и соответствующие типы):

Роли, описывающие внешний вид и метаданные (с соответствующими типами):

Роли доступности (с соответствующими типами):

Роли пользователя:

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

enum Qt::ItemFlagflags Qt::ItemFlags

Этот перечисление описывает свойства элемента:

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

Обратите внимание, что повторная реализация QAbstractItemModel::hasChildren для возвращения true для индекса, если для этого индекса установлен флаг Qt::ItemNeverHasChildren, является неопределенным поведением.

Тип ItemFlags — это псевдоним для QFlags<ItemFlag>. Он хранит логическое ИЛИ сочетание значений ItemFlag.

См. также QAbstractItemModel.

перечисление Qt::ItemSelectionMode

Это перечисление используется в QGraphicsItem, QGraphicsScene и QGraphicsView для указания того, как выбираются элементы, или как определить, пересекаются ли фигуры и элементы.

См. также QGraphicsScene::items(), QGraphicsScene::collidingItems(), QGraphicsView::items(), QGraphicsItem::collidesWithItem(), и QGraphicsItem::collidesWithPath().

перечисление Qt::ItemSelectionOperation

Этот перечисление используется в QGraphicsScene для указания действий с текущими выделенными элементами при установке области выделения.

См. также QGraphicsScene::setSelectionArea().

enum Qt::Key

Имена клавиш, используемые Qt.

См. также QKeyEvent::key().

enum Qt::KeyboardModifierflags Qt::KeyboardModifiers

Этот перечисление описывает модификаторы клавиш.

Примечание: В macOS, значение ControlModifier соответствует клавишам Command на клавиатуре, а значение MetaModifier — клавишам Control. Значение KeypadModifier также будет установлено при нажатии клавиши со стрелкой, так как клавиши со стрелками считаются частью цифрового блока.

Примечание: В Windows Keyboards, Qt::MetaModifier и Qt::Key_Meta сопоставлены с клавишей Windows.

Тип KeyboardModifiers — это typedef для QFlags<KeyboardModifier>. Он хранит логическое ИЛИ сочетание значений KeyboardModifier.

См. также MouseButton и Modifier.

enum Qt::LayoutDirection

Указывает направление макетов Qt и обработки текста.

Макеты справа налево необходимы для некоторых языков, в частности арабского и иврита.

LayoutDirectionAuto выполняет две задачи. При использовании совместно с виджетами и макетами он указывает использовать направление макета, заданное на родительском виджете или в QApplication. Это эквивалентно QWidget::unsetLayoutDirection().

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

См. также QGuiApplication::setLayoutDirection(), QWidget::setLayoutDirection(), QTextOption::setTextDirection() и QString::isRightToLeft().

enum Qt::MaskMode

Этот перечисление определяет поведение функций QPixmap::createMaskFromColor() и QImage::createMaskFromColor().

enum Qt::MatchFlagflags Qt::MatchFlags

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

Тип MatchFlags — это typedef для QFlags<MatchFlag>. Он хранит логическое ИЛИ сочетание значений MatchFlag.

См. также QString::compare() и QRegExp.

enum Qt::Modifier

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

Примечание: В macOS значение CTRL соответствует клавишам Command на клавиатуре, а значение META соответствует клавишам Control.

См. также KeyboardModifier и MouseButton.

enum Qt::MouseButtonflags Qt::MouseButtons

Этот тип перечисления описывает различные кнопки мыши.

Примечание: Некоторые модели мышей с несколькими кнопками предварительно настроены с кнопками с высокими номерами, имитирующими последовательности клавиш для использования в определённых играх. Чтобы эти кнопки отображались как реальные «Кнопки мыши», устройство необходимо перенастроить (используя утилиту конфигурации производителя).

Тип MouseButtons является псевдонимом для QFlags<MouseButton>. Он хранит логическое ИЛИ сочетание значений MouseButton.

См. также KeyboardModifier и Modifier.

enum Qt::MouseEventFlagflags Qt::MouseEventFlags

Этот перечисление предоставляет дополнительную информацию о QMouseEvent.

Это перечисление было введено или изменено в Qt 5.3.

Тип MouseEventFlags является псевдонимом для QFlags<MouseEventFlag>. Он хранит логическое ИЛИ сочетание значений MouseEventFlag.

enum Qt::MouseEventSource

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

Это перечисление было введено или изменено в Qt 5.3.

См. также Qt::AA_SynthesizeMouseForUnhandledTouchEvents.

enum Qt::NativeGestureType

Это перечисление возвращает тип жеста.

Этот перечисление был добавлен или изменён в Qt 5.2.

enum Qt::NavigationMode

Этот тип перечисления описывает режим перемещения фокуса.

Примечание: Навигация курсора в настоящее время не реализована ни на одной платформе и ведет себя как NavigationModeNone.

Этот перечисление был добавлен или изменён в Qt 4.6.

См. также QApplication::setNavigationMode() и QApplication::navigationMode().

enum Qt::Orientationflags Qt::Orientations

Этот тип используется для обозначения ориентации объекта.

Ориентация используется с QScrollBar, например.

Тип Orientations является псевдонимом для QFlags<Orientation>. Он хранит комбинацию значений Orientation с помощью оператора OR.

enum Qt::PenCapStyle

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

Qt::SquareCap	Qt::FlatCap	Qt::RoundCap

См. также QPen.

enum Qt::PenJoinStyle

Этот перечисление определяет стили соединения линий пера, поддерживаемые Qt, то есть типы соединений между двумя соединёнными линиями, которые можно нарисовать с помощью QPainter.

Qt::BevelJoin	Qt::MiterJoin	Qt::RoundJoin

См. также QPen.

enum Qt::PenStyle

Это перечисление определяет стили линий пера, которые можно нарисовать с помощью QPainter. Эти стили:

Qt::SolidLine	Qt::DashLine	Qt::DotLine
Qt::DashDotLine	Qt::DashDotDotLine	Qt::CustomDashLine

См. также QPen.

enum Qt::ScreenOrientationflags Qt::ScreenOrientations

Это перечисление определяет различные ориентации экрана.

Тип ScreenOrientations — это псевдоним для QFlags<ScreenOrientation>. Он хранит результат побитового ИЛИ всех значений ScreenOrientation.

enum Qt::ScrollBarPolicy

Этот перечисление описывает различные режимы полос прокрутки QAbstractScrollArea.

(Режимы для горизонтальной и вертикальной полос прокрутки независимы.)

enum Qt::ScrollPhase

Это перечисление описывает фазу прокрутки.

Это перечисление было добавлено или изменено в Qt 5.2.

enum Qt::ShortcutContext

Для того, чтобы событие QEvent::Shortcut произошло, последовательность клавиш ярлыка должна быть введена пользователем в контексте, где ярлык активен. Возможные контексты следующие:

enum Qt::SizeHint

Это перечисление используется методом QGraphicsLayoutItem::sizeHint()

Это перечисление было добавлено или изменено в Qt 4.4.

См. также QGraphicsLayoutItem::sizeHint().

enum Qt::SizeMode

Этот перечисление используется функциями QPainter::drawRoundedRect() и QPainterPath::addRoundedRect() для указания радиусов углов прямоугольника относительно размеров ограничивающих прямоугольников.

Это перечисление было введено или изменено в Qt 4.4.

enum Qt::SortOrder

Это перечисление описывает, как сортируются элементы в виджете.

enum Qt::TabFocusBehavior

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

Это перечисление было введено или изменено в Qt 5.5.

enum Qt::TextElideMode

Это перечисление определяет, где должна отображаться многоточие при отображении текста, который не помещается:

Qt::ElideMiddle обычно является наиболее подходящим выбором для URL-адресов (например, "http://bugreports.qt.../QTWEBSITE-13/"), а Qt::ElideRight подходит для других строк (например, "Deploying Applications on Ma...").

См. также QAbstractItemView::textElideMode, QFontMetrics::elidedText(), AlignmentFlag и QTabBar::elideMode.

enum Qt::TextFlag

Этот тип перечисления используется для определения некоторых флагов модификаторов. Некоторые из этих флагов имеют смысл только в контексте печати:

Можно использовать любое количество флагов модификаторов, за исключением того, что Qt::TextSingleLine и Qt::TextWordWrap нельзя комбинировать.

Флаги, которые не подходят для данного использования, обычно игнорируются.

перечисление Qt::TextFormat

Это перечисление используется в виджетах, которые могут отображать как обычный текст, так и форматированный текст, например, QLabel. Оно используется для определения, должна ли строка текста интерпретироваться как та или иная. Обычно это делается путем передачи одного из значений перечисления в функцию QTextEdit::setTextFormat().

перечисление Qt::TextInteractionFlagфлаги Qt::TextInteractionFlags

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

Тип TextInteractionFlags — псевдоним для QFlags<TextInteractionFlag>. Он хранит логическое ИЛИ сочетание значений TextInteractionFlag.

enum Qt::TileRule

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

Этот перечисление был введен или изменен в Qt 4.6.

enum Qt::TimeSpec