class Qt

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

摘要

静态函数

• def beginPropertyUpdateGroup()

• def bin()

• def bom()

• def center()

• def dec()

• def endPropertyUpdateGroup()

• def endl()

• def fixed()

• def flush()

• def forcepoint()

• 定义 forcesign()

• 定义 hex()

• 定义 left()

• 定义 lowercasebase()

• 定义 lowercasedigits()

• 定义 noforcepoint()

• 定义 noforcesign()

• 定义 noshowbase()

• 定义 oct()

• 定义 reset()

• 定义 right()

• 定义 scientific()

• 定义 showbase()

• 定义 uppercasebase()

• 定义 uppercasedigits()

• 定义 ws()

注意

本文档可能包含自动从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	第七个非滚轮鼠标按钮。
Qt.ExtraButton5	第八个非滚轮鼠标按钮。
Qt.ExtraButton6	第九个非滚轮鼠标按钮。
Qt.ExtraButton7	第十个非滚轮鼠标按钮。
Qt.ExtraButton8	第十一个非滚轮鼠标按钮。
Qt.ExtraButton9	第十二个非滚轮鼠标按钮。
Qt.ExtraButton10	第十三个非滚轮鼠标按钮。
Qt.ExtraButton11	第十四个非滚轮鼠标按钮。
Qt.ExtraButton12	第十五个非滚轮鼠标按钮。
Qt.ExtraButton13	第十六个非滚轮鼠标按钮。
Qt.ExtraButton14	第十七个非滚轮鼠标按钮。
Qt.ExtraButton15	第十八个非滚轮鼠标按钮。
Qt.ExtraButton16	第十九个非滚轮鼠标按钮。
Qt.ExtraButton17	第二十个非滚轮鼠标按钮。
Qt.ExtraButton18	第二十一个非滚轮鼠标按钮。
Qt.ExtraButton19	第二十二个非滚轮鼠标按钮。
Qt.ExtraButton20	第二十三个非滚轮鼠标按钮。
Qt.ExtraButton21	第二十四个非滚轮鼠标按钮。
Qt.ExtraButton22	第二十五个非滚轮鼠标按钮。
Qt.ExtraButton23	第二十六个非滚轮鼠标按钮。
Qt.ExtraButton24	第二十七个非滚轮鼠标按钮。

注意

某些多按钮鼠标型号在出厂时已预先配置了高级号按钮来模拟键盘序列，以在特定游戏中使用。为了使这些按钮被视为实际的“鼠标按钮”，必须重新配置设备（使用制造商的配置工具）。

另见

KeyboardModifier Modifier

class Orientation

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

常量	描述
Qt.Horizontal
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	类似于Repeat，但将图像缩小，以确保最后一个瓦片不会被裁剪。

自版本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 tab) 字符移动到下一个制表位。
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

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

主要的类型有

常量	描述
Qt.Widget	这是QWidget的默认类型。此类小部件如果有父级则是子小部件，如果没有父级则是独立窗口。另请参阅Qt::Window和Qt::SubWindow。
Qt.Window	表明小部件是一个窗口，通常具有窗口系统边框和标题栏，无论小部件是否有父级。请注意，如果小部件没有父级，则无法取消设置此标志。
Qt.Dialog	表明小部件是一个应该以对话框装饰的窗口（即，通常标题栏中没有最大化和最小化按钮）。这是QDialog的默认类型。如果您想将其用作模式对话框，则应从另一个窗口启动它，或具有父级并使用QWidget::windowModality属性。如果您使其模式化，则对话框将阻止应用程序中的其他顶级窗口获取任何输入。我们称具有父级的顶级窗口为次要窗口。
Qt.Sheet	表明窗口是macOS上的一个sheet。由于使用sheet隐含窗口模式，推荐的做法是使用QWidget::setWindowModality()或QDialog::open()。
Qt.Drawer	表明小部件是macOS上的一个drawer。该特性已过时。设置标志没有效果。
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》标志用于启用窗口控件的自定义功能。必须设置此标志，才能更改WindowTitleHint、WindowSystemMenuHint、WindowMinimizeButtonHint、WindowMaximizeButtonHint和WindowCloseButtonHint标志。

