Qt Namespace

类型文档

枚举 Qt::AlignmentFlag
flags Qt::Alignment

该枚举类型用于描述对齐方式。它包含水平和垂直标志，可结合使用以产生所需的效果。

TextElideMode 枚举也可在许多情况下用于微调对齐文本的外观。

水平标志包括

垂直标志有

一次只能使用一个水平标志。有一个二维标志：

一次最多只能使用一个水平和一个垂直标记。Qt::AlignCenter 可同时作为水平和垂直标志。

三个枚举值在可以从右向左模式运行的应用程序中非常有用：

遮罩：

相互冲突的标志组合具有未定义的含义。

Alignment 类型是QFlags<AlignmentFlag> 的类型定义。它存储 AlignmentFlag 值的 OR 组合。

enum Qt::AnchorPoint

指定布局项可以锚定的一面。QGraphicsAnchorLayout 将使用此功能。

另请参阅 QGraphicsAnchorLayout 。

enum Qt::ApplicationAttribute

该枚举描述了可改变全应用程序功能行为的属性。这些属性可通过QCoreApplication::setAttribute() 启用或禁用，也可通过QCoreApplication::testAttribute() 进行测试。

当此属性为真时，Qt 将不进行重映射，按下 Command 修饰符的结果是Qt::MetaModifier ，而按下 Control 修饰符的结果是Qt::ControlModifier 。

请注意，QKeySequence::StandardKey 序列将始终基于相同的修改器（即无论设置的值是什么，QKeySequence::Copy 都将是 Command+C），但QKeySequence::toString() 的输出将有所不同。

枚举 Qt::ApplicationState
flags Qt::ApplicationStates

该枚举类型用于指定应用程序的当前状态。

状态包括

ApplicationStates 类型是QFlags<ApplicationState> 的类型定义。它存储 ApplicationState 值的 OR 组合。

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 。

enum Qt::CaseSensitivity

enum Qt::CheckState

该枚举描述了可选中项、控件和部件的状态。

另请参阅 QCheckBox,Qt::ItemFlags, 和Qt::ItemDataRole 。

enum Qt::ChecksumType

该枚举描述了qChecksum() 可能使用的标准。

enum Qt::ClipOperation

enum class Qt::ColorScheme

代表应用程序主题的外观，由QGuiApplication::palette() 定义。

enum Qt::ConnectionType

该枚举描述了信号与时隙之间可使用的连接类型。特别是，它决定了特定信号是立即传送到槽，还是排队等待稍后传送。

使用队列连接时，参数必须是 Qt 元对象系统已知的类型，因为 Qt 需要复制参数并将其存储在幕后事件中。如果您尝试使用队列连接，并收到错误信息：

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

请在建立连接前调用qRegisterMetaType() 注册数据类型。

在多个线程中使用信号和插槽时，请参阅跨线程的信号和插槽。

另请参阅 Qt XML 中的线程支持、QObject::connect()、qRegisterMetaType() 和Q_DECLARE_METATYPE()。

enum Qt::ContextMenuPolicy

该枚举类型定义了 widget 在显示上下文菜单时可采用的各种策略。

[since 6.8] enum class Qt::ContextMenuTrigger

该枚举类型定义了用于触发上下文菜单事件的鼠标事件。

该枚举在 Qt 6.8 中引入。

另请参阅 QStyleHints::contextMenuTrigger 。

enum Qt::CoordinateSystem

该枚举用于指定坐标系。

enum Qt::Corner

该枚举类型指定矩形中的一个角：

enum Qt::CursorMoveStyle

该枚举描述了文本游标可用的移动方式。选项如下

enum Qt::CursorShape

该枚举类型定义了可使用的各种光标。

标准箭头光标是正常状态下部件的默认光标。

常量	值	说明
Qt::ArrowCursor	0	标准箭头光标。
Qt::UpArrowCursor	1	一个向上指向屏幕顶部的箭头。
Qt::CrossCursor	2	十字光标，通常用于帮助用户准确选择屏幕上的某一点。
Qt::WaitCursor	3	沙漏或手表光标，通常在阻止用户与应用程序交互的操作中显示。
Qt::IBeamCursor	4	圆点或 ibeam 光标，表示窗口小部件可以接受并显示文本输入。
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	光标，通常在拖动项目时使用。
Qt::DragCopyCursor	19	光标，通常在拖动项目进行复制时使用。
Qt::DragLinkCursor	21	光标，通常在拖动项目以建立链接时使用。
Qt::BitmapCursor	24

enum Qt::DateFormat

另请参见 QDate::toString(),QTime::toString(),QDateTime::toString(),QDate::fromString(),QTime::fromString(), 和QDateTime::fromString().

enum Qt::DayOfWeek

枚举 Qt::DockWidgetArea
flags Qt::DockWidgetAreas

