Qt 命名空间

Qt 命名空间包含的是 Qt 库中使用的各种标识符。 更多...

头文件 #include <Qt>
CMakefind_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmakeQT += core

命名空间

命名空间字面量

(自 6.7 版起)partial_ordering
(自 6.7 版起)strong_ordering
(自 6.7 版起)weak_ordering

类型

标识对齐
枚举对齐标识 { AlignLeft, AlignRight, AlignHCenter, AlignJustify, AlignTop, ..., AlignVertical_Mask }
枚举锚点 { AnchorLeft, AnchorHorizontalCenter, AnchorRight, AnchorTop, AnchorVerticalCenter, AnchorBottom }
枚举应用程序属性 { AA_QtQuickUseDefaultSizePolicy, AA_DontShowIconsInMenus, AA_DontShowShortcutsInContextMenus, AA_NativeWindows, AA_DontCreateNativeWidgetSiblings, …, AA_DisableNativeVirtualKeyboard }
枚举应用程序状态 { ApplicationSuspended, ApplicationHidden, ApplicationInactive, ApplicationActive }
标识应用程序状态
枚举箭头类型 { NoArrow, UpArrow, DownArrow, LeftArrow, RightArrow }
枚举纵横比模式 { IgnoreAspectRatio, KeepAspectRatio, KeepAspectRatioByExpanding }
枚举 { XAxis, YAxis, ZAxis }
枚举背景模式 { TransparentMode, OpaqueMode }
枚举画刷样式 { NoBrush, SolidPattern, Dense1Pattern, Dense2Pattern, Dense3Pattern, …, TexturePattern }
枚举大小写敏感性 { CaseInsensitive, CaseSensitive }
枚举复选框状态 { Unchecked, PartiallyChecked, Checked }
枚举校验类型 { ChecksumIso3309, ChecksumItuV41 }
枚举裁剪操作 { NoClip, ReplaceClip, IntersectClip }
枚举类颜色方案 { Unknown, Light, Dark }
枚举连接类型 { AutoConnection, DirectConnection, QueuedConnection, BlockingQueuedConnection, UniqueConnection, SingleShotConnection }
枚举上下文菜单策略 { NoContextMenu, PreventContextMenu, DefaultContextMenu, ActionsContextMenu, CustomContextMenu }
枚举坐标系 { DeviceCoordinates, LogicalCoordinates }
枚举 { TopLeftCorner, TopRightCorner, BottomLeftCorner, BottomRightCorner }
枚举光标移动样式 { LogicalMoveStyle, VisualMoveStyle }
枚举光标形状 { ArrowCursor, UpArrowCursor, CrossCursor, WaitCursor, IBeamCursor, …, BitmapCursor }
枚举日期格式 { TextDate, ISODateWithMs, ISODate, RFC2822Date }
枚举DayOfWeek { 星期一, 星期二, 星期三, 星期四, 星期五, …, 星期日 }
枚举DockWidgetArea { 左侧DockWidget区域, 右侧DockWidget区域, 顶部DockWidget区域, 底部DockWidget区域, 所有DockWidget区域, 无DockWidget区域 }
标识DockWidgetAreas
枚举DropAction { 复制动作, 移动动作, 链接动作, 动作掩码, 忽略动作, 目标移动动作 }
标识DropActions
枚举Edge { 顶部边缘, 左部边缘, 右部边缘, 底部边缘 }
标识Edges
枚举EnterKeyType { 默认Enter键, 回车键, 完成键, 去键, 发送键, …, 前一个键 }
枚举EventPriority { 高优先级事件, 正常优先级事件, 低优先级事件 }
枚举FillRule { 奇偶填充, 分散填充 }
枚举FindChildOption { 只查找直接子项, 递归查找子项 }
标识FindChildOptions
枚举FocusPolicy { 标签键聚焦, 点击聚焦, 强制聚焦, 鼠标轮聚焦, 无聚焦 }
枚举FocusReason { 鼠标聚焦原因, 标签键聚焦原因, 后标签键聚焦原因, 活跃窗口聚焦原因, 弹出聚焦原因, …, 其他聚焦原因 }
枚举GestureFlag { 在子项上不开始手势, 接收部分手势, 忽略手势传递给父项 }
标识GestureFlags
枚举GestureState { 无手势, 手势开始, 手势更新, 手势完成, 手势取消 }
枚举GestureType { 拨打电话手势, 拨打电话并保持手势, 拖动手势, 挤压手势, 滑动手势, 自定义手势 }
枚举GlobalColor { 白色, 黑色, 红色, 深红色, 绿色, …, 颜色1 }
HANDLE
枚举类HighDpiScaleFactorRoundingPolicy { 四舍五入, 向上取整, 向下取整, 向下取整并四舍五入, 透传 }
枚举HitTestAccuracy { 准确命中, 模糊命中 }
枚举ImageConversionFlag { 自动着色, 仅着色, 单色, 扩散抖动, 顺序抖动, …, 无格式转换 }
标识ImageConversionFlags
枚举InputMethodHint { 没有输入法提示, 隐藏文本提示, 敏感数据提示, 无自动大写提示, 优先数字提示, …, 单独输入掩码 }
标识InputMethodHints
标识InputMethodQueries
枚举InputMethodQuery { 输入法启用, 光标矩形, 字体, 当前位置, 周围文本, …, 查询所有 }
枚举ItemDataRole { 显示角色, 装饰角色, 编辑角色, 工具提示角色, 状态提示角色, …, 用户角色 }
枚举ItemFlag { 无项目标志, 可选择项目, 可编辑项目, 可拖动项目, 可放置项目, …, 用户三态项目 }
标识ItemFlags
枚举ItemSelectionMode { 包含项目形状, 交叉项目形状, 包含项目边界矩形, 交叉项目边界矩形 }
枚举ItemSelectionOperation { 替换选择, 添加到选择 }
枚举Key { ESC键, Tab键, Backtab键, Backspace键, 回车键, …, 取消键 }
枚举KeyboardModifier { 无修饰符, Shift修饰符, Ctrl修饰符, Alt修饰符, Meta修饰符, …, GroupSwitch修饰符 }
标识KeyboardModifiers
枚举LayoutDirection { 从左到右, 从右到左, 自动布局方向 }
枚举MaskMode { 遮罩在内颜色, 遮罩在外颜色 }
枚举MatchFlag { 准确匹配, 匹配固定字符串, 包含匹配, 以...开始匹配, 以...结束匹配, …, 递归匹配 }
标识MatchFlags
枚举Modifier { Shift, Meta, Ctrl, Alt }
标识Modifiers
枚举MouseButton { 无按钮, 所有按钮, 左按钮, 右按钮, 中按钮, …, 额外按钮24 }
标识MouseButtons
枚举MouseEventFlag { 鼠标事件创建双击 }
标识MouseEventFlags
枚举MouseEventSource { 鼠标事件非合成, 由系统合成的鼠标事件, 由Qt合成的鼠标事件, 由应用程序合成的鼠标事件 }
枚举NativeGestureType { 开始原生手势, 结束原生手势, 平移手势, 放大手势, 智能缩放手势, …, 滑动手势 }
枚举NavigationMode { 无导航模式, 键盘标签顺序导航模式, 键盘方向导航模式, 光标自动导航模式, 强制可见光标导航模式 }
枚举Orientation { 水平, 垂直 }
标识方向
枚举PenCapStyle { 平头, 方头, 圆头 }
枚举PenJoinStyle { 齿状连接, 斜面连接, 圆连接, Svg齿状连接 }
枚举PenStyle { 没有画笔, 实线, 虚线, 点线, 点划线, …, 自定义虚线 }
(自6.5起) 包枚举类PermissionStatus { 未确定, 已授权, 已拒绝 }
枚举按值返回常量 { }
枚举ScreenOrientation { 主方向, 横屏方向, 竖屏方向, 反向横屏方向, 反向竖屏方向 }
标识屏幕方向
枚举ScrollBarPolicy { 根据需要滚动条, 总是关闭滚动条, 总是显示滚动条 }
枚举ScrollPhase { 无滚动阶段, 滚动开始, 滚动更新, 滚动结束, 滚动惯性 }
枚举ShortcutContext { 小部件快捷方式, 小部件及其子快捷方式, 窗口快捷方式, 应用程序快捷方式 }
枚举SizeHint { 最小尺寸, 推荐尺寸, 最大尺寸, 最小下陷 }
枚举SizeMode { 绝对尺寸, 相对尺寸 }
枚举SortOrder { 升序排序, 降序排序 }
标识分割行为
枚举SplitBehaviorFlags { 保留空部分, 跳过空部分 }
枚举TabFocusBehavior { 无Tab焦点, Tab焦点文本控件, Tab焦点列表控件, Tab焦点所有控件 }
枚举TextElideMode { 左省略, 右省略, 中省略, 不省略 }
枚举TextFlag { 单行文本, 不裁剪, 展开制表符, 显示快捷键, 自动换行文本, …, 强制对齐文本 }
枚举TextFormat { 纯文本, 富文本, 自动文本, Markdown文本 }
枚举TextInteractionFlag { 无文本交互, 使用鼠标可选择的文本, 使用键盘可选择的文本, 使用鼠标访问链接, 使用键盘访问链接, …, 文本浏览器交互 }
标识文本交互标志
枚举TileRule { 拉伸平铺, 重复平铺, 圆形平铺 }
枚举TimeSpec { 本地时间, UTC, UTC偏移, 时区 }
枚举TimerType { 准确计时器, 粗计时器, 非常粗计时器 }
枚举ToolBarArea { 左工具栏区域, 右工具栏区域, 顶部工具栏区域, 底部工具栏区域, 所有工具栏区域, 无工具栏区域 }
标识工具栏区域
枚举ToolButtonStyle { 图标工具按钮, 文本工具按钮, 图标旁文本工具按钮, 图标下文本工具按钮, 遵循样式工具按钮 }
枚举TouchPointState { 未知状态, 按压状态, 移动状态, 稳定状态, 释放状态 }
标识触摸点状态
枚举TransformationMode { 快速转换, 平滑转换 }
枚举UIEffect { UI 动画菜单, UI 淡入菜单, UI 动画组合框, UI 动画工具提示, UI 淡入工具提示, UI 动画工具箱 }
枚举WhiteSpaceMode { 正常空白字符模式, 预格式化空白字符模式, 不换行空白字符模式 }
枚举WidgetAttribute { 接受拖放, 总是显示工具提示, 自定义What’s This帮助, 关闭时删除, 禁用, …, 内容边距尊重安全区域 }
标识窗口标志
枚举WindowFrameSection { 无部分, 左部分, 顶部左侧部分, 顶部部分, 顶部右侧部分, …, 标题栏区域 }
枚举WindowModality { 非模态, 窗口模态, 应用程序模态 }
枚举WindowState { WindowNoState, WindowMinimized, WindowMaximized, WindowFullScreen, WindowActive }
标识WindowStates
枚举WindowType { Widget, Window, Dialog, Sheet, Drawer, …, WindowType_Mask }

函数

(since 6.2) voidbeginPropertyUpdateGroup()
QTextStream &bin(QTextStream &stream)
QTextStream &bom(QTextStream &stream)
QTextStream &center(QTextStream &stream)
(since 6.7) Qt::strong_orderingcompareThreeWay(LeftInt lhs, RightInt rhs)
(since 6.7) Qt::partial_orderingcompareThreeWay(LeftFloat lhs, RightFloat rhs)
(since 6.7) Qt::partial_orderingcompareThreeWay(IntType lhs, FloatType rhs)
(since 6.7) Qt::partial_orderingcompareThreeWay(FloatType lhs, IntType rhs)
(since 6.7) Qt::strong_orderingcompareThreeWay(const LeftType *lhs, const RightType *rhs)
(since 6.7) Qt::strong_orderingcompareThreeWay(Enum lhs, Enum rhs)
QStringconvertFromPlainText(const QString &plain, Qt::WhiteSpaceMode mode)
QTextStream &dec(QTextStream &stream)
(since 6.2) voidendPropertyUpdateGroup()
QTextStream &endl(QTextStream &stream)
QTextStream &fixed(QTextStream &stream)
QTextStream &flush(QTextStream &stream)
QTextStream &forcepoint(QTextStream &stream)
QTextStream &forcesign(QTextStream &stream)
QTextStream &hex(QTextStream &stream)
QTextStream &left(QTextStream &stream)
QTextStream &lowercasebase(QTextStream &stream)
QTextStream &lowercasedigits(QTextStream &stream)
boolmightBeRichText(QAnyStringView text)
QTextStream &noforcepoint(QTextStream &stream)
QTextStream &noforcesign(QTextStream &stream)
QTextStream &noshowbase(QTextStream &stream)
QTextStream &oct(QTextStream &stream)
QTextStream &reset(QTextStream &stream)
QTextStream &right(QTextStream &stream)
QTextStream &scientific(QTextStream &stream)
QTextStream &showbase(QTextStream &stream)
QTextStream &uppercasebase(QTextStream &stream)
QTextStream &uppercasedigits(QTextStream &stream)
QTextStream &ws(QTextStream &stream)

详细描述

命名空间

namespace Qt::Literals

class partial_ordering

Qt::partial_ordering 表示允许无序结果的比较结果。 更多...

class strong_ordering

Qt::strong_ordering 表示一个比较,其中等效值是不可区分的。 更多...

class weak_ordering

Qt::weak_ordering 表示一个比较,其中等效值仍然可以区分。 更多...

类型文档

enum Qt::AlignmentFlag
标志 Qt::Alignment

此枚举类型用于描述对齐方式。它包含水平和垂直标志,可以组合起来以产生所需的效果。

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

水平标志包括

常量描述
Qt::AlignLeft0x0001与左边缘对齐。
Qt::AlignRight0x0002与右边缘对齐。
Qt::AlignHCenter0x0004在可用空间内水平居中。
Qt::AlignJustify0x0008在可用空间内对齐文本。

垂直标志包括

常量描述
Qt::AlignTop0x0020与顶部对齐。
Qt::AlignBottom0x0040与底部对齐。
Qt::AlignVCenter0x0080在可用空间内垂直居中。
Qt::AlignBaseline0x0100与基线对齐。

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

常量描述
Qt::AlignCenterAlignVCenter | AlignHCenter在两个维度上居中。

一次最多只能使用一个水平和一个垂直标志。Qt::AlignCenter既代表水平也代表垂直。

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

常量描述
Qt::AlignAbsolute0x0010如果小部件的布局方向是 Qt::RightToLeft(而不是默认的 Qt::LeftToRight),则 Qt::AlignLeft 指的是 右侧 边缘,Qt::AlignRight 指的是 左侧边缘。这通常是希望的行为。如果您希望 Qt::AlignLeft 总是表示 "left",Qt::AlignRight 总是表示 "right",请结合使用标志 Qt::AlignAbsolute。
Qt::AlignLeadingAlignLeftQt::AlignLeft 的同义词。
Qt::AlignTrailingAlignRightQt::AlignRight 的同义词。

掩码

常量
Qt::AlignHorizontal_MaskAlignLeft | AlignRight | AlignHCenter | AlignJustify | AlignAbsolute
Qt::AlignVertical_MaskAlignTop | AlignBottom | AlignVCenter | AlignBaseline

标志的组合存在冲突时,具有未定义的意义。

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

枚举 Qt::AnchorPoint

指定可以锚定的布局项的侧面。这是由 QGraphicsAnchorLayout 使用的。

常量描述
Qt::AnchorLeft0布局项的左侧。
Qt::AnchorHorizontalCenter1位于布局项左和右边缘之间的 "虚拟" 侧面。
Qt::AnchorRight2布局项的右侧。
Qt::AnchorTop3布局项的顶部。
Qt::AnchorVerticalCenter4位于布局项顶和底边之间的 "虚拟" 侧面。
Qt::AnchorBottom5布局项的底部。

另请参阅 QGraphicsAnchorLayout.

枚举 Qt::ApplicationAttribute

此枚举描述了改变应用程序范围功能行为的属性。这些属性使用 QCoreApplication::setAttribute() 启用和禁用,并可以使用 QCoreApplication::testAttribute() 进行测试。

常量描述
Qt::AA_QtQuickUseDefaultSizePolicy (自 Qt 6.7)1Qt Quick 布局使用Item内置的大小策略。例如,当设置为这一点时,Button将填充可用宽度,但高度保持固定。未设置时,它将使用布局的默认大小行为,即使用其隐式大小作为首选大小。这在指定首选大小大小约束中有详细说明。设置时,可以通过显式设置Layout.fillWidthLayout.fillHeight来覆盖布局项的默认大小策略。 注意:此API被认为是技术预览版,可能在Qt的未来版本中更改或删除。
Qt::AA_DontShowIconsInMenus2除非明确由QAction::iconVisibleInMenu属性设置,否则具有图标属性的操作不会在任何菜单中显示。当前已打开的菜单或已在原生macOS菜单栏中创建的菜单可能不会拾取此属性的更改。始终会拾取QAction::iconVisibleInMenu属性的更改。
Qt::AA_DontShowShortcutsInContextMenus28除非明确由QAction::shortcutVisibleInContextMenu属性设置,否则具有快捷键属性的操作不会在任何快捷菜单中显示。此值是在Qt 5.10中添加的,默认基于QStyleHints::showShortcutsInContextMenus报告的值。要覆盖默认行为,在QCoreApplication实例化之前设置样式提示,或在QCoreApplication实例化之后设置此属性。
Qt::AA_NativeWindows3确保小部件具有原生窗口。
Qt::AA_DontCreateNativeWidgetSiblings4确保除非由Qt::WA_NativeWindow属性明确设置,否则原生小部件的同级小部件保持非原生状态。
Qt::AA_PluginApplication5表示Qt用于创建插件。根据操作系统,它将抑制在插件情况下可能没有意义的特定初始化。例如,在macOS上,这可能包括避免加载主菜单的nib以及不使用原生菜单栏。将此属性设置为true也将设置QGuiApplication的AA_DontUseNativeMenuBar属性为true。它还禁用了原生事件过滤器。必须在与QGuiApplication构造之前设置此属性。此值是在Qt 5.7中添加的。
Qt::AA_DontUseNativeMenuBar6当此属性设置为true时,创建的所有菜单栏都不会作为原生菜单栏使用(例如,macOS主屏幕顶部的菜单栏)。
Qt::AA_MacDontSwapCtrlAndMeta7Apple平台上的键盘快捷键通常是基于Command(或Cmd)键盘修改符,由⌘符号表示。例如,“复制”操作是Command+C(⌘+C)。为了简化跨平台开发,Qt默认将Command映射到Qt::ControlModifier,以与其他平台一致。这允许创建如“Ctrl+J”这样的键盘快捷键,在macOS上会映射到预期的Command+J,以符合macOS用户的期望。Apple平台上实际的Control(或Ctrl)修改符,由⌃表示,映射到Qt::MetaModifier

当此属性为true时,Qt将不会进行映射,按下Command修改符将导致Qt::MetaModifier,而按下Control修改符将导致Qt::ControlModifier