常量	描述
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覆盖的 areas，例如状态栏或应用启动器。这可能导致窗口位于这些系统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	应用可见，但未选中为前景。在桌面平台上，这意味着用户激活了另一个应用。在移动平台上，在OS中断用户时更常见，例如收到来电或短信。在此状态中时，应考虑减少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	当小部件接受关闭事件时（请参阅 QWidget::closeEvent()），Qt 会删除此小部件。
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 可能会尝试压缩按键事件，以便每个事件可以处理多个字符。例如，文字处理小部件可能在 QKeyEvent::text() 中接收2、3个或更多字符，如果布局重新计算花费了CPU太长时间。如果小部件支持多字符的 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事件。这很少需要，但可以帮助避免自动插入widgets如splitter和布局。这是由widget的作者设置的。
Qt.WA_NoChildEventsFromChildren	表示小部件不希望接收来自其子widget的ChildAdded或ChildRemoved事件。这是由widget的作者设置的。
Qt.WA_NoMouseReplay	用于弹出小部件。表示弹出小部件关闭时不应该重新播放最近的鼠标按下事件。该标志由widget的作者设置，并且每当widget接收新的鼠标事件时，Qt内核都会清除该标志。
Qt.WA_NoMousePropagation	禁止鼠标事件传播到小部件的父级。默认禁用此属性。
Qt.WA_TransparentForMouseEvents	启用时，此属性会禁送鼠标事件到小部件及其子widget。鼠标事件将发送到其他小部件，好像小部件及其子widget在widget层次结构中不存在；鼠标点击和其他事件实际上“穿过”它们。默认禁用此属性。
Qt.WA_NoSystemBackground	表示小部件没有背景，即当小部件接收绘制事件时，背景不会自动重新绘制。**注意**：与WA_OpaquePaintEvent不同，新暴露的区域**永远**不会被填充背景（例如，第一次显示窗口的用户可以看到“穿”过它，直到应用程序处理绘制事件）。此标志由widget的作者设置或清除。
Qt.WA_OpaquePaintEvent	表示小部件在接收到绘制事件时绘制所有像素。因此，在进行更新、调整大小、滚动和焦点更改等操作之前，不需要擦除小部件以生成绘制事件。使用WA_OpaquePaintEvent提供的小优化可以有助于减少不支持双缓存的系统上的闪烁，并避免了在绘制之前清除背景的计算周期。**注意**：与WA_NoSystemBackground不同，WA_OpaquePaintEvent会努力避免透明的窗口背景。此标志由widget的作者设置或清除。
Qt.WA_OutsideWSRange	表示小部件位于窗口系统坐标系统有效范围的之外。位于有效范围之外的小部件无法在屏幕上绘制。这是由Qt内核设置的。
Qt.WA_PaintOnScreen	表示该小部件想要直接在屏幕上绘制。设置了此属性的小部件不参与合成管理，即它们不能是半透明的或半透明重叠小部件背后的发光。 注意：此标志仅在X11上受支持，并禁用双缓冲。在嵌入式Linux的Qt上，此标志仅在顶级小部件上设置时才有效，并且依赖于活动屏幕驱动程序的支持。此标志由小部件的作者设置或清除。要渲染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开始，在小部件显示后切换此属性在每个平台上 ikke统支持。当需要半透明背景时，应在创建小部件时尽早设置属性，并避免之后修改它。
Qt.WA_UnderMouse	指示小部件位于鼠标光标下。在拖放操作期间，值无法正确更新。还有一个getter函数，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 自动为 Dialog 和 Sheet 窗口类型设置此属性。
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 通过默认将边距合并到其内容边距中来尊重窗口的安全区域边距。这意味着 QLayout 将会使用小部件的内容区域进行布局，除非设置了 Qt::WA_LayoutOnEntireRect 属性。结合 0 的内容边距，可以在实际布局中使用，例如，允许背景图像在 iOS 设备上覆盖状态栏和其他系统区域，同时仍然基于安全区域对背景的小部件进行缩进。

class ApplicationAttribute

此枚举描述了会影响应用级功能的属性。这些属性可以使用 QCoreApplication::setAttribute() 启用或禁用，并且可以使用 QCoreApplication::testAttribute() 进行测试。

常量	描述
Qt.AA_QtQuickDontUseDefaultSizePolicy	Qt Quick 布局不会使用 Item 内置的大小策略。这恢复了之前的行为，其中所有项目默认都为固定大小。可以通过显式设置 Layout.fillWidth 或 Layout.fillHeight 来自定义大小策略。
Qt.AA_DontShowIconsInMenus	具有图标属性的 Action 不会显示在任何菜单中，除非通过 QAction::iconVisibleInMenu 属性特别设置。如果当前打开菜单或在原生 macOS 菜单栏中已创建菜单，则可能不会拾取此属性的更改。QAction::iconVisibleInMenu 属性的更改始终会被拾取。
Qt.AA_DontShowShortcutsInContextMenus	具有快捷方式的 Action 不会显示在任何快捷方式菜单中，除非通过 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	苹果平台上键盘快捷键通常基于命令（或Cmd）键盘修饰符，由⌘符号表示。例如，“复制”操作是Command+C（⌘+C）。为了简化跨平台开发，Qt默认会将命令映射到ControlModifier，以与其它平台相一致。这使得可以创建如“Ctrl+J”这样的键盘快捷键，在macOS上会映射到Command+J，满足macOS用户的期望。苹果平台上实际的控件（或Ctrl）修饰符，由⌃表示，映射到MetaModifier。

