PySide6.QtCore.Qt

class Qt

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

概要

静态函数

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题,您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

class GlobalColor

Qt 预定义的 QColor 对象:

常量

描述

Qt.white

白色 (#ffffff)

Qt.black

黑色 (#000000)

Qt.red

红色 (#ff0000)

Qt.darkRed

深红色 (#800000)

Qt.green

绿色 (#00ff00)

Qt.darkGreen

深绿色 (#008000)

Qt.blue

蓝色 (#0000ff)

Qt.darkBlue

深蓝色 (#000080)

Qt.cyan

青色 (#00ffff)

Qt.darkCyan

深青色 (#008080)

Qt.magenta

品红 (#ff00ff)

Qt.darkMagenta

深洋红色 (#800080)

Qt.yellow

黄色 (#ffff00)

Qt.darkYellow

深黄色 (#808000)

Qt.gray

灰色 (#a0a0a4)

Qt.darkGray

深灰色 (#808080)

Qt.lightGray

浅灰色 (#c0c0c0)

Qt.transparent

一个透明的黑色值(即 QColor(0, 0, 0, 0))

Qt.color0

0 像素值(用于位图)

Qt.color1

1 像素值(用于位图)

另请参阅

QColor

class ColorScheme

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

常量

描述

Qt.ColorScheme.Unknown

外观未知。

Qt.ColorScheme.Light

背景颜色比文本颜色浅,即主题是浅色的。

Qt.ColorScheme.Dark

背景颜色比文本颜色更深,即主题为深色。

在6.5版本中添加。

class MouseButton

(继承自 enum.Flag) 此枚举类型描述了不同的鼠标按钮。

常量

描述

Qt.NoButton

按钮状态不指向任何按钮(参见 QMouseEvent::button())。

Qt.AllButtons

此值对应于所有可能的鼠标按钮的掩码。用于设置MouseArea的‘acceptedButtons’属性以接受所有鼠标按钮。

Qt.LeftButton

按下左键,或事件涉及左键。(对于左手使用的鼠标,左键可能是右键。)

Qt.RightButton

右键。

Qt.MiddleButton

中间按钮。

Qt.BackButton

‘返回’按钮。(通常出现在鼠标的‘拇指’侧,带有额外按钮。这不是倾斜滚轮。)

Qt.XButton1

‘后退’按钮。

Qt.ExtraButton1

‘返回’按钮。

Qt.ForwardButton

‘前进’按钮。(通常位于‘后退’按钮旁边,并且也由拇指按下。)

Qt.XButton2

‘前进’按钮。

Qt.ExtraButton2

‘前进’按钮。

Qt.TaskButton

‘任务’按钮。

Qt.ExtraButton3

‘任务’按钮。

Qt.ExtraButton4

第7个非滚轮鼠标按钮。

Qt.ExtraButton5

第8个非滚轮鼠标按钮。

Qt.ExtraButton6

第9个非滚轮鼠标按钮。

Qt.ExtraButton7

第10个非滚轮鼠标按钮。

Qt.ExtraButton8

第11个非滚轮鼠标按钮。

Qt.ExtraButton9

第12个非滚轮鼠标按钮。

Qt.ExtraButton10

第13个非滚轮鼠标按钮。

Qt.ExtraButton11

第14个非滚轮鼠标按钮。

Qt.ExtraButton12

第15个非滚轮鼠标按钮。

Qt.ExtraButton13

第16个非滚轮鼠标按钮。

Qt.ExtraButton14

第17个非滚轮鼠标按钮。

Qt.ExtraButton15

第18个非滚轮鼠标按钮。

Qt.ExtraButton16

第19个非滚轮鼠标按钮。

Qt.ExtraButton17

第20个非滚轮鼠标按钮。

Qt.ExtraButton18

第21个非滚轮鼠标按钮。

Qt.ExtraButton19

第22个非滚轮鼠标按钮。

Qt.ExtraButton20

第23个非滚轮鼠标按钮。

Qt.ExtraButton21

第24个非滚轮鼠标按钮。

Qt.ExtraButton22

第25个非滚轮鼠标按钮。

Qt.ExtraButton23

第26个非滚轮鼠标按钮。

Qt.ExtraButton24

第27个非滚轮鼠标按钮。

注意

一些多按钮鼠标的型号预先配置了模拟键盘序列的高编号按钮,用于特定的游戏。为了使这些按钮被视为实际的“鼠标按钮”,必须重新配置设备(使用供应商的配置工具)。

另请参阅

KeyboardModifier Modifier

class Orientation

(继承自 enum.Flag) 此类型用于表示对象的方向。

常量

描述

Qt.水平

Qt.Vertical

方向用于QScrollBar,例如。

class FocusPolicy

(继承自 enum.IntFlag) 此枚举类型定义了小部件在获取键盘焦点时可以采取的各种策略。

常量

描述

Qt.TabFocus

该部件通过制表符接受焦点。

Qt.ClickFocus

小部件通过点击接受焦点。

Qt.StrongFocus

小部件通过制表符和点击接受焦点。在macOS上,这也将表明小部件在“文本/列表焦点模式”下接受制表符焦点。

Qt.WheelFocus

类似于 Qt::StrongFocus,加上该小部件通过使用鼠标滚轮接受焦点。

Qt.NoFocus

该部件不接受焦点。

class TabFocusBehavior

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

常量

描述

Qt.NoTabFocus

不进行任何迭代。

Qt.TabFocusTextControls

遍历文本控件和小部件。

Qt.TabFocusListControls

遍历列表控件和小部件。

Qt.TabFocusAllControls

遍历所有控件和小部件。

class SortOrder

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

常量

描述

Qt.AscendingOrder

项目按升序排序,例如在拉丁-1区域设置中,以‘AAA’开始,以‘ZZZ’结束

Qt.DescendingOrder

项目按降序排序,例如在拉丁-1区域设置中,以‘ZZZ’开头,以‘AAA’结尾

class SplitBehaviorFlags

(继承自 enum.Flag) 此枚举指定了 split() 函数在处理空字符串时应如何表现。

常量

描述

Qt.KeepEmptyParts

如果字段为空,则将其保留在结果中。

Qt.SkipEmptyParts

如果字段为空,不要将其包含在结果中。

另请参阅

split()

class TileRule

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

常量

描述

Qt.StretchTile

将图像缩放以适应可用区域。

Qt.RepeatTile

重复图像直到没有更多空间。可能会裁剪最后一张图像。

Qt.RoundTile

类似于重复,但缩小图像以确保最后一个图块不被裁剪。

在版本4.6中添加。

class AlignmentFlag

(继承自 enum.IntFlag) 此枚举类型用于描述对齐方式。它包含水平和垂直标志,可以组合使用以达到所需效果。

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

水平标志有:

常量

描述

Qt.AlignLeft

与左边缘对齐。

Qt.AlignRight

与右边缘对齐。

Qt.AlignHCenter

在可用空间中水平居中。

Qt.AlignJustify

在可用空间中对齐文本。

垂直标志是:

常量

描述

Qt.AlignTop

与顶部对齐。

Qt.AlignBottom

与底部对齐。

Qt.AlignVCenter

在可用空间中垂直居中。

Qt.AlignBaseline

与基线对齐。

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

常量

描述

Qt.AlignCenter

在水平和垂直方向上都居中。

您一次最多可以使用一个水平标志和一个垂直标志。Qt::AlignCenter 同时被视为水平和垂直标志。

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

常量

描述

Qt.AlignAbsolute

如果小部件的布局方向是RightToLeft(而不是默认的LeftToRight),则Qt::AlignLeft指的是边缘,而Qt::AlignRight指的是边缘。这通常是期望的行为。如果你希望Qt::AlignLeft始终表示“左”,Qt::AlignRight始终表示“右”,请将此标志与Qt::AlignAbsolute结合使用。

Qt.AlignLeading

Qt::AlignLeft 的同义词。

Qt.AlignTrailing

Qt::AlignRight 的同义词。

口罩:

常量

描述

Qt.AlignHorizontal_Mask

Qt.AlignVertical_Mask

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

class TextFlag

(继承自 enum.IntFlag) 此枚举类型用于定义一些修饰符标志。其中一些标志仅在打印的上下文中才有意义:

常量

描述

Qt.TextSingleLine

将所有空白视为空格并仅打印一行。

Qt.TextDontClip

如果无法保持在给定的边界内,它会在外部打印。

Qt.TextExpandTabs

使U+0009(ASCII制表符)字符移动到下一个制表位。

Qt.TextShowMnemonic

将字符串“&P”显示为P。对于&符号,使用“&&”。

Qt.TextWordWrap

在适当的位置换行,例如在单词边界处。

Qt.TextWrapAnywhere

在任何地方换行,甚至在单词内部。

Qt.TextHideMnemonic

与Qt::TextShowMnemonic相同,但不绘制下划线。

Qt.TextDontPrint

将此文本视为“隐藏”且不打印。

Qt.TextIncludeTrailingSpaces

当设置此选项时,QTextLine::naturalTextWidth() 和 QTextLine::naturalTextRect() 将返回一个包含文本中尾部空格宽度的值;否则,此宽度将被排除。

Qt.TextJustificationForced

确保文本行是两端对齐的。

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

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

class TextElideMode

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

常量

描述

Qt.ElideLeft

省略号应出现在文本的开头。

Qt.ElideRight

省略号应出现在文本的末尾。

Qt.ElideMiddle

省略号应出现在文本的中间。

Qt.ElideNone

文本中不应出现省略号。当传递给诸如QFontMetrics::elidedText()之类的函数时,这将导致返回完整的字符串,除非文本包含多长度变体。在这种情况下,必须通过裁剪到组件宽度来完成省略。

Qt::ElideMiddle 通常是URL的最合适选择(例如,“http://bugreports.qt…/QTWEBSITE-13/”),而Qt::ElideRight适用于其他字符串(例如,“Deploying Applications on Ma…”)。

另请参阅

AlignmentFlag elideMode

class WhiteSpaceMode

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

常量

描述

Qt.WhiteSpaceNormal

用于在段落中显示正常换行文本的空格模式。

Qt.WhiteSpacePre

一种预格式化文本模式,其中空白字符被精确复制。

Qt.WhiteSpaceNoWrap

class HitTestAccuracy

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

常量

描述

Qt.ExactHit

输入发生的点必须与文档中敏感输入部分完全一致。

Qt.FuzzyHit

输入发生的位置可以靠近文档中对输入敏感的部分。

class WindowType

(继承自 enum.IntFlag) 此枚举类型用于指定小部件的各种窗口系统属性。它们相当不常见,但在某些情况下是必要的。其中一些标志取决于底层窗口管理器是否支持它们。

主要类型有

常量

描述

Qt.Widget

这是QWidget的默认类型。如果这种类型的部件有父部件,则它们是子部件;如果没有父部件,则它们是独立的窗口。另请参见Qt::Window和Qt::SubWindow。

Qt.Window

表示该小部件是一个窗口,通常带有窗口系统框架和标题栏,无论该小部件是否有父级。请注意,如果小部件没有父级,则无法取消设置此标志。

Qt.Dialog

表示该小部件是一个窗口,应该被装饰为对话框(即,通常在标题栏中没有最大化或最小化按钮)。这是QDialog的默认类型。如果你想将其用作模态对话框,它应该从另一个窗口启动,或者有一个父窗口并与QWidget::windowModality属性一起使用。如果你使其模态,对话框将阻止应用程序中的其他顶级窗口获取任何输入。我们将具有父窗口的顶级窗口称为次级窗口。

Qt.Sheet

表示该窗口是macOS上的一个表单。由于使用表单意味着窗口模态性,推荐的方式是使用QWidget::setWindowModality(),或者QDialog::open()来代替。

Qt.Drawer

表示该小部件是macOS上的抽屉。此功能已过时。设置该标志无效。

Qt.Popup

表示该小部件是一个弹出式顶层窗口,即它是模态的,但具有适合弹出菜单的窗口系统框架。

Qt.Tool

表示该小部件是一个工具窗口。工具窗口通常是一个带有比通常更小的标题栏和装饰的小窗口,通常用于工具按钮的集合。如果有父窗口,工具窗口将始终保持在父窗口的顶部。如果没有父窗口,您也可以考虑使用Qt::WindowStaysOnTopHint。如果窗口系统支持,工具窗口可以用稍微轻一些的框架装饰。它也可以与Qt::FramelessWindowHint结合使用。在macOS上,工具窗口对应于NSPanel类的窗口。这意味着窗口位于普通窗口之上的层级,使得无法将普通窗口放在其顶部。默认情况下,当应用程序不活动时,工具窗口会消失。这可以通过WA_MacAlwaysShowToolWindow属性来控制。

Qt.ToolTip

表示该小部件是一个工具提示。这在内部用于实现工具提示。

Qt.SplashScreen

表示该窗口是一个启动画面。这是QSplashScreen的默认类型。

Qt.SubWindow

表示此小部件是一个子窗口,例如QMdiSubWindow小部件。

Qt.ForeignWindow

表示此窗口对象是一个句柄,代表由另一个进程或手动使用本机代码创建的本机平台窗口。

Qt.CoverWindow

表示该窗口代表一个封面窗口,当应用程序在某些平台上最小化时显示。

还有一些标志可以用来自定义顶层窗口的外观。这些标志对其他窗口没有影响:

常量

描述

Qt.MSWindowsFixedSizeDialogHint

在Windows上为窗口提供一个细的对话框边框。这种样式传统上用于固定大小的对话框。

注意

在多显示器环境中不建议使用此标志。这是因为系统会强制窗口在跨屏幕移动时保持其原始大小。这在使用的显示器具有不同分辨率时尤其不受欢迎。

常量

描述

Qt.MSWindowsOwnDC

在Windows上为窗口提供自己的显示上下文。

Qt.BypassWindowManagerHint

此标志可用于向平台插件指示应禁用“所有”窗口管理器协议。此标志的行为将根据应用程序运行的操作系统和运行的窗口管理器而有所不同。该标志可用于获取没有配置设置的本机窗口。

Qt.X11BypassWindowManagerHint

完全绕过窗口管理器。这将导致一个无边框的窗口,完全不受管理(即,除非手动调用QWidget::activateWindow(),否则没有键盘输入)。

Qt.FramelessWindowHint

生成一个无边框窗口。

在X11上,标志的结果取决于窗口管理器及其理解Motif和/或NETWM提示的能力。大多数现有的现代窗口管理器都能处理这个问题。

注意

如果窗口管理器依赖于框架来交互式地操作窗口,用户将无法再通过窗口系统移动或调整窗口大小,但这种副作用不应被依赖。要生成一个无法调整大小的固定大小窗口,请将QWindow::setMinimumSize()和QWindow::setMaximumSize()设置为相同的大小。

常量

描述

Qt.NoDropShadowWindowHint

在支持的平台上禁用窗口阴影。

CustomizeWindowHint 标志用于启用窗口控件的自定义。必须设置此标志才能更改 WindowTitleHintWindowSystemMenuHintWindowMinimizeButtonHintWindowMaximizeButtonHintWindowCloseButtonHint 标志。

常量

描述

Qt.CustomizeWindowHint

关闭默认的窗口标题提示。

Qt.WindowTitleHint

为窗口提供一个标题栏。

Qt.WindowSystemMenuHint

添加一个窗口系统菜单,可能还有一个关闭按钮(例如在Mac上)。如果你需要隐藏或显示关闭按钮,使用WindowCloseButtonHint更具可移植性。

Qt.WindowMinimizeButtonHint

添加一个最小化按钮。在某些平台上,这暗示了Qt::WindowSystemMenuHint以便其工作。

Qt.WindowMaximizeButtonHint

添加一个最大化按钮。在某些平台上,这暗示了Qt::WindowSystemMenuHint以便其正常工作。

Qt.WindowMinMaxButtonsHint

添加最小化和最大化按钮。在某些平台上,这暗示需要Qt::WindowSystemMenuHint才能正常工作。

Qt.WindowCloseButtonHint

添加一个关闭按钮。在某些平台上,这意味着需要Qt::WindowSystemMenuHint才能使其工作。

Qt.WindowContextHelpButtonHint

向对话框添加上下文帮助按钮。在某些平台上,这暗示了Qt::WindowSystemMenuHint以便其正常工作。

Qt.MacWindowToolBarButtonHint

在macOS上添加一个工具栏按钮(即,位于具有工具栏的窗口右上方的椭圆形按钮)。

Qt.WindowFullscreenButtonHint

在macOS上添加一个全屏按钮。

Qt.BypassGraphicsProxyWidget

如果父部件已经嵌入,防止窗口及其子窗口自动嵌入到QGraphicsProxyWidget中。如果您希望您的部件始终是桌面上的顶级部件,无论父部件是否嵌入到场景中,您可以设置此标志。

Qt.WindowShadeButtonHint

如果底层窗口管理器支持,则添加一个遮罩按钮以替代最小化按钮。

Qt.WindowStaysOnTopHint

通知窗口系统该窗口应保持在所有其他窗口的顶部。请注意,在某些X11窗口管理器上,您还需要传递Qt::X11BypassWindowManagerHint以使此标志正常工作。

Qt.WindowStaysOnBottomHint

通知窗口系统该窗口应保持在所有其他窗口的底部。

注意

在X11上,此提示仅在支持_NET_WM_STATE_BELOW原子的窗口管理器中有效。如果一个始终位于底部的窗口有父窗口,父窗口也将保持在底部。此窗口提示目前在macOS上未实现。

注意

在Windows上,这仅适用于无边框或全屏窗口。

常量

描述

Qt.WindowTransparentForInput

通知窗口系统此窗口仅用于输出(显示某些内容)并且不接受输入。因此,输入事件应该像它不存在一样通过。

Qt.WindowOverridesSystemGestures

通知窗口系统此窗口实现了自己的手势集,并且应禁用系统级别的手势,例如三指桌面切换。

Qt.WindowDoesNotAcceptFocus

通知窗口系统此窗口不应接收输入焦点。

Qt.MaximizeUsingFullscreenGeometryHint

通知窗口系统在最大化窗口时,应尽可能使用可用的屏幕几何区域,包括可能被系统UI(如状态栏或应用程序启动器)覆盖的区域。这可能会导致窗口被放置在这些系统UI之下,但并不保证,具体取决于平台是否支持。当启用此标志时,用户需要负责考虑QScreen::availableGeometry(),以确保应用程序中需要用户交互的任何UI元素不会被系统UI覆盖。

Qt.WindowType_Mask

用于提取窗口标志中窗口类型部分的掩码。

另请参阅

windowFlagsWindow Flags 示例

class WindowState

(继承自 enum.Flag) 此枚举类型用于指定顶层窗口的当前状态。

状态是

常量

描述

Qt.WindowNoState

窗口没有设置状态(处于正常状态)。

Qt.WindowMinimized

窗口已最小化(即图标化)。

Qt.WindowMaximized

窗口被最大化,并且周围有一个框架。

Qt.WindowFullScreen

窗口填满整个屏幕,周围没有任何边框。

Qt.WindowActive

窗口是活动窗口,即它具有键盘焦点。

class ApplicationState

(继承自 enum.Flag) 此枚举类型用于指定应用程序的当前状态。

状态是

常量

描述

Qt.ApplicationSuspended

应用程序即将挂起。当进入此状态时,应用程序应保存其状态,停止所有活动,并准备停止代码执行。在挂起期间,应用程序可以随时被终止,而无需进一步警告(例如,当内存不足迫使操作系统清除挂起的应用程序时)。

Qt.ApplicationHidden

应用程序已隐藏并在后台运行。这是需要执行后台处理(如播放音乐)的应用程序的正常状态,同时用户与其他应用程序交互。应用程序在进入此状态时应释放所有图形资源。

Qt.ApplicationInactive

应用程序可见,但未被选中置于前台。在桌面平台上,这通常意味着用户激活了另一个应用程序。在移动平台上,当操作系统通过例如来电或短信消息中断用户时,更常见的是进入此状态。在此状态下,考虑减少CPU密集型任务。

Qt.ApplicationActive

应用程序可见并被选中置于前台。

class ScreenOrientation

(继承自 enum.Flag) 此枚举类型指定了屏幕可能具有的各种方向。

常量

描述

Qt.PrimaryOrientation

显示器的主要方向。

Qt.LandscapeOrientation

横向方向,显示宽度大于显示高度。

Qt.PortraitOrientation

纵向方向,显示高度大于显示宽度,相对于横向顺时针旋转90度。

Qt.InvertedLandscapeOrientation

倒置的横向方向,相对于横向旋转180度。

Qt.InvertedPortraitOrientation

倒置的纵向方向,相对于纵向旋转180度。

class WidgetAttribute

此枚举类型用于指定各种小部件属性。属性通过QWidget::setAttribute()设置和清除,并通过QWidget::testAttribute()查询,尽管下面提到了一些具有特殊便利功能的属性。

常量

描述

Qt.WA_AcceptDrops

允许将拖放操作中的数据放到小部件上(参见 QWidget::setAcceptDrops())。

Qt.WA_AlwaysShowToolTips

为非活动窗口启用工具提示。

Qt.WA_CustomWhatsThis

表示该小部件希望在“这是什么?”模式下继续正常操作。这是由小部件的作者设置的。

Qt.WA_DeleteOnClose

当小部件接受关闭事件时,使Qt删除此小部件(参见QWidget::closeEvent())。

Qt.WA_Disabled

表示该小部件被禁用,即它不会接收任何鼠标或键盘事件。还有一个获取函数 QWidget::isEnabled()。这是由 Qt 内核设置/清除的。

Qt.WA_DontShowOnScreen

表示该小部件被隐藏或不是可见桌面的一部分。

Qt.WA_ForceDisabled

表示该小部件被显式禁用,即即使其所有祖先都被设置为启用状态,它也将保持禁用状态。这暗示了WA_Disabled。这是由QWidget::setEnabled()和QWidget::setDisabled()设置/清除的。

Qt.WA_ForceUpdatesDisabled

表示该小部件的更新被显式禁用;即即使其所有祖先都被设置为启用更新状态,它也将保持禁用状态。这暗示了WA_UpdatesDisabled。这是由QWidget::setUpdatesEnabled()设置/清除的。

Qt.WA_Hover

强制Qt在鼠标进入或离开小部件时生成绘制事件。此功能通常在实现自定义样式时使用。

Qt.WA_InputMethodEnabled

启用亚洲语言的输入法。在创建自定义文本编辑小部件时必须设置。

Qt.WA_KeyboardFocusChange

当用户使用键盘(Tab、Backtab 或快捷键)更改焦点时,设置在顶层窗口上。

Qt.WA_KeyCompression

如果设置,则启用按键事件压缩;如果未设置,则禁用。默认情况下,按键压缩是关闭的,因此小部件每次按键都会收到一个按键事件(或更多,因为自动重复通常是开启的)。如果你开启它并且你的程序跟不上按键输入,Qt可能会尝试压缩按键事件,以便每个事件可以处理多个字符。例如,如果CPU的布局重新计算时间过长,文字处理器小部件可能会在每个QKeyEvent::text()中接收2、3或更多字符。如果一个小部件支持多字符Unicode输入,开启压缩总是安全的。Qt仅对可打印字符执行按键事件压缩。Modifier键、光标移动键、功能键和各种操作键(例如Escape、Enter、Backspace、PrintScreen)将停止按键事件压缩,即使有更多可压缩的按键事件可用。除了Mac和X11以外的平台不支持此压缩,在这种情况下开启它将没有效果。这由小部件的作者设置/清除。

Qt.WA_LayoutOnEntireRect

表示该小部件希望QLayout在整个QWidget::rect()上操作,而不仅仅是在QWidget::contentsRect()上。这是由小部件的作者设置的。

Qt.WA_LayoutUsesWidgetRect

在使用QLayout布局此小部件时,忽略样式中的布局项矩形。

Qt.WA_MacOpaqueSizeGrip

表示原生大小调整手柄应为不透明而非透明(默认)。此属性仅适用于macOS,并由小部件的作者设置。

Qt.WA_MacShowFocusRect

表示此小部件周围应获得一个QFocusFrame。某些小部件无论此属性如何都会绘制自己的焦点光环。请注意,QWidget::focusPolicy也在是否给予焦点方面起着主要作用,这仅控制是否获得焦点框。此属性仅适用于macOS。

Qt.WA_MacNormalSize

表示该部件在macOS中应具有正常大小。此属性仅适用于macOS。

Qt.WA_MacSmallSize

表示在macOS中,小部件应具有小尺寸。此属性仅适用于macOS。

Qt.WA_MacMiniSize

表示小部件在macOS中应具有迷你尺寸。此属性仅适用于macOS。

Qt.WA_Mapped

表示该部件已映射到屏幕上。这是由Qt内核设置/清除的。

Qt.WA_MouseNoMask

使小部件接收整个小部件的鼠标事件,无论当前设置的遮罩如何,覆盖QWidget::setMask()。这不适用于顶级窗口。

Qt.WA_MouseTracking

表示该小部件已启用鼠标跟踪。请参阅 QWidget::mouseTracking。

Qt.WA_Moved

表示该小部件具有显式位置。这由QWidget::move()和QWidget::setGeometry()设置/清除。

Qt.WA_NoChildEventsForParent

表示该小部件不希望将ChildAdded或ChildRemoved事件发送到其父级。这很少需要,但可以帮助避免自动插入小部件,如分隔器和布局。这是由小部件的作者设置的。

Qt.WA_NoChildEventsFromChildren

表示该小部件不希望接收从其子部件发送的ChildAdded或ChildRemoved事件。这是由小部件的作者设置的。

Qt.WA_NoMouseReplay

用于弹出窗口部件。表示当弹出窗口部件关闭时,不应重放最近的鼠标按下事件。该标志由窗口部件的作者设置,并在每次窗口部件接收到新的鼠标事件时由Qt内核清除。

Qt.WA_NoMousePropagation

禁止鼠标事件传播到小部件的父级。默认情况下,此属性是禁用的。

Qt.WA_TransparentForMouseEvents

当启用时,此属性会禁用向该小部件及其子部件传递鼠标事件。鼠标事件会传递给其他小部件,就像该小部件及其子部件不在小部件层次结构中一样;鼠标点击和其他事件实际上“穿过”它们。此属性默认是禁用的。

Qt.WA_NoSystemBackground

表示该小部件没有背景,即当小部件接收到绘制事件时,背景不会自动重新绘制。注意:与WA_OpaquePaintEvent不同,新暴露的区域永远不会用背景填充(例如,在首次显示窗口后,用户可以看到“透过”它,直到应用程序处理绘制事件)。此标志由小部件的作者设置或清除。

Qt.WA_OpaquePaintEvent

表示小部件在接收到绘制事件时会绘制其所有像素。因此,在生成绘制事件之前,不需要进行更新、调整大小、滚动和焦点更改等操作来擦除小部件。使用WA_OpaquePaintEvent可以通过帮助减少不支持双缓冲的系统上的闪烁并避免在绘制之前擦除背景所需的计算周期来提供小的优化。注意:与WA_NoSystemBackground不同,WA_OpaquePaintEvent会尽量避免透明的窗口背景。此标志由小部件的作者设置或清除。

Qt.WA_OutsideWSRange

表示该小部件在窗口系统坐标系的有效范围之外。在有效范围之外的小部件无法在屏幕上映射。这由Qt内核设置/清除。

Qt.WA_PaintOnScreen

表示该小部件希望直接在屏幕上绘制。设置了此属性的小部件不参与合成管理,即它们不能是半透明的,也不能透过半透明的重叠小部件发光。注意:此标志仅在X11上受支持,并且它会禁用双缓冲。在Qt for Embedded Linux上,该标志仅在顶级小部件上设置时才有效,并且依赖于活动屏幕驱动程序的支持。此标志由小部件的作者设置或清除。要在Qt的绘制系统之外进行渲染,例如,如果您需要本地绘制原语,您需要重新实现QWidget::paintEngine()以返回0并设置此标志。

Qt.WA_PaintUnclipped

使所有在此小部件上操作的画家不受裁剪。此小部件的子部件或前面的其他小部件不会裁剪画家可以绘制的区域。此标志仅支持设置了WA_PaintOnScreen标志的小部件。跨平台实现此功能的优选方法是创建一个位于其他小部件前面的透明小部件。

Qt.WA_PendingMoveEvent

表示有一个移动事件待处理,例如,当一个隐藏的小部件被移动时。这个标志由Qt内核设置或清除。

Qt.WA_PendingResizeEvent

表示一个调整大小事件正在等待处理,例如,当一个隐藏的小部件被调整大小时。这个标志由Qt内核设置或清除。

Qt.WA_QuitOnClose

表示在决定是否在最后一个窗口关闭时退出应用程序时,应考虑该小部件。此行为可以通过QGuiApplication::quitOnLastWindowClosed属性进行修改。默认情况下,此属性为所有Window类型的小部件设置。

Qt.WA_Resized

表示该小部件具有显式大小。此标志由QWidget::resize()和QWidget::setGeometry()设置或清除。

Qt.WA_RightToLeft

表示小部件的布局方向是从右到左。

Qt.WA_SetCursor

表示该小部件有自己的光标。此标志由QWidget::setCursor()和QWidget::unsetCursor()设置或清除。

Qt.WA_SetFont

表示该小部件有自己的字体。此标志由QWidget::setFont()设置或清除。

Qt.WA_SetPalette

表示该小部件有自己的调色板。此标志由QWidget::setPalette()设置或清除。

Qt.WA_SetStyle

表示该小部件有自己的样式。此标志由QWidget::setStyle()设置或清除。

Qt.WA_ShowModal

此属性已被弃用。 请改用 QWidget::windowModality。

Qt.WA_StaticContents

表示小部件的内容是西北对齐且静态的。在调整大小时,这样的小部件只会接收到自身新可见部分的绘制事件。此标志由小部件的作者设置或清除。

Qt.WA_StyleSheet

表示该小部件使用样式表进行样式设置。每当小部件受到样式表影响时,即使样式表未影响小部件的外观,也会设置WA_StyleSheet。

Qt.WA_StyleSheetTarget

表示小部件的外观已被样式表修改。WA_StyleSheet 也将被设置。此值在 Qt 5.12 中引入。

Qt.WA_TabletTracking

表示该小部件已启用平板跟踪。请参阅 QWidget::tabletTracking。

Qt.WA_TranslucentBackground

表示小部件应具有半透明背景,即小部件的任何非不透明区域将因为小部件具有alpha通道而呈现半透明。设置此标志会导致WA_NoSystemBackground被设置。在Windows上,小部件还需要设置FramelessWindowHint窗口标志。此标志由小部件的作者设置或清除。自Qt 5.0起,在小部件显示后切换此属性在平台上并不统一支持。当需要半透明背景时,应在创建小部件时尽早设置此属性,并避免之后更改它。

Qt.WA_UnderMouse

表示小部件位于鼠标光标下方。在拖放操作期间,该值不会正确更新。还有一个获取函数,QWidget::underMouse()。此标志由Qt内核设置或清除。

Qt.WA_UpdatesDisabled

表示更新被阻止(包括系统背景)。此标志由Qt内核设置或清除。警告:此标志永远不应由小部件的作者设置或清除。

Qt.WA_WindowModified

表示窗口被标记为已修改。在某些平台上,此标志将不起作用,而在其他平台(包括macOS和Windows)上,窗口将显示为已修改的外观。此标志由QWidget::setWindowModified()设置或清除。

Qt.WA_WindowPropagation

使顶层窗口从其父窗口继承字体、调色板和区域设置。

Qt.WA_MacAlwaysShowToolWindow

在macOS上,即使应用程序不处于活动状态,也显示工具窗口。默认情况下,当应用程序不活动时,所有工具窗口都会被隐藏。

Qt.WA_SetLocale

表示在小部件中应考虑区域设置。

Qt.WA_StyledBackground

表示小部件应使用样式化的背景进行绘制。

Qt.WA_ShowWithoutActivating

显示小部件而不使其激活。

Qt.WA_NativeWindow

表示为该小部件创建了一个本地窗口。启用此标志还将强制为该小部件的祖先创建本地窗口,除非设置了Qt::WA_DontCreateNativeAncestors。

Qt.WA_DontCreateNativeAncestors

表示即使小部件本身是本地的,其祖先也保持非本地状态。

Qt.WA_X11NetWmWindowTypeDesktop

将 _NET_WM_WINDOW_TYPE_DESKTOP 添加到窗口的 _NET_WM_WINDOW_TYPE X11 窗口属性中。有关更多详细信息,请参阅 http://standards.freedesktop.org/wm-spec/。此属性在非 X11 平台上无效。

Qt.WA_X11NetWmWindowTypeDock

将 _NET_WM_WINDOW_TYPE_DOCK 添加到窗口的 _NET_WM_WINDOW_TYPE X11 窗口属性中。有关更多详细信息,请参阅 http://standards.freedesktop.org/wm-spec/。此属性在非 X11 平台上无效。

Qt.WA_X11NetWmWindowTypeToolBar

将_NET_WM_WINDOW_TYPE_TOOLBAR添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参阅http://standards.freedesktop.org/wm-spec/。此属性在非X11平台上无效。注意:Qt会自动为QToolBar设置此属性。

Qt.WA_X11NetWmWindowTypeMenu

将 _NET_WM_WINDOW_TYPE_MENU 添加到窗口的 _NET_WM_WINDOW_TYPE X11 窗口属性中。有关更多详细信息,请参阅 http://standards.freedesktop.org/wm-spec/。此属性在非 X11 平台上无效。注意:当 QMenu 被分离时,Qt 会自动设置此属性。

Qt.WA_X11NetWmWindowTypeUtility

将 _NET_WM_WINDOW_TYPE_UTILITY 添加到窗口的 _NET_WM_WINDOW_TYPE X11 窗口属性中。有关更多详细信息,请参阅 http://standards.freedesktop.org/wm-spec/。此属性在非 X11 平台上无效。注意:Qt 会自动为 Tool 窗口类型设置此属性。

Qt.WA_X11NetWmWindowTypeSplash

将_NET_WM_WINDOW_TYPE_SPLASH添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参见http://standards.freedesktop.org/wm-spec/。此属性在非X11平台上无效。注意:Qt会自动为SplashScreen窗口类型设置此属性。

Qt.WA_X11NetWmWindowTypeDialog

将_NET_WM_WINDOW_TYPE_DIALOG添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参见http://standards.freedesktop.org/wm-spec/。此属性在非X11平台上无效。注意:Qt会自动为DialogSheet窗口类型设置此属性。

Qt.WA_X11NetWmWindowTypeDropDownMenu

将 _NET_WM_WINDOW_TYPE_DROPDOWN_MENU 添加到窗口的 _NET_WM_WINDOW_TYPE X11 窗口属性中。有关更多详细信息,请参阅 http://standards.freedesktop.org/wm-spec/。此属性在非 X11 平台上无效。注意:Qt 会自动为添加到 QMenuBar 的 QMenu 对象设置此属性。

Qt.WA_X11NetWmWindowTypePopupMenu

将_NET_WM_WINDOW_TYPE_POPUP_MENU添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参见http://standards.freedesktop.org/wm-spec/。此属性在非X11平台上无效。注意:Qt会自动为QMenu设置此属性。

Qt.WA_X11NetWmWindowTypeToolTip

将_NET_WM_WINDOW_TYPE_TOOLTIP添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参见http://standards.freedesktop.org/wm-spec/。此属性在非X11平台上无效。注意:Qt会自动为ToolTip窗口类型设置此属性。

Qt.WA_X11NetWmWindowTypeNotification

将_NET_WM_WINDOW_TYPE_NOTIFICATION添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参见http://standards.freedesktop.org/wm-spec/。此属性在非X11平台上无效。

Qt.WA_X11NetWmWindowTypeCombo

将 _NET_WM_WINDOW_TYPE_COMBO 添加到窗口的 _NET_WM_WINDOW_TYPE X11 窗口属性中。有关更多详细信息,请参阅 http://standards.freedesktop.org/wm-spec/。此属性在非 X11 平台上无效。注意:Qt 会自动为 QComboBox 弹出窗口设置此属性。

Qt.WA_X11NetWmWindowTypeDND

将_NET_WM_WINDOW_TYPE_DND添加到窗口的_NET_WM_WINDOW_TYPE X11窗口属性中。有关更多详细信息,请参阅http://standards.freedesktop.org/wm-spec/。此属性在非X11平台上无效。注意:Qt会自动在拖动期间使用的反馈小部件上设置此属性。

Qt.WA_AcceptTouchEvents

允许触摸事件(参见 QTouchEvent)发送到小部件。必须在所有可以处理触摸事件的小部件上设置此属性。如果没有设置此属性,来自触摸设备的事件将作为鼠标事件发送。

Qt.WA_TouchPadAcceptSingleTouchEvents

允许将触摸板的单点触控事件发送到小部件。

Qt.WA_X11DoNotAcceptFocus

请求窗口管理器不要将此顶层窗口设为焦点。此属性在非X11平台上无效。

Qt.WA_AlwaysStackOnTop

强制QOpenGLWidget和QQuickWidget最后绘制,位于其他小部件之上。对于其他类型的小部件忽略此属性。设置此属性会破坏堆叠顺序,但允许拥有一个半透明的OpenGL小部件,并且可以看到其下的其他小部件。强烈建议在启用或禁用此属性后,在小部件的顶层窗口上调用update()。

Qt.WA_ContentsMarginsRespectsSafeArea

默认情况下,QWidget 通过将窗口的安全区域边距合并到其内容的边距中来尊重窗口的安全区域边距。这意味着,除非设置了 Qt::WA_LayoutOnEntireRect 属性,否则 QLayout 将使用小部件的内容区域进行布局。这可以与实际布局上的内容边距为 0 一起使用,以允许例如背景图像在 iOS 设备上覆盖状态栏和其他系统区域,同时仍然允许该背景的子小部件根据安全区域进行内嵌。

class ApplicationAttribute

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

常量

描述

Qt.AA_QtQuickUseDefaultSizePolicy

Qt Quick 布局使用 Item 的内置大小策略。例如,当设置此选项时,Button 会填充可用宽度,但具有固定高度。当未设置此选项时,它将使用其所在布局的默认大小行为,即使用其隐式大小作为首选大小。这在指定首选大小和大小约束中有详细解释。当设置此选项时,可以通过显式设置 Layout.fillWidth 或 Layout.fillHeight 来覆盖具有布局的项目的默认大小策略。

Qt.AA_DontShowIconsInMenus

具有图标属性的操作将不会在任何菜单中显示,除非通过QAction::iconVisibleInMenu属性特别设置。此属性的默认值取决于平台。要覆盖默认行为,请在QGuiApplication实例化后设置此属性。当前打开的菜单或已在原生macOS菜单栏中创建的菜单可能不会反映此属性的更改。QAction::iconVisibleInMenu属性的更改将始终被反映。

Qt.AA_DontShowShortcutsInContextMenus

具有Shortcut属性的操作将不会显示在任何快捷菜单中,除非通过QAction::shortcutVisibleInContextMenu属性特别设置。此值在Qt 5.10中添加,默认基于QStyleHints::showShortcutsInContextMenus()报告的值。要覆盖默认行为,请在QCoreApplication实例化之前设置样式提示,或在QCoreApplication实例化之后设置此属性。

Qt.AA_NativeWindows

确保小部件具有本地窗口。

Qt.AA_DontCreateNativeWidgetSiblings

确保原生小部件的兄弟小部件保持非原生状态,除非通过WA_NativeWindow属性特别设置。

Qt.AA_PluginApplication

表示Qt用于编写插件。根据操作系统的不同,它会抑制在插件情况下不一定有意义的特定初始化。例如,在macOS上,这包括避免加载主菜单的nib文件,并且不占用原生菜单栏。将此属性设置为true也会将AA_DontUseNativeMenuBar属性设置为true。它还会禁用原生事件过滤器。此属性必须在QGuiApplication构造之前设置。此值在Qt 5.7中添加。

Qt.AA_DontUseNativeMenuBar

当此属性设置为true时,创建的所有菜单栏将不会用作原生菜单栏(例如,macOS主屏幕顶部的菜单栏)。

Qt.AA_MacDontSwapCtrlAndMeta

在苹果平台上,键盘快捷键通常基于Command(或Cmd)键盘修饰键,用⌘符号表示。例如,“复制”操作是Command+C(⌘+C)。为了简化跨平台开发,Qt默认会将Command重新映射为ControlModifier,以与其他平台保持一致。这使得可以创建如“Ctrl+J”这样的键盘快捷键,在macOS上会映射为Command+J,符合macOS用户的预期。苹果平台上的实际Control(或Ctrl)修饰键,用⌃表示,被映射为MetaModifier

当此属性为true时,Qt将不会进行重新映射,按下Command修饰键将导致MetaModifier,而按下Control修饰键将导致ControlModifier

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

常量

描述

Qt.AA_Use96Dpi

假设屏幕的分辨率为96 DPI,而不是使用操作系统提供的分辨率。这将导致字体渲染在每点像素数上跨设备保持一致,而不是将1点定义为1/72英寸。

Qt.AA_SynthesizeTouchForUnhandledMouseEvents

所有未被应用程序接受的鼠标事件将被转换为触摸事件。

Qt.AA_SynthesizeMouseForUnhandledTouchEvents

所有未被应用程序接受的触摸事件将被转换为左键鼠标事件。此属性默认启用。

Qt.AA_ForceRasterWidgets

使顶级小部件使用纯光栅表面,并且不支持非本地的基于GL的子小部件。

Qt.AA_UseDesktopOpenGL

强制在使用动态加载OpenGL实现的平台上使用桌面OpenGL(例如,opengl32.dlllibGL.so)。此属性必须在构建QGuiApplication之前设置。此值在Qt 5.3中添加。

Qt.AA_UseOpenGLES

在使用动态加载OpenGL实现的平台上,强制使用OpenGL ES 2.0或更高版本。此属性必须在构建QGuiApplication之前设置。此值在Qt 5.3中添加。

Qt.AA_UseSoftwareOpenGL

在使用动态加载OpenGL实现的平台上强制使用基于软件的OpenGL实现。这通常是一个修补过的Mesa llvmpipe构建,提供OpenGL 2.1。如果没有这样的OpenGL实现可用,该值可能无效。此库的默认名称是opengl32sw.dll,并且可以通过设置环境变量QT_OPENGL_DLL来覆盖。有关更多信息,请参阅特定平台的页面,例如Qt for Windows。此属性必须在构建QGuiApplication之前设置。此值在Qt 5.4中添加。

Qt.AA_ShareOpenGLContexts

启用由QOpenGLWidget和QQuickWidget等类使用的OpenGL上下文之间的资源共享。这允许在属于不同顶层窗口的QOpenGLWidget实例之间共享OpenGL资源,如纹理。此属性必须在构建QGuiApplication之前设置。此值在Qt 5.4中添加。

Qt.AA_SetPalette

指示是否在QGuiApplication上显式设置了调色板。此值在Qt 5.5中添加。

Qt.AA_UseStyleSheetPropagationInWidgetStyles

默认情况下,Qt 样式表会禁用常规的 QWidget 调色板和字体传播。当启用此标志时,样式表中的字体和调色板更改将在设置样式表时传播一次。有关更多详细信息,请参阅样式表语法 - 继承。此值在 Qt 5.7 中添加。

Qt.AA_DontUseNativeDialogs

当此属性设置为true时,创建的所有对话框将不使用平台提供的原生对话框。此值在Qt 5.7中添加。

Qt.AA_SynthesizeMouseForUnhandledTabletEvents

所有未被应用程序接受的平板事件将被转换为鼠标事件。此属性默认启用。此值在Qt 5.7中添加。

Qt.AA_CompressHighFrequencyEvents

启用某些频繁事件的压缩。在X11窗口系统中,默认值为true,这意味着MouseMoveTouchUpdate以及窗口大小和位置的变化将在它们发生的频率超过应用程序处理它们的频率时被合并,这样它们就不会积累并在以后压垮应用程序。在Windows 8及以上版本中,默认值也是true,但它仅适用于触摸事件。鼠标和窗口事件不受此标志的影响。在其他平台上,默认值为false。(未来,压缩功能可能会跨平台实现。)您可以测试该属性以查看是否启用了压缩。如果您的应用程序需要处理所有事件而不进行压缩,您可以取消设置此属性。请注意,来自平板设备的输入事件不会被压缩。如果您希望这些事件也被压缩,请参见AA_CompressTabletEvents。此值在Qt 5.7中添加。

Qt.AA_CompressTabletEvents

启用来自平板设备输入事件的压缩。请注意,AA_CompressHighFrequencyEvents 必须为 true 才能启用事件压缩,并且此标志将前者扩展到平板事件。目前支持 X11 窗口系统、Windows 8 及以上版本。默认值为 false。此值在 Qt 5.10 中添加。

Qt.AA_DontCheckOpenGLContextThreadAffinity

在使用QOpenGLContext使上下文成为当前上下文时,不要检查QOpenGLContext对象的QObject thread affinity是否与调用makeCurrent()的线程相同。此值在Qt 5.8中添加。

Qt.AA_DisableShaderDiskCache

禁用磁盘上的着色器程序二进制缓存。默认情况下,在支持glProgramBinary()的系统上,Qt Quick、QPainter的OpenGL后端以及任何使用QOpenGLShaderProgram并调用其addCacheableShaderFromSource重载的应用程序将在共享或每个进程的缓存存储位置使用基于磁盘的程序二进制缓存。如果这种情况不太可能成为问题,请设置此属性以禁用所有基于磁盘的着色器缓存。

Qt.AA_DisableSessionManager

禁用QSessionManager。默认情况下,Qt会在支持的平台上为GUI应用程序连接到正在运行的会话管理器,对于系统服务来说,使用会话管理器可能是多余的。此属性必须在QGuiApplication构建之前设置。此值在5.14版本中添加。

Qt.AA_DisableNativeVirtualKeyboard

当设置此属性时,在没有物理键盘的系统上,当文本输入小部件获得焦点时,将不会自动显示本地的屏幕虚拟键盘。目前仅在Windows平台上支持。此值在5.15版本中添加。

Qt.AA_DontUseNativeMenuWindows

当此属性设置为true时,创建的菜单弹出窗口(例如上下文菜单、组合框菜单和非原生菜单栏菜单)将不会表示为原生顶层窗口,除非实现需要。此值在Qt 6.8中添加。

class ImageConversionFlag

(继承自 enum.Flag)如果列表中未包含其他值,则标记为“(默认)”的选项将被设置(因为默认值为零):

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

常量

描述

Qt.AutoColor

(默认) - 如果图像的深度为1并且仅包含黑白像素,则位图变为单色。

Qt.ColorOnly

位图被抖动/转换为本地显示深度。

Qt.MonoOnly

位图变为单色。如有必要,将使用选定的抖动算法进行抖动处理。

抖动模式偏好:

常量

描述

Qt.DiffuseDither

(默认)- 使用误差扩散的高质量抖动。

Qt.OrderedDither

一种更快的、有序的抖动。

Qt.ThresholdDither

无抖动;使用最接近的颜色。

1位alpha掩码的抖动模式偏好:

常量

描述

Qt.ThresholdAlphaDither

(默认)- 无抖动。

Qt.OrderedAlphaDither

一种更快的、有序的抖动。

Qt.DiffuseAlphaDither

使用误差扩散的高质量抖动。

颜色匹配与抖动偏好的比较:

常量

描述

Qt.PreferDither

在转换为较小的颜色空间时始终对图像进行抖动处理。

Qt.AvoidDither

仅在源图像使用的颜色数量超过目标格式颜色表大小时,才对索引格式进行抖动处理。

Qt.AutoDither

(默认)- 仅在向下转换为1位或8位索引格式时进行抖动。

Qt.NoOpaqueDetection

不检查图像是否包含非不透明像素。如果您知道图像是半透明的,并且希望避免在找到非不透明像素之前检查图像中的像素的开销,或者如果您希望像素图保留一个alpha通道出于其他原因,请使用此选项。如果图像没有alpha通道,则此标志无效。

Qt.NoFormatConversion

不对图像进行任何格式转换。例如,在将QImage转换为QPixmap以进行一次性渲染操作时,这可能很有用。请注意,不在首选格式中的QPixmap作为绘图设备会慢得多。

class BGMode

背景模式:

常量

描述

Qt.透明模式

Qt.OpaqueMode

class Key

(继承自 enum.IntEnum) Qt 使用的键名。

常量

描述

Qt.Key_Escape

Qt.Key_Tab

Qt.Key_Backtab

Qt.Key_Backspace

Qt.Key_Return

Qt.Key_Enter

通常位于小键盘上。

Qt.Key_Insert

Qt.Key_Delete

Qt.Key_Pause

暂停/中断键(注意:与暂停媒体无关)

Qt.Key_Print

Qt.Key_SysReq

Qt.Key_Clear

对应于某些苹果键盘型号上的清除键。在其他系统上,当数字锁定处于关闭状态时,它通常映射到数字键盘上的5键。

Qt.Key_Home

Qt.Key_End

Qt.Key_Left

Qt.Key_Up

Qt.Key_Right

Qt.Key_Down

Qt.Key_PageUp

Qt.Key_PageDown

Qt.Key_Shift

Qt.Key_Control

在macOS上,这对应于Command键。

Qt.Key_Meta

在macOS上,这对应于Control键。在Windows键盘上,此键映射到Windows键。

Qt.Key_Alt

Qt.Key_AltGr

在Windows上,当发送此键的KeyDown事件时,Ctrl+Alt修饰符也会被设置。

Qt.Key_CapsLock

Qt.Key_NumLock

Qt.Key_ScrollLock

Qt.Key_F1

Qt.Key_F2

Qt.Key_F3

Qt.Key_F4

Qt.Key_F5

Qt.Key_F6

Qt.Key_F7

Qt.Key_F8

Qt.Key_F9

Qt.Key_F10

Qt.Key_F11

Qt.Key_F12

Qt.Key_F13

Qt.Key_F14

Qt.Key_F15

Qt.Key_F16

Qt.Key_F17

Qt.Key_F18

Qt.Key_F19

Qt.Key_F20

Qt.Key_F21

Qt.Key_F22

Qt.Key_F23

Qt.Key_F24

Qt.Key_F25

Qt.Key_F26

Qt.Key_F27

Qt.Key_F28

Qt.Key_F29

Qt.Key_F30

Qt.Key_F31

Qt.Key_F32

Qt.Key_F33

Qt.Key_F34

Qt.Key_F35

Qt.Key_Super_L

Qt.Key_Super_R

Qt.Key_Menu

Qt.Key_Hyper_L

Qt.Key_Hyper_R

Qt.Key_Help

Qt.Key_Direction_L

Qt.Key_Direction_R

Qt.Key_Space

Qt.Key_Any

Qt.Key_Exclam

Qt.Key_QuoteDbl

Qt.Key_NumberSign

Qt.Key_Dollar

Qt.Key_Percent

Qt.Key_Ampersand

Qt.Key_Apostrophe

Qt.Key_ParenLeft

Qt.Key_ParenRight

Qt.Key_Asterisk

Qt.Key_Plus

Qt.Key_Comma

Qt.Key_Minus

Qt.Key_Period

Qt.Key_Slash

Qt.Key_0

Qt.Key_1

Qt.Key_2

Qt.Key_3

Qt.Key_4

Qt.Key_5

Qt.Key_6

Qt.Key_7

Qt.Key_8

Qt.Key_9

Qt.Key_Colon

Qt.Key_Semicolon

Qt.Key_Less

Qt.Key_Equal

Qt.Key_Greater

Qt.Key_Question

Qt.Key_At

Qt.Key_A

Qt.Key_B

Qt.Key_C

Qt.Key_D

Qt.Key_E

Qt.Key_F

Qt.Key_G

Qt.Key_H

Qt.Key_I

Qt.Key_J

Qt.Key_K

Qt.Key_L

Qt.Key_M

Qt.Key_N

Qt.Key_O

Qt.Key_P

Qt.Key_Q

Qt.Key_R

Qt.Key_S

Qt.Key_T

Qt.Key_U

Qt.Key_V

Qt.Key_W

Qt.Key_X

Qt.Key_Y

Qt.Key_Z

Qt.Key_BracketLeft

Qt.Key_Backslash

Qt.Key_BracketRight

Qt.Key_AsciiCircum

Qt.Key_Underscore

Qt.Key_QuoteLeft

Qt.Key_BraceLeft

Qt.Key_Bar

Qt.Key_BraceRight

Qt.Key_AsciiTilde

Qt.Key_nobreakspace

Qt.Key_exclamdown

Qt.Key_cent

Qt.Key_sterling

Qt.Key_currency

Qt.Key_yen

Qt.Key_brokenbar

Qt.Key_section

Qt.Key_diaeresis

Qt.Key_copyright

Qt.Key_ordfeminine

Qt.Key_guillemotleft

Qt.Key_notsign

Qt.Key_hyphen

Qt.Key_registered

Qt.Key_macron

Qt.Key_degree

Qt.Key_plusminus

Qt.Key_twosuperior

Qt.Key_threesuperior

Qt.Key_acute

Qt.Key_micro

Qt.Key_mu

已弃用的Key_micro别名

Qt.Key_段落

Qt.Key_periodcentered

Qt.Key_cedilla

Qt.Key_onesuperior

Qt.Key_masculine

Qt.Key_guillemotright

Qt.Key_onequarter

Qt.Key_onehalf

Qt.Key_threequarters

Qt.Key_questiondown

Qt.Key_Agrave

Qt.Key_Aacute

Qt.Key_Acircumflex

Qt.Key_Atilde

Qt.Key_Adiaeresis

Qt.Key_Aring

Qt.Key_AE

Qt.Key_Ccedilla

Qt.Key_Egrave

Qt.Key_Eacute

Qt.Key_Ecircumflex

Qt.Key_Ediaeresis

Qt.Key_Igrave

Qt.Key_Iacute

Qt.Key_Icircumflex

Qt.Key_Idiaeresis

Qt.Key_ETH

Qt.Key_Ntilde

Qt.Key_Ograve

Qt.Key_Oacute

Qt.Key_Ocircumflex

Qt.Key_Otilde

Qt.Key_Odiaeresis

Qt.Key_multiply

Qt.Key_Ooblique

Qt.Key_Ugrave

Qt.Key_Uacute

Qt.Key_Ucircumflex

Qt.Key_Udiaeresis

Qt.Key_Yacute

Qt.Key_THORN

Qt.Key_ssharp

Qt.Key_division

Qt.Key_ydiaeresis

Qt.Key_Multi_key

Qt.Key_Codeinput

Qt.Key_SingleCandidate

Qt.Key_MultipleCandidate

Qt.Key_PreviousCandidate

Qt.Key_Mode_switch

Qt.Key_Kanji

Qt.Key_Muhenkan

Qt.Key_Henkan

Qt.Key_Romaji

Qt.Key_Hiragana

Qt.Key_Katakana

Qt.Key_Hiragana_Katakana

Qt.Key_Zenkaku

Qt.Key_Hankaku

Qt.Key_Zenkaku_Hankaku

Qt.Key_Touroku

Qt.Key_Massyo

Qt.Key_Kana_Lock

Qt.Key_Kana_Shift

Qt.Key_Eisu_Shift

Qt.Key_Eisu_toggle

Qt.Key_Hangul

Qt.Key_Hangul_Start

Qt.Key_Hangul_End

Qt.Key_Hangul_Hanja

Qt.Key_Hangul_Jamo

Qt.Key_Hangul_Romaja

Qt.Key_Hangul_Jeonja

Qt.Key_Hangul_Banja

Qt.Key_Hangul_PreHanja

Qt.Key_Hangul_PostHanja

Qt.Key_Hangul_Special

Qt.Key_Dead_Grave

Qt.Key_Dead_Acute

Qt.Key_Dead_Circumflex

Qt.Key_Dead_Tilde

Qt.Key_Dead_Macron

Qt.Key_Dead_Breve

Qt.Key_Dead_Abovedot

Qt.Key_Dead_Diaeresis

Qt.Key_Dead_Abovering

Qt.Key_Dead_Doubleacute

Qt.Key_Dead_Caron

Qt.Key_Dead_Cedilla

Qt.Key_Dead_Ogonek

Qt.Key_Dead_Iota

Qt.Key_Dead_Voiced_Sound

Qt.Key_Dead_Semivoiced_Sound

Qt.Key_Dead_Belowdot

Qt.Key_Dead_Hook

Qt.Key_Dead_Horn

Qt.Key_Dead_Stroke

Qt.Key_Dead_Abovecomma

Qt.Key_Dead_Abovereversedcomma

Qt.Key_Dead_Doublegrave

Qt.Key_Dead_Belowring

Qt.Key_Dead_Belowmacron

Qt.Key_Dead_Belowcircumflex

Qt.Key_Dead_Belowtilde

Qt.Key_Dead_Belowbreve

Qt.Key_Dead_Belowdiaeresis

Qt.Key_Dead_Invertedbreve

Qt.Key_Dead_Belowcomma

Qt.Key_Dead_Currency

Qt.Key_Dead_a

Qt.Key_Dead_A

Qt.Key_Dead_e

Qt.Key_Dead_E

Qt.Key_Dead_i

Qt.Key_Dead_I

Qt.Key_Dead_o

Qt.Key_Dead_O

Qt.Key_Dead_u

Qt.Key_Dead_U

Qt.Key_Dead_Small_Schwa

Qt.Key_Dead_Capital_Schwa

Qt.Key_Dead_Greek

Qt.Key_Dead_Lowline

Qt.Key_Dead_Aboveverticalline

Qt.Key_Dead_Belowverticalline

Qt.Key_Dead_Longsolidusoverlay

Qt.Key_Back

Qt.Key_Forward

Qt.Key_Stop

Qt.Key_Refresh

Qt.Key_VolumeDown

Qt.Key_VolumeMute

Qt.Key_VolumeUp

Qt.Key_BassBoost

Qt.Key_BassUp

Qt.Key_BassDown

Qt.Key_TrebleUp

Qt.Key_TrebleDown

Qt.Key_MediaPlay

一个将媒体播放器状态设置为播放的键

Qt.Key_MediaStop

一个将媒体播放器状态设置为停止的键

Qt.Key_MediaPrevious

Qt.Key_MediaNext

Qt.Key_MediaRecord

Qt.Key_MediaPause

一个将媒体播放器状态设置为暂停的键(注意:不是暂停/中断键)

Qt.Key_MediaTogglePlayPause

一个用于切换媒体播放器中播放/暂停状态的键(而不是设置绝对状态)

Qt.Key_HomePage

Qt.Key_Favorites

Qt.Key_Search

Qt.Key_Standby

Qt.Key_OpenUrl

Qt.Key_LaunchMail

Qt.Key_LaunchMedia

Qt.Key_Launch0

Qt.Key_Launch1

Qt.Key_Launch2

Qt.Key_Launch3

Qt.Key_Launch4

Qt.Key_Launch5

Qt.Key_Launch6

Qt.Key_Launch7

Qt.Key_Launch8

Qt.Key_Launch9

Qt.Key_LaunchA

Qt.Key_LaunchB

Qt.Key_LaunchC

Qt.Key_LaunchD

Qt.Key_LaunchE

Qt.Key_LaunchF

Qt.Key_LaunchG

Qt.Key_LaunchH

Qt.Key_MonBrightnessUp

Qt.Key_MonBrightnessDown

Qt.Key_KeyboardLightOnOff

Qt.Key_KeyboardBrightnessUp

Qt.Key_KeyboardBrightnessDown

Qt.Key_PowerOff

Qt.Key_WakeUp

Qt.Key_Eject

Qt.Key_ScreenSaver

Qt.Key_WWW

Qt.Key_Memo

Qt.Key_LightBulb

Qt.Key_Shop

Qt.Key_History

Qt.Key_AddFavorite

Qt.Key_HotLinks

Qt.Key_BrightnessAdjust

Qt.Key_Finance

Qt.Key_Community

Qt.Key_AudioRewind

Qt.Key_BackForward

Qt.Key_ApplicationLeft

Qt.Key_ApplicationRight

Qt.Key_Book

Qt.Key_CD

Qt.Key_Calculator

Qt.Key_ToDoList

Qt.Key_ClearGrab

Qt.Key_Close

Qt.Key_Copy

Qt.Key_Cut

Qt.Key_Display

Qt.Key_DOS

Qt.Key_Documents

Qt.Key_Excel

Qt.Key_Explorer

Qt.Key_Game

Qt.Key_Go

Qt.Key_iTouch

Qt.Key_LogOff

Qt.Key_Market

Qt.Key_Meeting

Qt.Key_MenuKB

Qt.Key_MenuPB

Qt.Key_MySites

Qt.Key_News

Qt.Key_OfficeHome

Qt.Key_Option

Qt.Key_Paste

Qt.Key_Phone

Qt.Key_Calendar

Qt.Key_Reply

Qt.Key_Reload

Qt.Key_RotateWindows

Qt.Key_RotationPB

Qt.Key_RotationKB

Qt.Key_Save

Qt.Key_Send

Qt.Key_Spell

Qt.Key_SplitScreen

Qt.Key_Support

Qt.Key_TaskPane

Qt.Key_Terminal

Qt.Key_Tools

Qt.Key_Travel

Qt.Key_Video

Qt.Key_Word

Qt.Key_Xfer

Qt.Key_ZoomIn

Qt.Key_ZoomOut

Qt.Key_Away

Qt.Key_Messenger

Qt.Key_WebCam

Qt.Key_MailForward

Qt.Key_Pictures

Qt.Key_Music

Qt.Key_Battery

Qt.Key_Bluetooth

Qt.Key_WLAN

Qt.Key_UWB

Qt.Key_AudioForward

Qt.Key_AudioRepeat

Qt.Key_AudioRandomPlay

Qt.Key_Subtitle

Qt.Key_AudioCycleTrack

Qt.Key_Time

Qt.Key_Hibernate

Qt.Key_View

Qt.Key_TopMenu

Qt.Key_PowerDown

Qt.Key_Suspend

Qt.Key_ContrastAdjust

Qt.Key_TouchpadToggle

Qt.Key_TouchpadOn

Qt.Key_TouchpadOff

Qt.Key_MicMute

Qt.Key_Red

Qt.Key_Green

Qt.Key_Yellow

Qt.Key_Blue

Qt.Key_ChannelUp

Qt.Key_ChannelDown

Qt.Key_Guide

Qt.Key_Info

Qt.Key_Settings

Qt.Key_MicVolumeUp

Qt.Key_MicVolumeDown

Qt.Key_New

Qt.Key_Open

Qt.Key_Find

Qt.Key_Undo

Qt.Key_Redo

Qt.Key_MediaLast

Qt.Key_unknown

Qt.Key_Call

用于接听或发起通话的按键(请参阅Qt::Key_ToggleCallHangup以获取切换当前通话状态的按键)

Qt.Key_Camera

用于激活相机快门的按键。在Windows Runtime上,必须设置环境变量QT_QPA_ENABLE_CAMERA_KEYS才能接收该事件。

Qt.Key_CameraFocus

一个用于聚焦相机的键。在Windows Runtime上,必须设置环境变量QT_QPA_ENABLE_CAMERA_KEYS才能接收该事件。

Qt.Key_Context1

Qt.Key_Context2

Qt.Key_Context3

Qt.Key_Context4

Qt.Key_Flip

Qt.Key_Hangup

用于结束正在进行的通话的键(请参阅 Qt::Key_ToggleCallHangup 以获取切换当前通话状态的键)

Qt.Key_No

Qt.Key_Select

Qt.Key_Yes

Qt.Key_ToggleCallHangup

一个按键,用于根据当前通话状态切换当前通话状态(即接听或挂断)

Qt.Key_VoiceDial

Qt.Key_LastNumberRedial

Qt.Key_Execute

Qt.Key_Printer

Qt.Key_Play

Qt.Key_Sleep

Qt.Key_Zoom

Qt.Key_Exit

Qt.Key_Cancel

另请参阅

key()

class KeyboardModifier

(继承自 enum.Flag) 此枚举描述了修饰键。

常量

描述

Qt.NoModifier

没有按下修饰键。

Qt.ShiftModifier

键盘上的Shift键被按下。

Qt.ControlModifier

键盘上的Ctrl键被按下。

Qt.AltModifier

键盘上的Alt键被按下。

Qt.MetaModifier

键盘上的Meta键被按下。

Qt.KeypadModifier

按下了小键盘按钮。

Qt.GroupSwitchModifier

仅限X11(除非通过命令行参数在Windows上激活)。键盘上的Mode_switch键被按下。

注意

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

注意

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

另请参阅

MouseButton Modifier

class Modifier

(继承自 enum.Flag) 此枚举为 Qt 支持的键盘修饰键提供了更短的名称。

注意

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

常量

描述

Qt.SHIFT

所有标准键盘上提供的Shift键。

Qt.META

Meta键。

Qt.CTRL

Ctrl 键。

Qt.ALT

普通的Alt键,但不包括像AltGr这样的键。

class ArrowType

常量

描述

Qt.NoArrow

Qt.UpArrow

Qt.DownArrow

Qt.LeftArrow

Qt.右箭头

class PenStyle

此枚举类型定义了可以使用QPainter绘制的画笔样式。样式包括:

qpen-dot3

qpen-dot3

qpen-dot3

Qt::SolidLine

Qt::DashLine

Qt::DotLine

qpen-custom6

qpen-custom6

qpen-custom6

Qt::DashDotLine

Qt::DashDotDotLine

Qt::CustomDashLine

常量

描述

Qt.NoPen

没有任何线条。例如,QPainter::drawRect() 填充但不绘制任何边界线。

Qt.SolidLine

一条实线。

Qt.DashLine

由几个像素分隔的虚线。

Qt.DotLine

由几个像素分隔的点。

Qt.DashDotLine

交替的点和短划线。

Qt.DashDotDotLine

一划,两点,一划,两点。

Qt.CustomDashLine

使用QPainterPathStroker::setDashPattern()定义的自定义模式。

另请参阅

QPen

class PenCapStyle

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

qpen-roundcap3

qpen-roundcap3

qpen-roundcap3

Qt::SquareCap

Qt::FlatCap

Qt::RoundCap

常量

描述

Qt.FlatCap

一个不覆盖线条端点的方形线帽。

Qt.SquareCap

一个方形的线端,覆盖端点并延伸超过端点一半的线宽。

Qt.RoundCap

圆形的线端。

另请参阅

QPen

class PenJoinStyle

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

qpen-roundjoin3

qpen-roundjoin3

qpen-roundjoin3

Qt::BevelJoin

Qt::MiterJoin

Qt::RoundJoin

常量

描述

Qt.MiterJoin

线条的外边缘被延伸以在某个角度相遇,并且这个区域被填充。

Qt.BevelJoin

两条线之间的三角形缺口被填充。

Qt.RoundJoin

两条线之间的圆弧被填充。

Qt.SvgMiterJoin

对应于SVG 1.2 Tiny规范中斜接连接定义的斜接连接。

另请参阅

QPen

class BrushStyle

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

../../_images/brush-styles.png

常量

描述

Qt.NoBrush

无画笔模式。

Qt.SolidPattern

统一颜色。

Qt.Dense1Pattern

极其密集的画笔图案。

Qt.Dense2Pattern

非常密集的画笔图案。

Qt.Dense3Pattern

较为密集的画笔图案。

Qt.Dense4Pattern

半密集画笔图案。

Qt.Dense5Pattern

较为稀疏的画笔图案。

Qt.Dense6Pattern

非常稀疏的画笔图案。

Qt.Dense7Pattern

极其稀疏的画笔图案。

Qt.HorPattern

水平线。

Qt.VerPattern

垂直线。

Qt.CrossPattern

交叉的水平和垂直线。

Qt.BDiagPattern

向后对角线。

Qt.FDiagPattern

前向对角线。

Qt.DiagCrossPattern

交叉对角线。

Qt.LinearGradientPattern

线性渐变(使用专用的QBrush构造函数设置)。

Qt.ConicalGradientPattern

锥形渐变(使用专用的QBrush构造函数设置)。

Qt.RadialGradientPattern

径向渐变(使用专用的QBrush构造函数设置)。

Qt.TexturePattern

自定义图案(参见 QBrush::setTexture())。

另请参阅

QBrush

class SizeMode

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

常量

描述

Qt.AbsoluteSize

指定使用绝对测量的尺寸。

Qt.RelativeSize

指定相对于边界矩形的大小,通常使用百分比测量。

class UIEffect

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

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

请注意,所有效果在运行于低于16位色深的屏幕上都会被禁用。

常量

描述

Qt.UI_AnimateMenu

显示动画菜单。

Qt.UI_FadeMenu

显示淡出菜单。

Qt.UI_AnimateCombo

显示动画组合框。

Qt.UI_AnimateTooltip

显示工具提示动画。

Qt.UI_FadeTooltip

显示工具提示的淡入淡出效果。

Qt.UI_AnimateToolBox

保留

另请参阅

setDesktopSettingsAware()

class CursorShape

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

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

常量

描述

Qt.ArrowCursor

cursor-arrow1 标准箭头光标。

Qt.UpArrowCursor

cursor-uparrow2 一个指向屏幕上方的箭头。

Qt.CrossCursor

cursor-cross3 十字光标,通常用于帮助用户准确选择屏幕上的点。

Qt.WaitCursor

cursor-wait4 一个沙漏或手表光标,通常在阻止用户与应用程序交互的操作期间显示。

Qt.IBeamCursor

cursor-ibeam5 一个插入符号或I型光标,表示小部件可以接受并显示文本输入。

Qt.SizeVerCursor

cursor-sizev6 用于垂直调整顶层窗口大小的元素的光标。

Qt.SizeHorCursor

cursor-sizeh7 用于水平调整顶级窗口大小的元素的光标。

Qt.SizeBDiagCursor

cursor-sizeb8 用于在右上角和左下角对角调整顶级窗口大小的元素的光标。

Qt.SizeFDiagCursor

cursor-sizef9 用于在左上角和右下角对角调整顶级窗口大小的元素的光标。

Qt.SizeAllCursor

cursor-sizeall10 用于在任何方向上调整顶层窗口大小的元素的光标。

Qt.BlankCursor

一个空白/不可见的光标,通常用于需要隐藏光标形状的情况。

Qt.SplitVCursor

cursor-vsplit11 用于垂直分割器的光标,表示可以水平拖动手柄以调整可用空间的使用。

Qt.SplitHCursor

cursor-hsplit12 用于水平分割器的光标,表示可以垂直拖动手柄以调整可用空间的使用。

Qt.PointingHandCursor

cursor-hand13 一个指向手形光标,通常用于可点击的元素,如超链接。

Qt.ForbiddenCursor

cursor-forbidden14 一个带斜线的圆圈光标,通常用于拖放操作中,表示拖拽的内容不能放置在特定的部件上或某些区域内。

Qt.OpenHandCursor

cursor-openhand15 一个表示张开的手的光标,通常用于指示光标下的区域是用户可以点击并拖动以滚动查看的画布的可见部分。

Qt.ClosedHandCursor

cursor-closedhand16 一个表示闭合手的光标,通常用于指示正在进行涉及滚动的拖动操作。

Qt.WhatsThisCursor

cursor-whatsthis17 一个带有问号的箭头,通常用于指示小部件上存在“这是什么?”帮助。

Qt.BusyCursor

cursor-busy18 一个沙漏或手表光标,通常在允许用户与应用程序交互的操作期间显示,而这些操作在后台执行。

Qt.DragMoveCursor

通常用于拖动项目时的光标。

Qt.DragCopyCursor

通常用于拖动项目以复制它的光标。

Qt.DragLinkCursor

通常用于拖动项目以创建链接的光标。

Qt.BitmapCursor

class TextFormat

此枚举用于可以显示纯文本和富文本的小部件,例如QLabel。它用于决定文本字符串应被解释为纯文本还是富文本。这通常通过将枚举值之一传递给QTextEdit::setTextFormat()函数来完成。

常量

描述

Qt.PlainText

文本字符串被解释为纯文本字符串。

Qt.RichText

文本字符串被解释为富文本字符串。有关富文本的定义,请参见支持的HTML子集。

Qt.AutoText

如果Qt::mightBeRichText()返回true,则文本字符串被解释为Qt::RichText,否则被解释为Qt::PlainText。

Qt.MarkdownText

文本字符串被解释为Markdown格式的文本。此枚举值在Qt 5.14中添加。

class AspectRatioMode

此枚举类型定义了在缩放矩形时长宽比会发生什么变化。

../../_images/qimage-scaling.png

常量

描述

Qt.IgnoreAspectRatio

大小可以自由缩放。不保持宽高比。

Qt.KeepAspectRatio

尺寸被缩放到给定矩形内尽可能大的矩形,保持宽高比。

Qt.KeepAspectRatioByExpanding

尺寸被缩放到尽可能小的矩形,该矩形位于给定矩形之外,保持宽高比。

另请参阅

scale() scaled()

class DockWidgetArea

(继承自 enum.Flag) 表示 QDockWidget 可以停靠的区域。

注意

一个带有标签的浮动停靠小部件可以停靠在任何地方。

常量

描述

Qt.LeftDockWidgetArea

QMainWindow 的左侧停靠区域。

Qt.RightDockWidgetArea

QMainWindow 的右侧停靠区域。

Qt.TopDockWidgetArea

QMainWindow的顶部停靠区域。

Qt.BottomDockWidgetArea

QMainWindow 的底部停靠区域。

Qt.AllDockWidgetAreas

所有停靠小部件区域(默认)。

Qt.NoDockWidgetArea

没有停靠小部件区域。

另请参阅

isAreaAllowed

class DockWidgetAreaSizes
class ToolBarArea

常量

描述

Qt.LeftToolBarArea

Qt.RightToolBarArea

Qt.TopToolBarArea

Qt.BottomToolBarArea

Qt.AllToolBarAreas

Qt.NoToolBarArea

class ToolBarAreaSizes
class DateFormat

常量

描述

Qt.TextDate

默认的Qt格式,包括月份和日期的名称、月份中的日期号以及完整的年份。日期和月份名称将是英文的缩写(C语言环境)。这实际上使用,对于日期,格式为ddd MMM d yyyy,对于时间HH:mm:ss,并将这些组合为ddd MMM d HH:mm:ss yyyy用于日期时间,带有可选的时区偏移后缀,如果适用。从字符串读取时,时间部分的秒数也识别小数部分,如HH:mm:ss.zzz,并且可能会识别格式的一些小变体,以便与早期版本的Qt和未来计划中的格式更改兼容。特别是,时区偏移后缀目前使用GMT[±tzoff],其中tzoffHH[[:]mm]格式(两位小时和可选的两位分钟,带有可选的冒号分隔符);这将在未来的Qt版本中更改为使用UTC代替GMT,因此计划的UTC格式被识别。

Qt.ISODateWithMs

ISO 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.ISODate

ISO 8601 扩展格式,与 ISODateWithMs 相同,但在转换为字符串时省略毫秒部分 (.zzz)。从字符串读取时没有区别:如果最后一个时间字段存在小数部分,两种格式都会接受它。

Qt.RFC2822Date

RFC 2822、RFC 850 和 RFC 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小时,其他时间字段为零,被理解为下一天的开始。.zzz代表前一个字段的小数部分后缀,可以通过逗号','或点'.'与前一个字段分隔。接受超过毫秒的精度但会被丢弃,四舍五入到最接近的可表示的毫秒。当同时指定日期和时间时,使用字面T字符来分隔日期和时间。对于TextDateRFC2822Date格式,ddd代表星期几名称的前三个字母,MMM代表月份名称的前三个字母。无论用户偏好或系统设置如何,星期和月份的名称始终为英文(C语言环境)。其他格式字符与ISODate格式的含义相同,除了24不被接受为小时。格式中用方括号[...]括起来的部分是可选的;方括号不构成格式的一部分。这里的正负号字符'±'代表任意符号字符,'-'代表减号,'+'代表加号。

注意

时区偏移量以东经格林威治为正,以西经为负,这是基于UTC的偏移表示法的常见做法(与一些基于GMT的时区名称相冲突,例如Etc/GMT+3,它们使用相反的惯例)。

class TimeSpec

常量

描述

Qt.LocalTime

本地时间,由系统时区设置控制。

Qt.UTC

协调世界时。

Qt.OffsetFromUTC

与协调世界时的偏移量,以秒为单位。

Qt.TimeZone

一个命名的时区。

LocalTime 和 TimeZone 都会处理过渡,例如夏令时的开始和结束。UTC 是通常指定时区的标准时间:格林尼治标准时间与它的偏移量为零。UTC 和 OffsetFromUTC 都没有任何过渡。

当使用OffsetFromUTC指定日期时间时,还必须提供与UTC的偏移量(以秒为单位)。要使用TimeZone指定日期时间,必须提供QTimeZone。从Qt 6.5开始,QTimeZone现在可以在需要时将时间规范与偏移量打包为轻量级时间描述,因此传递QTimeZone现在提供了一种统一的方式来使用日期时间API,无需为不同的时间规范调用不同的方法。

注意

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

另请参阅

QTimeZone QDateTime

class DayOfWeek

常量

描述

星期一

星期二

星期三

星期四

Qt.Friday

Qt.Saturday

Qt.Sunday

class ScrollBarPolicy

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

常量

描述

Qt.ScrollBarAsNeeded

当内容太大无法适应时,QAbstractScrollArea 会显示滚动条,否则不显示。这是默认设置。

Qt.ScrollBarAlwaysOff

QAbstractScrollArea 从不显示滚动条。

Qt.ScrollBarAlwaysOn

QAbstractScrollArea 总是显示滚动条。在具有瞬态滚动条的系统上(例如,从版本10.7开始的Mac),此属性将被忽略。

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

class CaseSensitivity

常量

描述

Qt.CaseInsensitive

Qt.区分大小写

class Corner

此枚举类型指定矩形中的一个角:

常量

描述

Qt.TopLeftCorner

矩形的左上角。

Qt.TopRightCorner

矩形的右上角。

Qt.BottomLeftCorner

矩形的左下角。

Qt.BottomRightCorner

矩形的右下角。

class Edge

(继承自 enum.Flag) 此枚举类型指定矩形中的一条边:

常量

描述

Qt.TopEdge

矩形的上边缘。

Qt.LeftEdge

矩形的左边缘。

Qt.RightEdge

矩形的右边缘。

Qt.BottomEdge

矩形的底边。

class ConnectionType

此枚举描述了信号和槽之间可以使用的连接类型。特别是,它决定了特定信号是立即传递给槽还是排队以便稍后传递。

常量

描述

Qt.AutoConnection

(默认) 如果接收者 lives in 发出信号的线程,则使用 Qt::DirectConnection。否则,使用 Qt::QueuedConnection。连接类型在信号发出时确定。

Qt.DirectConnection

当信号发出时,槽函数立即被调用。槽函数在发出信号的线程中执行。

Qt.QueuedConnection

当控制返回到接收者线程的事件循环时,槽函数被调用。槽函数在接收者的线程中执行。

Qt.BlockingQueuedConnection

与Qt::QueuedConnection相同,不同之处在于信号线程会阻塞直到槽函数返回。如果接收者位于信号线程中,则不得使用此连接,否则应用程序将死锁。

Qt.UniqueConnection

这是一个可以与上述任何连接类型组合的标志,使用按位或操作。当设置了Qt::UniqueConnection时,如果连接已经存在(即相同的信号已经连接到相同对象的相同槽),connect()将会失败。

Qt.SingleShotConnection

这是一个可以与上述任何连接类型组合使用的标志,使用按位或操作。当设置了Qt::SingleShotConnection时,槽函数只会被调用一次;当信号发出时,连接将自动断开。此标志在Qt 6.0中引入。

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

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

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

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

另请参阅

connect() qRegisterMetaType() Q_DECLARE_METATYPE()

class ShortcutContext

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

常量

描述

Qt.WidgetShortcut

当父部件获得焦点时,快捷键处于活动状态。

Qt.WidgetWithChildrenShortcut

当父部件或其任何子部件获得焦点时,快捷键处于活动状态。顶级部件的子部件(除了弹出窗口)不受此快捷键上下文的影响。

Qt.WindowShortcut

当父部件是活动顶层窗口的逻辑子部件时,快捷键处于活动状态。

Qt.ApplicationShortcut

当应用程序的某个窗口处于活动状态时,快捷键处于活动状态。

class FillRule

指定应使用哪种方法来填充路径和多边形。

常量

描述

Qt.OddEvenFill

指定使用奇偶填充规则填充区域。使用此规则,我们通过以下方法确定一个点是否在形状内部。从该点绘制一条水平线到形状外部的位置,并计算交点的数量。如果交点的数量是奇数,则该点在形状内部。此模式是默认模式。

Qt.WindingFill

指定使用非零环绕规则填充区域。使用此规则,我们通过以下方法确定一个点是否在形状内部。从该点绘制一条水平线到形状外的位置。确定每个交点的方向是向上还是向下。通过求和每个交点的方向来确定环绕数。如果该数不为零,则该点在形状内部。在大多数情况下,此填充模式也可以被视为闭合形状的交集。

class MaskMode

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

常量

描述

Qt.MaskInColor

创建一个遮罩,其中所有与给定颜色匹配的像素都是不透明的。

Qt.MaskOutColor

创建一个遮罩,其中所有与给定颜色匹配的像素都是透明的。

class ClipOperation

常量

描述

Qt.NoClip

此操作关闭裁剪。

Qt.ReplaceClip

用函数调用中提供的路径/矩形/区域替换当前的剪裁路径/矩形/区域。

Qt.IntersectClip

将当前的剪裁路径/矩形/区域与函数调用中提供的剪裁路径/矩形/区域进行交集操作。

class ItemSelectionMode

此枚举用于QGraphicsItem、QGraphicsScene和QGraphicsView,以指定如何选择项目,或如何确定形状和项目是否发生碰撞。

常量

描述

Qt.ContainsItemShape

输出列表仅包含形状完全在选择区域内的项目。与区域轮廓相交的项目不包括在内。

Qt.IntersectsItemShape

输出列表包含形状完全包含在选择区域内的项目,以及与区域轮廓相交的项目。这是橡皮筋选择的常见模式。

Qt.ContainsItemBoundingRect

输出列表仅包含其边界矩形完全包含在选择区域内的项目。与区域轮廓相交的项目不包括在内。

Qt.IntersectsItemBoundingRect

输出列表包含边界矩形完全包含在选择区域内的项目,以及与区域轮廓相交的项目。此方法通常用于确定需要重新绘制的区域。

另请参阅

collidesWithPath()

class ItemSelectionOperation

此枚举用于QGraphicsScene中,以指定在设置选择区域时如何处理当前选定的项目。

常量

描述

Qt.ReplaceSelection

当前选中的项目将被选择区域中的项目替换。

Qt.AddToSelection

选择区域中的项目被添加到当前选中的项目中。

另请参阅

setSelectionArea()

class TransformationMode

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

常量

描述

Qt.FastTransformation

转换执行速度快,没有平滑处理。

Qt.SmoothTransformation

生成的图像使用双线性过滤进行转换。

另请参阅

scaled()

class Axis

此枚举类型定义了三个值,用于表示笛卡尔坐标系中的三个轴。

常量

描述

Qt.XAxis

X轴。

Qt.YAxis

Y轴。

Qt.ZAxis

Z轴。

另请参阅

rotateRadians()

class FocusReason

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

常量

描述

Qt.MouseFocusReason

发生了鼠标操作。

Qt.TabFocusReason

按下了Tab键。

Qt.BacktabFocusReason

发生了Backtab。输入可能包括Shift或Control键;例如Shift+Tab。

Qt.ActiveWindowFocusReason

窗口系统使此窗口变为活动或非活动状态。

Qt.PopupFocusReason

应用程序打开/关闭了一个弹出窗口,该窗口获取/释放了键盘焦点。

Qt.ShortcutFocusReason

用户输入了一个标签的伙伴快捷键

Qt.MenuBarFocusReason

菜单栏获得了焦点。

Qt.OtherFocusReason

另一个原因,通常是特定于应用程序的。

另请参阅

Keyboard Focus in Widgets

class ContextMenuPolicy

此枚举类型定义了小部件在显示上下文菜单时可以采取的各种策略。

常量

描述

Qt.NoContextMenu

该部件没有上下文菜单功能,上下文菜单的处理被推迟到该部件的父部件。

Qt.PreventContextMenu

该部件没有上下文菜单,与NoContextMenu不同,处理不会延迟到部件的父部件。这意味着所有右键点击事件都保证通过QWidget::mousePressEvent()和QWidget::mouseReleaseEvent()传递给部件本身。

Qt.DefaultContextMenu

调用小部件的 QWidget::contextMenuEvent() 处理程序。

Qt.ActionsContextMenu

该小部件将其QWidget::actions()显示为上下文菜单。

Qt.CustomContextMenu

小部件发出 QWidget::customContextMenuRequested() 信号。

class ContextMenuTrigger

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

常量

描述

Qt.ContextMenuTrigger.Press

在鼠标按下事件时显示上下文菜单,UNIX系统上的默认设置。

Qt.ContextMenuTrigger.Release

在鼠标释放事件时显示上下文菜单,Windows 上的默认设置。

另请参阅

contextMenuTrigger

在版本6.8中添加。

class InputMethodQuery

常量

描述

Qt.ImEnabled

(继承自 enum.Flag) 该小部件接受输入法输入。

Qt.ImCursorRectangle

覆盖输入光标区域的小部件坐标中的矩形。

Qt.ImFont

当前用于文本输入的字体。

Qt.ImCursorPosition

光标在输入区域周围文本中的逻辑位置(参见ImSurroundingText)。该位置不包括光标在预编辑区域内的偏移量,该偏移量由QInputMethodEvent::Cursor控制。

Qt.ImSurroundingText

输入区域周围的纯文本,例如当前段落。

Qt.ImCurrentSelection

当前选中的文本。

Qt.ImMaximumTextLength

小部件可以容纳的最大字符数。如果没有限制,则返回QVariant()

Qt.ImAnchorPosition

选择锚点的位置。这可能小于或大于ImCursorPosition,具体取决于光标在选择的那一侧。如果没有选择,则返回与ImCursorPosition相同的值。

Qt.ImHints

输入法在预期输入上的提示。(参见 InputMethodHints

Qt.ImPreferredLanguage

首选输入语言。

Qt.ImPlatformData

输入法的平台特定数据。

Qt.ImAbsolutePosition

光标在整个文档中的逻辑位置。该位置不包括光标在预编辑区域内的偏移量,该偏移量由QInputMethodEvent::Cursor控制。

Qt.ImTextBeforeCursor

光标前的纯文本。小部件可以决定返回多少文本,但必须不返回空字符串,除非光标位于文档的开头。

Qt.ImTextAfterCursor

光标后的纯文本。小部件可以决定返回多少文本,但必须不返回空字符串,除非光标位于文档的末尾。

Qt.ImEnterKeyType

回车键类型。

Qt.ImAnchorRectangle

选择锚点的边界矩形。此值在Qt 5.7中添加。

Qt.ImInputItemClipRectangle

实际暴露的输入项矩形。输入项的部分可能会被裁剪。此值将考虑裁剪并返回实际绘制的项矩形。矩形位于小部件坐标中。

Qt.ImReadOnly

该小部件是只读的。此值在Qt 6.2中添加。

口罩:

常量

描述

Qt.ImQueryInput

输入时常用的属性。

Qt.ImQueryAll

查询所有输入法属性。

另请参阅

QInputMethodQueryEvent

class InputMethodHint

常量

描述

Qt.ImhNone

(继承自 enum.Flag) 无提示。

改变行为的标志:

常量

描述

Qt.ImhHiddenText

输入法在输入时不应显示字符。当将QLineEdit::echoMode设置为Password时,这将自动设置。请注意,设置ImhHiddenText不会改变回显模式。

Qt.ImhSensitiveData

输入的文本不应由活动的输入法存储在任何持久性存储中,例如预测用户词典。

Qt.ImhNoAutoUppercase

输入法不应在句子结束时尝试自动切换为大写。

Qt.ImhPreferNumbers

优先使用数字(但不是必需的)。

Qt.ImhPreferUppercase

优先使用大写字母(但不是必需的)。

Qt.ImhPreferLowercase

优先使用小写字母(但不是必需的)。

Qt.ImhNoPredictiveText

在输入时不使用预测文本(即字典查找)。

Qt.ImhDate

文本编辑器作为日期字段的功能。

Qt.ImhTime

文本编辑器功能作为时间字段。

Qt.ImhPreferLatin

优先使用拉丁字符(但不是必需的)。

Qt.ImhMultiLine

可以在文本字段中输入多行。

Qt.ImhNoEditMenu

不使用内置的编辑菜单。此标志在Qt 5.11中引入。

Qt.ImhNoTextHandles

不使用内置的文本光标和选择手柄。此标志在Qt 5.11中引入。

限制输入的标志(互斥标志):

常量

描述

Qt.ImhDigitsOnly

只允许输入数字。

Qt.ImhFormattedNumbersOnly

仅允许输入数字。这包括小数点和减号。

Qt.ImhUppercaseOnly

只允许输入大写字母。

Qt.ImhLowercaseOnly

只允许输入小写字母。

Qt.ImhDialableCharactersOnly

仅允许适合电话拨号的字符。

Qt.ImhEmailCharactersOnly

仅允许适合电子邮件地址的字符。

Qt.ImhUrlCharactersOnly

只允许适合URL的字符。

Qt.ImhLatinOnly

只允许基于拉丁字母的输入。

口罩:

常量

描述

Qt.ImhExclusiveInputMask

如果使用了任何独占标志,此掩码将产生非零值。

注意

如果几个互斥的标志通过OR操作组合在一起,生成的字符集将包含指定集合的并集。例如,指定ImhNumbersOnlyImhUppercaseOnly将生成一个包含数字和大写字母的集合。

另请参阅

inputMethodHints()

在版本4.6中添加。

class EnterKeyType

这可以用来改变屏幕上返回键的外观。

注意

并非所有平台都支持这些值。对于不支持的值,将使用默认键代替。

常量

描述

Qt.EnterKeyDefault

默认的Enter键。这可以是一个关闭键盘的按钮,或者是一个在有多行输入字段时导致新行的返回按钮。

Qt.EnterKeyReturn

显示一个插入新行的返回按钮。按下此按钮时,键盘不会关闭。

Qt.EnterKeyDone

显示一个“完成”按钮。按下此按钮时,键盘将关闭。

Qt.EnterKeyGo

显示一个“Go”按钮。通常用于在地址栏中输入URL时;按下此按钮时,键盘将关闭。

Qt.EnterKeySend

显示一个“发送”按钮。按下此按钮时,键盘将关闭。

Qt.EnterKeySearch

显示一个“搜索”按钮。按下此按钮时,键盘将关闭。

Qt.EnterKeyNext

显示一个“下一步”按钮。通常用于表单中,允许导航到下一个输入字段;按下此按钮时,键盘不会关闭。

Qt.EnterKeyPrevious

显示一个“上一页”按钮。按下此按钮时,键盘不会关闭。

class ToolButtonStyle

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

常量

描述

Qt.ToolButtonIconOnly

仅显示图标。

Qt.ToolButtonTextOnly

仅显示文本。

Qt.ToolButtonTextBesideIcon

文本显示在图标旁边。

Qt.ToolButtonTextUnderIcon

文本显示在图标下方。

Qt.ToolButtonFollowStyle

遵循样式。

class LayoutDirection

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

常量

描述

Qt.LeftToRight

从左到右的布局。

Qt.RightToLeft

从右到左布局。

Qt.LayoutDirectionAuto

自动布局。

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

LayoutDirectionAuto 有两个用途。当与小部件和布局一起使用时,它将意味着使用在父小部件或 QApplication 上设置的布局方向。这与 QWidget::unsetLayoutDirection() 具有相同的效果。

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

另请参阅

isRightToLeft()

class AnchorPoint

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

常量

描述

Qt.AnchorLeft

布局项的左侧。

Qt.AnchorHorizontalCenter

一个“虚拟”边,位于布局项左侧和右侧之间的中心位置。

Qt.AnchorRight

布局项的右侧。

Qt.AnchorTop

布局项的顶部。

Qt.AnchorVerticalCenter

一个“虚拟”边,位于布局项的顶部和底部之间的中心位置。

Qt.AnchorBottom

布局项的底部。

另请参阅

QGraphicsAnchorLayout

在版本4.6中添加。

class FindChildOption

常量

描述

Qt.FindDirectChildrenOnly

(继承自 enum.Flag) 仅查看对象的直接子对象。

Qt.FindChildrenRecursively

查看对象的所有子对象(递归搜索)。

class DropAction

常量

描述

Qt.CopyAction

(继承自 enum.Flag) 将数据复制到目标。

Qt.MoveAction

将数据从源移动到目标。

Qt.LinkAction

从源到目标创建一个链接。

Qt.ActionMask

Qt.IgnoreAction

忽略该操作(不对数据做任何处理)。

Qt.TargetMoveAction

在Windows上,当拖放数据的所有权应由目标应用程序接管时,即源应用程序不应删除数据时,使用此值。在X11上,此值用于执行移动操作。TargetMoveAction在Mac上不使用。

class CheckState

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

常量

描述

Qt.Unchecked

该项目未选中。

Qt.PartiallyChecked

该项目被部分选中。在分层模型中,如果某些但不是所有子项被选中,则这些项可能被部分选中。

Qt.Checked

该项目已被选中。

另请参阅

ItemFlags ItemDataRole

class ItemDataRole

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

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

常量

描述

Qt.DisplayRole

以文本形式呈现的关键数据。( QString )

Qt.DecorationRole

数据将以图标的形式呈现为装饰。(QColor, QIcon 或 QPixmap)

Qt.EditRole

适合在编辑器中编辑的数据。( QString )

Qt.ToolTipRole

在项目的工具提示中显示的数据。( QString )

Qt.StatusTipRole

状态栏中显示的数据。( QString )

Qt.WhatsThisRole

在“这是什么?”模式下为项目显示的数据。( QString )

Qt.SizeHintRole

提供给视图的项的大小提示。( QSize )

描述外观和元数据的角色(带有相关类型):

常量

描述

Qt.FontRole

用于使用默认委托呈现的项目的字体。(QFont)

Qt.TextAlignmentRole

使用默认委托渲染的项目的文本对齐方式。( Alignment )

Qt.BackgroundRole

用于使用默认委托渲染的项目的背景画笔。(QBrush)

Qt.ForegroundRole

用于默认委托渲染项目的前景画笔(通常是文本颜色)。(QBrush)

Qt.CheckStateRole

此角色用于获取项目的选中状态。( CheckState )

Qt.InitialSortOrderRole

此角色用于获取标题视图部分的初始排序顺序。( SortOrder ).

可访问性角色(带有相关类型):

常量

描述

Qt.AccessibleTextRole

用于辅助功能扩展和插件的文本,例如屏幕阅读器。( QString )

Qt.AccessibleDescriptionRole

用于无障碍目的的项的描述。( QString )

用户角色:

常量

描述

Qt.UserRole

第一个可用于应用程序特定目的的角色。

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

class ItemFlag

(继承自 enum.Flag) 此枚举描述了一个项目的属性:

常量

描述

Qt.NoItemFlags

它没有任何属性设置。

Qt.ItemIsSelectable

它可以被选择。

Qt.ItemIsEditable

它可以被编辑。

Qt.ItemIsDragEnabled

它可以被拖动。

Qt.ItemIsDropEnabled

它可以作为拖放目标使用。

Qt.ItemIsUserCheckable

用户可以选择或取消选择。

Qt.ItemIsEnabled

用户可以与项目进行交互。

Qt.ItemIsAutoTristate

项目的状态取决于其子项目的状态。这使得在QTreeWidget中自动管理父项目的状态成为可能(如果所有子项目都被选中,则选中;如果所有子项目都未选中,则未选中;或者如果只有部分子项目被选中,则部分选中)。

Qt.ItemNeverHasChildren

该项永远不会有子项。这仅用于优化目的。

Qt.ItemIsUserTristate

用户可以循环切换三种不同的状态。此值在Qt 5.5中添加。

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

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

另请参阅

QAbstractItemModel

class MatchFlag

(继承自 enum.Flag) 此枚举描述了在模型中搜索项目时可以使用的匹配类型。

常量

描述

Qt.MatchExactly

执行基于 QVariant 的匹配。

Qt.MatchFixedString

执行基于字符串的匹配。基于字符串的比较是大小写不敏感的,除非还指定了MatchCaseSensitive标志。

Qt.MatchContains

搜索词包含在项目中。

Qt.MatchStartsWith

搜索词匹配项目的开头。

Qt.MatchEndsWith

搜索词匹配项目的结尾。

Qt.MatchCaseSensitive

搜索区分大小写。

Qt.MatchRegularExpression

使用正则表达式作为搜索词执行基于字符串的匹配。使用QRegularExpression。当使用此标志时,可以将QRegularExpression对象作为参数传递,并直接用于执行搜索。由于QRegularExpression对象预期已完全配置,因此将忽略大小写敏感标志。此枚举值在Qt 5.15中添加。

Qt.MatchWildcard

使用带有通配符的字符串作为搜索词执行基于字符串的匹配。

Qt.MatchWrap

执行一个环绕搜索,当搜索到达模型中的最后一项时,它会从第一项重新开始,并继续直到所有项都被检查完毕。

Qt.MatchRecursive

搜索整个层次结构。

注意

Qt::MatchExactly、Qt::MatchContains、Qt::MatchStartsWith、Qt::MatchEndsWith、Qt::MatchRegularExpression、Qt::MatchWildcard 和 Qt::MatchFixedString 是互斥的。在 Qt::MatchFlags 参数中设置多个标志的行为是未定义的。

另请参阅

compare() QRegularExpression

class WindowModality

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

值为:

常量

描述

Qt.NonModal

窗口不是模态的,不会阻止输入到其他窗口。

Qt.WindowModal

窗口对单个窗口层次结构是模态的,并阻止对其父窗口、所有祖父窗口以及其父窗口和祖父窗口的所有兄弟窗口的输入。

Qt.ApplicationModal

窗口对应用程序是模态的,并阻止对所有窗口的输入。

另请参阅

windowModalityQDialog

class TextInteractionFlag

(继承自 enum.Flag) 此枚举指定了显示文本的小部件如何响应用户输入。

常量

描述

Qt.NoTextInteraction

无法与文本进行交互。

Qt.TextSelectableByMouse

文本可以通过鼠标选择,并使用上下文菜单或标准键盘快捷键复制到剪贴板。

Qt.TextSelectableByKeyboard

可以使用键盘上的光标键选择文本。会显示一个文本光标。

Qt.LinksAccessibleByMouse

链接可以通过鼠标高亮和激活。

Qt.LinksAccessibleByKeyboard

可以使用Tab键聚焦链接,并使用Enter键激活。

Qt.TextEditable

文本完全可编辑。

Qt.TextEditorInteraction

文本编辑器的默认设置。

Qt.TextBrowserInteraction

QTextBrowser 的默认设置。

class EventPriority

警告

本节包含从C++自动翻译到Python的代码片段,可能包含错误。

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

常量

描述

Qt.HighEventPriority

具有此优先级的事件在具有NormalEventPriority或LowEventPriority的事件之前发送。

Qt.NormalEventPriority

具有此优先级的事件在具有HighEventPriority的事件之后发送,但在具有LowEventPriority的事件之前发送。

Qt.LowEventPriority

具有此优先级的事件在具有HighEventPriority或NormalEventPriority的事件之后发送。

请注意,这些值仅为了方便提供,因为事件优先级可以是INT_MAXINT_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

另请参阅

postEvent()

class SizeHint

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

常量

描述

Qt.MinimumSize

用于指定图形布局项的最小尺寸。

Qt.PreferredSize

用于指定图形布局项的首选大小。

Qt.MaximumSize

用于指定图形布局项的最大尺寸。

Qt.MinimumDescent

用于指定图形布局项中文本字符串的最小下降。

另请参阅

sizeHint()

class WindowFrameSection

此枚举用于描述窗口框架的各个部分。它由QGraphicsWidget::windowFrameSectionAt()返回,用于描述鼠标下方的窗口框架部分。

常量

描述

Qt.NoSection

Qt.LeftSection

Qt.TopLeftSection

Qt.TopSection

Qt.TopRightSection

Qt.右侧部分

Qt.BottomRightSection

Qt.BottomSection

Qt.BottomLeftSection

Qt.标题栏区域

另请参阅

windowFrameSectionAt()

class CoordinateSystem

此枚举指定了坐标系。

常量

描述

Qt.DeviceCoordinates

坐标相对于对象的绘制设备的左上角。

Qt.LogicalCoordinates

坐标相对于对象的左上角。

在版本4.6中添加。

class TouchPointState

(继承自 enum.Flag) 此枚举表示在 QTouchEvent 发生时触摸点的状态。

常量

描述

Qt.TouchPointUnknownState

触摸点的状态未知。

Qt.TouchPointPressed

触摸点现在被按下。

Qt.TouchPointMoved

触摸点已移动。

Qt.TouchPointStationary

触摸点没有移动。

Qt.TouchPointReleased

触摸点已释放。

在版本4.6中添加。

class GestureState

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

常量

描述

Qt.NoGesture

未检测到手势。

Qt.GestureStarted

一个连续的手势已经开始。

Qt.GestureUpdated

手势继续。

Qt.GestureFinished

手势已完成。

Qt.GestureCanceled

手势被取消。

另请参阅

QGesture

在版本4.6中添加。

class GestureType

(继承 enum.IntEnum) 此枚举类型描述了标准手势。

常量

描述

Qt.TapGesture

点击手势。

Qt.TapAndHoldGesture

点击并保持(长按)手势。

Qt.PanGesture

平移手势。

Qt.PinchGesture

捏合手势。

Qt.SwipeGesture

一个滑动手势。

Qt.CustomGesture

一个标志,可用于测试手势是否为用户定义的手势ID。

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

另请参阅

grabGesture()

在版本4.6中添加。

class GestureFlag

(继承自 enum.Flag) 此枚举类型描述了在订阅手势时可以使用的附加标志。

常量

描述

Qt.DontStartGestureOnChildren

默认情况下,手势可以在小部件或其任何子部件上开始。使用此标志可以禁用此功能,并允许手势仅在小部件上开始。

Qt.ReceivePartialGestures

允许任何被忽略的手势事件传播到指定了此提示的父部件。默认情况下,只有处于GestureStarted状态的手势会被传播,并且部件总是会接收到从GestureStarted状态开始到GestureFinishedGestureCanceled状态结束的完整手势序列。

Qt.IgnoredGesturesPropagateToParent

允许微调手势事件的传播。通过在抓取手势时设置此标志,所有被忽略的部分手势将传播到它们的父项。

另请参阅

grabGesture()

在版本4.6中添加。

class NativeGestureType

此枚举返回手势类型。

常量

描述

Qt.BeginNativeGesture

在手势事件流之前发送。

Qt.EndNativeGesture

在手势事件流之后发送。

Qt.PanNativeGesture

指定位移增量,单位为像素。

Qt.ZoomNativeGesture

指定放大倍数的百分比变化。

Qt.SmartZoomNativeGesture

布尔放大状态。

Qt.RotateNativeGesture

指定旋转角度(以度为单位)。

Qt.SwipeNativeGesture

在滑动动作后发送。

class NavigationMode

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

常量

描述

Qt.NavigationModeNone

仅使用触摸屏。

Qt.NavigationModeKeypadTabOrder

Key_UpKey_Down 用于改变焦点。

Qt.NavigationModeKeypadDirectional

Key_Up , Key_Down , Key_LeftKey_Right 用于改变焦点。

Qt.NavigationModeCursorAuto

鼠标光标用于改变焦点,它仅在非触摸屏设备上显示。键盘用于实现虚拟光标,除非设备具有模拟鼠标类型的输入设备(例如触摸板)。这是推荐用于需要指针控制的应用程序(如网页浏览器)的设置,适用于触摸和非触摸设备。

Qt.NavigationModeCursorForceVisible

鼠标光标用于改变焦点,无论设备类型如何都会显示。键盘用于实现虚拟光标,除非设备具有模拟鼠标类型的输入设备(例如触摸板)

注意

光标导航目前在任何平台上都没有实现,其行为类似于NavigationModeNone。

另请参阅

navigationMode()

在版本4.6中添加。

class CursorMoveStyle

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

常量

描述

Qt.LogicalMoveStyle

在从左到右的文本块中,按下左箭头键时减少光标位置,按下右箭头键时增加光标位置。如果文本块是从右到左的,则应用相反的行为。

Qt.VisualMoveStyle

按下左箭头键将始终使光标向左移动,无论文本的书写方向如何。按下右箭头键将始终使光标向右移动。

在版本4.8中添加。

class TimerType

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

常量

描述

Qt.PreciseTimer

精确计时器尝试保持毫秒级精度

Qt.CoarseTimer

粗粒度计时器尝试将精度保持在所需间隔的5%以内

Qt.VeryCoarseTimer

非常粗糙的计时器仅保持整秒精度

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

在Windows上,Qt将使用Windows的多媒体计时器功能(如果可用)用于Qt::PreciseTimer,并使用普通的Windows计时器用于Qt::CoarseTimer和Qt::VeryCoarseTimer。

在所有平台上,Qt::VeryCoarseTimer 的间隔会被四舍五入到最接近的整秒(例如,23500ms 的间隔会被四舍五入到 24000ms,20300ms 会被四舍五入到 20000ms)。

class TimerId

这用于表示计时器ID(例如,QTimerQChronoTimer)。底层类型是 int。你可以使用 qToUnderlying() 将 Qt::TimerId 转换为 int

常量

描述

Qt.TimerId.Invalid

表示一个无操作的计时器ID;其使用取决于上下文,例如,这是startTimer()返回的值,表示它未能启动计时器;而id()在计时器未激活时返回此值,即timer.isActive()返回false

另请参阅

id() id() startTimer()

在版本6.8中添加。

class ScrollPhase

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

常量

描述

Qt.NoScrollPhase

输入设备不支持滚动阶段。此值在Qt 5.7中引入。

Qt.ScrollBegin

滚动即将开始,但滚动距离尚未改变。

Qt.ScrollUpdate

滚动距离已更改(默认)。

Qt.ScrollEnd

滚动已结束,滚动距离不再变化。

Qt.ScrollMomentum

用户不再触摸输入设备,但由于滚动惯性,滚动仍在继续。此值在Qt 5.12中引入。

class MouseEventSource

此枚举描述了鼠标事件的来源,可用于确定事件是否是从另一个设备(如触摸屏)生成的人工鼠标事件。

常量

描述

Qt.MouseEventNotSynthesized

最常见的值。在提供此类信息的平台上,此值表示事件是响应系统中的真实鼠标事件而生成的。

Qt.MouseEventSynthesizedBySystem

表示该鼠标事件是由平台从触摸事件合成的。

Qt.MouseEventSynthesizedByQt

表示该鼠标事件是由Qt从未处理的触摸事件合成的。

Qt.MouseEventSynthesizedByApplication

表示鼠标事件是由应用程序合成的。这允许区分应用程序生成的鼠标事件与来自系统或由Qt合成的事件。此值在Qt 5.6中引入

class MouseEventFlag

(继承自 enum.Flag) 此枚举提供了关于 QMouseEvent 的额外信息。

常量

描述

Qt.MouseEventCreatedDoubleClick

表示Qt已从此事件创建了一个MouseButtonDblClick事件。该标志在引发的MouseButtonPress中设置,而不是在生成的MouseButtonDblClick中设置。

class ChecksumType

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

常量

描述

Qt.ChecksumIso3309

基于ISO 3309的校验和计算。

Qt.ChecksumItuV41

基于ITU-V.41的校验和计算。

class HighDpiScaleFactorRoundingPolicy

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

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

常量

描述

Qt.HighDpiScaleFactorRoundingPolicy.Round

对于0.5及以上进行向上取整。

Qt.HighDpiScaleFactorRoundingPolicy.Ceil

始终向上取整。

Qt.HighDpiScaleFactorRoundingPolicy.Floor

始终向下取整。

Qt.HighDpiScaleFactorRoundingPolicy.RoundPreferFloor

对于0.75及以上的值进行向上取整。

Qt.HighDpiScaleFactorRoundingPolicy.PassThrough

不进行四舍五入。

class PermissionStatus

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

常量

描述

Qt.PermissionStatus.Undetermined

权限状态尚未确定。应通过requestPermission()请求权限以确定实际状态。此状态永远不会是请求权限的结果。

Qt.PermissionStatus.Granted

用户已明确授予应用程序权限,或者已知该权限在给定平台上不需要用户授权。

Qt.PermissionStatus.Denied

用户已明确拒绝应用程序请求的权限,或者已知该权限在给定平台上不可访问或不适用于应用程序。

注意

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

另请参阅

requestPermission() checkPermission() 应用程序权限

在6.5版本中添加。

class ReturnByValueConstant

这是一个虚拟类型,旨在帮助用户从某些已弃用的API过渡到它们的替代API。

另请参阅

pixmap()

static beginPropertyUpdateGroup()

标记属性更新组的开始。在这个组内,更改属性既不会立即更新任何依赖属性,也不会触发更改通知。这些操作将被推迟,直到通过调用endPropertyUpdateGroup结束该组。

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

注意

只有在组中所有受影响的属性值都已更新为新值后,才会发送更改通知。这允许在需要更新多个属性时重新建立类不变量,防止任何外部观察者注意到不一致的状态。

另请参阅

endPropertyUpdateGroup QScopedPropertyUpdateGroup

static bin(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream 上调用 setIntegerBase (2) 并返回 stream

另请参阅

oct() dec() hex() QTextStream 操作符

static bom(s)
Parameters:

sQTextStream

Return type:

QTextStream

QTextStream与UTF编码一起使用时,切换在stream上插入字节顺序标记。

另请参阅

setGenerateByteOrderMark() QTextStream 操作符

static center(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream上调用setFieldAlignmentAlignCenter)并返回stream

另请参阅

left() right() QTextStream manipulators

static dec(s)
Parameters:

sQTextStream

Return type:

QTextStream

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

另请参阅

bin() oct() hex() QTextStream manipulators

static endPropertyUpdateGroup()

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

警告

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

另请参阅

beginPropertyUpdateGroup QScopedPropertyUpdateGroup

static endl(s)
Parameters:

sQTextStream

Return type:

QTextStream

警告

本节包含从C++自动翻译到Python的代码片段,可能包含错误。

将‘\n’写入stream并刷新流。

等同于

stream << '\n' << Qt.flush

注意:在Windows上,如果使用QIODevice::Text标志打开QTextStream的设备或字符串,所有‘\n’字符将被写为‘\r\n’。

另请参阅

flush() reset() QTextStream 操作符

static fixed(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream 上调用 setRealNumberNotation ( FixedNotation ) 并返回 stream

另请参阅

scientific() QTextStream manipulators

static flush(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream上调用flush()并返回stream

另请参阅

endl() reset() QTextStream manipulators

static forcepoint(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream上调用setNumberFlagsnumberFlags() | ForcePoint)并返回stream

另请参阅

noforcepoint() forcesign() showbase() QTextStream manipulators

static forcesign(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream上调用setNumberFlagsnumberFlags() | ForceSign)并返回stream

另请参阅

noforcesign() forcepoint() showbase() QTextStream manipulators

static hex(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream 上调用 setIntegerBase (16) 并返回 stream

注意

hex 修饰符只能用于写入流。

另请参阅

bin() oct() dec() QTextStream 操作符

static left(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream 上调用 setFieldAlignment ( AlignLeft ) 并返回 stream

另请参阅

right() center() QTextStream manipulators

static lowercasebase(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream 上调用 setNumberFlags ( numberFlags() & ~ UppercaseBase ) 并返回 stream

另请参阅

uppercasebase() lowercasedigits() QTextStream manipulators

static lowercasedigits(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream 上调用 setNumberFlags ( numberFlags() & ~ UppercaseDigits ) 并返回 stream

另请参阅

uppercasedigits() lowercasebase() QTextStream manipulators

static noforcepoint(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream上调用setNumberFlags ( numberFlags() & ~ ForcePoint ) 并返回stream

另请参阅

forcepoint() noforcesign() noshowbase() QTextStream manipulators

static noforcesign(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream上调用setNumberFlags ( numberFlags() & ~ ForceSign ) 并返回stream

另请参阅

forcesign() noforcepoint() noshowbase() QTextStream manipulators

static noshowbase(s)
Parameters:

sQTextStream

Return type:

QTextStream

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

另请参阅

showbase() noforcesign() noforcepoint() QTextStream manipulators

static oct(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream 上调用 setIntegerBase (8) 并返回 stream

另请参阅

bin() dec() hex() QTextStream manipulators

static reset(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream 上调用 reset() 并返回 stream

另请参阅

flush() QTextStream manipulators

static right(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream上调用setFieldAlignmentAlignRight)并返回stream

另请参阅

left() center() QTextStream manipulators

static scientific(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream上调用setRealNumberNotationScientificNotation)并返回stream

另请参阅

fixed() QTextStream manipulators

static showbase(s)
Parameters:

sQTextStream

Return type:

QTextStream

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

另请参阅

noshowbase() forcesign() forcepoint() QTextStream 操纵器

static uppercasebase(s)
Parameters:

sQTextStream

Return type:

QTextStream

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

另请参阅

lowercasebase() uppercasedigits() QTextStream manipulators

static uppercasedigits(s)
Parameters:

sQTextStream

Return type:

QTextStream

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

另请参阅

lowercasedigits() uppercasebase() QTextStream manipulators

static ws(s)
Parameters:

sQTextStream

Return type:

QTextStream

stream上调用skipWhiteSpace()并返回stream

另请参阅

QTextStream manipulators