请注意,QKeySequence::StandardKey 序列始终基于相同的修饰符(即,QKeySequence::Copy 无论如何设置值,都将使用 Command+C),但是 QKeySequence::toString() 输出的结果将不同。

常量描述
Qt::AA_Use96Dpi8假设屏幕分辨率为 96 DPI 而不是使用操作系统提供的分辨率。这将导致字体渲染在不同设备上始终保持每点像素数一致,而不是将 1 点定义为 1/72 英寸。
Qt::AA_SynthesizeTouchForUnhandledMouseEvents11所有未被应用程序接受的鼠标事件将被转换为触摸事件。
Qt::AA_SynthesizeMouseForUnhandledTouchEvents12所有未被应用程序接受的触摸事件将被转换为左键鼠标事件。此属性默认启用。
Qt::AA_ForceRasterWidgets14使顶层小部件使用纯光栅表面,并不支持非本机 GL 基于子小部件。
Qt::AA_UseDesktopOpenGL15强制在动态加载 OpenGL 实现的平台上使用桌面 OpenGL(例如,opengl32.dlllibGL.so)。此属性必须在构造 QGuiApplication 之前设置。此值在 Qt 5.3 中添加。
Qt::AA_UseOpenGLES16强制在动态加载 OpenGL 实现的平台上使用 OpenGL ES 2.0 或更高版本。此属性必须在构造 QGuiApplication 之前设置。此值在 Qt 5.3 中添加。
Qt::AA_UseSoftwareOpenGL17强制在动态加载 OpenGL 实现的平台上使用基于软件的 OpenGL 实现。这通常是一个修补过的 Mesa llvmpipe 构建,提供 OpenGL 2.1。如果没有此类 OpenGL 实现,则该值可能没有作用。此库的默认名称为 opengl32sw.dll,可以通过设置环境变量 QT_OPENGL_DLL 来覆盖。有关更多信息,请参阅特定平台页面,例如 Qt for Windows。此属性必须在构造 QGuiApplication 之前设置。此值在 Qt 5.4 中添加。
Qt::AA_ShareOpenGLContexts18启用类似于 QOpenGLWidgetQQuickWidget 的类所使用的 OpenGL 上下文之间的资源共享。这允许不同顶层窗口的 QOpenGLWidget 实例之间共享 OpenGL 资源,如纹理。此属性必须在构造 QGuiApplication 之前设置。此值在 Qt 5.4 中添加。
Qt::AA_SetPalette19表示是否在 QGuiApplication 上显式设置了调色板。此值在 Qt 5.5 中添加。
Qt::AA_UseStyleSheetPropagationInWidgetStyles22默认情况下,Qt 样式表禁用常规 QWidget 调色板和字体的传播。当此标志启用时,从样式表进行的字体和调色板更改将在设置样式表时传播一次。有关详细信息,请参阅样式表语法 - 继承。此值在 Qt 5.7 中添加。
Qt::AA_DontUseNativeDialogs23当此属性设置为 true 时创建的所有对话框将不使用平台提供的原生对话框。此值在 Qt 5.7 中添加。
Qt::AA_SynthesizeMouseForUnhandledTabletEvents24所有未被应用程序接受的平板电脑事件将被转换为鼠标事件。此属性默认启用。此值在 Qt 5.7 中添加。
Qt::AA_CompressHighFrequencyEvents25启用某些频繁事件的压缩。在X11窗口系统中,默认值是true,这意味着当QEvent::MouseMoveQEvent::TouchUpdate以及窗口大小和位置的改变发生的频率超过应用程序可以处理时,它们会被合并处理,以防止后续累积和耗尽应用程序的资源。在Windows 8及更高版本上,默认值也是true,但这只适用于触摸事件。鼠标和窗口事件不受此标志的影响。在其他平台上,默认值是false。(将来,压缩功能可能将在所有平台上实现。)你可以测试这个属性来查看是否启用了压缩。如果你的应用程序需要处理所有事件而不进行压缩,你可以取消这个属性的设置。请注意,来自平板电脑设备的输入事件不会进行压缩。如果你希望这些事件也进行压缩,请参阅AA_CompressTabletEvents。此属性自Qt 5.7开始添加。
Qt::AA_CompressTabletEvents29启用来自平板电脑设备的输入事件的压缩。请注意,要启用事件压缩,AA_CompressHighFrequencyEvents必须为true,并且此标志将前一个属性扩展到平板电脑事件。目前支持X11窗口系统、Windows 8及以上版本。默认值是false。此属性自Qt 5.10开始添加。
Qt::AA_DontCheckOpenGLContextThreadAffinity26当使用QOpenGLContext使上下文当前时,不要检查QOpenGLContext对象的QObject线程亲和度是否与调用makeCurrent()的线程相同。此属性自Qt 5.8开始添加。
Qt::AA_DisableShaderDiskCache27禁用对磁盘上着色器程序二进制文件的缓存。默认情况下,Qt Quick、QPainter的OpenGL后端以及使用其任何QOpenGLShaderProgramaddCacheableShaderFromSource重载的应用程序,在支持glProgramBinary()的系统中,会在共享或进程特定的缓存存储位置中采用基于磁盘的程序二进制缓存。在不太可能遇到问题的情况下,设置此属性以禁用所有基于磁盘的着色器缓存。
Qt::AA_DisableSessionManager31禁用QSessionManager。默认情况下,Qt会在支持的平台上的GUI应用程序上连接到一个正在运行的会话管理器,对于系统服务,使用会话管理器可能是多余的。此属性必须在QGuiApplication构造之前设置。此属性自5.14开始添加。
Qt::AA_DisableNativeVirtualKeyboard9当设置此属性时,在没有物理键盘的系统上,当文本输入部件获得焦点时,不会自动显示原生的屏幕键盘。目前仅支持Windows平台。此属性自5.15开始添加。

枚举 Qt::ApplicationState
标志 Qt::ApplicationStates

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

状态如下

常量描述
Qt::ApplicationSuspended0x00000000应用程序即将挂起。当进入此状态时,应用程序应该保存其状态,停止所有活动,并准备好代码执行停止。挂起期间,应用程序可以在任何时候被杀死而不需要进一步的警告(例如,当低内存迫使操作系统清除挂起的应用程序时)。
Qt::ApplicationHidden0x00000001应用程序被隐藏并在后台运行。这是需要做后台处理的应用程序的正常状态,例如播放音乐,当用户与其他应用程序交互时。当进入此状态时,应用程序应该释放所有图形资源。
Qt::ApplicationInactive0x00000002应用程序可见,但未被选中以显示在前面。在桌面平台上,这通常意味着用户激活了另一个应用程序。在移动平台上,当操作系统由于例如来电或短信消息等中断用户时,更常进入此状态。在此状态下,请考虑减少CPU密集型任务。
Qt::ApplicationActive0x00000004应用程序可见且被选中显示在前面。

ApplicationStates类型是ApplicationState的typedef,即QFlags。它存储ApplicationState值的逻辑或组合。

enum Qt::ArrowType

常量
Qt::NoArrow0
Qt::UpArrow1
Qt::DownArrow2
Qt::LeftArrow3
Qt::RightArrow4

enum Qt::AspectRatioMode

此枚举类型定义了在缩放矩形时矩形的纵横比会发生变化。

常量描述
Qt::IgnoreAspectRatio0大小可自由缩放。不保留纵横比。
Qt::KeepAspectRatio1大小缩放至给定矩形内尽可能大的矩形,保持纵横比。
Qt::KeepAspectRatioByExpanding2大小缩放至给定矩形外尽可能小的矩形,保持纵横比。

另请参阅QSize::scale() 和 QImage::scaled

enum Qt::Axis

此枚举类型定义代表笛卡尔坐标系中三个轴的三个值。

常量描述
Qt::XAxis0X轴。
Qt::YAxis1Y轴。
Qt::ZAxis2Z轴。

另请参阅QTransform::rotate() 和 QTransform::rotateRadians

enum Qt::BGMode

背景模式

常量
Qt::TransparentMode0
Qt::OpaqueMode1

enum Qt::BrushStyle

此枚举类型定义了Qt支持的刷子样式,即使用QPainter绘制的形状的填充模式。

Brush Styles

常量描述
Qt::NoBrush0无刷子图案。
Qt::SolidPattern1统一颜色。
Qt::Dense1Pattern2极其密集的刷子图案。
Qt::Dense2Pattern3非常密集的刷子图案。
Qt::Dense3Pattern4有点密集的刷子图案。
Qt::Dense4Pattern5半密集刷子图案。
Qt::Dense5Pattern6有点稀疏的刷子图案。
Qt::Dense6Pattern7非常稀疏的刷子图案。
Qt::Dense7Pattern8极其稀疏的刷子图案。
Qt::HorPattern9水平线。
Qt::VerPattern10垂直线。
Qt::CrossPattern11水平和垂直线的交叉。
Qt::BDiagPattern12反向对角线。
Qt::FDiagPattern13正向对角线。
Qt::DiagCrossPattern14交叉对角线。
Qt::LinearGradientPattern15线性渐变(使用专用QBrush构造函数设置)。
Qt::ConicalGradientPattern17圆锥渐变(使用专用QBrush构造函数设置)。
Qt::RadialGradientPattern16径向渐变(使用专用QBrush构造函数设置)。
Qt::TexturePattern24自定义图案(见QBrush::setTexture)。

另请参阅QBrush

enum Qt::CaseSensitivity

常量
Qt::CaseInsensitive0
Qt::CaseSensitive1

枚举 Qt::CheckState

此枚举描述了可检查项、控件和小部件的状态。

常量描述
Qt::Unchecked0该项未被选中。
Qt::PartiallyChecked1该项部分选中。在层次模型中,如果某些子项被选中而并非所有子项都被选中,这些项目可能被部分选中。
Qt::Checked2该项被选中。

另请参阅 QCheckBoxQt::ItemFlagsQt::ItemDataRole

枚举 Qt::ChecksumType

此枚举描述了 qChecksum() 可以使用的标准。

常量描述
Qt::ChecksumIso33090基于 ISO 3309 的校验和计算。
Qt::ChecksumItuV411基于 ITU-V.41 的校验和计算。

枚举 Qt::ClipOperation

常量描述
Qt::NoClip0此操作关闭剪辑。
Qt::ReplaceClip1用函数调用中提供的剪辑路径/矩形/区域替换当前剪辑路径/矩形/区域。
Qt::IntersectClip2将当前剪辑路径/矩形/区域与函数调用中提供的剪辑路径/矩形/区域相交。

枚举 Qt::ColorScheme

表示应用程序主题的外观,由 QGuiApplication::palette 定义。

常量描述
Qt::ColorScheme::Unknown0外观未知。
Qt::ColorScheme::Light1背景颜色比文字颜色浅,即主题为浅色。
Qt::ColorScheme::Dark2背景颜色比文字颜色深,即主题为深色。

枚举 Qt::ConnectionType

此枚举描述了可在信号和槽之间使用的连接类型。特别是,它确定了特定信号是立即传递给槽还是延迟传递。

常量描述
Qt::AutoConnection0(默认) 如果接收器 位于 发出信号的线程中,则使用 Qt::DirectConnection。否则,使用 Qt::QueuedConnection。连接类型在发出信号时确定。
Qt::DirectConnection1信号发出时立即调用槽。槽在发出信号的线程中执行。
Qt::QueuedConnection2当控制返回到接收者的线程的事件循环时调用槽。槽在接收者的线程中执行。
Qt::BlockingQueuedConnection3与 Qt::QueuedConnection 相同,但它阻止发出信号的线程,直到槽返回。此连接不得在接收器位于发出信号的线程时使用,否则应用程序将陷入死锁。
Qt::UniqueConnection0x80这是一个可以与上述任何一种连接类型组合使用的标志,通过位或运算实现。当设置为 Qt::UniqueConnection 时,如果连接已存在(即相同的信号已连接到相同的槽,针对同一对对象),则 QObject::connect() 将失败。
Qt::SingleShotConnection0x100这是一个可以与上述任何一种连接类型组合使用的标志,通过位或运算实现。当设置为 Qt::SingleShotConnection 时,槽仅被调用一次;当信号发出时,连接将被自动断开。此标志在 Qt 6.0 中引入。

对于队列连接,参数必须是 Qt 的元对象系统已知类型的,因为 Qt 需要复制参数以在后台存储它们的事件。如果您尝试使用队列连接并收到错误消息

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

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

当使用多线程中的信号和槽时,请参阅 跨线程的信号和槽

另请参阅 Qt中的线程支持QObject::connect(),qRegisterMetaType() 以及 Q_DECLARE_METATYPE

enum Qt::ContextMenuPolicy

此枚举类型定义了小部件可以有的各种上下文菜单策略。

常量描述
Qt::NoContextMenu0小部件没有上下文菜单,上下文菜单处理将延迟到小部件的父级。
Qt::PreventContextMenu4小部件没有上下文菜单,与 NoContextMenu 不同,处理将 不会 延迟到小部件的父级。这意味着所有右键鼠标事件都将通过 QWidget::mousePressEvent() 和 QWidget::mouseReleaseEvent() 确保传递给小部件本身。
Qt::DefaultContextMenu1调用小部件的 QWidget::contextMenuEvent() 处理程序。
Qt::ActionsContextMenu2小部件将 QWidget::actions() 显示为上下文菜单。
Qt::CustomContextMenu3小部件发出 QWidget::customContextMenuRequested() 信号。

enum Qt::CoordinateSystem

此枚举指定坐标系。

常量描述
Qt::DeviceCoordinates0坐标相对于对象的绘制设备左上角。
Qt::LogicalCoordinates1坐标相对于对象的左上角。

enum Qt::Corner

此枚举类型指定矩形中的角。

常量描述
Qt::TopLeftCorner0x00000矩形的左上角。
Qt::TopRightCorner0x00001矩形的右上角。
Qt::BottomLeftCorner0x00002矩形的左下角。
Qt::BottomRightCorner0x00003矩形的右下角。

enum Qt::CursorMoveStyle

此枚举描述了可用于文本光标的移动样式。选项有

常量描述
Qt::LogicalMoveStyle0在从左到右的文本块中,按左箭头键时减小光标位置,按右箭头键时增加光标位置。如果文本块是从右到左,则相反。
Qt::VisualMoveStyle1按下左箭头键将始终使光标向左移动,无论文本的书写方向如何。按下右箭头键将始终使光标向右移动。

enum Qt::CursorShape

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

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

常量描述
Qt::ArrowCursor0 标准箭头光标。
Qt::UpArrowCursor1 指向上方的箭头。
Qt::CrossCursor2 矩形光标,通常用来帮助用户精确地选择屏幕上的点。
Qt::WaitCursor3沙漏或手表光标,通常在阻止用户与应用程序交互的操作期间显示。
Qt::IBeamCursor4 光标或I形光标,表示小部件可以接受并显示文本输入。
Qt::SizeVerCursor5 用于垂直调整顶级窗口大小的光标。
Qt::SizeHorCursor6 用于水平调整顶级窗口大小的光标。
Qt::SizeBDiagCursor7 用于在顶级窗口右上角和左下角进行对角调整的光标。
Qt::SizeFDiagCursor8 用于在顶级窗口左上角和右下角进行对角调整的光标。
Qt::SizeAllCursor9 用于在任何方向调整顶级窗口大小的光标。
Qt::BlankCursor10空白/不可见光标,通常在需要隐藏光标形状时使用。
Qt::SplitVCursor11 用于垂直分隔符的光标,指示可以水平拖动拖把以调整可用空间的分配。
Qt::SplitHCursor12 用于水平分隔符的光标,指示可以垂直拖动拖把以调整可用空间的分配。
Qt::PointingHandCursor13 点指光标,通常用于超链接等可点击元素。
Qt::ForbiddenCursor14 带斜杠的圆形光标,通常在拖放操作期间使用,表示拖动的内容不能放在特定的小部件或某个区域内。
Qt::OpenHandCursor17 手形光标,表示张开的手,通常用来表示光标下方的区域是用户可以点击和拖动以滚动视图的可见部分。
Qt::ClosedHandCursor18 手形光标,表示合拢的手,通常用来表示正在进行涉及滚动的拖放操作。
Qt::WhatsThisCursor15 带问号箭头,通常用来指示小部件有“这是什么?”的帮助信息。
Qt::BusyCursor16 时钟或沙漏光标,通常在后台执行允许用户与应用程序交互的操作时显示。
Qt::DragMoveCursor20通常在拖动项时使用的光标。
Qt::DragCopyCursor19通常在拖动项以复制它时使用的光标。
Qt::DragLinkCursor21通常在拖动项以创建链接时使用的光标。
Qt::BitmapCursor24 

enum Qt::DateFormat

常量描述
Qt::TextDate0默认的Qt格式,包括日期和月份名称、月份中的日期和完整的年份。日期和月份名称将使用英文简称(C区域)。这实际上使用日期的格式ddd MMM d yyyy,时间的格式HH:mm:ss,结合日期时间和可选的时区偏移量后缀,如果适用,则会将这些格式组合起来。在从字符串读取时,时间部分的秒上也会识别出小数部分,如HH:mm:ss.zzz,并且可能识别格式的一些较小变化,以兼容Qt的早期版本和未来格式变更。特别是,时区偏移量后缀目前使用GMT[±tzoff],其中tzoffHH[[:]mm]格式表示(两位数小时和可选的两位数分钟,可选的分隔符是冒号);在Qt未来版本中将使用而不是GMT,因此预定的UTC格式将被识别。
Qt::ISODateWithMs9ISO 8601扩展格式:日期使用yyyy-MM-dd格式,时间使用HH:mm:ss.zzz,或联合日期和时间使用yyyy-MM-ddTHH:mm:ss.zzz(例如2017-07-24T15:46:29.739)格式,可选的时区后缀(Z表示UTC,否则为±HH:mm偏移量)适用。在解析时,日期和时间之间的分隔符' '可以替换为'T';不允许使用其他空格字符。此格式还接受时间部分为HH:mm或简单的HH格式,这两种格式都可能包含小数部分,HH:mm.zzzHH.zzz,应用到最后显示的字段(小时或分钟)。
Qt::ISODate1ISO 8601扩展格式,与ISODateWithMs类似,但转换为字符串时省略了毫秒部分(.zzz)。从字符串读取时没有差异:如果最后一个时间字段上存在小数部分,两个格式都将接受它。
Qt::RFC2822Date8RFC 2822RFC 850RFC 1036格式:将日期转换为字符串形式时,格式使用dd MMM yyyy,时间使用HH:mm:ss。对于组合日期和时间,将这两种格式组合为dd MMM yyyy HH:mm:ss ±tzoff(省略第一个格式中可选的每周的第一天)。从字符串读取时,将识别组合日期和时间([ddd,] dd MMM yyyy [HH:mm[:ss]][ ±tzoff]ddd MMM dd[ HH:mm:ss] yyyy[ ±tzoff]),其中tzoffHHmm格式的时区偏移。文本前后可以出现任意空格,任何非空空格都可以替换此格式中的空格。对于单独的日期和时间,将匹配相同的格式,并忽略不需要的部分。特别是,请注意没有伴随日期的时间将不被识别。