代表QDockWidget 可以插入的区域。

DockWidgetAreas 类型是QFlags<DockWidgetArea> 的类型定义。它存储了 DockWidgetArea 值的 OR 组合。

另请参阅 QDockWidget::setAllowedAreas 和QDockWidget::isAreaAllowed 。

枚举 Qt::DropAction
flags Qt::DropActions

DropActions 类型是QFlags<DropAction> 的类型定义。它存储 DropAction 值的 OR 组合。

枚举 Qt::Edge
flags Qt::Edges

此枚举类型指定矩形中的边缘：

Edges 类型是QFlags<Edge> 的类型定义。它存储边缘值的 OR 组合。

enum Qt::EnterKeyType

可用于更改屏幕键盘上 Return 键的外观。

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

指定填充路径和多边形的方法。

枚举 Qt::FindChildOption
标志 Qt::FindChildOptions

FindChildOptions 类型是QFlags<FindChildOption> 的类型定义。它存储 FindChildOption 值的 OR 组合。

enum Qt::FocusPolicy

此枚举类型定义了部件在获取键盘焦点时的各种策略。

enum Qt::FocusReason

该枚举指定焦点改变的原因。它将通过QWidget::setFocus 传递，并可在焦点改变时从发送给 widget 的QFocusEvent 中获取。

另请参阅 小工具中的键盘焦点。

枚举 Qt::GestureFlag
flags Qt::GestureFlags

此枚举类型描述了订阅手势时可使用的附加标志。

GestureFlags 类型是QFlags<GestureFlag> 的类型定义。它存储手势标志值的 OR 组合。

另请参阅 QWidget::grabGesture() 和QGraphicsObject::grabGesture()。

enum Qt::GestureState

该枚举类型描述手势的状态。

另请参阅 QGesture 。

enum Qt::GestureType

该枚举类型描述了标准手势。

用户自定义手势通过QGestureRecognizer::registerRecognizer() 函数注册，该函数会生成一个自定义手势 ID，并设置 Qt XML::CustomGesture 标志。

另请参阅 QGesture 、QWidget::grabGesture() 和QGraphicsObject::grabGesture()。

enum Qt::GlobalColor

Qt XML 预定义的QColor 对象：

另请参见 QColor 。

Qt::HANDLE

系统对象的句柄类型，在所有平台上都定义为void * 。

enum class Qt::HighDpiScaleFactorRoundingPolicy

该枚举描述了可能的高 DPI 比例因子四舍五入策略，它决定了如何处理非整数比例因子（如 Windows 150%）。

活动策略通过在创建应用程序对象前调用QGuiApplication::setHighDpiScaleFactorRoundingPolicy() 进行设置。

另请参见 QGuiApplication::setHighDpiScaleFactorRoundingPolicy()。

enum Qt::HitTestAccuracy

该枚举包含QTextDocument 类在测试文本文档上的鼠标点击时可使用的准确度类型。

枚举 Qt::ImageConversionFlag
flags Qt::ImageConversionFlags

如果没有包含列表中的其他值，标记为"（默认）"的选项将被设置（因为默认值为零）：

颜色/单色偏好（对于QBitmap 会忽略）：

抖动模式首选项：

1 位 alpha 遮罩的首选抖动模式：

色彩匹配与抖动偏好：

ImageConversionFlags 类型是QFlags<ImageConversionFlag> 的类型定义。它存储 ImageConversionFlag 值的 OR 组合。

enum Qt::InputMethodHint
flags Qt::InputMethodHints

改变行为的标志：

限制输入的标志（排他性标志）：

掩码

InputMethodHints 类型是QFlags<InputMethodHint> 的类型定义。它存储 InputMethodHint 值的 OR 组合。

另请参阅 QGraphicsItem::inputMethodHints().

enum Qt::InputMethodQuery
flags Qt::InputMethodQueries

遮罩：

InputMethodQueries 类型是QFlags<InputMethodQuery> 的类型定义。它存储 InputMethodQuery 值的 OR 组合。

另请参阅 QInputMethodQueryEvent 。

enum Qt::ItemDataRole

模型中的每个项目都有一组与之关联的数据元素，每个元素都有自己的角色。视图使用角色来向模型指示它需要哪种类型的数据。自定义模型应返回这些类型的数据。

通用角色（及相关类型）包括

描述外观和元数据（以及相关类型）的角色：

无障碍角色（带相关类型）：

用户角色：

对于用户角色，由开发人员决定使用哪些类型，并确保组件在访问和设置数据时使用正确的类型。

枚举 Qt::ItemFlag
flags Qt::ItemFlags

该枚举描述了项目的属性：