当此属性为真时，Qt不会进行映射，按下命令修饰符将导致 MetaModifier，而按下控件修饰符将导致 ControlModifier。

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

常量	描述
Qt.AA_Use96Dpi	假设屏幕分辨率为96 DPI，而不是使用操作系统提供的分辨率。这将导致字体渲染在各种设备上以像素每点的方式保持一致，而不是将一点定义为1/72英寸。
Qt.AA_SynthesizeTouchForUnhandledMouseEvents	所有未被应用程序接受的光标事件将被转换为触摸事件。
Qt.AA_SynthesizeMouseForUnhandledTouchEvents	所有未被应用程序接受的触摸事件将被转换为鼠标左键事件。此属性默认启用。
Qt.AA_ForceRasterWidgets	使顶层控件仅使用纯光栅表面，并不支持基于非native GL的子控件。
Qt.AA_UseDesktopOpenGL	强制在使用动态加载OpenGL实现的平台上使用桌面OpenGL（例如，opengl32.dll 或 libGL.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进行覆盖。请参考特定平台页面，例如Windows的Qt，以获取更多信息。此特性必须在构建 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调色板和字体的传播。当此标志启用时，字体和调色板更改会像用户手动调用相应的QWidget方法一样传播。有关更多详细信息，请参阅《样式表语法 - 继承》。此值是在Qt 5.7中添加的。
Qt.AA_DontUseNativeDialogs	当此属性设置为true时创建的所有对话框将不会使用平台提供的原生对话框。此值是在Qt 5.7中添加的。
Qt.AA_SynthesizeMouseForUnhandledTabletEvents	所有未被应用程序接受的平板电脑事件将被转换为鼠标事件。此属性默认启用。此值是在Qt 5.7中添加的。
Qt.AA_CompressHighFrequencyEvents	启用某些高频事件的压缩。在X11窗口系统上，默认值为true，这意味着当MouseMove , TouchUpdate 和窗口大小和位置更改发生频率超过应用程序处理它们时，这些事件将结合在一起，以免它们累积并后来压倒应用程序。在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线程亲和力是否与调用makeCurrent()的线程相同。此值是在Qt 5.8中添加的。
Qt.AA_DisableShaderDiskCache	禁用磁盘上着色器程序二进制文件的缓存。默认情况下，Qt Quick、QPainter的OpenGL后端以及使用具有其addCacheableShaderFromSource重载之一的QOpenGLShaderProgram的应用程序将在支持glProgramBinary()的系统上使用基于磁盘的程序二进制缓存，在共享或进程缓存存储位置中。如果这可能是问题所在，则将此属性设置为禁用所有基于磁盘的着色器缓存。
Qt.AA_DisableSessionManager	禁用QSessionManager。默认情况下，Qt将在支持的平台上连接到一个运行中的会话管理器，对于GUI应用程序，使用会话管理器可能对于系统服务来说是多余的。此属性必须在创建QGuiApplication之前设置。此值是在5.14中添加的
Qt.AA_DisableNativeVirtualKeyboard	当此属性设置为true时，在物理键盘不存在的情况下，当文本输入小部件获取焦点时不会自动显示原生屏幕虚拟键盘。目前仅在Windows平台受支持。此值是在5.15中添加的。

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.TransparentMode
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	Pause/Break 键（注意：与暂停媒体无关）
Qt.Key_Print
Qt.Key_SysReq
Qt.Key_Clear	对应于所选苹果键盘模型上的 Clear 键。在其他系统上，它通常映射到当 Num Lock 为 off 时的数字键盘键 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_paragraph
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	设置媒体播放器状态为播放的按键
设置媒体播放器状态为停止的按键	设置媒体播放器状态为停止的按键
播放上一首的按键
播放下一首的按键
记录媒体按键
暂停播放的按键	设置媒体播放器状态为暂停的按键（注意：不是暂停/中断键）
切换播放/暂停状态的按键（而不是设置绝对状态）	切换媒体播放器中播放/暂停状态的按键（而不是设置绝对状态）
首页按键
收藏夹按键
搜索按键
待机按键
打开URL的按键
启动邮件的按键
启动媒体播放器的按键
启动软件0的按键
启动软件1的按键
启动软件2的按键
启动软件3的按键
启动软件4的按键
启动软件5的按键
启动软件6的按键
启动软件7的按键
启动软件8的按键
启动软件9的按键
启动软件A的按键
启动软件B的按键
启动软件C的按键
启动软件D的按键
启动软件E的按键
启动软件F的按键
启动软件G的按键
启动软件H的按键
显示亮度增加按键
显示亮度减少按键
键盘灯光开关按键
键盘亮度增加按键
键盘亮度减少按键
关机按键
唤醒按键
弹出钥匙孔按键
启动屏幕保护程序的按键
网络浏览器按键
记事本按键
电灯按键
购物按键
历史记录按键
添加收藏夹按键
热链接按键
亮度调整按键
理财按键
社区按键
音频回退按键
前向后退按键
应用软件左键
应用软件右键
书籍按键
CD按键
计算器按键
待办事项按键
清除抓取按键
关闭按键
复制按键
剪切按键
显示按键
MS-DOS按键
文档按键
Excel按键
资源管理器按键
游戏按键
转到按键
触摸屏按键
注销按键
市场按键
会议按键
键盘菜单按键
点选按钮菜单按键
我的网站按键
新闻按键
办公室首页按键
选项按键
粘贴按键
电话按键
日历按键
回复按键
重新加载按键
旋转窗口按键
旋转点选按钮按键
旋转键盘按键
保存按键
发送按键
拼写检查按键
分割屏幕按键
支持按键
任务栏按键
终端按键
工具按键
旅行按键
视频按键
文字按键
传输按键
放大按键
缩小按键
远程按键
信息传达者按键
摄像头按键
邮件转发按键
图片按键
音乐按键
电池按键
蓝牙按键
WLAN按键
UWB按键
音频前向按键
音频重复按键
音频随机播放按键
字幕按键
循环曲目按键
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 运行时，必须设置环境变量 QT_QPA_ENABLE_CAMERA_KEYS 以接收事件。
Qt.Key_CameraFocus	一个用于聚焦相机的键。在 Windows 运行时，必须设置环境变量 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这样的键。

