Qt Namespace

类型文档

enum Qt::AlignmentFlag
flags Qt::Alignment

该枚举类型用于描述对齐方式。它包含水平和垂直标志，可以通过组合这些标志来实现所需的效果。

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

水平对齐标志包括：

垂直标志包括：

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

每次最多可同时使用一个水平标志和一个垂直标志。Qt::AlignCenter 同时计为水平和垂直标志。

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

掩码：

标志的冲突组合将产生未定义的行为。

Alignment 类型是QFlags<AlignmentFlag> 的 typedef。它存储 AlignmentFlag 值的按“或”运算组合。

enum Qt::AnchorPoint

指定布局项中可锚定的边。该属性由QGraphicsAnchorLayout 方法使用。

另请参阅 QGraphicsAnchorLayout 。

enum Qt::ApplicationAttribute

此枚举描述了会改变全局功能行为的属性。这些属性可通过QCoreApplication::setAttribute() 启用或禁用，并可通过QCoreApplication::testAttribute() 进行检测。

当此属性设为 true 时，Qt 将不会进行重映射，按下 Command 修饰键将触发Qt::MetaModifier ，而按下 Control 修饰键将触发Qt::ControlModifier 。

请注意，QKeySequence::StandardKey 序列始终基于相同的修饰键（即无论设置何种值，QKeySequence::Copy 始终为Command+C），但QKeySequence::toString()的输出结果会有所不同。

enum Qt::ApplicationState
flags Qt::ApplicationStates

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

状态包括

ApplicationStates 类型是QFlags<ApplicationState> 的 typedef。它存储 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 。

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

该枚举类型定义了小部件在显示上下文菜单方面可能采用的各种策略。

[since 6.8] enum class Qt::ContextMenuTrigger

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

该枚举在 Qt 6.8 中引入。

另请参阅 QStyleHints::contextMenuTrigger 。

[since 6.10] enum class Qt::ContrastPreference

表示用户首选的对比度设置。样式可通过提高前景色和背景色的对比度，以及为小部件和控件设置更粗的边框来遵循此设置。

该枚举在 Qt 6.10 中引入。

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	插入符或 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	通常在拖动项目时使用的光标。
Qt::DragCopyCursor	19	通常在拖动项目以复制它时使用的光标。
Qt::DragLinkCursor	21	通常在拖动项目以创建其链接时使用的光标。
Qt::BitmapCursor	24

enum Qt::DateFormat

对于ISODate 格式，每个y 、M 和d 分别代表用于指定日期的年、月、日的单个数字。每个H 、m 和s 分别代表用于指定时间的小时（最大值为 24）、分钟和秒的单个数字。 当小时为 24 且所有其他时间字段均为零时，则被视为次日的开始。.zzz 表示前一个字段的小数部分后缀，该后缀可通过逗号',' 或如图所示的点'.' 与该字段分隔。超过毫秒的精度虽被接受但会被舍弃，并四舍五入到最接近的可表示毫秒。 当同时指定日期和时间时，字面量T 用于分隔日期和时间。对于TextDate 和RFC2822Date 格式，ddd 代表星期名称的前三个字母，MMM 代表月份名称的前三个字母。无论用户偏好或系统设置如何，星期和月份的名称始终为英文（C 语言环境）。 其他格式字符的含义与 ISODate 格式相同，但 24 不被接受为小时值。方括号[...] 括起的格式部分是可选的；方括号本身不属于格式的一部分。此处的加减号字符'±' 代表任意符号字符，'-' 代表减号，'+' 代表加号。

另请参阅 QDate::toString()、QTime::toString()、QDateTime::toString()、QDate::fromString()、QTime::fromString() 以及QDateTime::fromString()。

enum Qt::DayOfWeek

enum Qt::DockWidgetArea
flags Qt::DockWidgetAreas

表示QDockWidget 可以停靠的位置。

DockWidgetAreas 类型是QFlags<DockWidgetArea> 的 typedef。它存储 DockWidgetArea 值的或（OR）组合。

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

enum Qt::DropAction
flags Qt::DropActions

DropActions 类型是QFlags<DropAction> 的 typedef 定义。它存储 DropAction 值的按“或”运算组合。

enum Qt::Edge
flags Qt::Edges

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

“边”类型是QFlags<Edge> 的 typedef 定义。它存储 Edge 值的按“或”运算组合。

enum Qt::EnterKeyType

此选项可用于更改屏幕键盘上“返回”键的外观。

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::FindChildOption
flags Qt::FindChildOptions

FindChildOptions 类型是QFlags<FindChildOption> 的 typedef 定义。它存储 FindChildOption 值的“或”组合。

enum Qt::FocusPolicy

该枚举类型定义了控件在获取键盘焦点方面的各种策略。

enum Qt::FocusReason

此枚举用于指定焦点变化的原因。它将通过QWidget::setFocus 传递，并可在焦点变化时发送到控件的QFocusEvent 中获取。

另请参阅 “控件中的键盘焦点”。

enum Qt::GestureFlag
flags Qt::GestureFlags

此枚举类型描述了订阅手势时可用的其他标志。

GestureFlags 类型是QFlags<GestureFlag> 的 typedef。它存储 GestureFlag 值的按“或”运算组合。

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