注意: 对于ISODate格式,每个yMd分别代表年份、月份和日期的单个数字,用于指定日期。每个Hms分别代表小时(最多24小时)、分钟和用于指定时间的秒数。24小时的小时数,其他时间字段为0,表示下一天的开始。一个.zzz表示前一个字段的分数后缀,这可能通过逗号','或点'.'与之分隔。接受超过毫秒的精度,但会丢弃,四舍五入到最接近的可表示的毫秒。当同时指定日期和时间时,使用字面量T来分隔日期和时间。对于TextDateRFC2822Date格式,ddd代表星期名称的前三个字母,MMM代表月份名称的前三个字母。无论用户偏好或系统设置如何,星期和月份的名称总是英文(C区域)。其他格式字符的用法与ISODate格式相同,只是24小时不能作为小时数。括号[...]中的格式部分是可选的;括号不是格式的一部分。这里的正负号字符'±'表示正负号字符,'-'表示负号,'+'表示正号。

注意: 时区偏差以格林尼治东部为正,西部为负,这与基于UTC的偏差表示法(与一些基于GMT的时区名称冲突,如Etc/GMT+3,它们使用相反的约定)。

另请参阅 QDate::toString(),QTime::toString(),QDateTime::toString(),QDate::fromString(),QTime::fromString()和QDateTime::fromString()。

枚举 Qt::DayOfWeek

常量
Qt::Monday1
Qt::Tuesday2
Qt::Wednesday3
Qt::Thursday4
Qt::Friday5
Qt::Saturday6
Qt::Sunday7

枚举 Qt::DockWidgetArea
标志 Qt::DockWidgetAreas

表示QDockWidget可以连接到的区域。

注意: 具有选项卡的浮动坞组件可以停靠在任何地方。

常量描述
Qt::LeftDockWidgetArea0x1QMainWindow的左侧坞区。
Qt::RightDockWidgetArea0x2QMainWindow的右侧坞区。
Qt::TopDockWidgetArea0x4QMainWindow的顶部坞区。
Qt::BottomDockWidgetArea0x8QMainWindow的底部坞区。
Qt::AllDockWidgetAreasDockWidgetArea_Mask所有坞组件区域(默认)。
Qt::NoDockWidgetArea0没有坞组件区域。

文档组件区域类型是原始类型为QFlags<DockWidgetArea>。它存储了一个或组合的DockWidgetArea值。

另请参阅 QDockWidget::setAllowedAreasQDockWidget::isAreaAllowed

枚举 Qt::DropAction
标志 Qt::DropActions

常量描述
Qt::CopyAction0x1将数据复制到目标。
Qt::MoveAction0x2将数据从源移动到目标。
Qt::LinkAction0x4从源到目标创建一个链接。
Qt::ActionMask0xff 
Qt::IgnoreAction0x0忽略操作(不对数据进行任何操作)。
Qt::TargetMoveAction0x8002在Windows上,当应该由目标应用程序接管D&D数据的所有权时,使用此值,即源应用程序不应删除数据。在X11上,使用此值来进行移动。在Mac上不使用TargetMoveAction。

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

enum Qt::Edge
flags Qt::Edges

此枚举类型指定矩形的边。

常量描述
Qt::TopEdge0x00001矩形的上边。
Qt::LeftEdge0x00002矩形的左边。
Qt::RightEdge0x00004矩形的右边。
Qt::BottomEdge0x00008矩形的下边。

Edges类型是QFlags<Edge>的typedef。它存储Edge值的OR组合。

enum Qt::EnterKeyType

可用于更改虚拟键盘上Return键的显示。

注意:并非所有这些值都在所有平台上得到支持。对于不支持的价值,将使用默认键。

常量描述
Qt::EnterKeyDefault0默认的Enter键。这可以是关闭键盘的按钮,或者在多行输入字段的情况下引起新行的Return按钮。
Qt::EnterKeyReturn1显示插入新行的Return按钮。按此按钮时,键盘不会关闭。
Qt::EnterKeyDone2显示“完成”按钮。按此按钮时,键盘将关闭。
Qt::EnterKeyGo3显示“前往”按钮。通常用于地址栏输入URL时;按此按钮时,键盘将关闭。
Qt::EnterKeySend4显示“发送”按钮。按此按钮时,键盘将关闭。
Qt::EnterKeySearch5显示“搜索”按钮。按此按钮时,键盘将关闭。
Qt::EnterKeyNext6显示“下一个”按钮。通常用于表单中允许导航到下一输入字段;按此按钮时,键盘不会关闭。
Qt::EnterKeyPrevious7显示“上一个”按钮。按此按钮时,键盘不会关闭。

enum Qt::EventPriority

可以用此枚举来指定事件优先级。

常量描述
Qt::HighEventPriority1具有此优先级的事件会在具有NormalEventPriority或LowEventPriority的事件之前发送。
Qt::NormalEventPriority0具有此优先级的事件会在具有HighEventPriority的事件之后发送,但在具有LowEventPriority的事件之前。
Qt::LowEventPriority-1具有此优先级的事件会在具有HighEventPriority或NormalEventPriority的事件之后发送。

请注意,这些值仅提供方便,因为事件优先级可以是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::OddEvenFill0指定使用奇偶填充规则填充区域。根据此规则,我们通过以下方法确定一个点是否在形状内。从点到形状外的位置画一条水平线,并计算交叉点的数量。如果交叉点的数量是奇数,则该点在形状内。此模式是默认模式。
Qt::WindingFill1指定使用非零线段环绕填充规则填充区域。根据此规则,我们通过以下方法确定一个点是否在形状内。从点到形状外的位置画一条水平线。在每个交叉点确定线的方向是向上还是向下。环绕数是通过求和每个交叉点的方向来确定的。如果该数为非零,则该点在形状内。此填充模式也可以在大多数情况下视为封闭形状的交集。

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

常量描述
Qt::FindDirectChildrenOnly0x0仅查看对象的直接子代。
Qt::FindChildrenRecursively0x1查看对象的所有子代(递归搜索)。

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

枚举 Qt::FocusPolicy

此枚举类型定义了小部件在获取键盘焦点方面可以拥有的各种策略。

常量描述
Qt::TabFocus0x1通过制表符接受焦点。
Qt::ClickFocus0x2通过点击接受焦点。
Qt::StrongFocusTabFocus | ClickFocus | 0x8通过制表符和点击接受焦点。在 macOS 上,这还将表明小部件在“文本/列表焦点模式”下接受制表符焦点。
Qt::WheelFocusStrongFocus | 0x4类似于 Qt::StrongFocus,加上小部件可以通过鼠标滚轮接受焦点。
Qt::NoFocus0小部件不接受焦点。

枚举 Qt::FocusReason

此枚举指定焦点改变的原因。它将通过 QWidget::setFocus 传递,并且可以在焦点变化时发送到小部件的 QFocusEvent 中检索。

常量描述
Qt::MouseFocusReason0发生鼠标动作。
Qt::TabFocusReason1按下了制表符键。
Qt::BacktabFocusReason2发生退格。此输入可能包括 Shift 或 Control 键;例如 Shift+Tab。
Qt::ActiveWindowFocusReason3窗口系统使此窗口变为活动或非活动。
Qt::PopupFocusReason4应用程序打开/关闭了弹出窗口,该窗口抢夺/释放了键盘焦点。
Qt::ShortcutFocusReason5用户输入了标签的表亲快捷方式。
Qt::MenuBarFocusReason6菜单栏获取了焦点。
Qt::OtherFocusReason7其他原因,通常是应用程序特定的。

另请参阅小部件中的键盘焦点

枚举 Qt::GestureFlag
标志 Qt::GestureFlags

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

常量描述
Qt::DontStartGestureOnChildren0x01默认情况下,手势可以在小部件或其任何子部件上开始。使用此标志可禁用此功能,并允许仅在组件上开始手势。
Qt::ReceivePartialGestures0x02允许将被忽略的手势事件传播到指定了该提示的父控件。默认情况下,只有处于Qt::GestureStarted状态的手势才被传播,并且控件总是接收到从Qt::GestureStarted状态的手势开始,以处于Qt::GestureFinishedQt::GestureCanceled状态的手势结束的完整手势序列。
Qt::IgnoredGesturesPropagateToParent (自 Qt 4.7 开始)0x04允许对手势事件传播进行微调。在抓取手势时设置标志,所有被忽略的局部手势将传播到它们的父元素。

GestureFlags类型是QFlags的typedef。它存储GestureFlag值的或组合。

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

enum Qt::GestureState

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

常量描述
Qt::NoGesture0没有检测到手势。
Qt::GestureStarted1一个连续的手势已开始。
Qt::GestureUpdated2手势持续。
Qt::GestureFinished3手势已完成。
Qt::GestureCanceled4手势已被取消。

另请参阅QGesture

enum Qt::GestureType

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

常量描述
Qt::TapGesture1触摸手势。
Qt::TapAndHoldGesture2触摸并保持(长触摸)手势。
Qt::PanGesture3平移手势。
Qt::PinchGesture4捏合手势。
Qt::SwipeGesture5滑动手势。
Qt::CustomGesture0x0100一个可以用来检查手势是否是用户定义的手势ID的标志。

用户定义的手势通过QGestureRecognizer::registerRecognizer()函数注册,此函数生成一个设置有Qt::CustomGesture标志的自定义手势ID。

另请参阅QGestureQWidget::grabGestureQGraphicsObject::grabGesture

enum Qt::GlobalColor

Qt的预定义QColor对象