另见

KeyboardModifier MouseButton

class ArrowType

常量	描述
Qt.NoArrow
Qt.UpArrow
Qt.DownArrow
Qt.LeftArrow
Qt.RightArrow

class PenStyle

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

Qt::SolidLine	Qt::DashLine	Qt::DotLine
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中绘制的线条端点样式。

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

常量	描述
Qt.FlatCap	一个方形线条端点，不覆盖线的终点。
Qt.SquareCap	一个方形线条端点，覆盖线的终点并超过它一半的线宽。
Qt.RoundCap	一个圆滑的线条端点。

另见

QPen

class PenJoinStyle

此枚举类型定义了Qt支持的笔连接样式，即在QPainter中绘制两条连接线的连接方式。

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

常量	描述
Qt.MiterJoin	线条的外边缘延伸至相遇的角，并填充此区域。
Qt.BevelJoin	两条线之间的三角形凹口被填充。
Qt.RoundJoin	两条线之间的圆弧被填充。
Qt.SvgMiterJoin	符合SVG 1.2 Tiny规范中的斜接连接定义的斜接连接。

另见

QPen

class BrushStyle

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

常量	描述
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	标准箭头光标。
Qt.UpArrowCursor	指向上屏幕顶部的箭头。
Qt.CrossCursor	十字光标，通常用于帮助用户精确选择屏幕上的一个点。
Qt.WaitCursor	时钟或沙漏光标，通常在可能阻止用户与应用程序交互的操作期间显示。
Qt.IBeamCursor	指示小部件可以接受并显示文本输入的插入光标或 I 型光标。
Qt.SizeVerCursor	用于顶部窗口垂直调整大小的元素的光标。
Qt.SizeHorCursor	用于水平调整顶层窗口大小的元素的光标。
Qt.SizeBDiagCursor	用于在顶层窗口顶部右角和底部左角上进行对角调整大小的元素的光标。
Qt.SizeFDiagCursor	用于在顶层窗口顶部左角和底部右角上进行对角调整大小的元素的光标。
Qt.SizeAllCursor	用于在任何方向上调整顶层窗口大小的元素的光标。
Qt.BlankCursor	空白/不可见光标，通常用于需要隐藏光标形状时。
Qt.SplitVCursor	用来进行垂直分割的光标，表示可以水平拖动手柄来调整可用空间的分配。
Qt.SplitHCursor	用来进行水平分割的光标，表示可以垂直拖动手柄来调整可用空间的分配。
Qt.PointingHandCursor	指向光标，通常用于可点击元素（如超链接）。
Qt.ForbiddenCursor	被斜杠切割的圆形光标，通常在拖放操作期间使用，表示拖动的项不能放在某些小部件或区域内部。
Qt.OpenHandCursor	代表张开手的光标，通常用于表示光标下的区域是可以点击并拖动的可见画布区域。
Qt.ClosedHandCursor	代表闭合手的光标，通常表示进行涉及滚动的拖动操作。
Qt.WhatsThisCursor	带有问号的箭头，通常用于指示窗口部件是否有“这是什么？”帮助。
Qt.BusyCursor	时钟或沙漏光标，通常在操作被后台执行时显示，允许用户与应用程序交互。
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

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

