Qt 命名空间

QtCore.Qt 命名空间下包含了整个 Qt 库中所使用的各种标识符。

这些标识符大多为枚举（enum）或标志（flags）类型。本文收录部分标识符文档的中文翻译，按字母顺序排列。

A

Alignment

Qt.AlignmentFlag 中又分为水平对齐方式与垂直对齐方式，具体有如下数种：

水平对齐：

垂直对齐：

若需同时设置水平、垂直两个维度的对齐方式，只需将两个Flags用或运算符连接，例如： Qt.AlignCenter 等价于 Qt.AlignVCenter | Qt.AlignHCenter

C

CursorMoveStyle

此枚举值描述文本光标移动的风格。逻辑风格中，键盘左箭头意味着光标向文本的前方移动（对于从右至左的文本，前方意味着右方）；而视觉风格中，键盘左箭头意味着光标向视觉上的左侧移动，而不考虑文本书写方向。

F

FocusPolicy

L

LayoutDirection

控制 Qt 的布局与文字方向。

对于阿拉伯语、希伯来语等特定语言，需要从右至左布局。

S

ScrollBarPolicy

此枚举类型描述了 QAbstractScrollArea 滚动条的各种模式。水平滚动条与垂直滚动条的模式相互独立。

T

TextElideMode

此枚举值指定显示需省略的文本时省略号应出现的位置：

Qt.ElideMiddle 通常是最适合 URL 的选择（例如，"http://bugreports.qt.../QTWEBSITE-13/"），而 Qt.ElideRight 适合其他字符串。

TextFormat

TextInteractionFlag

W

WindowModality

此枚举值用于控制窗口的模态行为。对话框窗口大多为模态窗口。

WindowType

此枚举值用于为控件指定各种窗口系统（window-system）属性。它们一般比较少见，但在少数情况下是必要的。其中一些标志取决于底层窗口管理器是否支持。

主要类型包括：

还有许多标志可用于自定义顶级窗口的外观。这对其他窗口没有影响：

常用窗口的概述

QWindow

QWindow 是一个底层的窗口抽象，它表示屏幕上的一个矩形区域。它主要用于处理与平台相关的窗口细节，例如窗口的透明度、形状等。QWindow 通常不是直接用来创建用户界面的，而是作为更高级别的窗口类的基础。如果你需要处理底层的窗口事件或者做一些特定于平台的操作，那么你可能会用到 QWindow。

QWidget

QWidget 是所有用户界面对象的基类。它是一个简单的 GUI 小部件，可以用来构建自定义的窗口小部件。QWidget 可以作为一个独立的窗口，也可以作为其他小部件的一部分嵌入到更复杂的布局中。它是创建基本窗口和对话框的起点，可以非常灵活地设置其属性和行为。

适用场景：

• 创建基本的应用程序窗口。
• 作为其他更复杂小部件的容器。
• 自定义控件开发。

QDialog

QDialog 是一个模态或非模态对话框。它是一个特殊的 QWidget，通常用来显示一个短暂的任务，比如一个信息提示、警告或者是让用户做出选择。对话框通常会阻止用户与主窗口交互直到它们被关闭（如果是模态的话）。

适用场景：

• 收集用户输入。
• 显示警告或错误信息。
• 提供选项让用户进行选择。

QMainWindow

QMainWindow 是一个带有菜单栏、工具栏和状态栏的主窗口。它通常用于创建具有复杂用户界面的应用程序，提供了很多常用的组件，如 Dock Widgets 和 Central Widget。

适用场景：

• 复杂的应用程序，如文本编辑器、图像编辑器等。
• 需要有菜单栏、工具栏和状态栏的应用程序。

QFrame

QFrame 是一个可以绘制边框和阴影的容器小部件。虽然它本身不提供太多功能，但它可以用来创建自定义外观的用户界面元素。

适用场景：

• 创建自定义的UI元素，如带边框的面板。
• 作为其他小部件的容器，提供视觉上的分隔。

QStackedWidget

QStackedWidget 是一个堆叠小部件容器，可以用来切换不同的页面或视图。它通常用于实现类似于标签页或导航菜单的效果。

适用场景：

• 实现多页面布局，如标签页界面。
• 动态切换不同的视图或页面。

QTabWidget

QTabWidget 是一个带有标签页的小部件容器，用于组织多个相关的小部件，每个小部件都有一个标签。

适用场景：

• 创建标签页界面，如浏览器或文件管理器中的标签页。
• 组织多个相关的小部件。

QToolBox

QToolBox 是一个带有工具箱样式的容器小部件，每个工具项都有一个标题和一个小部件。

适用场景：

• 创建带有工具箱样式的界面，如设置或配置页面。

QMdiArea

QMdiArea 是一个多文档界面（MDI）容器，允许在一个主窗口中打开多个子窗口。

适用场景：

• 创建支持多文档界面的应用程序，如文本编辑器或集成开发环境（IDE）。

QWizard

QWizard 是一个向导窗口，用于引导用户完成一系列步骤或任务。

适用场景：

• 创建向导或设置向导，逐步引导用户完成某个过程。
• 复杂的设置或安装过程。

QSplitter

QSplitter 是一个分割器小部件，可以用来组织多个小部件，并允许用户调整它们的大小。

适用场景：

• 创建可调整大小的多视图布局，如文本编辑器中的编辑区和预览区。

QScrollArea

QScrollArea 是一个滚动区域，允许在其内部放置一个可以滚动的小部件。

适用场景：

• 创建可以滚动的区域，如长文档或大图像的查看器。

QOpenGLWidget

QOpenGLWidget 是一个用于渲染 OpenGL 内容的小部件。

适用场景：

• 渲染复杂的图形或动画。
• 开发需要高性能图形的应用程序。