enum Qt::GestureState

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

另请参阅 QGesture 。

enum Qt::GestureType

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

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

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

enum Qt::GlobalColor

Qt 的预定义QColor 对象：

另请参阅 QColor 。

Qt::HANDLE

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

enum class Qt::HighDpiScaleFactorRoundingPolicy

此枚举描述了高DPI缩放因子可能的舍入策略，这些策略决定了如何处理非整数缩放因子（例如 Windows 150%）。

通过在创建应用程序对象之前调用QGuiApplication::setHighDpiScaleFactorRoundingPolicy()来设置当前生效的策略。

另请参阅 QGuiApplication::setHighDpiScaleFactorRoundingPolicy()。

enum Qt::HitTestAccuracy

此枚举包含QTextDocument 类在检测文本文档上的鼠标点击时可使用的精度类型。

enum Qt::ImageConversionFlag
flags Qt::ImageConversionFlags

如果列表中未包含其他值，则会采用标有“(默认)”的选项（因为默认值为零）：

彩色/单色偏好设置（QBitmap 模式下将被忽略）：

抖动模式首选项：

1 位透明度蒙版的抖动模式首选项：

颜色匹配与抖动偏好：

ImageConversionFlags 类型是QFlags<ImageConversionFlag> 的 typedef。它存储 ImageConversionFlag 值的按“或”运算组合。

enum Qt::InputMethodHint
flags Qt::InputMethodHints

影响行为的标志：

请注意，Android输入法会刻意限制密码字段仅允许输入拉丁/ASCII字符。

请注意，Qt 框架将此视为可见密码，在此情况下，Android 输入法会刻意仅允许输入拉丁/ASCII 字符。

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

验证规则：

InputMethodHints 类型是QFlags<InputMethodHint> 的 typedef。它存储 InputMethodHint 值的按“或”运算组合。

另请参阅 QGraphicsItem::inputMethodHints()。

enum Qt::InputMethodQuery
flags Qt::InputMethodQueries

掩码：

InputMethodQueries 类型是QFlags<InputMethodQuery> 的 typedef。它存储 InputMethodQuery 值的“或”组合。

另请参阅 QInputMethodQueryEvent 。

enum Qt::ItemDataRole

模型中的每个项都关联着一组数据元素，每个元素都有其特定的角色。视图通过这些角色向模型指示所需的数据类型。自定义模型应按这些类型返回数据。

通用角色（及其关联的类型）包括：

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

辅助功能角色（及其关联类型）：

用户角色：

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

enum Qt::ItemFlag
flags Qt::ItemFlags

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

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

请注意，如果某个索引已设置 Qt::ItemNeverHasChildren 标志，而重新实现QAbstractItemModel::hasChildren 时该方法对该索引返回 true，则属于未定义行为。

ItemFlags 类型是QFlags<ItemFlag> 的 typedef。它存储了 ItemFlag 值的按“或”运算组合。

另请参阅 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()。

enum Qt::KeyboardModifier
flags Qt::KeyboardModifiers

此枚举描述了修饰键。

KeyboardModifiers 类型是QFlags<KeyboardModifier> 的 typedef。它存储 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::MatchFlag
flags Qt::MatchFlags

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

MatchFlags 类型是QFlags<MatchFlag> 的 typedef。它存储 MatchFlag 值的“或”组合。

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

enum Qt::Modifier
flags Qt::Modifiers

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

Modifiers 类型是QFlags<Modifier> 的 typedef。它存储 Modifier 值的按“或”运算组合。

另请参阅 KeyboardModifier 和MouseButton 。

[since 6.12] enum class Qt::MotionPreference

表示用户对动画和动作的首选设置。控件、样式和应用程序可根据枚举值限制动画数量，从而遵循此设置。

该枚举类型在 Qt 6.12 中引入。

enum Qt::MouseButton
flags Qt::MouseButtons

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

MouseButtons 类型是QFlags<MouseButton> 的 typedef。它存储 MouseButton 值的按“或”运算组合。

另请参阅 KeyboardModifier 和Modifier 。

enum Qt::MouseEventFlag
flags Qt::MouseEventFlags

此枚举提供了有关“QMouseEvent ”的附加信息。

MouseEventFlags 类型是QFlags<MouseEventFlag> 的 typedef。它存储 MouseEventFlag 值的按“或”运算组合。

enum Qt::MouseEventSource

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

另请参阅 Qt::AA_SynthesizeMouseForUnhandledTouchEvents 。

enum Qt::NativeGestureType

此枚举返回手势类型。

enum Qt::Orientation
flags Qt::Orientations

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

例如，Orientation 可与 `QScrollBar ` 配合使用。

Orientations 类型是QFlags<Orientation> 的 typedef。它存储 Orientation 值的按“或”运算组合。

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::虚点虚点线	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()。

enum Qt::ScreenOrientation
flags Qt::ScreenOrientations

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

ScreenOrientations 类型是QFlags<ScreenOrientation> 的 typedef 定义。它存储 ScreenOrientation 值的按“或”运算组合。

enum Qt::ScrollBarPolicy

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

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

enum Qt::ScrollPhase

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