常量	描述
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] 与 tzoff 在格式 HH[[:]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.zzz 或 HH.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（省略可选的第一个格式的基准日），其中 tzoff 是 HHmm 格式的时区偏移量。文本前后可能出现任意空格，任何非空空格可以替换该格式中的空格。在读取字符串时，可以识别 [ddd,] dd MMM yyyy [HH:mm[:ss]][ ±tzoff] 或 ddd MMM dd[ HH:mm:ss] yyyy[ ±tzoff] 作为日期和时间的组合，其中 tzoff 是 HHmm 格式的时区偏移量。在日期和时间的单独格式中，匹配相同的格式，忽略不需要的部分。特别是要注意，没有伴随日期的时间无法识别。

注意

对于 ISODate 格式，每个 y，M 和 d 表示用于指定日期的年、月和日的单个数字。每个 H、m 和 s 表示用于指定时间的时、分和秒的单个数字。24小时制的时数，其他时间字段为0，表示下一天的开始。一个 .zzz 字符表示前一个字段的分数后缀，可能通过逗号（,）或点（.）与该字段分开。接受超过毫秒的精度，但会丢弃，四舍五入到最近的表示毫秒。当同时指定日期和时间时，使用字面量字符 T 作为它们的分隔符。对于 TextDate 和 RFC2822Date 格式，ddd 代表星期几名称的前三个字母，而 MMM 代表月份名称的前三个字母。无论用户的偏好或系统设置如何，日期和月份的名称始终为英文（C区域）。除了24小时不接受作为时数，其他格式字符的含义与ISODate格式相同。括号《[...]》内包围的格式部分是可选的；括号本身不属于格式。这里的正负号字符'±'代表正号或负号，即'-'代表负号或'+'代表正号。

注意

时区偏差是指格林尼治以东为正，以西班牙时间为负，这是基于UTC的偏差记号的常规做法（与一些基于GMT的时区名称冲突，如Etc/GMT+3，它们使用相反的约定）。

另见

toString() toString() toString() fromString() fromString() fromString()

class TimeSpec

常量	描述
Qt.LocalTime	本地时间，受系统时区设置控制。
Qt.UTC	世界协调时间。
Qt.OffsetFromUTC	从世界协调时间起的秒数时区。
Qt.TimeZone	命名时区。

LocalTime和TimeZone将处理转换，例如夏令时的开始和结束。UTC是时区通常相对于的标准时间：格林威治平均时间与此的偏差为零。UTC和OffsetFromUTC都没有任何转换。

指定OffsetFromUTC的datetime时，必须也提供UTC的偏差（以秒为单位）。要使用TimeZone指定datetime，必须提供一个QTimeZone。从Qt 6.5开始，一个QTimeZone现在可以包装一个timespec，在该需要时包含一个偏移量，作为轻量级时间描述，从而提供一个统一的方式来使用datetime API，避免需要为不同的timespec调用它们。

注意

在更改系统时区设置后，更改之前基于LocalTime创建的QDateTime对象的行为是未定义的：《code class="xref py py-class docutils literal notranslate">QDateTimetransitions（转换）触发。在长时间运行的过程中，系统时区数据的更新（例如当政治家更改某地区的规则时）也可能导致系统时区信息与更新前使用LocalTime或TimeZone创建的《code class="xref py py-class docutils literal notranslate">QDateTime对象之间产生冲突。

另见

QTimeZone QDateTime

《em class="property">class DayOfWeek

常量	描述
Qt.Monday
Qt.Tuesday
Qt.Wednesday
Qt.Thursday
Qt.Friday
Qt.Saturday
Qt.Sunday

class ScrollBarPolicy

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

常量	描述
Qt.ScrollBarAsNeeded	当内容太大而无法适应时，QAbstractScrollArea显示滚动条，否则不显示。这是默认设置。
Qt.ScrollBarAlwaysOff	QAbstractScrollArea永远不会显示滚动条。
Qt.ScrollBarAlwaysOn	QAbstractScrollArea始终显示滚动条。在具有瞬态滚动条的系统中，此属性会被忽略（例如，从Mac版本10.7开始）。

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

class CaseSensitivity

常量	描述
Qt.CaseInsensitive
Qt.CaseSensitive

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	(默认) 如果接收器 存在于 发出信号的 线程中，则使用 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()

类 ItemSelectionOperation

此枚举用于QGraphicsScene中，以指定设置选择区域时对当前选中项所采取的操作。

常量	描述
Qt.ReplaceSelection	将当前选中项替换为选择区域中的项。
Qt.AddToSelection	将选择区域中的项添加到当前选中项。

另见

setSelectionArea()

类 TransformationMode

此枚举类型定义了图像变换（例如，缩放）是否应该平滑。

常量	描述
Qt.FastTransformation	执行变换操作快速，没有平滑处理。
Qt.SmoothTransformation	使用双线性过滤对结果图像进行变换。

另见

scaled()

类 Axis

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

常量	描述
Qt.XAxis	X轴。
Qt.YAxis	Y轴。
Qt.ZAxis	Z轴。

另见

rotateRadians()

类 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	其他原因，通常与应用程序特定。

另见

小部件中的键盘焦点

类 ContextMenuPolicy

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

常量	描述
Qt.NoContextMenu	小部件没有上下文菜单，上下文菜单处理被推迟到小部件的父级。
Qt.PreventContextMenu	小部件没有上下文菜单，与`Qt.NoContextMenu`相比，处理不会推迟到小部件的父级。这意味着所有鼠标右键事件都通过 QWidget::mousePressEvent() 和 QWidget::mouseReleaseEvent() 保证交付给小部件自身。
Qt.DefaultContextMenu	调用小部件的 QWidget::contextMenuEvent() 处理程序。
Qt.ActionsContextMenu	小部件将其 QWidget::actions() 显示为上下文菜单。
Qt.CustomContextMenu	小部件发出 QWidget::customContextMenuRequested() 信号。

类 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	Enter 键的类型。
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	只允许适合网址的字符。
Qt.ImhLatinOnly	只允许拉丁字母输入。

掩码

常量	描述
Qt.ImhExclusiveInputMask	如果使用任何独占标志，此掩码将返回非零值。

注意

如果组合几个独占标志，结果字符集将包含指定集的并集。例如，指定 ImhNumbersOnly 和 ImhUppercaseOnly 将产生包含数字和大写字母的集合。

另见

inputMethodHints()

自版本4.6引入。

类 EnterKeyType

这可以用来更改嵌入式键盘上“回车键”的外观。

注意

并不是所有值都支持所有平台。对于不支持的值，将使用默认键。

常量	描述
Qt.EnterKeyDefault	默认的回车键。这可以是关闭键盘的按钮，或者当使用多行输入字段时，插入新行的回车按钮。
Qt.EnterKeyReturn	显示一个插入新行的回车按钮。按下此按钮时，键盘不会关闭。
Qt.EnterKeyDone	显示一个“完成”按钮。当按下此按钮时，键盘将关闭。
Qt.EnterKeyGo	显示一个“导航”按钮。通常在地址栏输入 URL 时使用；当按下此按钮时，键盘将关闭。
Qt.EnterKeySend	显示一个“发送”按钮。当按下此按钮时，键盘将关闭。
Qt.EnterKeySearch	显示一个“搜索”按钮。当按下此按钮时，键盘将关闭。
Qt.EnterKeyNext	显示一个“下一项”按钮。通常用于表单中，允许导航到下一个输入字段；当按下此按钮时，键盘不会关闭。
Qt.EnterKeyPrevious	显示一个“上一项”按钮。当按下此按钮时，键盘不会关闭。

类 ToolButtonStyle

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

常量	描述
Qt.ToolButtonIconOnly	仅显示图标。
Qt.ToolButtonTextOnly	仅显示文本。
Qt.ToolButtonTextBesideIcon	文本显示在图标旁边。
Qt.ToolButtonTextUnderIcon	文本显示在图标下方。
Qt.ToolButtonFollowStyle	跟随样式。

类 LayoutDirection

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

常量	描述
Qt.LeftToRight	从左到右布局。
Qt.RightToLeft	从右到左布局。
Qt.LayoutDirectionAuto	自动布局。

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

LayoutDirectionAuto有两个用途。当与小部件和布局一起使用时，它将暗示使用父小部件或QApplication设置的方向。这和QWidget::unsetLayoutDirection()的效果相同。

当与文本布局一起使用时，LayoutDirectionAuto将暗示文本的方向性由要布局的字符串内容确定。

另见

isRightToLeft()

class AnchorPoint

指定了一个可以作为锚点的布局项的一边。这被QGraphicsAnchorLayout使用。

常量	描述
Qt.AnchorLeft	布局项的左侧。
Qt.AnchorHorizontalCenter	一个“虚拟”边，位于布局项的左侧和右侧之间。
Qt.AnchRight	布局项的右侧。
Qt.AnchorTop	布局项的顶部。
Qt.AnchVericalCenter	一个“虚拟”边，位于布局项的顶部和底部之间。
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上使用此值进行移动。Mac上不使用TargetMoveAction。

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_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

另见

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.RightSection
Qt.BottomRightSection
Qt.BottomSection
Qt.BottomLeftSection
Qt.TitleBarArea

另见

WindowFrameSectionAt()

类 CoordinateSystem

此枚举指定了坐标系。

常量	描述
Qt.DeviceCoordinates	坐标相对于对象的绘制设备左上角。
Qt.LogicalCoordinates	坐标相对于对象的左上角。

自版本4.6引入。

类 TouchPointState

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

常量	描述
Qt.TouchPointUnknownState	触摸点的状态未知。
Qt.TouchPointPressed	触摸点现在是按下的。
Qt.TouchPointMoved	触摸点已移动。
Qt.TouchPointStationary	触摸点没有移动。
Qt.TouchPointReleased	触摸点已释放。

自版本4.6引入。

类 GestureState

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

常量	描述
Qt.NoGesture	未检测到手势。
Qt.GestureStarted	一个连续的手势已开始。
Qt.GestureUpdated	手势持续进行。
Qt.GestureFinished	手势已完成。
Qt.GestureCanceled	手势已被取消。

另见

QGesture

自版本4.6引入。

类 GestureType

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

常量	描述
Qt.TapGesture	点击手势。
Qt.TapAndHoldGesture	点击并保持（长按）手势。
Qt.PanGesture	拖动手势。
Qt.PinchGesture	缩放手势。
Qt.SwipeGesture	滑动手势。
Qt.CustomGesture	可以用来检测手势是否是用户定义的手势 ID 的标志。

用户定义的手势通过 QGestureRecognizer::registerRecognizer() 函数注册，该函数将使用 Qt::CustomGesture 标志生成一个自定义手势 ID。

另见

grabGesture()

自版本4.6引入。

类 GestureFlag

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

常量	描述
Qt.DontStartGestureOnChildren	默认情况下，手势可以在小部件或其任何子项上启动。使用此标志可以禁用此功能，并允许手势仅在小部件上启动。
Qt.ReceivePartialGestures	允许将所有已忽略的手势事件传播到指定了此提示的父小部件。默认情况下，只有状态在 GestureStarted 的手势会被传播，并且小部件总是获取从状态下开始的完整手势序列 GestureStarted 至状态结束 GestureFinished 或 GestureCanceled。
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_Up 和 Key_Down 用于更改焦点。
Qt.NavigationModeKeypadDirectional	Key_Up , Key_Down , Key_Left 和 Key_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 的间隔将被舍入到最接近的完整秒（例如，一个 23500 毫秒的间隔将被舍入到 24000 毫秒，20300 毫秒将被舍入到 20000 毫秒）。

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 中引入的

另见

AA_SynthesizeMouseForUnhandledTouchEvents

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

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

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

常量	描述
Qt.HighDpiScaleFactorRoundingPolicy.Round	向上舍入到.5及以上。
Qt.HighDpiScaleFactorRoundingPolicy.Ceil	始终向上舍入。
Qt.HighDpiScaleFactorRoundingPolicy.Floor	始终向下舍入。
Qt.HighDpiScaleFactorRoundingPolicy.RoundPreferFloor	向上舍入到.75及以上。
Qt.HighDpiScaleFactorRoundingPolicy.PassThrough	不进行舍入。

另见

setHighDpiScaleFactorRoundingPolicy()

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)