常量描述
Qt::white3白色 (#ffffff)
Qt::black2黑色 (#000000)
Qt::red7红色 (#ff0000)
Qt::darkRed13深红色 (#800000)
Qt::green8绿色 (#00ff00)
Qt::darkGreen14深绿色 (#008000)
Qt::blue9蓝色 (#0000ff)
Qt::darkBlue15深蓝色 (#000080)
Qt::cyan10青色 (#00ffff)
Qt::darkCyan16深青色 (#008080)
Qt::magenta11品红色 (#ff00ff)
Qt::darkMagenta17深品红色 (#800080)
Qt::yellow12黄色 (#ffff00)
Qt::darkYellow18深黄色 (#808000)
Qt::gray5灰色 (#a0a0a4)
Qt::darkGray4深灰色 (#808080)
Qt::lightGray6浅灰色 (#c0c0c0)
Qt::transparent19透明黑色值(即,QColor(0, 0, 0, 0))
Qt::color000像素值(用于位图)
Qt::color111像素值(用于位图)

另请参阅QColor

Qt::HANDLE

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

enum class Qt::HighDpiScaleFactorRoundingPolicy

此枚举描述了可能的High-DPI缩放因子舍入策略,这些策略决定了如何处理非整数缩放因子(如Windows 150%)。

活动策略是通过在创建应用对象之前调用 QGuiApplication::setHighDpiScaleFactorRoundingPolicy() 来设置的。

常量描述
Qt::HighDpiScaleFactorRoundingPolicy::Round10.5及以上的情况向上取整。
Qt::HighDpiScaleFactorRoundingPolicy::Ceil2总是向上取整。
Qt::HighDpiScaleFactorRoundingPolicy::Floor3总是向下取整。
Qt::HighDpiScaleFactorRoundingPolicy::RoundPreferFloor40.75及以上的情况向上取整。
Qt::HighDpiScaleFactorRoundingPolicy::PassThrough5不取整。

另请参阅QGuiApplication::setHighDpiScaleFactorRoundingPolicy

enum Qt::HitTestAccuracy

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

常量描述
Qt::ExactHit0输入发生的点必须精确地与文档的输入敏感部分一致。
Qt::FuzzyHit1输入发生的点可以位于文档的输入敏感部分附近。

enum Qt::ImageConversionFlag
flags Qt::ImageConversionFlags

标记为“(default)”的选项如果未包含列表中的其他值(因为默认值为零)则被设置为。

颜色/单色偏好(对QBitmap忽略)

常量描述
Qt::AutoColor0x00000000(默认)- 如果图像的深度为1并且仅包含黑色和白色像素,则拼贴图变为单色。
Qt::ColorOnly0x00000003拼贴图将被抖动/转换为原生显示深度。
Qt::MonoOnly0x00000002拼贴图变为单色。如有必要,将使用选择的抖动算法进行抖动。

抖动模式偏好

常量描述
Qt::DiffuseDither0x00000000(默认)- 使用误差扩散的高保真抖动。
Qt::OrderedDither0x00000010较快的有序抖动。
Qt::ThresholdDither0x00000020不抖动;使用最接近的颜色。

1位alpha蒙版抖动模式偏好

常量描述
Qt::ThresholdAlphaDither0x00000000(默认)- 不抖动。
Qt::OrderedAlphaDither0x00000004较快的有序抖动。
Qt::DiffuseAlphaDither0x00000008使用误差扩散的高保真抖动。

颜色匹配与抖动偏好

常量描述
Qt::PreferDither0x00000040在转换为更小的色彩空间时始终抖动图像。
Qt::AvoidDither0x00000080只在源图像使用的不同颜色多于目标格式颜色表大小时,才对索引格式进行抖动。
Qt::AutoDither0x00000000(默认)- 仅当转换为1或8位索引格式时才抖动。
Qt::NoOpaqueDetection0x00000100不检查图像是否包含非不透明像素。如果已知图像是半透明的并且想避免在找到非不透明像素之前检查图像中的像素的开销,或者如果想使拼贴图保留alpha通道用于其他原因,请使用此选项。如果图像没有alpha通道,则此标志没有作用。
Qt::NoFormatConversion0x00000200不对图像执行任何格式转换。当需要将QImage转换为QPixmap进行一次性的渲染操作时可能很有用。注意,不在首选格式中的QPixmap将作为绘制设备要慢得多。

ImageConversionFlags类型是QFlags类型定义。它存储了ImageConversionFlag值的或组合。

enum Qt::InputMethodHint
flags Qt::InputMethodHints

常量描述
Qt::ImhNone0x0无提示。

改变行为的标志

常量描述
Qt::ImhHiddenText0x1输入法在输入时不应显示字符。将 QLineEdit::echoMode 设置为 Password 时会自动设置此选项。请注意,设置 ImhHiddenText 不会更改回声模式。
Qt::ImhSensitiveData0x2输入法不应将输入的文本存储在任何持久存储中,如预测性用户字典。
Qt::ImhNoAutoUppercase0x4输入法不应在句子结束时尝试自动切换到大写。
Qt::ImhPreferNumbers0x8优先使用数字(但不是必需的)。
Qt::ImhPreferUppercase0x10优先使用大写字母(但不是必需的)。
Qt::ImhPreferLowercase0x20优先使用小写字母(但不是必需的)。
Qt::ImhNoPredictiveText0x40在输入时不要使用预测文本(即字典查找)。
Qt::ImhDate0x80文本编辑器作为日期字段使用。
Qt::ImhTime0x100文本编辑器作为时间字段使用。
Qt::ImhPreferLatin0x200优先使用拉丁字符(但不是必需的)。
Qt::ImhMultiLine0x400可以输入多个行到文本字段。
Qt::ImhNoEditMenu0x800不要使用内置的编辑菜单。此标志从 Qt 5.11 中引入。
Qt::ImhNoTextHandles0x1000不要使用内置的文本光标和选择句柄。此标志从 Qt 5.11 中引入。

限制输入的标志(专用标志)

常量描述
Qt::ImhDigitsOnly0x10000只允许数字。
Qt::ImhFormattedNumbersOnly0x20000只允许数字输入。这包括小数点和负号。
Qt::ImhUppercaseOnly0x40000只允许大写字母输入。
Qt::ImhLowercaseOnly0x80000只允许小写字母输入。
Qt::ImhDialableCharactersOnly0x100000只允许适合电话拨号的字符。
Qt::ImhEmailCharactersOnly0x200000只允许适合电子邮件地址的字符。
Qt::ImhUrlCharactersOnly0x400000只允许适合 URL 的字符。
Qt::ImhLatinOnly0x800000只允许基于拉丁的输入。

掩码

常量描述
Qt::ImhExclusiveInputMask0xffff0000此掩码如果使用任何专用标志将为非零。

注意: 如果将多个专用标志进行按位或操作,则结果字符集将是指定集的并集。例如,指定 ImhNumbersOnlyImhUppercaseOnly 将得到一个包含数字和大写字母的集。

InputMethodHints 类型是 InputMethodHint 的 typedef。它存储 InputMethodHint 值的或组合。

另请参阅 QGraphicsItem::inputMethodHints

enum Qt::InputMethodQuery
flags Qt::InputMethodQueries

常量描述
Qt::ImEnabled0x1小部件接受输入法输入。
Qt::ImCursorRectangle0x2以小部件坐标覆盖输入光标区域的长方形。
Qt::ImFont0x4当前用于文本输入的字体。
Qt::ImCursorPosition0x8输入区域周围文本中光标的逻辑位置(参见 ImSurroundingText)。该位置不包含由 QInputMethodEvent::Cursor 控制的预编辑区域内的光标偏移量。
Qt::ImSurroundingText0x10输入区域周围的纯文本文本,例如当前段落。
Qt::ImCurrentSelection0x20当前选中的文本。
Qt::ImMaximumTextLength0x40小部件可以容纳的字符最大数量。如果没有限制,返回QVariant::QVariant。
Qt::ImAnchorPosition0x80选择锚点的位置。这可能与ImCursorPosition的值较小或较大,这取决于光标位于选择的一侧。如果没有选择,则返回与ImCursorPosition相同的值。
Qt::ImHints0x100对预期输入的输入方法提示。请见Qt::InputMethodHints)
Qt::ImPreferredLanguage0x200首选输入语言。
Qt::ImPlatformData0x80000000输入法特定的平台数据。
Qt::ImAbsolutePosition0x400光标在整个文档中的逻辑位置。该位置不包含由QInputMethodEvent::Cursor控制的预编辑区域内光标的偏移。
Qt::ImTextBeforeCursor0x800光标之前的纯文本。小部件可以决定返回多少文本,但必须返回非空字符串,除非光标位于文档开始处。
Qt::ImTextAfterCursor0x1000光标之后的纯文本。小部件可以决定返回多少文本,但必须返回非空字符串,除非光标位于文档末尾。
Qt::ImEnterKeyType0x2000Enter键的类型。
Qt::ImAnchorRectangle0x4000选择锚点的边界矩形。这个值从Qt 5.7版开始加入。
Qt::ImInputItemClipRectangle0x8000实际暴露的输入项矩形。输入项的一部分可能会被剪裁。这个值将考虑剪裁并返回实际绘制项的矩形。矩形以小部件坐标为准。
Qt::ImReadOnly0x10000小部件只读。这个值从Qt 6.2版开始加入。

掩码

常量描述
Qt::ImQueryInputImCursorRectangle | ImCursorPosition | ImSurroundingText | ImCurrentSelection | ImAnchorRectangle | ImAnchorPosition输入通常更改的属性。
Qt::ImQueryAll0xffffffff查询所有输入法属性。

The InputMethodQueries type is a typedef for QFlags<InputMethodQuery>. It stores an OR combination of InputMethodQuery values.

参见 QInputMethodQueryEvent.

枚举 Qt::ItemDataRole

模型中的每个项都与一系列数据元素相关联,每个元素都有自己的角色。这些角色被视图用来指示模型它需要哪种类型的数据。自定义模型应返回这些类型的数据。

通用角色(及其相关类型)包括:

常量描述
Qt::DisplayRole0以文本形式渲染的关键数据。(QString
Qt::DecorationRole1以图标形式渲染的装饰数据。(QColorQIconQPixmap
Qt::EditRole2适合在编辑器中编辑的格式数据。(QString
Qt::ToolTipRole3在项的工具提示中显示的数据。(QString
Qt::StatusTipRole4在状态栏中显示的数据。(QString
Qt::WhatsThisRole5"这是什么?"模式下显示的数据。(QString
Qt::SizeHintRole13将提供给视图的项的大小提示。(QSize

描述外观和元数据的角色(及其相关类型)

常量描述
Qt::FontRole6用于以默认委托渲染的项的字体。(QFont
Qt::TextAlignmentRole7以默认委托渲染的项中的文本对齐方式。(Qt::Alignment
Qt::BackgroundRole8用于默认委托渲染的项的后台画刷。(QBrush
Qt::ForegroundRole9用于默认委托渲染的项的前景画刷(通常是文字颜色)。(《a href="qbrush.html" translate="no">QBrush)
Qt::CheckStateRole10此角色用于获取项的勾选状态。(Qt::CheckState)
Qt::InitialSortOrderRole14此角色用于获取标题视图部分的初始排序顺序。(Qt::SortOrder)。

可访问性角色(与其关联的类型)

常量描述
Qt::AccessibleTextRole11用于辅助功能扩展和插件的文本,例如屏幕阅读器。(QString
Qt::AccessibleDescriptionRole12用于辅助功能的项的描述。(QString

用户角色

常量描述
Qt::UserRole0x0100可被用于特定应用目的的第一个角色。

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

枚举 Qt::ItemFlag
标志 Qt::ItemFlags

此枚举描述了项的属性

常量描述
Qt::NoItemFlags0没有设置任何属性。
Qt::ItemIsSelectable1它可以被选中。
Qt::ItemIsEditable2它可以被编辑。
Qt::ItemIsDragEnabled4它可以被拖动。
Qt::ItemIsDropEnabled8它可以用作目标。
Qt::ItemIsUserCheckable16用户可以勾选或取消勾选它。
Qt::ItemIsEnabled32用户可以与此项交互。
Qt::ItemIsAutoTristate64项的状态取决于其子项的状态。这允许在 QTreeWidget 中自动管理父项的状态(如果所有子项都被勾选则为勾选状态,如果所有子项都被取消勾选则为未勾选状态,如果只有部分子项被勾选则为部分勾选状态)。
Qt::ItemNeverHasChildren128项从不具有子项。这仅用于优化目的。
Qt::ItemIsUserTristate256用户可以通过循环访问三个独立的状态。此值是在 Qt 5.5 中添加的。

注意,钩选项需要被赋予一组适当的标志和一个初始状态,以指示项是否被勾选或未勾选。对于模型/视图组件,这会被自动处理,但对于 QListWidgetItem、QTableWidgetItem 和 QTreeWidgetItem 的实例,需要显式设置。

注意,如果索引设置了 Qt::ItemNeverHasChildren 标志,重新实现 QAbstractItemModel::hasChildren 以返回 true 是未定义的行为。

ItemFlags 类型是 QFlags<`ItemFlag>` 的 typedef。它存储了 ItemFlag 值的 OR 组合。

另请参阅 QAbstractItemModel

枚举 Qt::ItemSelectionMode

此枚举用于 `QGraphicsItem`、`QGraphicsScene` 和 `QGraphicsView` 以指定如何选择项或如何确定形状和项是否冲突。

常量描述
Qt::ContainsItemShape0x0输出列表仅包含那些其 `shape` 完全位于选择区域内的项。与区域轮廓相交的项不包括在内。
Qt::IntersectsItemShape0x1输出列表包含那些其 `shape` 完全位于选择区域内,以及与区域轮廓相交的项。这是一个常见的橡皮筋选择模式。
Qt::ContainsItemBoundingRect0x2输出列表仅包含那些其边界矩形完全位于选择区域内的项目。与区域轮廓相交的项目不包括在内。
Qt::IntersectsItemBoundingRect0x3输出列表包含那些其边界矩形完全位于选择区域内,以及与区域轮廓相交的项目。此方法通常用于确定需要重绘的区域。

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

enum Qt::ItemSelectionOperation

此枚举用于在QGraphicsScene中设置选择区域时指定对当前选中项目应执行的操作。

常量描述
Qt::ReplaceSelection0当前选中项目将被选择区域内的项目替换。
Qt::AddToSelection1选择区域内的项目将被添加到当前选中项目。

另请参阅QGraphicsScene::setSelectionArea()。

enum Qt::Key

Qt中使用的键名。

常量描述
Qt::Key_Escape0x01000000 
Qt::Key_Tab0x01000001 
Qt::Key_Backtab0x01000002 
Qt::Key_Backspace0x01000003 
Qt::Key_Return0x01000004 
Qt::Key_Enter0x01000005通常位于数字键盘上。
Qt::Key_Insert0x01000006 
Qt::Key_Delete0x01000007 
Qt::Key_Pause0x01000008暂停/中断键(注意:与暂停媒体无关)
Qt::Key_Print0x01000009 
Qt::Key_SysReq0x0100000a 
Qt::Key_Clear0x0100000b对应于某些苹果键盘模型的清除键。在其他系统中,它通常映射到数字键盘上的键5,当Num Lock关闭时。
Qt::Key_Home0x01000010 
Qt::Key_End0x01000011 
Qt::Key_Left0x01000012 
Qt::Key_Up0x01000013 
Qt::Key_Right0x01000014 
Qt::Key_Down0x01000015 
Qt::Key_PageUp0x01000016 
Qt::Key_PageDown0x01000017 
Qt::Key_Shift0x01000020 
Qt::Key_Control0x01000021在macOS上,这与命令键相对应。
Qt::Key_Meta0x01000022在macOS上,这与控制键相对应。在Windows键盘上,此键映射到Windows键。
Qt::Key_Alt0x01000023 
Qt::Key_AltGr0x01001103在Windows中,当向此键发送KeyDown事件时,也会设置Ctrl+Alt修饰符。
Qt::Key_CapsLock0x01000024 
Qt::Key_NumLock0x01000025 
Qt::Key_ScrollLock0x01000026 
Qt::Key_F10x01000030 
Qt::Key_F20x01000031 
Qt::Key_F30x01000032 
Qt::Key_F40x01000033 
Qt::Key_F50x01000034 
Qt::Key_F60x01000035 
Qt::Key_F70x01000036 
Qt::Key_F80x01000037 
Qt::Key_F90x01000038 
Qt::Key_F100x01000039 
Qt::Key_F110x0100003a 
Qt::Key_F120x0100003b 
Qt::Key_F130x0100003c 
Qt::Key_F140x0100003d 
Qt::Key_F150x0100003e 
Qt::Key_F160x0100003f 
Qt::Key_F170x01000040 
Qt::Key_F180x01000041 
Qt::Key_F190x01000042 
Qt::Key_F200x01000043 
Qt::Key_F210x01000044 
Qt::Key_F220x01000045 
Qt::Key_F230x01000046 
Qt::Key_F240x01000047 
Qt::Key_F250x01000048 
Qt::Key_F260x01000049 
Qt::Key_F270x0100004a 
Qt::Key_F280x0100004b 
Qt::Key_F290x0100004c 
Qt::Key_F300x0100004d 
Qt::Key_F310x0100004e 
Qt::Key_F320x0100004f 
Qt::Key_F330x01000050 
Qt::Key_F340x01000051 
Qt::Key_F350x01000052 
Qt::Key_Super_L0x01000053 
Qt::Key_Super_R0x01000054 
Qt::Key_Menu0x01000055 
Qt::Key_Hyper_L0x01000056 
Qt::Key_Hyper_R0x01000057 
Qt::Key_Help0x01000058 
Qt::Key_Direction_L0x01000059 
Qt::Key_Direction_R0x01000060 
Qt::Key_Space0x20 
Qt::Key_AnyKey_Space 
Qt::Key_Exclam0x21 
Qt::Key_QuoteDbl0x22 
Qt::Key_NumberSign0x23 
Qt::Key_Dollar0x24 
Qt::Key_Percent0x25 
Qt::Key_Ampersand0x26 
Qt::Key_Apostrophe0x27 
Qt::Key_ParenLeft0x28 
Qt::Key_ParenRight0x29 
Qt::Key_Asterisk0x2a 
Qt::Key_Plus0x2b 
Qt::Key_Comma0x2c 
Qt::Key_Minus0x2d 
Qt::Key_Period0x2e 
Qt::Key_Slash0x2f 
Qt::Key_00x30 
Qt::Key_10x31 
Qt::Key_20x32 
Qt::Key_30x33 
Qt::Key_40x34 
Qt::Key_50x35 
Qt::Key_60x36 
Qt::Key_70x37 
Qt::Key_80x38 
Qt::Key_90x39 
Qt::Key_Colon0x3a 
Qt::Key_Semicolon0x3b 
Qt::Key_Less0x3c 
Qt::Key_Equal0x3d 
Qt::Key_Greater0x3e 
Qt::Key_Question0x3f 
Qt::Key_At0x40 
Qt::Key_A0x41 
Qt::Key_B0x42 
Qt::Key_C0x43 
Qt::Key_D0x44 
Qt::Key_E0x45 
Qt::Key_F0x46 
Qt::Key_G0x47 
Qt::Key_H0x48 
Qt::Key_I0x49 
Qt::Key_J0x4a 
Qt::Key_K0x4b 
Qt::Key_L0x4c 
Qt::Key_M0x4d 
Qt::Key_N0x4e 
Qt::Key_O0x4f 
Qt::Key_P0x50 
Qt::Key_Q0x51 
Qt::Key_R0x52 
Qt::Key_S0x53 
Qt::Key_T0x54 
Qt::Key_U0x55 
Qt::Key_V0x56 
Qt::Key_W0x57 
Qt::Key_X0x58 
Qt::Key_Y0x59 
Qt::Key_Z0x5a 
Qt::Key_BracketLeft0x5b 
Qt::Key_Backslash0x5c 
Qt::Key_BracketRight0x5d 
Qt::Key_AsciiCircum0x5e 
Qt::Key_Underscore0x5f 
Qt::Key_QuoteLeft0x60 
Qt::Key_BraceLeft0x7b 
Qt::Key_Bar0x7c 
Qt::Key_BraceRight0x7d 
Qt::Key_AsciiTilde0x7e 
Qt::Key_nobreakspace0x0a0 
Qt::Key_exclamdown0x0a1 
Qt::Key_cent0x0a2 
Qt::Key_sterling0x0a3 
Qt::Key_currency0x0a4 
Qt::Key_yen0x0a5 
Qt::Key_brokenbar0x0a6 
Qt::Key_section0x0a7 
Qt::Key_diaeresis0x0a8 
Qt::Key_copyright0x0a9 
Qt::Key_ordfeminine0x0aa 
Qt::Key_guillemotleft0x0ab 
Qt::Key_notsign0x0ac 
Qt::Key_hyphen0x0ad 
Qt::Key_registered0x0ae 
Qt::Key_macron0x0af 
Qt::Key_degree0x0b0 
Qt::Key_plusminus0x0b1 
Qt::Key_twosuperior0x0b2 
Qt::Key_threesuperior0x0b3 
Qt::Key_acute0x0b4 
Qt::Key_micro(自Qt 6.7起)0x0b5 
Qt::Key_muKey_microKey_micro的废弃别名
Qt::Key_paragraph0x0b6 
Qt::Key_periodcentered0x0b7 
Qt::Key_cedilla0x0b8 
Qt::Key_onesuperior0x0b9 
Qt::Key_masculine0x0ba 
Qt::Key_guillemotright0x0bb 
Qt::Key_onequarter0x0bc 
Qt::Key_onehalf0x0bd 
Qt::Key_threequarters0x0be 
Qt::Key_questiondown0x0bf 
Qt::Key_Agrave0x0c0 
Qt::Key_Aacute0x0c1 
Qt::Key_Acircumflex0x0c2 
Qt::Key_Atilde0x0c3 
Qt::Key_Adiaeresis0x0c4 
Qt::Key_Aring0x0c5 
Qt::Key_AE0x0c6 
Qt::Key_Ccedilla0x0c7 
Qt::Key_Egrave0x0c8 
Qt::Key_Eacute0x0c9 
Qt::Key_Ecircumflex0x0ca 
Qt::Key_Ediaeresis0x0cb 
Qt::Key_Igrave0x0cc 
Qt::Key_Iacute0x0cd 
Qt::Key_Icircumflex0x0ce 
Qt::Key_Idiaeresis0x0cf 
Qt::Key_ETH0x0d0 
Qt::Key_Ntilde0x0d1 
Qt::Key_Ograve0x0d2 
Qt::Key_Oacute0x0d3 
Qt::Key_Ocircumflex0x0d4 
Qt::Key_Otilde0x0d5 
Qt::Key_Odiaeresis0x0d6 
Qt::Key_multiply0x0d7 
Qt::Key_Ooblique0x0d8 
Qt::Key_Ugrave0x0d9 
Qt::Key_Uacute0x0da 
Qt::Key_Ucircumflex0x0db 
Qt::Key_Udiaeresis0x0dc 
Qt::Key_Yacute0x0dd 
Qt::Key_THORN0x0de 
Qt::Key_ssharp0x0df 
Qt::Key_division0x0f7 
Qt::Key_ydiaeresis0x0ff 
Qt::Key_Multi_key0x01001120 
Qt::Key_Codeinput0x01001137 
Qt::Key_SingleCandidate0x0100113c 
Qt::Key_MultipleCandidate0x0100113d 
Qt::Key_PreviousCandidate0x0100113e 
Qt::Key_Mode_switch0x0100117e 
Qt::Key_Kanji0x01001121 
Qt::Key_Muhenkan0x01001122 
Qt::Key_Henkan0x01001123 
Qt::Key_Romaji0x01001124 
Qt::Key_Hiragana0x01001125 
Qt::Key_Katakana0x01001126 
Qt::Key_Hiragana_Katakana0x01001127 
Qt::Key_Zenkaku0x01001128 
Qt::Key_Hankaku0x01001129 
Qt::Key_Zenkaku_Hankaku0x0100112a 
Qt::Key_Touroku0x0100112b 
Qt::Key_Massyo0x0100112c 
Qt::Key_Kana_Lock0x0100112d 
Qt::Key_Kana_Shift0x0100112e 
Qt::Key_Eisu_Shift0x0100112f 
Qt::Key_Eisu_toggle0x01001130 
Qt::Key_Hangul0x01001131 
Qt::Key_Hangul_Start0x01001132 
Qt::Key_Hangul_End0x01001133 
Qt::Key_Hangul_Hanja0x01001134 
Qt::Key_Hangul_Jamo0x01001135 
Qt::Key_Hangul_Romaja0x01001136 
Qt::Key_Hangul_Jeonja0x01001138 
Qt::Key_Hangul_Banja0x01001139 
Qt::Key_Hangul_PreHanja0x0100113a 
Qt::Key_Hangul_PostHanja0x0100113b 
Qt::Key_Hangul_Special0x0100113f 
Qt::Key_Dead_Grave0x01001250 
Qt::Key_Dead_Acute0x01001251 
Qt::Key_Dead_Circumflex0x01001252 
Qt::Key_Dead_Tilde0x01001253 
Qt::Key_Dead_Macron0x01001254 
Qt::Key_Dead_Breve0x01001255 
Qt::Key_Dead_Abovedot0x01001256 
Qt::Key_Dead_Diaeresis0x01001257 
Qt::Key_Dead_Abovering0x01001258 
Qt::Key_Dead_Doubleacute0x01001259 
Qt::Key_Dead_Caron0x0100125a 
Qt::Key_Dead_Cedilla0x0100125b 
Qt::Key_Dead_Ogonek0x0100125c 
Qt::Key_Dead_Iota0x0100125d 
Qt::Key_Dead_Voiced_Sound0x0100125e 
Qt::Key_Dead_Semivoiced_Sound0x0100125f 
Qt::Key_Dead_Belowdot0x01001260 
Qt::Key_Dead_Hook0x01001261 
Qt::Key_Dead_Horn0x01001262 
Qt::Key_Dead_Stroke0x01001263 
Qt::Key_Dead_Abovecomma0x01001264 
Qt::Key_Dead_Abovereversedcomma0x01001265 
Qt::Key_Dead_Doublegrave0x01001266 
Qt::Key_Dead_Belowring0x01001267 
Qt::Key_Dead_Belowmacron0x01001268 
Qt::Key_Dead_Belowcircumflex0x01001269 
Qt::Key_Dead_Belowtilde0x0100126a 
Qt::Key_Dead_Belowbreve0x0100126b 
Qt::Key_Dead_Belowdiaeresis0x0100126c 
Qt::Key_Dead_Invertedbreve0x0100126d 
Qt::Key_Dead_Belowcomma0x0100126e 
Qt::Key_Dead_Currency0x0100126f 
Qt::Key_Dead_a0x01001280 
Qt::Key_Dead_A0x01001281 
Qt::Key_Dead_e0x01001282 
Qt::Key_Dead_E0x01001283 
Qt::Key_Dead_i0x01001284 
Qt::Key_Dead_I0x01001285 
Qt::Key_Dead_o0x01001286 
Qt::Key_Dead_O0x01001287 
Qt::Key_Dead_u0x01001288 
Qt::Key_Dead_U0x01001289 
Qt::Key_Dead_Small_Schwa0x0100128a 
Qt::Key_Dead_Capital_Schwa0x0100128b 
Qt::Key_Dead_Greek0x0100128c 
Qt::Key_Dead_Lowline0x01001290 
Qt::Key_Dead_Aboveverticalline0x01001291 
Qt::Key_Dead_Belowverticalline0x01001292 
Qt::Key_Dead_Longsolidusoverlay0x01001293 
Qt::Key_Back0x01000061 
Qt::Key_Forward0x01000062 
Qt::Key_Stop0x01000063 
Qt::Key_Refresh0x01000064 
Qt::Key_VolumeDown0x01000070 
Qt::Key_VolumeMute0x01000071 
Qt::Key_VolumeUp0x01000072 
Qt::Key_BassBoost0x01000073 
Qt::Key_BassUp0x01000074 
Qt::Key_BassDown0x01000075 
Qt::Key_TrebleUp0x01000076 
Qt::Key_TrebleDown0x01000077 
Qt::Key_MediaPlay0x01000080设置媒体播放器播放状态的按键
Qt::Key_MediaStop0x01000081设置媒体播放器停止状态的按键
Qt::Key_MediaPrevious0x01000082 
Qt::Key_MediaNext0x01000083 
Qt::Key_MediaRecord0x01000084 
Qt::Key_MediaPause0x01000085设置媒体播放器暂停状态的按键(注意:不是暂停/中断键)
Qt::Key_MediaTogglePlayPause0x01000086切换媒体播放器播放/暂停状态的按键(而不是设置绝对状态)
Qt::Key_HomePage0x01000090 
Qt::Key_Favorites0x01000091 
Qt::Key_Search0x01000092 
Qt::Key_Standby0x01000093 
Qt::Key_OpenUrl0x01000094 
Qt::Key_LaunchMail0x010000a0 
Qt::Key_LaunchMedia0x010000a1 
Qt::Key_Launch00x010000a2 
Qt::Key_Launch10x010000a3 
Qt::Key_Launch20x010000a4 
Qt::Key_Launch30x010000a5 
Qt::Key_Launch40x010000a6 
Qt::Key_Launch50x010000a7 
Qt::Key_Launch60x010000a8 
Qt::Key_Launch70x010000a9 
Qt::Key_Launch80x010000aa 
Qt::Key_Launch90x010000ab 
Qt::Key_LaunchA0x010000ac 
Qt::Key_LaunchB0x010000ad 
Qt::Key_LaunchC0x010000ae 
Qt::Key_LaunchD0x010000af 
Qt::Key_LaunchE0x010000b0 
Qt::Key_LaunchF0x010000b1 
Qt::Key_LaunchG0x0100010e 
Qt::Key_LaunchH0x0100010f 
Qt::Key_MonBrightnessUp0x010000b2 
Qt::Key_MonBrightnessDown0x010000b3 
Qt::Key_KeyboardLightOnOff0x010000b4 
Qt::Key_KeyboardBrightnessUp0x010000b5 
Qt::Key_KeyboardBrightnessDown0x010000b6 
Qt::Key_PowerOff0x010000b7 
Qt::Key_WakeUp0x010000b8 
Qt::Key_Eject0x010000b9 
Qt::Key_ScreenSaver0x010000ba 
Qt::Key_WWW0x010000bb 
Qt::Key_Memo0x010000bc 
Qt::Key_LightBulb0x010000bd 
Qt::Key_Shop0x010000be 
Qt::Key_History0x010000bf 
Qt::Key_AddFavorite0x010000c0 
Qt::Key_HotLinks0x010000c1 
Qt::Key_BrightnessAdjust0x010000c2 
Qt::Key_Finance0x010000c3 
Qt::Key_Community0x010000c4 
Qt::Key_AudioRewind0x010000c5 
Qt::Key_BackForward0x010000c6 
Qt::Key_ApplicationLeft0x010000c7 
Qt::Key_ApplicationRight0x010000c8 
Qt::Key_Book0x010000c9 
Qt::Key_CD0x010000ca 
Qt::Key_Calculator0x010000cb 
Qt::Key_ToDoList0x010000cc 
Qt::Key_ClearGrab0x010000cd 
Qt::Key_Close0x010000ce 
Qt::Key_Copy0x010000cf 
Qt::Key_Cut0x010000d0 
Qt::Key_Display0x010000d1 
Qt::Key_DOS0x010000d2 
Qt::Key_Documents0x010000d3 
Qt::Key_Excel0x010000d4 
Qt::Key_Explorer0x010000d5 
Qt::Key_Game0x010000d6 
Qt::Key_Go0x010000d7 
Qt::Key_iTouch0x010000d8 
Qt::Key_LogOff0x010000d9 
Qt::Key_Market0x010000da 
Qt::Key_Meeting0x010000db 
Qt::Key_MenuKB0x010000dc 
Qt::Key_MenuPB0x010000dd 
Qt::Key_MySites0x010000de 
Qt::Key_News0x010000df 
Qt::Key_OfficeHome0x010000e0 
Qt::Key_Option0x010000e1 
Qt::Key_Paste0x010000e2 
Qt::Key_Phone0x010000e3 
Qt::Key_Calendar0x010000e4 
Qt::Key_Reply0x010000e5 
Qt::Key_Reload0x010000e6 
Qt::Key_RotateWindows0x010000e7 
Qt::Key_RotationPB0x010000e8 
Qt::Key_RotationKB0x010000e9 
Qt::Key_Save0x010000ea 
Qt::Key_Send0x010000eb 
Qt::Key_Spell0x010000ec 
Qt::Key_SplitScreen0x010000ed 
Qt::Key_Support0x010000ee 
Qt::Key_TaskPane0x010000ef 
Qt::Key_Terminal0x010000f0 
Qt::Key_Tools0x010000f1 
Qt::Key_Travel0x010000f2 
Qt::Key_Video0x010000f3 
Qt::Key_Word0x010000f4 
Qt::Key_Xfer0x010000f5 
Qt::Key_ZoomIn0x010000f6 
Qt::Key_ZoomOut0x010000f7 
Qt::Key_Away0x010000f8 
Qt::Key_Messenger0x010000f9 
Qt::Key_WebCam0x010000fa 
Qt::Key_MailForward0x010000fb 
Qt::Key_Pictures0x010000fc 
Qt::Key_Music0x010000fd 
Qt::Key_Battery0x010000fe 
Qt::Key_Bluetooth0x010000ff 
Qt::Key_WLAN0x01000100 
Qt::Key_UWB0x01000101 
Qt::Key_AudioForward0x01000102 
Qt::Key_AudioRepeat0x01000103 
Qt::Key_AudioRandomPlay0x01000104 
Qt::Key_Subtitle0x01000105 
Qt::Key_AudioCycleTrack0x01000106 
Qt::Key_Time0x01000107 
Qt::Key_Hibernate0x01000108 
Qt::Key_View0x01000109 
Qt::Key_TopMenu0x0100010a 
Qt::Key_PowerDown0x0100010b 
Qt::Key_Suspend0x0100010c 
Qt::Key_ContrastAdjust0x0100010d 
Qt::Key_TouchpadToggle0x01000110 
Qt::Key_TouchpadOn0x01000111 
Qt::Key_TouchpadOff0x01000112 
Qt::Key_MicMute0x01000113 
Qt::Key_Red0x01000114 
Qt::Key_Green0x01000115 
Qt::Key_Yellow0x01000116 
Qt::Key_Blue0x01000117 
Qt::Key_ChannelUp0x01000118 
Qt::Key_ChannelDown0x01000119 
Qt::Key_Guide0x0100011a 
Qt::Key_Info0x0100011b 
Qt::Key_Settings0x0100011c 
Qt::Key_MicVolumeUp0x0100011d 
Qt::Key_MicVolumeDown0x0100011e 
Qt::Key_New0x01000120 
Qt::Key_Open0x01000121 
Qt::Key_Find0x01000122 
Qt::Key_Undo0x01000123 
Qt::Key_Redo0x01000124 
Qt::Key_MediaLast0x0100ffff 
Qt::Key_unknown0x01ffffff 
Qt::Key_Call0x01100004一个用来应答或发起呼叫的键(有关切换当前呼叫状态的键,请参阅 Qt::Key_ToggleCallHangup)
Qt::Key_Camera0x01100020一个用来激活相机快照的键。在 Windows 运行时,必须设置环境变量 QT_QPA_ENABLE_CAMERA_KEYS 以接收事件。
Qt::Key_CameraFocus0x01100021一个用来聚焦相机的键。在 Windows 运行时,必须设置环境变量 QT_QPA_ENABLE_CAMERA_KEYS 以接收事件。
Qt::Key_Context10x01100000 
Qt::Key_Context20x01100001 
Qt::Key_Context30x01100002 
Qt::Key_Context40x01100003 
Qt::Key_Flip0x01100006 
Qt::Key_Hangup0x01100005按键用于结束进行中的通话(有关切换当前通话状态的按键,请参阅 Qt::Key_ToggleCallHangup)
Qt::Key_No0x01010002 
Qt::Key_Select0x01010000 
Qt::Key_Yes0x01010001 
Qt::Key_ToggleCallHangup0x01100007按键用于切换当前通话状态(即接听或挂断,具体取决于当前通话状态)
Qt::Key_VoiceDial0x01100008 
Qt::Key_LastNumberRedial0x01100009 
Qt::Key_Execute0x01020003 
Qt::Key_Printer0x01020002 
Qt::Key_Play0x01020005 
Qt::Key_Sleep0x01020004 
Qt::Key_Zoom0x01020006 
Qt::Key_Exit0x0102000a 
Qt::Key_Cancel0x01020001 

参见 QKeyEvent::key

枚举 Qt::KeyboardModifier
flags Qt::KeyboardModifiers

此枚举描述了修饰键。

常量描述
Qt::NoModifier0x00000000没有按修饰键。
Qt::ShiftModifier0x02000000按下键盘上的 Shift 键。
Qt::ControlModifier0x04000000按下键盘上的 Ctrl 键。
Qt::AltModifier0x08000000按下键盘上的 Alt 键。
Qt::MetaModifier0x10000000按下键盘上的 Meta 键。
Qt::KeypadModifier0x20000000按下数字键区按钮。
Qt::GroupSwitchModifier0x40000000X11 仅(除非通过命令行参数在 Windows 上激活)。按下键盘上的 Mode_switch 键。

注意: 在 macOS 上,ControlModifier 值对应于键盘上的 Command 键,而 MetaModifier 值对应于 Control 键。在按下箭头键时,也会设置 KeypadModifier,因为箭头键被视为数字键区的一部分。

注意: 在 Windows 键盘上,Qt::MetaModifier 和 Qt::Key_Meta 映射到 Windows 键。

键盘修饰符类型是 QFlags<KeyboardModifier> 的别称。它存储了 KeyboardModifier 值的 OR 组合。

参见 MouseButtonModifier

枚举 Qt::LayoutDirection

指定 Qt 的布局和文本处理的方向。

常量描述
Qt::LeftToRight0从左到右的布局。
Qt::RightToLeft1从右到左的布局。
Qt::LayoutDirectionAuto2自动布局。

对于某些语言来说,需要从右到左的布局,特别是阿拉伯语和希伯来语。

LayoutDirectionAuto 旨在实现两个目的。当与小部件和布局一起使用时,它将意味着使用父小部件或 QApplication 上设置的布局方向。这相当于 QWidget::unsetLayoutDirection

当 LayoutDirectionAuto 与文本布局一起使用时,它将意味着文本方向性由要布局的字符串内容确定。

参见 QGuiApplication::setLayoutDirectionQWidget::setLayoutDirectionQTextOption::setTextDirectionQString::isRightToLeft

枚举 Qt::MaskMode

此枚举指定了 QPixmap::createMaskFromColor() 和 QImage::createMaskFromColor() 函数的行为。

常量描述
Qt::MaskInColor0创建一个掩码,其中所有匹配给定颜色的像素都是不透明的。
Qt::MaskOutColor1创建一个掩码,其中所有匹配给定颜色的像素都变为透明。

枚举 Qt::MatchFlag
标志 Qt::MatchFlags

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

常量描述
Qt::MatchExactly0执行基于 QVariant 的匹配。
Qt::MatchFixedString8执行基于字符串的匹配。除非指定了 MatchCaseSensitive 标志,否则基于字符串的比较不区分大小写。
Qt::MatchContains1搜索词包含在项目中。
Qt::MatchStartsWith2搜索词与项目的开头匹配。
Qt::MatchEndsWith3搜索词与项目的结尾匹配。
Qt::MatchCaseSensitive16搜索区分大小写。
Qt::MatchRegularExpression4使用正则表达式作为搜索词执行基于字符串的匹配。使用 QRegularExpression。当使用此标志时,可以将 QRegularExpression 对象作为参数传递,并将直接用于搜索。由于预期 QRegularExpression 对象已完全配置,因此将忽略大小写敏感性标志。此枚举值添加于 Qt 5.15。
Qt::MatchWildcard5使用通配符字符串作为搜索词执行基于字符串的匹配。
Qt::MatchWrap32执行环绕搜索,当搜索到达模型中的最后一个项目时,它从第一个项目重新开始,直到检查完所有项目。
Qt::MatchRecursive64搜索整个层次结构。

注意:Qt::MatchExactly,Qt::MatchContains,Qt::MatchStartsWith,Qt::MatchEndsWith,Qt::MatchRegularExpression,Qt::MatchWildcard 和 Qt::MatchFixedString 是互斥的。将它们中的一个设置为 Qt::MatchFlags 参数时获得的行为是未定义的。

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

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

枚举 Qt::Modifier
标志 Qt::Modifiers

此枚举提供 Qt 支持的键盘修饰键的简短名称。

注意:在 macOS 上,CTRL 值对应键盘上的 Command 键,而 META 值对应 Control 键。

常量描述
Qt::SHIFTQt::ShiftModifier所有标准键盘上的 Shift 键。
Qt::METAQt::MetaModifierMeta 键。
Qt::CTRLQt::ControlModifierCtrl 键。
Qt::ALTQt::AltModifier正常的 Alt 键,但不包括 AltGr 等键。

Modifiers 类型是 QFlags<Modifier> 的typedef,它存储 Modifier 值的 OR 组合。

另请参阅:KeyboardModifierMouseButton

枚举 Qt::MouseButton
标志 Qt::MouseButtons

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

常量描述
Qt::NoButton0x00000000按钮状态不指任何按钮(见 QMouseEvent::button())。
Qt::AllButtons0x07ffffff此值对应于所有可能的鼠标按钮的掩码。用于将 MouseArea 的 'acceptedButtons' 属性设置为接受所有鼠标按钮。
Qt::LeftButton0x00000001左键被按下,或事件引用了左键。(对于左手摇杆,左键可能是右键。)
Qt::RightButton0x00000002右键。
Qt::MiddleButton0x00000004中键。
Qt::BackButton0x00000008'Back' 键。(通常位于带有额外按钮的鼠标的 '拇指' 边缘。这不是倾斜滚轮。)
Qt::XButton1BackButton'Back' 按钮。
Qt::ExtraButton1XButton1'Back' 按钮。
Qt::ForwardButton0x00000010“前进”按钮。(通常位于“后退”按钮旁边,并由拇指按下。)
Qt::XButton2ForwardButton“前进按钮。”
Qt::ExtraButton2ForwardButton“前进”按钮。
Qt::TaskButton0x00000020“任务”按钮。
Qt::ExtraButton3TaskButton“任务”按钮。
Qt::ExtraButton40x00000040第7个非滚轮鼠标按钮。
Qt::ExtraButton50x00000080第8个非滚轮鼠标按钮。
Qt::ExtraButton60x00000100第9个非滚轮鼠标按钮。
Qt::ExtraButton70x00000200第10个非滚轮鼠标按钮。
Qt::ExtraButton80x00000400第11个非滚轮鼠标按钮。
Qt::ExtraButton90x00000800第12个非滚轮鼠标按钮。
Qt::ExtraButton100x00001000第13个非滚轮鼠标按钮。
Qt::ExtraButton110x00002000第14个非滚轮鼠标按钮。
Qt::ExtraButton120x00004000第15个非滚轮鼠标按钮。
Qt::ExtraButton130x00008000第16个非滚轮鼠标按钮。
Qt::ExtraButton140x00010000第17个非滚轮鼠标按钮。
Qt::ExtraButton150x00020000第18个非滚轮鼠标按钮。
Qt::ExtraButton160x00040000第19个非滚轮鼠标按钮。
Qt::ExtraButton170x00080000第20个非滚轮鼠标按钮。
Qt::ExtraButton180x00100000第21个非滚轮鼠标按钮。
Qt::ExtraButton190x00200000第22个非滚轮鼠标按钮。
Qt::ExtraButton200x00400000第23个非滚轮鼠标按钮。
Qt::ExtraButton210x00800000第24个非滚轮鼠标按钮。
Qt::ExtraButton220x01000000第25个非滚轮鼠标按钮。
Qt::ExtraButton230x02000000第26个非滚轮鼠标按钮。
Qt::ExtraButton240x04000000第27个非滚轮鼠标按钮。

注意:某些多按钮鼠标型号已预先配置为使用具有高编号按钮的键盘序列,用于特定的游戏。为了让这些按钮被视为真正的“鼠标按钮”,必须重新配置设备(使用厂商的配置工具)。

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

另请参阅:KeyboardModifierModifier

enum Qt::MouseEventFlag
flags Qt::MouseEventFlags

此枚举提供了有关QMouseEvent的额外信息。

常量描述
Qt::MouseEventCreatedDoubleClick0x01指示Qt已从这个事件创建了一个MouseButtonDblClick事件。标志在造成事件的MouseButtonPress中设置,而不在结果MouseButtonDblClick中设置。

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

enum Qt::MouseEventSource

此枚举描述鼠标事件源,可用于确定事件是否是源自其他设备(如触摸屏)的模拟鼠标事件。

常量描述
Qt::MouseEventNotSynthesized0最常见值。在提供此类信息的平台上,此值指示事件是对系统中真实鼠标事件的响应而生成。
Qt::MouseEventSynthesizedBySystem1指示鼠标事件是通过平台从触摸事件合成的。
Qt::MouseEventSynthesizedByQt2指示鼠标事件是由Qt从未处理的触摸事件合成的。
Qt::MouseEventSynthesizedByApplication3表示鼠标事件是由应用程序合成的。这允许区分应用程序生成的事件和来自系统或由 Qt 合成的事件。此值自 Qt 5.6 起引入。

另请参阅 Qt::AA_SynthesizeMouseForUnhandledTouchEvents

枚举 Qt::NativeGestureType

此枚举返回手势类型。

常量描述
Qt::BeginNativeGesture0在手势事件流之前发送。
Qt::EndNativeGesture1在手势事件流之后发送。
Qt::PanNativeGesture2指定像素位移增量。
Qt::ZoomNativeGesture3指定百分比缩放增量。
Qt::SmartZoomNativeGesture4布尔放大状态。
Qt::RotateNativeGesture5指定旋转增量(度)。
Qt::SwipeNativeGesture6在滑动动作后发送。

此枚举类型描述了移动焦点的方式。

常量描述
Qt::NavigationModeNone0仅使用触摸屏。
Qt::NavigationModeKeypadTabOrder1Qt::Key_UpQt::Key_Down 用于更改焦点。
Qt::NavigationModeKeypadDirectional2Qt::Key_UpQt::Key_DownQt::Key_LeftQt::Key_Right 用于更改焦点。
Qt::NavigationModeCursorAuto3鼠标光标用于更改焦点,仅在非触摸屏设备上显示。按键盘实现虚拟光标,除非设备有模拟鼠标类型的输入设备(例如触摸板)。这是对于需要指针控制的触摸和非触摸设备的应用程序(如网页浏览器)的推荐设置。
Qt::NavigationModeCursorForceVisible4鼠标光标用于更改焦点,无论设备类型如何都显示。按键盘实现虚拟光标,除非设备有模拟鼠标类型的输入设备(例如触摸板)

注意:当前在任何平台上都没有实现光标导航,它表现为导航模式 None。

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

枚举 Qt::Orientation
flags Qt::Orientations

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

常量
Qt::Horizontal0x1
Qt::Vertical0x2

朝向用于 QScrollBar 等。

Orientations 类型是 QFlags<Orientation> 的typedef。它存储了 Orientation 值的 OR 组合。

枚举 Qt::PenCapStyle

此枚举类型定义了 Qt 支持的笔尖样式,即可以使用 QPainter 绘制的线端点样式。

Qt::SquareCapQt::FlatCapQt::RoundCap
常量描述
Qt::FlatCap0x00不覆盖线端点的方形线端。
Qt::SquareCap0x10覆盖线端并超出线宽一半的方形线端。
Qt::RoundCap0x20圆形线端。

另请参阅 QPen

枚举 Qt::PenJoinStyle

此枚举类型定义了 Qt 支持的笔连接样式,即在连接线之间可以绘制的连接方式。

Qt::BevelJoinQt::MiterJoinQt::RoundJoin
常量描述
Qt::MiterJoin0x00线条的外边缘被延伸以在角度处相遇,并填充这个区域。
Qt::BevelJoin0x40两条线条之间的三角缺口被填充。
Qt::RoundJoin0x80两条线条之间的圆形弧被填充。
Qt::SvgMiterJoin0x100与 SVG 1.2 Tiny 规范中定义的斜接连接对应的斜接连接。

另请参阅 QPen

enum Qt::PenStyle

此枚举类型定义了可以使用 QPainter 绘制的笔刷样式。样式有

Qt::SolidLineQt::DashLineQt::DotLine
Qt::DashDotLineQt::DashDotDotLineQt::CustomDashLine
常量描述
Qt::NoPen0完全不绘制线条。例如,QPainter::drawRect() 填充但不绘制任何边界线。
Qt::SolidLine1一条普通线条。
Qt::DashLine2由几个像素间距的虚线组成。
Qt::DotLine3由几个像素间距的点组成。
Qt::DashDotLine4交替的点线和虚线。
Qt::DashDotDotLine5一点,两划,一点,两划。
Qt::CustomDashLine6使用 QPainterPathStroker::setDashPattern() 定义的自定义图案。

另请参阅 QPen

[since 6.5] enum class Qt::PermissionStatus

此枚举描述了权限可能的状祝

常量描述
Qt::PermissionStatus::Undetermined0权限状况尚未知晓。应该通过 QCoreApplication::requestPermission() 请求来确定实际状态。此状态不会是请求权限的结果。
Qt::PermissionStatus::Granted1用户已明确授予应用程序权限,或者权限在给定平台上不需要用户授权。
Qt::PermissionStatus::Denied2用户明确拒绝应用程序请求的权限,或者权限在给定平台上无法访问或适用。

注意:在 Android 上,平台 API 没有此 Undetermined 状态。因此,如果应用程序的权限被拒绝,将默认返回 Undetermined,直到调用 QCoreApplication::requestPermission()。之后 QCoreApplication::checkPermission() 报告非 Undetermined 状态。

此枚举首次在 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

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

常量描述
Qt::PrimaryOrientation0x00000000显示的主方向。
Qt::LandscapeOrientation0x00000002纵向方向,显示宽度大于显示高度。
Qt::PortraitOrientation0x00000001纵向方向,显示高度大于显示宽度,相对于横向逆时针旋转 90 度。
Qt::InvertedLandscapeOrientation0x00000008相对于横向旋转 180 度的翻转纵向方向。
Qt::InvertedPortraitOrientation0x00000004相对于纵向旋转 180 度的翻转纵向方向。

ScreenOrientations 类型是 QFlags 的 typedef,用于存储 ScreenOrientation 值的 OR 组合。

枚举 Qt::ScrollBarPolicy

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

常量描述
Qt::ScrollBarAsNeeded0QAbstractScrollArea 在内容太大而无法适应时显示滚动条,否则不显示。这是默认设置。
Qt::ScrollBarAlwaysOff1QAbstractScrollArea 从不显示滚动条。
Qt::ScrollBarAlwaysOn2QAbstractScrollArea 总是显示滚动条。在具有瞬息滚动条的系统中(例如,从 Mac 版本 10.7 开始),此属性会被忽略。

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

枚举 Qt::ScrollPhase

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

常量描述
Qt::NoScrollPhase0输入设备不支持滚动阶段。此值是在 Qt 5.7 中引入的。
Qt::ScrollBegin1即将开始滚动,但滚动距离尚未改变。
Qt::ScrollUpdate2滚动距离已改变(默认)。
Qt::ScrollEnd3滚动已结束,滚动距离不再改变。
Qt::ScrollMomentum4用户不再接触输入设备,但滚动因滚动惯性而继续。此值是在 Qt 5.12 中引入的。

枚举 Qt::ShortcutContext

为了发生 QEvent::Shortcut 事件,简截的键序列必须由用户在某些简截处于活动状态的情况下输入。可能的上下文有这些

常量描述
Qt::WidgetShortcut0当其父小部件获得焦点时,简截处于活动状态。
Qt::WidgetWithChildrenShortcut3当其父小部件或其子项中的任何一个获得焦点时,简截处于活动状态。受此简截上下文影响的子项不包括顶层小部件,除非是弹出窗口。
Qt::WindowShortcut1当其父小部件是活动顶层窗口的逻辑子小部件时,简截处于活动状态。
Qt::ApplicationShortcut2当其中一个应用程序窗口处于激活状态时,简截处于活动状态。

枚举 Qt::SizeHint

此枚举用于 QGraphicsLayoutItem::sizeHint()

常量描述
Qt::MinimumSize0用于指定图形布局项目的最小大小。
Qt::PreferredSize1用于指定图形布局项目的首选大小。
Qt::MaximumSize2用于指定图形布局项目的最大大小。
Qt::MinimumDescent3用于指定图形布局项中文本字符串的最小下倾。

另请参阅 QGraphicsLayoutItem::sizeHint

枚举 Qt::SizeMode

此枚举由 QPainter::drawRoundedRect() 和 QPainterPath::addRoundedRect() 函数使用,用于指定与边界矩形尺寸相关的矩形角落的半径。

常量描述
Qt::AbsoluteSize0使用绝对测量值指定大小。
Qt::RelativeSize1使用与边界矩形相对的大小指定大小,通常使用百分比测量值。

枚举 Qt::SortOrder

此枚举描述了小部件中项目的排序方式。

常量描述
Qt::AscendingOrder0项目按升序排列,例如在拉丁-1区域中,从'AAA'开始到'ZZZ'结束。
Qt::DescendingOrder1项目按降序排列,例如在拉丁-1区域中,从'ZZZ'开始到'AAA'结束。

枚举 Qt::SplitBehaviorFlags
标志 Qt::SplitBehavior

此枚举指定 split() 函数在处理空字符串时的行为。

常量描述
Qt::KeepEmptyParts0如果字段为空,则在结果中保留它。
Qt::SkipEmptyParts0x1如果字段为空,则不在结果中包含它。

SplitBehavior 类型是 SplitBehaviorFlags 的 typedef。它存储 SplitBehaviorFlags 值的 OR 组合。

另请参阅 QString::split

枚举 Qt::TabFocusBehavior

此枚举类型提供了不同的标签导航焦点行为。

常量描述
Qt::NoTabFocus0x00没有任何迭代。
Qt::TabFocusTextControls0x01迭代文本控件和小部件。
Qt::TabFocusListControls0x02迭代列表控件和小部件。
Qt::TabFocusAllControls0xff迭代所有控件和小部件。

枚举 Qt::TextElideMode

此枚举指定当显示不适应的文本时省略号应出现的位置。

常量描述
Qt::ElideLeft0省略号应在文本的开头出现。
Qt::ElideRight1省略号应在文本的末尾出现。
Qt::ElideMiddle2省略号应在文本的中间出现。
Qt::ElideNone3省略号不应出现在文本中。当传递给如 QFontMetrics::elidedText() 等函数时,除非文本包含多长度变体,否则将返回整个字符串。在这种情况下,省略必须通过裁剪到组件宽度来完成。

Qt::ElideMiddle 对于 URL(例如,“http://bugreports.qt.../QTWEBSITE-13/”)通常是最佳选择,而 Qt::ElideRight 对于其他字符串(例如,“在 macOS 上部署应用程序...”)则更合适。

另请参阅 QAbstractItemView::textElideModeQFontMetrics::elidedTextAlignmentFlagQTabBar::elideMode

枚举 Qt::TextFlag

此枚举类型用于定义一些修饰符标志。其中一些标志仅在打印的上下文中有意义

常量描述
Qt::TextSingleLine0x0100将所有空白视为空格,并打印单行。
Qt::TextDontClip0x0200如果无法保持给定的限制,则超出打印。
Qt::TextExpandTabs0x0400将 U+0009 (ASCII tab) 字符移动到下一个制表位。
Qt::TextShowMnemonic0x0800将字符串 "&P" 显示为 P。对于分隔符,使用 "&&"。
Qt::TextWordWrap0x1000在适当的位置断行,例如在单词边界处。
Qt::TextWrapAnywhere0x2000在任何位置断行,甚至可以在单词中。
Qt::TextHideMnemonic0x8000与 Qt::TextShowMnemonic 相同,但不绘制下划线。
Qt::TextDontPrint0x4000将此文本视为“隐藏”且不打印它。
Qt::TextIncludeTrailingSpaces0x08000000当设置此选项时,QTextLine::naturalTextWidth() 和 QTextLine::naturalTextRect() 将返回一个值,该值包括文本中尾随空格的宽度;否则此宽度将被排除。
Qt::TextJustificationForced0x10000确保文本行对齐。

你可以使用任意多的修饰符标志,除了 Qt::TextSingleLine 和 Qt::TextWordWrap 不能组合。

对于特定用途不适合的标志通常会被忽略。

枚举 Qt::TextFormat

该枚举用于可以显示纯文本和富文本的控件中,例如 QLabel。它用于决定一个文本字符串应该被解释为哪一种。这通常通过将枚举值传递给 QTextEdit::setTextFormat() 函数来实现。

常量描述
Qt::PlainText0将文本字符串解释为纯文本。
Qt::RichText1将文本字符串解释为富文本。有关富文本的定义,请参阅 支持的 HTML 子集
Qt::AutoText2如果 Qt::mightBeRichText() 返回 true,则文本字符串被解释为 Qt::RichText;否则,作为 Qt::PlainText。
Qt::MarkdownText3将文本字符串解释为 Markdown 格式的文本。此枚举值是在 Qt 5.14 中添加的。

枚举 Qt::TextInteractionFlag
标志 Qt::TextInteractionFlags

该枚举指定了文本显示控件如何对用户输入做出反应。

常量描述
Qt::NoTextInteraction0不能与文本进行交互。
Qt::TextSelectableByMouse1可以使用鼠标选择文本,然后使用上下文菜单或标准键盘快捷键将其复制到剪贴板。
Qt::TextSelectableByKeyboard2可以使用键盘上的光标键选择文本。会显示文本光标。
Qt::LinksAccessibleByMouse4可以使用鼠标突出显示和激活链接。
Qt::LinksAccessibleByKeyboard8可以使用 Tab 键来聚焦链接,并使用回车键激活。
Qt::TextEditable16文本可完全编辑。
Qt::TextEditorInteractionTextSelectableByMouse | TextSelectableByKeyboard | TextEditable文本编辑器的默认设置。
Qt::TextBrowserInteractionTextSelectableByMouse | LinksAccessibleByMouse | LinksAccessibleByKeyboardQTextBrowser 的默认设置。

TextInteractionFlags 类型是 QFlags<TextInteractionFlag> 的typedef。它存储了一组 TextInteractionFlag 值的 OR 组合。

枚举 Qt::TileRule

该枚举描述了绘制图像时如何重复或拉伸图像的部分。

常量描述
Qt::StretchTile0将图像缩放到与可用区域相匹配。
Qt::RepeatTile1重复图像,直到没有更多空间。可能会裁剪最后一个图像。
Qt::RoundTile2与重复相似,但会将图像调整至足够小,以确保最后一个瓦片不会被裁剪。

枚举 Qt::TimeSpec

常量描述
Qt::LocalTime0本地时间,由系统时区设置控制。
Qt::UTC1协调世界时。
Qt::OffsetFromUTC2相对于协调世界时的秒数偏移量。
Qt::TimeZone3一个命名时区。

LocalTime 和 TimeZone 都会处理诸如夏令时的开始和结束等过渡。UTC 是通常用来指定时区的标准时间,格林尼治标准时间与此时间没有偏移。UTC 和 OffsetFromUTC 都没有过渡。

当使用OffsetFromUTC指定日期时间时,必须也提供相对于UTC的偏移量(以秒为单位)。要使用TimeZone指定日期时间,必须提供一个QTimeZone。从Qt 6.5开始,QTimeZone现在可以将timespec包装在其中,需要时包括偏移量作为轻量级时间描述,从而使得传递QTimeZone现在提供了一种使用日期时间API的统一方式,无需针对不同的timespec调用它们。

注意:系统时区设置更改后,更改之前基于LocalTime创建的QDateTime对象的行为是未定义的:QDateTime可能缓存了更改使其无效的数据。(这不是由系统时区的转换触发的。)在长时间运行的进程中,系统时区数据的更新(例如,政客更改一个区域的规则时)也可能导致更新后的时区信息和之前更新中创建的QDateTime对象缓存的数据之间发生冲突,无论使用的是LocalTime还是TimeZone。

另请参阅QTimeZoneQDateTime

枚举 Qt::TimerType

计时器类型指示计时器的精确度。

常量描述
Qt::PreciseTimer0精确计时器试图保持毫秒级精度
Qt::CoarseTimer1粗略计时器试图将精度保持在所需间隔的5%以内
Qt::VeryCoarseTimer2非常粗略的计时器只能保持整秒精度

在UNIX(包括Linux、macOS和iOS)上,Qt将为Qt::PreciseTimer保持毫秒级精度。对于Qt::CoarseTimer,间隔将调整至5%,以将计时器与预期在同一时间或附近触发的其他计时器对齐。目标是使大多数计时器同时唤醒,从而减少CPU唤醒和功耗。

在Windows上,Qt将使用Windows的多媒体计时器功能(如果可用)来处理Qt::PreciseTimer,对于Qt::CoarseTimer和Qt::VeryCoarseTimer使用正常的Windows计时器。

在所有平台上,Qt::VeryCoarseTimer的间隔将舍入到最接近的完整秒(例如,23,500毫秒的间隔将舍入到24,000毫秒,20,300毫秒到20,000毫秒)。

枚举 Qt::ToolBarArea
标志 Qt::ToolBarAreas

常量
Qt::LeftToolBarArea0x1
Qt::RightToolBarArea0x2
Qt::TopToolBarArea0x4
Qt::BottomToolBarArea0x8
Qt::AllToolBarAreasToolBarArea_Mask
Qt::NoToolBarArea0

ToolBarAreas类型是QFlags<ToolBarArea>的typedef。它存储了ToolBarArea值的OR组合。

枚举 Qt::ToolButtonStyle

工具按钮的样式,描述了按钮的文本和图标应该如何显示。

常量描述
Qt::ToolButtonIconOnly0只显示图标。
Qt::ToolButtonTextOnly1只显示文本。
Qt::ToolButtonTextBesideIcon2文本出现在图标旁边。
Qt::ToolButtonTextUnderIcon3文本出现在图标下面。
Qt::ToolButtonFollowStyle4遵循样式

枚举 Qt::TouchPointState
标志 Qt::TouchPointStates

此枚举表示QTouchEvent发生时的触摸点的状态。

常量描述
Qt::TouchPointUnknownState0x00触摸点的状态不了解。
Qt::TouchPointPressed0x01触摸点现在是按下的。
Qt::TouchPointMoved0x02触摸点移动了。
Qt::TouchPointStationary0x04触摸点没有移动。
Qt::TouchPointReleased0x08触摸点已释放。

TouchPointStates 类型是 QFlags<TouchPointState> 的别名。它存储了 TouchPointState 值的或组合。

enum Qt::TransformationMode

此枚举类型定义了图像变换(例如,缩放)是否应该平滑。

常量描述
Qt::FastTransformation0转换快速执行,无平滑。
Qt::SmoothTransformation1使用双线性滤波对结果图像进行转换。

另请参阅QImage::scaled()。

enum Qt::UIEffect

此枚举描述了可用的 UI 特效。

默认情况下,Qt 将尝试为每个效果使用平台特定的桌面设置。使用 QApplication::setDesktopSettingsAware() 函数(传递参数 false)来防止此行为,并使用 QApplication::setEffectEnabled() 来启用或禁用特定效果。

请注意,在小于 16 位颜色深度的屏幕上,所有效果都是禁用的。

常量描述
Qt::UI_AnimateMenu1显示动画菜单。
Qt::UI_FadeMenu2显示渐变菜单。
Qt::UI_AnimateCombo3显示动画组合框。
Qt::UI_AnimateTooltip4显示工具提示动画。
Qt::UI_FadeTooltip5显示工具提示渐变效果。
Qt::UI_AnimateToolBox6保留

另请参阅QApplication::setEffectEnabled() 和 QGuiApplication::setDesktopSettingsAware

enum Qt::WhiteSpaceMode

此枚举描述了由 QTextDocument 类使用的空白模式类型,以满足不同类型文本信息的要求。

常量描述
Qt::WhiteSpaceNormal0用于在段落下显示正常换行文本的空白模式。
Qt::WhiteSpacePre1一种预格式化文本模式,其中的空白将被精确复制。
Qt::WhiteSpaceNoWrap2 

enum Qt::WidgetAttribute

此枚举类型用于指定各种小部件属性。使用 QWidget::setAttribute() 设置属性,并使用 QWidget::testAttribute() 查询属性,尽管其中一些具有特殊的便利函数,如下所述。

常量描述
Qt::WA_AcceptDrops78允许将拖放操作的数据拖放到小部件上(见 QWidget::setAcceptDrops())。
Qt::WA_AlwaysShowToolTips84为非活动窗口启用工具提示。
Qt::WA_CustomWhatsThis47表示小部件希望继续以“这是什么?”模式正常操作。这是由小部件的作者设置的。
Qt::WA_DeleteOnClose55使 Qt 在小部件接受关闭事件时删除该小部件(见 QWidget::closeEvent())。
Qt::WA_Disabled0表示小部件被禁用,即它不接受任何鼠标或键盘事件。也存在一些获取器函数 QWidget::isEnabled()。这是由 Qt 内核设置的。
Qt::WA_DontShowOnScreen103表示小部件被隐藏或不是可视图面的桌面的一部分。
Qt::WA_ForceDisabled32表示小部件被显式禁用,即在所有祖先都设置为启用状态时,它也将保持禁用状态。这隐含了 WA_Disabled。这是由 QWidget::setEnabled() 和 QWidget::setDisabled() 设置和清除的。
Qt::WA_ForceUpdatesDisabled59表示显式禁用了小部件的更新;即即使在所有祖先都设置为更新启用的状态时,它也将保持禁用状态。这隐含了 WA_UpdatesDisabled。这是由 QWidget::setUpdatesEnabled() 设置和清除的。
Qt::WA_Hover74强迫Qt在鼠标进入或离开小部件时生成绘图事件。此功能通常用于实现自定义样式。
Qt::WA_InputMethodEnabled14启用亚洲语言的输入方法。在创建自定义文本编辑小部件时必须设置。
Qt::WA_KeyboardFocusChange77当用户使用键盘(标签、转标签或快捷键)更改焦点时,设置在最顶层窗口上。
Qt::WA_KeyCompression33如果设置,启用按键事件压缩;如果未设置,则禁用。默认情况下,按键压缩关闭,因此小部件为每个按键(或更多,因为自动重复通常开启)接收一个按键事件。如果启用它而您的程序无法跟上按键输入,Qt可能会尝试压缩按键事件,以便每次事件可以处理多个字符。例如,字处理器小部件可能会在每次QKeyEvent::text中接收2、3个或更多的字符,如果布局重新计算对于CPU来说耗时太久。如果小部件支持多字符Unicode输入,始终可以安全地开启压缩。Qt仅对可打印字符执行按键事件压缩。如Qt::Modifier键,光标移动键,功能键和其它动作键(例如Esc、Enter、退格、屏幕截图)将会停止按键事件压缩,即使还有可压缩的按键事件。除了Mac和X11之外的其它平台不支持此压缩,在这种情况下开启将没有效果。这是由小部件创作者设置/清除的。
Qt::WA_LayoutOnEntireRect48表示小部件想要QLayout在整个QWidget::rect上操作,而不仅是在QWidget::contentsRect上。这是由小部件创作者设置的。
Qt::WA_LayoutUsesWidgetRect92在用QLayout布置这个小部件时忽略布局项的矩形。
Qt::WA_MacOpaqueSizeGrip85表示本地的尺寸把手应该是不透明的而不是透明的(默认)。此属性仅适用于macOS,并由小部件的创作者设置。
Qt::WA_MacShowFocusRect88表示这个小部件应该在其周围得到QFocusFrame。一些小部件不管这个属性如何都会绘制自己的焦点光环。请注意,QWidget::focusPolicy也起着主要作用,确定是否能给予焦点,这仅控制是否得到焦点框架。此属性仅适用于macOS。
Qt::WA_MacNormalSize89表示小部件应该有macOS中小部件的正常大小。此属性仅适用于macOS。
Qt::WA_MacSmallSize90表示小部件应该有macOS中小部件的小大小。此属性仅适用于macOS。
Qt::WA_MacMiniSize91表示小部件应该有macOS中小部件的最小大小。此属性仅适用于macOS。
Qt::WA_Mapped11表示小部件已映射到屏幕上。这是由Qt内核设置/清除的。
Qt::WA_MouseNoMask71使小部件接收整个小部件的鼠标事件,而不考虑当前设置的掩码,覆盖QWidget::setMask。这不适用于顶级窗口。
Qt::WA_MouseTracking2表示小部件启用了鼠标跟踪。见QWidget::mouseTracking
Qt::WA_Moved43表示小部件有一个显式的位置。这是由QWidget::move()和QWidget::setGeometry()设置/清除的。
Qt::WA_NoChildEventsForParent58表示小部件不想将ChildAdded或ChildRemoved事件发送到其父级。这很少需要,但可以帮助避免自动插入的小部件,如分隔符和布局。这是由小部件的创作者设置的。
Qt::WA_NoChildEventsFromChildren39表示小部件不希望接收从其子部件发送的ChildAdded或ChildRemoved事件。这是由小部件的作者设置的。
Qt::WA_NoMouseReplay54用于弹出窗口部件。表示在弹出窗口关闭时,最近一次鼠标按下事件不应重新播放。此标志由小部件的作者设置,由Qt内核在每次小部件接收新鼠标事件时清除。
Qt::WA_NoMousePropagation73禁止鼠标事件传播到小部件的父部件。此属性默认禁用。
Qt::WA_TransparentForMouseEvents51当启用时,此属性禁止将鼠标事件传递给小部件及其子部件。鼠标事件被传递到其他小部件,就好像小部件及其子部件不在小部件层次结构中一样;鼠标点击和其他事件实际上“穿过”它们。此属性默认禁用。
Qt::WA_NoSystemBackground9表示小部件没有背景,即当小部件接收到绘画事件时,背景不会自动重绘。注意:与WA_OpaquePaintEvent不同,新暴露的面积永远不会填充背景(例如,在第一次显示窗口后,用户可以看到“通过”它,直到应用程序处理绘画事件)。此标志由小部件的作者设置或清除。
Qt::WA_OpaquePaintEvent4表示小部件在接收到绘画事件时绘制所有像素。因此,在进行更新、调整大小、滚动和焦点更改等操作之前,不需要擦除小部件以生成绘画事件。使用WA_OpaquePaintEvent提供了一个小的优化,通过帮助减少不支持双缓存的系统上的闪烁,避免在绘画之前删除背景的计算周期。注意:与WA_NoSystemBackground不同,WA_OpaquePaintEvent试图避免透明的窗口背景。此标志由小部件的作者设置或清除。
Qt::WA_OutsideWSRange49表示小部件位于窗口系统坐标系统的有效范围之外。处于有效范围之外的小部件无法在屏幕上映射。这是由Qt内核设置/清除的。
Qt::WA_PaintOnScreen8表示小部件希望在屏幕上直接绘制。设置了此属性的小部件不参与合成管理,即它们不能是半透明的,也不能通过半透明重叠小部件发光。注意:此标志仅在X11上受支持,它禁用了双缓冲。在Qt for Embedded Linux中,此标志仅在设置为顶级小部件时才有效,并且它依赖于活动屏幕驱动程序的支持。此标志由小部件的作者设置或清除。要在外部渲染Qt的绘图系统之外,例如,如果您需要原生的绘图原语,则需要重新实现QWidget::paintEngine()以返回0并设置此标志。
Qt::WA_PaintUnclipped52使在此小部件上操作的所有绘图器无裁剪。此小部件的孩子或其他前面的小部件不会裁剪绘图器可以绘制的区域。此标志仅在设置了WA_PaintOnScreen标志的小部件上受支持。在跨平台方式中执行此操作的最佳方式是创建一个透明的小部件,它位于其他小部件前面。
Qt::WA_PendingMoveEvent34表示有挂起的移动事件,例如,当一个隐藏的小部件被移动时。此标志由Qt内核设置或清除。
Qt::WA_PendingResizeEvent35表示有挂起的调整大小事件,例如,当一个隐藏的小部件被调整大小时。此标志由Qt内核设置或清除。
Qt::WA_QuitOnClose76表示在最后一个窗口关闭时决定退出应用程序时应该将小部件考虑在内。此行为可以通过QGuiApplication::quitOnLastWindowClosed属性进行修改。默认情况下,此属性对所有类型为Qt::Window的小部件都进行了设置。
Qt::WA_Resized42表示小部件有一个显式的大小。此标志由QWidget::resize()和QWidget::setGeometry()设置或清除。
Qt::WA_RightToLeft56指示该小部件的布局方向为从右到左。
Qt::WA_SetCursor38表示小部件拥有自己的光标。此标志由 QWidget::setCursor() 和 QWidget::unsetCursor() 设置或清除。
Qt::WA_SetFont37表示该小部件有自己的字体。此标志由 QWidget::setFont() 设置或清除。
Qt::WA_SetPalette36表示该小部件有自己的调色板。此标志由 QWidget::setPalette() 设置或清除。
Qt::WA_SetStyle86表示该小部件有自己的样式。此标志由 QWidget::setStyle() 设置或清除。
Qt::WA_ShowModal70此属性已弃用。请使用 QWidget::windowModality 代替。
Qt::WA_StaticContents5表示小部件的内容是西北对齐且静态的。在调整大小时,此类小部件只为新可见的自身部分接收绘图事件。此标志由小部件的作者设置或清除。
Qt::WA_StyleSheet97表示小部件使用 样式表 进行样式化。只要小部件受到样式表的影响,即使样式表没有影响小部件的外观,WA_StyleSheet 也会被设置。
Qt::WA_StyleSheetTarget131表示小部件的外观被 样式表 修改。WA_StyleSheet 也将被设置。此值是在 Qt 5.12 中引入的。
Qt::WA_TabletTracking129表示该小部件已启用平板跟踪。请参阅 QWidget::tabletTracking
Qt::WA_TranslucentBackground120表示小部件应具有半透明背景,即小部件的非不透明区域的背景将是半透明的,因为小部件将具有alpha通道。设置此标志将导致 WA_NoSystemBackground 被设置。在 Windows 上,小部件还需要设置 Qt::FramelessWindowHint 窗口标志。此标志由小部件的作者设置或清除。截至 Qt 5.0,在窗口显示后切换此属性不会在平台间得到一致的支持。当需要半透明背景时,应在创建小部件时尽早设置属性,并避免之后修改它。
Qt::WA_UnderMouse1表示小部件位于鼠标光标下方。在拖放操作期间值不会正确更新。还有一个获取器函数,QWidget::underMouse()。此标志由 Qt 内核设置或清除。
Qt::WA_UpdatesDisabled10表示更新被阻止(包括系统背景)。此标志由 Qt 内核设置或清除。警告:此标志不得由小部件的作者设置或清除。
Qt::WA_WindowModified41表示窗口被标记为已修改。在某些平台上,此标志将不起作用,在其他平台(包括 macOS 和 Windows)上,窗口将采取已修改的外观。此标志由 QWidget::setWindowModified() 设置或清除。
Qt::WA_WindowPropagation80使顶层窗口从其父窗口继承字体、调色板和区域设置。
Qt::WA_MacAlwaysShowToolWindow96在 macOS 上,即使应用程序未处于活动状态也会显示工具窗口。默认情况下,当应用程序未处于活动状态时,所有工具窗口都将被隐藏。
Qt::WA_SetLocale87表示在小部件中应考虑区域设置。
Qt::WA_StyledBackground93表示应使用样式化的背景绘制小部件。
Qt::WA_ShowWithoutActivating98在不使小部件活动的情况下显示小部件。
Qt::WA_NativeWindow100表示已为小部件创建了原生窗口。启用此标志还将强制为小部件的祖先使用原生窗口,除非设置了 Qt::WA_DontCreateNativeAncestors。
Qt::WA_DontCreateNativeAncestors101表示即使小部件本身是原生的,其祖先也将保持非原生。
Qt::WA_X11NetWmWindowTypeDesktop104将_X11_WINDOW_TYPE_DESKTOP属性添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参阅http://standards.freedesktop.org/wm-spec/。此属性对非X11平台没有影响。
Qt::WA_X11NetWmWindowTypeDock105将_NET_WM_WINDOW_TYPE_DOCK属性添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参阅http://standards.freedesktop.org/wm-spec/。此属性对非X11平台没有影响。
Qt::WA_X11NetWmWindowTypeToolBar106将_NET_WM_WINDOW_TYPE_TOOLBAR属性添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参阅http://standards.freedesktop.org/wm-spec/。此属性对非X11平台没有影响。注意:Qt会自动为QToolBar设置此属性。
Qt::WA_X11NetWmWindowTypeMenu107将_NET_WM_WINDOW_TYPE_MENU属性添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参阅http://standards.freedesktop.org/wm-spec/。此属性对非X11平台没有影响。注意:Qt在菜单被撕裂时自动为QMenu设置此属性。
Qt::WA_X11NetWmWindowTypeUtility108将_NET_WM_WINDOW_TYPE_UTILITY属性添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参阅http://standards.freedesktop.org/wm-spec/。此属性对非X11平台没有影响。注意:Qt会自动为Qt::Tool窗口类型设置此属性。
Qt::WA_X11NetWmWindowTypeSplash109将_NET_WM_WINDOW_TYPE_SPLASH属性添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参阅http://standards.freedesktop.org/wm-spec/。此属性对非X11平台没有影响。注意:Qt会自动为Qt::SplashScreen窗口类型设置此属性。
Qt::WA_X11NetWmWindowTypeDialog110将_NET_WM_WINDOW_TYPE_DIALOG属性添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参阅http://standards.freedesktop.org/wm-spec/。此属性对非X11平台没有影响。注意:Qt会自动为Qt::DialogQt::Sheet窗口类型设置此属性。
Qt::WA_X11NetWmWindowTypeDropDownMenu111将_NET_WM_WINDOW_TYPE_DROPDOWN_MENU属性添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参阅http://standards.freedesktop.org/wm-spec/。此属性对非X11平台没有影响。注意:Qt会自动为添加到QMenuBarQMenu对象设置此属性。
Qt::WA_X11NetWmWindowTypePopupMenu112将_NET_WM_WINDOW_TYPE_POPUP_MENU属性添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参阅http://standards.freedesktop.org/wm-spec/。此属性对非X11平台没有影响。注意:Qt会自动为QMenu设置此属性。
Qt::WA_X11NetWmWindowTypeToolTip113将_NET_WM_WINDOW_TYPE_TOOLTIP属性添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参阅http://standards.freedesktop.org/wm-spec/。此属性对非X11平台没有影响。注意:Qt会自动为Qt::ToolTip窗口类型设置此属性。
Qt::WA_X11NetWmWindowTypeNotification114将_NET_WM_WINDOW_TYPE_NOTIFICATION属性添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参阅http://standards.freedesktop.org/wm-spec/。此属性对非X11平台没有影响。
Qt::WA_X11NetWmWindowTypeCombo115将_NET_WM_WINDOW_TYPE_COMBO属性添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参阅http://standards.freedesktop.org/wm-spec/。此属性对非X11平台没有影响。注意:Qt会自动为QComboBox弹出窗口设置此属性。
Qt::WA_X11NetWmWindowTypeDND116将_NET_WM_WINDOW_TYPE_DND属性添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参阅http://standards.freedesktop.org/wm-spec/。此属性对非X11平台没有影响。注意:Qt在拖动过程中自动设置反馈小部件使用的此属性。
Qt::WA_AcceptTouchEvents121允许将触摸事件(请参阅 QTouchEvent)发送到小部件。必须在可以处理触摸事件的全部小部件上设置。如果没有设置此属性,来自触摸设备的触摸事件将作为鼠标事件发送。
Qt::WA_TouchPadAcceptSingleTouchEvents123允许将触摸板单点触摸事件发送到小部件。
Qt::WA_X11DoNotAcceptFocus126请求窗口管理器不要将焦点给这个顶层窗口。此属性在非-X11平台上没有效果。
Qt::WA_AlwaysStackOnTop (自Qt 5.4起)128强制QOpenGLWidgetQQuickWidget 最后绘制,在其它小部件之上。对于其它类型的小部件,该设置将被忽略。设置此属性会破坏堆叠顺序,但允许有一个半透明OpenGL小部件,其它小部件可以在其下方可见。强烈建议启用或禁用此属性后,在小部件的顶层窗口上调用update()。
Qt::WA_ContentsMarginsRespectsSafeArea130QWidget 会尊重窗口的安全区域边距,默认情况下将其边距合并到内容边距中。这意味着,QLayout 将使用小部件的内容区域进行布局,除非设置了Qt::WA_LayoutOnEntireRect属性。与内容边距0一起使用,可以在实际情况布局中,例如在iOS设备上允许背景图像在状态栏和其他系统区域下方,同时仍然允许背景小部件的子小部件根据安全区域进行内嵌。

枚举 Qt::WindowFrameSection

此枚举用于描述窗口边框的各部分。由QGraphicsWidget::windowFrameSectionAt() 返回,用于描述鼠标所在的窗口边框部分。

常量
Qt::NoSection0
Qt::LeftSection1
Qt::TopLeftSection2
Qt::TopSection3
Qt::TopRightSection4
Qt::RightSection5
Qt::BottomRightSection6
Qt::BottomSection7
Qt::BottomLeftSection8
Qt::TitleBarArea9

请参阅QGraphicsWidget::windowFrameEvent()、QGraphicsWidget::paintWindowFrame() 和 QGraphicsWidget::windowFrameSectionAt()。

枚举 Qt::WindowModality

此枚举指定了模态窗口的行为。模态窗口是一种阻止输入到其他窗口的窗口。请注意,模态窗口的子窗口不受阻止。

值包括:

常量描述
Qt::NonModal0窗口不是模态的,不会阻止对其他窗口的输入。
Qt::WindowModal1窗口相对于单个窗口层次结构是模态的,阻止对其父窗口、所有祖父母窗口以及其父窗口和祖父母窗口的兄弟窗口的输入。
Qt::ApplicationModal2窗口相对于应用程序是模态的,阻止对所有窗口的输入。

请参阅QWidget::windowModalityQDialog

枚举 Qt::WindowState
标志 Qt::WindowStates

该枚举类型用于指定顶层窗口的当前状态。

状态如下

常量描述
Qt::WindowNoState0x00000000窗口没有设置状态(在正常状态下)。
Qt::WindowMinimized0x00000001窗口被最小化(即图标化)。
Qt::WindowMaximized0x00000002窗口最大化且有框架。
Qt::WindowFullScreen0x00000004窗口占满整个屏幕,没有框架。
Qt::WindowActive0x00000008窗口是活动窗口,即它有键盘焦点。

WindowsStates 类型是 QFlags<WindowState> 的 typedef。它存储了一个或组合的 WindowState 值。

枚举 Qt::WindowType
标志 Qt::WindowFlags

该枚举类型用于指定小部件的各种窗口系统属性。它们在少数情况下是必需的,但相当不寻常。其中一些标志取决于底层窗口管理器是否支持它们。

主要类型包括:

常量描述
Qt::Widget0x00000000这是QWidget的默认类型。此类小部件如果在有父级的情况下,则为子部件;如果没有父级,则为独立窗口。也可参见Qt::Window和Qt::SubWindow。
Qt::Window0x00000001表示该小部件是一个窗口,通常具有窗口系统边框和标题栏,不管它是否有父级。注意,如果小部件没有父级,则无法取消此标志。
Qt::Dialog0x00000002 | Window表示该小部件是一个应该以对话框方式装饰的窗口(即,通常标题栏中没有最大化或最小化按钮)。这是QDialog的默认类型。如果您想将其用作模态对话框,则应从另一个窗口启动,或有一个父级并使用QWidget::windowModality属性。如果您将其设置为模态,则对话框会阻止应用程序中的其他顶级窗口获取任何输入。我们将有一个父级的顶级窗口称为二级窗口。
Qt::Sheet0x00000004 | Window表示在macOS上,该窗口是一个文档。由于使用文档暗示了窗口模态,建议的方法是使用QWidget::setWindowModality()或QDialog::open()。
Qt::DrawerSheet | Dialog表示该小部件是在macOS上的抽屉。此功能已过时。设置标志没有效果。
Qt::Popup0x00000008 | Window表示该小部件是一个弹出顶级窗口,即它是模态的,但具有适合弹出菜单的窗口系统边框。
Qt::ToolPopup | Dialog表示该小部件是一个工具窗口。工具窗口通常是带有比通常更小标题栏和装饰的小窗口,通常用于工具按钮的集合。如果有父级,则工具窗口将始终保持在它的顶部。如果没有父级,您可以考虑使用Qt::WindowStaysOnTopHint。如果窗口系统支持,则工具窗口可以带有较轻的边框。它还可以与Qt::FramelessWindowHint结合使用。在macOS上,工具窗口与NSPanel类窗口对应。这意味着该窗口位于比普通窗口更高的层面,因此不可能将正常窗口放在其上方。默认情况下,工具窗口在不活跃时将消失。这可以通过Qt::WA_MacAlwaysShowToolWindow属性来控制。
Qt::ToolTipPopup | Sheet表示该小部件是一个工具提示。这是用来内部实现tooltips的。
Qt::SplashScreenToolTip | Dialog表示该窗口是启动屏幕。这是QSplashScreen的默认类型。
Qt::SubWindow0x00000012表示该小部件是子窗口,如QMdiSubWindow小部件。
Qt::ForeignWindow0x00000020 | Window表示此窗口对象是一个表示由另一个进程创建或手动使用本地代码创建的本地平台窗口的句柄。
Qt::CoverWindow0x00000040 | Window表示该窗口代表一个遮罩窗口,在某些平台上当应用程序最小化时显示。

还有许多标志可用于自定义顶层窗口的外观。这些对其他窗口没有任何效果

常量描述
Qt::MSWindowsFixedSizeDialogHint0x00000100在Windows上为窗口提供薄的对话框边框。这种样式传统上用于固定大小对话框。

注意: 在多显示器环境中不建议使用此标志。这是因为系统将强制在窗口跨越屏幕时保持其原始大小。当使用分辨率不同的显示器时尤其不希望这样。

常量描述
Qt::MSWindowsOwnDC0x00000200在Windows上给窗口自己的显示上下文。
Qt::BypassWindowManagerHint0x00000400此标志可以用来通知平台插件禁用“所有”窗口管理器协议。该标志的执行方式取决于应用程序运行的操作系统以及运行的窗口管理器。此标志可用于获取未设置任何配置的本地窗口。
Qt::X11BypassWindowManagerHintBypassWindowManagerHint完全跳过窗口管理器。这将导致一个边框无边无际的窗口,完全不进行管理(即,除非您手动调用QWidget::activateWindow(),否则将没有任何键盘输入)。
Qt::FramelessWindowHint0x00000800生成一个无边框窗口。

在X11上,此标志的结果取决于窗口管理器和它理解Motif和/或NETWM提示的能力。大多数现有的现代窗口管理器都可以处理这一点。

注意: 如果窗口管理器依赖于边框来进行交互式操作窗口,则用户将无法通过窗口系统移动或调整窗口的大小,但这种副作用不应该被依赖。要生成固定大小的窗口并且不能调整大小,请将QWindow::setMinimumSize()和QWindow::setMaximumSize()设置为相同的尺寸。

常量描述
Qt::NoDropShadowWindowHint0x40000000在支持的平台禁用窗口阴影。

CustomizeWindowHint标志用于启用窗口控制的自定义。此标志必须设置为允许改变WindowTitleHint、WindowSystemMenuHint、WindowMinimizeButtonHint、WindowMaximizeButtonHint和WindowCloseButtonHint标志。

常量描述
Qt::CustomizeWindowHint0x02000000关闭默认的窗口标题提示。
Qt::WindowTitleHint0x00001000给窗口一个标题栏。
Qt::WindowSystemMenuHint0x00002000添加窗口系统菜单,以及可能的关闭按钮(例如在Mac上)。如果您需要隐藏或显示关闭按钮,使用WindowCloseButtonHint将更便携。
Qt::WindowMinimizeButtonHint0x00004000添加最小化按钮。在有些平台上,这隐含Qt::WindowSystemMenuHint以便其工作。
Qt::WindowMaximizeButtonHint0x00008000添加最大化按钮。在有些平台上,这隐含Qt::WindowSystemMenuHint以便其工作。
Qt::WindowMinMaxButtonsHintWindowMinimizeButtonHint | WindowMaximizeButtonHint添加最小化和最大化按钮。在有些平台上,这隐含Qt::WindowSystemMenuHint以便其工作。
Qt::WindowCloseButtonHint0x08000000添加关闭按钮。在有些平台上,这隐含Qt::WindowSystemMenuHint以便其工作。
Qt::WindowContextHelpButtonHint0x00010000在对话框中添加上下文帮助按钮。在有些平台上,这隐含Qt::WindowSystemMenuHint以便其工作。
Qt::MacWindowToolBarButtonHint0x10000000在macOS上添加工具栏按钮(即工具栏窗口右上角的那个椭圆形按钮)。
Qt::WindowFullscreenButtonHint0x80000000在macOS上添加全屏按钮。
Qt::BypassGraphicsProxyWidget0x20000000防止窗口及其子窗口自动嵌入到一个QGraphicsProxyWidget中,如果父窗口已经嵌入。如果您想使您的窗口始终是桌面的顶层窗口,不管父窗口是否已嵌入场景中,可以设置此标志。
Qt::WindowShadeButtonHint0x00020000如果底层窗口管理器支持,添加一个替代最小化按钮的卷帘按钮。
Qt::WindowStaysOnTopHint0x00040000通知窗口系统该窗口应该始终保持在其他所有窗口的顶部。注意:在某些X11窗口管理器上,为了使此标志正常工作,您还必须传递Qt::X11BypassWindowManagerHint。
Qt::WindowStaysOnTopHint0x04000000通知窗口系统该窗口应该始终保持在所有其他窗口的底部。

注意:在X11上,此提示仅在支持_NET_WM_STATE_BELOW原子的窗口管理器中工作。如果一个始终在底部的窗口有一个父窗口,则父窗口也会被放置在底部。此窗口提示目前在macOS上未实现。

注意:在Windows上,此功能仅适用于无边框或全屏窗口。

常量描述
Qt::WindowTransparentForInput0x00080000通知窗口系统此窗口仅用于输出(显示内容)且不接收输入。因此输入事件应穿过仿佛该窗口不存在一样。
Qt::WindowOverridesSystemGestures0x00100000通知窗口系统此窗口实现了自己的一套手势,并且应该禁用系统级别的手势,例如三指桌面切换。
Qt::WindowDoesNotAcceptFocus0x00200000通知窗口系统此窗口不应接收输入焦点。
Qt::MaximizeUsingFullscreenGeometryHint0x00400000通知窗口系统在最大化窗口时,应尽可能使用可用的屏幕几何形状,包括可能被系统UI(如状态栏或应用程序启动器)覆盖的区域。这可能的结果是窗口被放置在这些系统UI之下,但这并不保证,这取决于平台是否支持它。当启用标志时,用户负责考虑QScreen::availableGeometry(),以确保任何需要用户交互的应用程序UI元素不会被系统UI覆盖。
Qt::WindowType_Mask0x000000ff用于提取窗口标志窗口类型部分的掩码。

WindowFlags类型是QFlags<WindowType>的typedef。它存储了WindowType值的或组合。

另请参阅:QWidget::windowFlags窗口标志示例

函数文档

[since 6.2] void beginPropertyUpdateGroup()

标记属性更新组的开始。在此组内部,更改属性既不会立即更新任何相关属性,也不会触发更改通知。这些都会被推迟,直到通过调用 endPropertyUpdateGroup 结束组。

组可以嵌套。在这种情况下,延迟只会在最外层组结束后结束。

注意:更改通知仅在组影响的属性值全部更新到新值后才发送。这允许在需要更新多个属性时重新建立类的不变性,从而防止外部观察者注意到不一致的状态。

此函数是在Qt 6.2中引入的。

另请参阅:Qt::endPropertyUpdateGroupQScopedPropertyUpdateGroup

QTextStream &Qt::bin(QTextStream &stream)

stream上调用QTextStream::setIntegerBase(2),并返回stream

另请参阅:oct(),dec(),hex(),以及QTextStream操作符

QTextStream &Qt::bom(QTextStream &stream)

当使用UTF编码的QTextStream时,切换在中插入字节顺序标记。

参见 QTextStream::setGenerateByteOrderMark() 和 QTextStream操作符

QTextStream &Qt::center(QTextStream &stream)

调用stream上的QTextStream::setFieldAlignment(QTextStream::AlignCenter)并返回stream

参见 left(),right(),以及 QTextStream操作符

[constexpr noexcept,since 6.7] 模板 <typename LeftInt, typename RightInt, Qt::if_integral<LeftInt> = true, Qt::if_integral= true> Qt::strong_ordering compareThreeWay(LeftInt lhs, RightInt rhs)

这是一个重载函数。

执行整型的三路比较。

注意: 此函数仅在LeftIntRightInt都是内置整型时参与重载解析。

返回lhs <=> rhs,前提是LeftIntRightInt都是内置整型。与operator<=>()不同,此函数模板在C++17中也可用。有关更多详细信息,请参阅cppreference

此函数也可以用于自定义的compareThreeWay()函数,当按顺序排列由内置类型表示的自定义类的成员时

class MyClass {
public:
    ...
private:
    int value;
    ...
    friend Qt::strong_ordering
    compareThreeWay(const MyClass &lhs, const MyClass &rhs) noexcept
    { return Qt::compareThreeWay(lhs.value, rhs.value); }
    Q_DECLARE_STRONGLY_ORDERED(MyClass)
};

返回一个表示lhsrhs之间关系的Qt::strong_ordering实例。

此函数在Qt 6.7中被引入。

[constexpr noexcept, since 6.7] 模板 <typename LeftFloat, typename RightFloat, Qt::if_floating_point<LeftFloat> = true, Qt::if_floating_point= true> Qt::partial_ordering compareThreeWay(LeftFloat lhs, RightFloat rhs)

这是一个重载函数。

执行浮点类型的三路比较。

注意: 此函数仅在LeftFloatRightFloat都是内置浮点类型时参与重载解析。

如果LeftFloatRightFloat都是内置浮点类型,则返回lhs <=> rhs。与operator<=>()不同,此函数模板在C++17中也可用。有关更多详细信息,请参阅cppreference

此函数也可以用于自定义的compareThreeWay()函数,当按顺序排列由内置类型表示的自定义类的成员时

class MyClass {
public:
    ...
private:
    double value;
    ...
    friend Qt::partial_ordering
    compareThreeWay(const MyClass &lhs, const MyClass &rhs) noexcept
    { return Qt::compareThreeWay(lhs.value, rhs.value); }
    Q_DECLARE_PARTIALLY_ORDERED(MyClass)
};

返回一个表示lhsrhs之间关系的Qt::partial_ordering实例。如果lhsrhs不是一个数字(NaN),则返回Qt::partial_ordering::unordered

此函数在Qt 6.7中被引入。

[constexpr noexcept, since 6.7] 模板 <typename IntType, typename FloatType, Qt::if_integral<IntType> = true, Qt::if_floating_point= true> Qt::partial_ordering compareThreeWay(IntType lhs, FloatType rhs)

这是一个重载函数。

执行整数和浮点类型的三路比较。

注意: 此函数仅在IntType是内置整型,而FloatType是内置浮点型时参与重载解析。

此函数将lhs转换为FloatType并调用浮点类型的重载。

返回一个代表 lhsrhs 之间关系的 Qt::partial_ordering 实例。如果 rhs 不是一个数字(NaN),则返回 Qt::partial_ordering::unordered

此函数在Qt 6.7中被引入。

[constexpr noexcept, since 6.7] 模板 <typename FloatType, typename IntType, Qt::if_floating_point<FloatType> = true, Qt::if_integral= true> Qt::partial_ordering compareThreeWay(FloatType lhs, IntType rhs)

这是一个重载函数。

实现了浮点数和整数类型的 三元比较。

注意:此函数只有在 FloatType 是内置浮点类型,且 IntType 是内置整数类型时,才参与重载解析。

此函数将 rhs 转换为 FloatType 并调用浮点类型重载。

返回一个代表 lhsrhs 之间关系的 Qt::partial_ordering 实例。如果 lhs 不是一个数字(NaN),则返回 Qt::partial_ordering::unordered

此函数在Qt 6.7中被引入。

[constexpr noexcept, since 6.7] 模板 <typename LeftType, typename RightType, Qt::if_compatible_pointers<LeftType, RightType> = true> Qt::strong_ordering compareThreeWay(const LeftType *lhs, const RightType *rhs)

这是一个重载函数。

实现了指针的三元比较。

注意:如果 LeftTypeRightType 是同一类型或基类与派生类型,则此函数参与重载解析。它还用于比较任何指针到 std::nullptr_t

返回一个表示lhsrhs之间关系的Qt::strong_ordering实例。

此函数在Qt 6.7中被引入。

[constexpr noexcept, since 6.7] 模板 <typename Enum, Qt::if_enum<Enum> = true> Qt::strong_ordering compareThreeWay(Enum lhs, Enum rhs)

这是一个重载函数。

实现了枚举类型的三元比较。

注意:此函数只有在 Enum 是枚举类型时才参与重载解析。

此函数将 Enum 转换为其底层类型,并调用整数类型的重载。

返回一个表示lhsrhs之间关系的Qt::strong_ordering实例。

此函数在Qt 6.7中被引入。

QTextStream &Qt::dec(QTextStream &stream)

stream 上调用 QTextStream::setIntegerBase(10) 并返回 stream

另请参阅:bin(),oct(),hex(),以及 QTextStream 宽展器

[since 6.2] void endPropertyUpdateGroup()

结束属性更新组。如果最外层的组已经结束,并且现在将发生延迟的绑定评估和通知。

警告:在没有先调用 beginPropertyUpdateGroup 的情况下调用 endPropertyUpdateGroup 将导致未定义的行为。

此函数是在Qt 6.2中引入的。

另请参阅:Qt::beginPropertyUpdateGroupQScopedPropertyUpdateGroup

QTextStream &Qt::endl(QTextStream &stream)

stream 写入 '\n' 并刷新流。

等同于

stream << '\n' << Qt::flush;

注意:在Windows中,如果使用QIODevice::Text标志打开QTextStream的设备或字符串,所有的'\n'字符都将以'\r\n'的格式写入。

另请参阅flush(),reset(),以及QTextStream操作符

QTextStream &Qt::fixed(QTextStream &stream)

stream上调用的QTextStream::setRealNumberNotation(QTextStream::FixedNotation),并返回stream

另请参阅scientific() 和 QTextStream操作符

QTextStream &Qt::flush(QTextStream &stream)

stream上调用的QTextStream::flush(),并返回stream

另请参阅endl(),reset(),以及QTextStream操作符

QTextStream &Qt::forcepoint(QTextStream &stream)

stream上调用的QTextStream::setNumberFlags(QTextStream::numberFlags() | QTextStream::ForcePoint),并返回stream

另请参阅noforcepoint(),forcesign(),showbase(),以及QTextStream操作符

QTextStream &Qt::forcesign(QTextStream &stream)

stream上调用的QTextStream::setNumberFlags(QTextStream::numberFlags() | QTextStream::ForceSign),并返回stream

另请参阅noforcesign(),forcepoint(),showbase(),以及QTextStream操作符

QTextStream &Qt::hex(QTextStream &stream)

stream上调用的QTextStream::setIntegerBase(16),并返回stream

注意:十六进制修饰符仅可用于写入流。

另请参阅bin(),oct(),dec(),以及QTextStream操作符

QTextStream &Qt::left(QTextStream &stream)

stream上调用的QTextStream::setFieldAlignment(QTextStream::AlignLeft),并返回stream

另请参阅right(),center(),以及QTextStream操作符

QTextStream &Qt::lowercasebase(QTextStream &stream)

在流上调用 QTextStream::setNumberFlags(QTextStream::numberFlags() & ~QTextStream::UppercaseBase) 并返回 stream

另请参阅uppercasebase(),lowercasedigits(),以及 QTextStream manipulators

QTextStream &Qt::lowercasedigits(QTextStream &stream)

在流上调用 QTextStream::setNumberFlags(QTextStream::numberFlags() & ~QTextStream::UppercaseDigits) 并返回 stream

另请参阅uppercasedigits(),lowercasebase(),以及 QTextStream manipulators

QTextStream &Qt::noforcepoint(QTextStream &stream)

在流上调用 QTextStream::setNumberFlags(QTextStream::numberFlags() & ~QTextStream::ForcePoint) 并返回 stream

另请参阅forcepoint(),noforcesign(),noshowbase(),以及 QTextStream manipulators

QTextStream &Qt::noforcesign(QTextStream &stream)

在流上调用 QTextStream::setNumberFlags(QTextStream::numberFlags() & ~QTextStream::ForceSign) 并返回 stream

另请参阅forcesign(),noforcepoint(),noshowbase(),以及 QTextStream manipulators

QTextStream &Qt::noshowbase(QTextStream &stream)

在流上调用 QTextStream::setNumberFlags(QTextStream::numberFlags() & ~QTextStream::ShowBase) 并返回 stream

另请参阅showbase(),noforcesign(),noforcepoint(),以及 QTextStream manipulators

QTextStream &Qt::oct(QTextStream &stream)

在流上调用 QTextStream::setIntegerBase(8) 并返回 stream

另请参阅bin(),dec(),hex(),以及 QTextStream manipulators

QTextStream &Qt::reset(QTextStream &stream)

在流上调用 QTextStream::reset() 并返回 stream

另请参阅flush() 以及 QTextStream manipulators

stream上调用QTextStream::setFieldAlignment(QTextStream::AlignRight)并返回stream

另请参阅leftcenterQTextStream操纵符

QTextStream &Qt::scientific(QTextStream &stream)

stream上调用QTextStream::setRealNumberNotation(QTextStream::ScientificNotation)并返回stream

另请参阅fixedQTextStream操纵符

QTextStream &Qt::showbase(QTextStream &stream)

stream上调用QTextStream::setNumberFlags(QTextStream::numberFlags() | QTextStream::ShowBase)并返回stream

另请参阅noshowbaseforcesignforcepointQTextStream操纵符

QTextStream &Qt::uppercasebase(QTextStream &stream)

stream上调用QTextStream::setNumberFlags(QTextStream::numberFlags() | QTextStream::UppercaseBase)并返回stream

另请参阅lowercasebaseuppercasedigitsQTextStream操纵符

QTextStream &Qt::uppercasedigits(QTextStream &stream)

stream上调用QTextStream::setNumberFlags(QTextStream::numberFlags() | QTextStream::UppercaseDigits)并返回stream

另请参阅lowercasedigitsuppercasebaseQTextStream操纵符

QTextStream &Qt::ws(QTextStream &stream)

stream上调用skipWhiteSpace()并返回stream

另请参阅QTextStream操纵符

© 2024 Qt公司有限公司。本文档的贡献者是各自版权的所有者。本提供的文档是在GNU自由文档许可版本1.3下许可的,由自由软件基金会发布。Qt及其 respective 商标是芬兰和/或其他国家的 Qt公司有限公司的商标。所有其他商标均为其各自所有者的财产。