请注意，可选中项需要同时给出一组合适的标志和一个初始状态，以指示该项目是否被选中。对于模型/视图组件，这将自动处理，但对于QListWidgetItem 、QTableWidgetItem 和QTreeWidgetItem 的实例，则需要显式设置。

请注意，如果一个索引设置了 Qt XML::ItemNeverHasChildren 标志，那么重新实现QAbstractItemModel::hasChildren 并返回 true 将是未定义的行为。

ItemFlags 类型是QFlags<ItemFlag> 的类型定义。它存储 ItemFlag 值的 OR 组合。

另请参阅 QAbstractItemModel 。

enum Qt::ItemSelectionMode

该枚举在QGraphicsItem 、QGraphicsScene 和QGraphicsView 中使用，用于指定如何选择项目，或如何确定形状和项目是否发生碰撞。

另请参阅 QGraphicsScene::items()、QGraphicsScene::collidingItems()、QGraphicsView::items()、QGraphicsItem::collidesWithItem() 和QGraphicsItem::collidesWithPath()。

enum Qt::ItemSelectionOperation

QGraphicsScene 中使用该枚举来指定在设置选择区域时如何处理当前选择的项目。

另请参阅 QGraphicsScene::setSelectionArea()。

enum Qt::Key

Qt 使用的键名。

另请参阅 QKeyEvent::key().

枚举 Qt::KeyboardModifier
flags Qt::KeyboardModifiers

此枚举描述了修改器按键。

KeyboardModifiers 类型是QFlags<KeyboardModifier> 的类型定义。它存储了 KeyboardModifier 值的 OR 组合。

另请参见 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() 函数的行为。

枚举 Qt::MatchFlag
flags Qt::MatchFlags

此枚举描述了在模型中搜索项目时可使用的匹配类型。

MatchFlags 类型是QFlags<MatchFlag> 的类型定义。它存储 MatchFlag 值的 OR 组合。

另请参阅 QString::compare() 和QRegularExpression 。

枚举 Qt::Modifier
flags Qt::Modifiers

该枚举为 Qt 支持的键盘修改键提供了更简短的名称。

Modifiers 类型是QFlags<Modifier> 的类型定义。它存储修改器值的 OR 组合。

另请参阅 KeyboardModifier 和MouseButton 。

枚举 Qt::MouseButton
flags Qt::MouseButtons

该枚举类型描述了不同的鼠标按钮。

MouseButtons 类型是QFlags<MouseButton> 的类型定义。它存储 MouseButton 值的 OR 组合。

另请参阅 KeyboardModifier 和Modifier 。

枚举 Qt::MouseEventFlag
flags Qt::MouseEventFlags

该枚举提供了有关QMouseEvent 的附加信息。

MouseEventFlags 类型是QFlags<MouseEventFlag> 的类型定义。它存储 MouseEventFlag 值的 OR 组合。

enum Qt::MouseEventSource

该枚举描述鼠标事件的来源，可用于确定该事件是否是来自其他设备（如触摸屏）的人工鼠标事件。

另请参阅 Qt::AA_SynthesizeMouseForUnhandledTouchEvents 。

enum Qt::NativeGestureType

该枚举返回手势类型。

enum Qt::NavigationMode

该枚举类型描述了移动对焦的模式。

另请参阅 QApplication::setNavigationMode() 和QApplication::navigationMode()。

枚举 Qt::Orientation
flags Qt::Orientations

该类型用于表示对象的方向。

例如，Orientation 用于QScrollBar 。

Orientations 类型是QFlags<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 。

[since 6.5] enum class Qt::PermissionStatus

该枚举描述了权限的可能状态。

该枚举在 Qt 6.5 中引入。

另请参阅 QCoreApplication::requestPermission()、QCoreApplication::checkPermission() 和应用程序权限。

enum Qt::ReturnByValueConstant

这是一种虚拟类型，旨在帮助用户从某些已废弃的 API 过渡到其替代 API。

另请参阅 QCursor::bitmap()、QCursor::mask()、QLabel::picture() 和QLabel::pixmap() 。

枚举 Qt::ScreenOrientation
flags Qt::ScreenOrientations

此枚举类型指定屏幕可能具有的各种方向。

ScreenOrientations 类型是QFlags<ScreenOrientation> 的类型定义。它存储 ScreenOrientation 值的 OR 组合。

enum Qt::ScrollBarPolicy

该枚举类型描述了QAbstractScrollArea 滚动条的各种模式。

(水平和垂直滚动条的模式是独立的）。

enum Qt::ScrollPhase

该枚举描述了滚动的阶段。

enum Qt::ShortcutContext

要发生QEvent::Shortcut 事件，用户必须在快捷键处于活动状态的上下文中输入快捷键的按键序列。可能的上下文包括

enum Qt::SizeHint

该枚举由QGraphicsLayoutItem::sizeHint() 使用