参数：

s – QTextStream

返回类型：

QTextStream

在 stream 上调用 setIntegerBase (2) 返回 stream。

另见

oct() dec() hex() QTextStream manipulators

static bom(s)

参数：

s – QTextStream

返回类型：

QTextStream

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

另见

setGenerateByteOrderMark() QTextStream manipulators

static center(s)

参数：

s – QTextStream

返回类型：

QTextStream

在 stream 上调用 setFieldAlignment (AlignCenter) 并返回 stream。

另见

left() right() QTextStream manipulators

静态 dec(s)

参数：

s – QTextStream

返回类型：

QTextStream

调用 setIntegerBase (10) 在 stream 上，并返回 stream。

另见

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

静态 endPropertyUpdateGroup()

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

警告

在调用 beginPropertyUpdateGroup 之前调用 endPropertyUpdateGroup 将导致未定义的行为。

另见

beginPropertyUpdateGroup QScopedPropertyUpdateGroup

静态 endl(s)

参数：

s – QTextStream

返回类型：

QTextStream

警告

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

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

相当于

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

注意：在 Windows 上，如果 QTextStream 的设备或字符串是以 QIODevice::Text 标志打开的，则所有 '\n' 字符都将写成 '\r\n'。

另见

flush() reset() QTextStream 操作符

静态 fixed(s)

参数：

s – QTextStream

返回类型：

QTextStream

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

另见

scientific() QTextStream 操作符

静态 flush(s)

参数：

s – QTextStream

返回类型：

QTextStream

在stream上调用flush()并返回stream。

另见

endl() reset() QTextStream manipulators

静态forcepoint(s)

参数：

s – QTextStream

返回类型：

QTextStream

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

另见

noforcepoint() forcesign() showbase() QTextStream manipulators

静态forcesign(s)

参数：

s – QTextStream

返回类型：

QTextStream

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

另见

noforcesign() forcepoint() showbase() QTextStream manipulators

静态hex(s)

参数：

s – QTextStream

返回类型：

QTextStream

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

注意

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

另见

bin() oct() dec() QTextStream manipulators

静态left(s)

参数：

s – QTextStream

返回类型：

QTextStream

在 stream 上调用 setFieldAlignment ( AlignLeft )，并返回 stream。

另见

right() center() QTextStream manipulators

静态lowercasebase(s)

参数：

s – QTextStream

返回类型：

QTextStream

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

另见

uppercasebase() lowercasedigits() QTextStream manipulators

静态lowercasedigits(s)

参数：

s – QTextStream

返回类型：

QTextStream

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

另见

uppercasedigits() lowercasebase() QTextStream manipulators

静态noforcepoint(s)

参数：

s – QTextStream

返回类型：

QTextStream

调用 setNumberFlags（numberFlags() & ~ ForcePoint ）在 stream 上，并返回 stream。

另见

forcepoint() noforcesign() noshowbase() QTextStream manipulators

static noforcesign(s)

参数：

s – QTextStream

返回类型：

QTextStream

在 stream 上调用 setNumberFlags（numberFlags() & ~ ForceSign），并返回 stream。

另见

forcesign() noforcepoint() noshowbase() QTextStream manipulators

static noshowbase(s)

参数：

s – QTextStream

返回类型：

QTextStream

在 stream 上调用 setNumberFlags（numberFlags() & ~ ShowBase），并返回 stream。

另见

showbase() noforcesign() noforcepoint() QTextStream manipulators

static oct(s)

参数：

s – QTextStream

返回类型：

QTextStream

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

另见

bin() dec() hex() QTextStream manipulators

static reset(s)

参数：

s – QTextStream

返回类型：

QTextStream

在 stream 上调用 reset() 并返回 stream.

另见

flush() QTextStream manipulators

static right(s)

参数：

s – QTextStream

返回类型：

QTextStream

在 stream 上调用 setFieldAlignment (AlignRight) 并返回 stream.

另见

left() center() QTextStream manipulators

static scientific(s)

参数：

s – QTextStream

返回类型：

QTextStream

在 stream 上调用 setRealNumberNotation (ScientificNotation) 并返回 stream.

另见

fixed() QTextStream manipulators

static showbase(s)

参数：

s – QTextStream

返回类型：

QTextStream

调用setNumberFlags ( numberFlags | ShowBase ) 方法在 stream 上，并返回 stream。

另见

noshowbase forcesign forcepoint QTextStream manipulators

staticuppercasebase(s)

参数：

s – QTextStream

返回类型：

QTextStream

调用setNumberFlags ( numberFlags | UppercaseBase ) 方法在 stream 上，并返回 stream。

另见

lowercasebase uppercasedigits QTextStream manipulators

staticuppercasedigits(s)

参数：

s – QTextStream

返回类型：

QTextStream

调用setNumberFlags ( numberFlags | UppercaseDigits ) 方法在 stream 上，并返回 stream。

另见

lowercasedigits uppercasebase QTextStream manipulators

staticws(s)

参数：

s – QTextStream

返回类型：

QTextStream

在 stream 上调用 skipWhiteSpace 方法并返回 stream。

另见

QTextStream manipulators