Qt 名称空间

Qt 名称空间包含整个 Qt 库所用的杂项标识符。 更多...

头: #include <Qt>

类型

flags Alignment
enum AlignmentFlag { AlignLeft, AlignRight, AlignHCenter, AlignJustify, ..., AlignVertical_Mask }
enum AnchorAttribute { AnchorName, AnchorHref }
enum AnchorPoint { AnchorLeft, AnchorHorizontalCenter, AnchorRight, AnchorTop, AnchorVerticalCenter, AnchorBottom }
enum ApplicationAttribute { AA_ImmediateWidgetCreation, AA_MSWindowsUseDirect3DByDefault, AA_DontShowIconsInMenus, AA_NativeWindows, ..., AA_CaptureMultimediaKeys }
enum ArrowType { NoArrow, UpArrow, DownArrow, LeftArrow, RightArrow }
enum AspectRatioMode { IgnoreAspectRatio, KeepAspectRatio, KeepAspectRatioByExpanding }
enum Axis { XAxis, YAxis, ZAxis }
enum BGMode { TransparentMode, OpaqueMode }
enum BrushStyle { NoBrush, SolidPattern, Dense1Pattern, Dense2Pattern, ..., TexturePattern }
enum CaseSensitivity { CaseInsensitive, CaseSensitive }
enum CheckState { Unchecked, PartiallyChecked, Checked }
enum ClipOperation { NoClip, ReplaceClip, IntersectClip, UniteClip }
enum ConnectionType { AutoConnection, DirectConnection, QueuedConnection, BlockingQueuedConnection, UniqueConnection, AutoCompatConnection }
enum ContextMenuPolicy { NoContextMenu, PreventContextMenu, DefaultContextMenu, ActionsContextMenu, CustomContextMenu }
enum CoordinateSystem { DeviceCoordinates, LogicalCoordinates }
enum Corner { TopLeftCorner, TopRightCorner, BottomLeftCorner, BottomRightCorner }
enum CursorMoveStyle { LogicalMoveStyle, VisualMoveStyle }
enum CursorShape { ArrowCursor, UpArrowCursor, CrossCursor, WaitCursor, ..., BitmapCursor }
enum DateFormat { TextDate, ISODate, SystemLocaleShortDate, SystemLocaleLongDate, ..., LocalDate }
enum DayOfWeek { Monday, Tuesday, Wednesday, Thursday, ..., Sunday }
enum DockWidgetArea { LeftDockWidgetArea, RightDockWidgetArea, TopDockWidgetArea, BottomDockWidgetArea, AllDockWidgetAreas, NoDockWidgetArea }
flags DockWidgetAreas
enum DropAction { CopyAction, MoveAction, LinkAction, ActionMask, IgnoreAction, TargetMoveAction }
flags DropActions
enum EventPriority { HighEventPriority, NormalEventPriority, LowEventPriority }
enum FillRule { OddEvenFill, WindingFill }
enum FocusPolicy { TabFocus, ClickFocus, StrongFocus, WheelFocus, NoFocus }
enum FocusReason { MouseFocusReason, TabFocusReason, BacktabFocusReason, ActiveWindowFocusReason, ..., OtherFocusReason }
enum GestureFlag { DontStartGestureOnChildren, ReceivePartialGestures, IgnoredGesturesPropagateToParent }
flags GestureFlags
enum GestureState { GestureStarted, GestureUpdated, GestureFinished, GestureCanceled }
enum GestureType { TapGesture, TapAndHoldGesture, PanGesture, PinchGesture, SwipeGesture, CustomGesture }
enum GlobalColor { white, black, red, darkRed, ..., color1 }
typedef HANDLE
enum HitTestAccuracy { ExactHit, FuzzyHit }
enum ImageConversionFlag { AutoColor, ColorOnly, MonoOnly, DiffuseDither, ..., NoOpaqueDetection }
flags ImageConversionFlags
enum InputMethodHint { ImhNone, ImhHiddenText, ImhNoAutoUppercase, ImhPreferNumbers, ..., ImhExclusiveInputMask }
flags InputMethodHints
enum InputMethodQuery { ImMicroFocus, ImFont, ImCursorPosition, ImSurroundingText, ..., ImAnchorPosition }
enum ItemDataRole { DisplayRole, DecorationRole, EditRole, ToolTipRole, ..., UserRole }
enum ItemFlag { NoItemFlags, ItemIsSelectable, ItemIsEditable, ItemIsDragEnabled, ..., ItemIsTristate }
flags ItemFlags
enum ItemSelectionMode { ContainsItemShape, IntersectsItemShape, ContainsItemBoundingRect, IntersectsItemBoundingRect }
enum Key { Key_Escape, Key_Tab, Key_Backtab, Key_Backspace, ..., Key_Cancel }
enum KeyboardModifier { NoModifier, ShiftModifier, ControlModifier, AltModifier, ..., GroupSwitchModifier }
flags KeyboardModifiers
enum LayoutDirection { LeftToRight, RightToLeft, LayoutDirectionAuto }
enum MaskMode { MaskInColor, MaskOutColor }
enum MatchFlag { MatchExactly, MatchFixedString, MatchContains, MatchStartsWith, ..., MatchRecursive }
flags MatchFlags
enum Modifier { SHIFT, META, CTRL, ALT, UNICODE_ACCEL }
enum MouseButton { NoButton, LeftButton, RightButton, MidButton, ..., XButton2 }
flags MouseButtons
enum NavigationMode { NavigationModeNone, NavigationModeKeypadTabOrder, NavigationModeKeypadDirectional, NavigationModeCursorAuto, NavigationModeCursorForceVisible }
enum Orientation { Horizontal, Vertical }
flags Orientations
enum PenCapStyle { FlatCap, SquareCap, RoundCap }
enum PenJoinStyle { MiterJoin, BevelJoin, RoundJoin, SvgMiterJoin }
enum PenStyle { NoPen, SolidLine, DashLine, DotLine, ..., CustomDashLine }
enum ScrollBarPolicy { ScrollBarAsNeeded, ScrollBarAlwaysOff, ScrollBarAlwaysOn }
enum ShortcutContext { WidgetShortcut, WidgetWithChildrenShortcut, WindowShortcut, ApplicationShortcut }
enum SizeHint { MinimumSize, PreferredSize, MaximumSize, MinimumDescent }
enum SizeMode { AbsoluteSize, RelativeSize }
enum SortOrder { AscendingOrder, DescendingOrder }
enum TextElideMode { ElideLeft, ElideRight, ElideMiddle, ElideNone }
enum TextFlag { TextSingleLine, TextDontClip, TextExpandTabs, TextShowMnemonic, ..., TextJustificationForced }
enum TextFormat { PlainText, RichText, AutoText, LogText }
enum TextInteractionFlag { NoTextInteraction, TextSelectableByMouse, TextSelectableByKeyboard, LinksAccessibleByMouse, ..., TextBrowserInteraction }
flags TextInteractionFlags
enum TileRule { StretchTile, RepeatTile, RoundTile }
enum TimeSpec { LocalTime, UTC, OffsetFromUTC }
enum ToolBarArea { LeftToolBarArea, RightToolBarArea, TopToolBarArea, BottomToolBarArea, AllToolBarAreas, NoToolBarArea }
flags ToolBarAreas
enum ToolButtonStyle { ToolButtonIconOnly, ToolButtonTextOnly, ToolButtonTextBesideIcon, ToolButtonTextUnderIcon, ToolButtonFollowStyle }
enum TouchPointState { TouchPointPressed, TouchPointMoved, TouchPointStationary, TouchPointReleased }
flags TouchPointStates
enum TransformationMode { FastTransformation, SmoothTransformation }
enum UIEffect { UI_AnimateMenu, UI_FadeMenu, UI_AnimateCombo, UI_AnimateTooltip, UI_FadeTooltip, UI_AnimateToolBox }
typedef WFlags
enum WhiteSpaceMode { WhiteSpaceNormal, WhiteSpacePre, WhiteSpaceNoWrap }
enum WidgetAttribute { WA_AcceptDrops, WA_AlwaysShowToolTips, WA_ContentsPropagated, WA_CustomWhatsThis, ..., WA_MacNoShadow }
flags WindowFlags
enum WindowFrameSection { NoSection, LeftSection, TopLeftSection, TopSection, ..., TitleBarArea }
enum WindowModality { NonModal, WindowModal, ApplicationModal }
enum WindowState { WindowNoState, WindowMinimized, WindowMaximized, WindowFullScreen, WindowActive }
flags WindowStates
enum WindowType { Widget, Window, Dialog, Sheet, ..., WMacNoSheet }

函数

QString convertFromPlainText (const QString & plain , WhiteSpaceMode mode = WhiteSpacePre)
QString escape (const QString & plain )
bool mightBeRichText (const QString & text )

详细描述

Qt 名称空间包含整个 Qt 库所用的杂项标识符。

类型文档编制

enum Qt:: AlignmentFlag
flags Qt:: Alignment

此枚举类型用于描述对齐。它包含可以组合以产生要求效果的水平标志和垂直标志。

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

水平标志:

常量 描述
Qt::AlignLeft 0x0001 与左边缘对齐。
Qt::AlignRight 0x0002 与右边缘对齐。
Qt::AlignHCenter 0x0004 在可用空间水平居中。
Qt::AlignJustify 0x0008 在可用空间两端对齐文本。

垂直标志:

常量 描述
Qt::AlignTop 0x0020 与顶部对齐。
Qt::AlignBottom 0x0040 与底部对齐。
Qt::AlignVCenter 0x0080 在可用空间垂直居中。

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

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

每次最多可以使用一个水平标志和一个垂直标志。Qt::AlignCenter 算作水平和垂直两者。

3 枚举值在可以从右到左模式下运行的应用程序中很有用:

常量 描述
Qt::AlignAbsolute 0x0010 若 Widget 的布局方向是 Qt::RightToLeft (而不是 Qt::LeftToRight ,默认),Qt::AlignLeft 参照 right 边缘和 Qt::AlignRight 到 left 边缘。这通常是期望行为。若想要 Qt::AlignLeft 始终意味着 left 而 Qt::AlignRight 始终意味着 right,组合标志与 Qt::AlignAbsolute。
Qt::AlignLeading AlignLeft 同义词 Qt::AlignLeft。
Qt::AlignTrailing AlignRight 同义词 Qt::AlignRight。

掩码:

常量
Qt::AlignHorizontal_Mask AlignLeft | AlignRight | AlignHCenter | AlignJustify | AlignAbsolute
Qt::AlignVertical_Mask AlignTop | AlignBottom | AlignVCenter

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

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

enum Qt:: AnchorAttribute

An anchor has one or more of the following attributes:

常量 描述
Qt::AnchorName 0 the name attribute of the anchor. This attribute is used when scrolling to an anchor in the document.
Qt::AnchorHref 1 the href attribute of the anchor. This attribute is used when a link is clicked to determine what content to load.

enum Qt:: AnchorPoint

指定可以锚定的布局项侧。这用于 QGraphicsAnchorLayout .

常量 描述
Qt::AnchorLeft 0 布局项的左侧。
Qt::AnchorHorizontalCenter 1 在布局项左侧和右侧之间的居中 "虚拟" 侧。
Qt::AnchorRight 2 布局项的右侧。
Qt::AnchorTop 3 布局项的顶侧。
Qt::AnchorVerticalCenter 4 在布局项顶部和底部之间的居中 "虚拟" 侧。
Qt::AnchorBottom 5 布局项的底侧。

另请参阅 QGraphicsAnchorLayout .

enum Qt:: ApplicationAttribute

此枚举描述改变应用程序范围特征行为的属性。这些的启用和禁用是使用 QCoreApplication::setAttribute (),且可以被测试采用 QCoreApplication::testAttribute ().

常量 描述
Qt::AA_ImmediateWidgetCreation 0 Ensures that widgets are created as soon as they are constructed. By default, resources for widgets are allocated on demand to improve efficiency and minimize resource usage. Setting or clearing this attribute affects widgets constructed after the change. Setting it tells Qt to create toplevel windows immediately. Therefore, if it is important to minimize resource consumption, do not set this attribute.
Qt::AA_MSWindowsUseDirect3DByDefault 1 此值已过时且不起作用。
Qt::AA_DontShowIconsInMenus 2 具有 Icon 特性的动作不会展示在任何菜单中,除非专门设置通过 QAction::iconVisibleInMenu property. Menus that are currently open or menus already created in the native Mac OS X menubar may not 拾取此属性中的变化。改变在 QAction::iconVisibleInMenu 特性将始终被拾取。
Qt::AA_NativeWindows 3 确保 Widget 拥有本机窗口。
Qt::AA_DontCreateNativeWidgetSiblings 4 Ensures that siblings of native widgets stay non-native unless specifically set by the Qt::WA_NativeWindow 属性。
Qt::AA_MacPluginApplication 5 Stops the Qt mac application from doing specific initializations that do not necessarily make sense when using Qt to author a plugin. This includes avoiding loading our nib for the main menu and not taking possession of the native menu bar. When setting this attribute to true will also set the AA_DontUseNativeMenuBar attribute to true.
Qt::AA_DontUseNativeMenuBar 6 All menubars created while this attribute is set to true won't be used as a native menubar (e.g, the menubar at the top of the main screen on Mac OS X or at the bottom in Windows CE).
Qt::AA_MacDontSwapCtrlAndMeta 7 On Mac OS X by default, Qt swaps the Control and Meta (Command) keys (i.e., whenever Control is pressed, Qt sends Meta, and whenever Meta is pressed Control is sent). When this attribute is true, Qt will not do the flip. QKeySequence::StandardShortcuts will also flip accordingly (i.e., QKeySequence::Copy will be Command+C on the keyboard regardless of the value set, though what is output for QKeySequence::toString ( QKeySequence::PortableText ) will be different).
Qt::AA_S60DontConstructApplicationPanes 8 Stops Qt from initializing the S60 status pane and softkey pane on Symbian. This is useful to save memory and reduce startup time for applications that will run in fullscreen mode during their whole lifetime. This attribute must be set before QApplication is constructed.
Qt::AA_S60DisablePartialScreenInputMode 9 By default in Symbian^3, a separate editing window is opened on top of an application. This is exactly like editing on previous versions of Symbian behave. When this attribute is false, a non-fullscreen virtual keyboard window is shown on top of application and it is ensured that the focused text input widget is visible. The auto-translation of input widget is only supported for applications based on QGraphicsView , but the non-fullscreen virtual keyboard will work for any kind of application (i.e. QWidgets-based). By default this attribute is true. This attribute must be set after QApplication is constructed. This is only supported in Symbian^3 and later Symbian releases.
Qt::AA_X11InitThreads 10 Calls XInitThreads() as part of the QApplication construction in order to make Xlib calls thread-safe. This attribute must be set before QApplication is constructed.
Qt::AA_CaptureMultimediaKeys 11 Enables application to receive multimedia key events (play, next, previous etc). This includes also external sources such as headsets. Application can not use Remote Control framework on Symbian if this attribute is set. On Symbian, multimedia key event routing may vary between different devices. For example, application on background may receive multimedia key events only if it has active audio stream i.e. it is playing music or video. This attribute must be set before QApplication is constructed. This attribute is only supported in Symbian platform.

enum Qt:: ArrowType

常量
Qt::NoArrow 0
Qt::UpArrow 1
Qt::DownArrow 2
Qt::LeftArrow 3
Qt::RightArrow 4

enum Qt:: AspectRatioMode

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

常量 描述
Qt::IgnoreAspectRatio 0 大小可自由比例缩放。不保留宽高比。
Qt::KeepAspectRatio 1 大小按尽可能大矩形比例缩放到给定矩形内,保留宽高比。
Qt::KeepAspectRatioByExpanding 2 大小按尽可能小矩形比例缩放到给定矩形外,保留宽高比。

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

enum Qt:: Axis

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

常量 描述
Qt::XAxis 0 X 轴。
Qt::YAxis 1 Y 轴。
Qt::ZAxis 2 Z 轴。

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

enum Qt:: BGMode

背景模式:

常量
Qt::TransparentMode 0
Qt::OpaqueMode 1

enum Qt:: BrushStyle

此枚举类型定义由 Qt 支持的笔刷样式,即:形状的填充图案绘制使用 QPainter .

Brush Styles

常量 描述
Qt::NoBrush 0 没有笔刷图案。
Qt::SolidPattern 1 统一颜色。
Qt::Dense1Pattern 2 极度密集的笔刷图案。
Qt::Dense2Pattern 3 非常密集的笔刷图案。
Qt::Dense3Pattern 4 有点密集的笔刷图案。
Qt::Dense4Pattern 5 一半密集的笔刷图案。
Qt::Dense5Pattern 6 有点稀疏的笔刷图案。
Qt::Dense6Pattern 7 非常稀疏的笔刷图案。
Qt::Dense7Pattern 8 极度稀疏的笔刷图案。
Qt::HorPattern 9 水平线。
Qt::VerPattern 10 垂直线。
Qt::CrossPattern 11 交叉水平线和垂直线。
Qt::BDiagPattern 12 向后的对角线。
Qt::FDiagPattern 13 向前的对角线。
Qt::DiagCrossPattern 14 交叉对角线。
Qt::LinearGradientPattern 15 线性渐变 (设置使用专用 QBrush 构造函数)。
Qt::ConicalGradientPattern 17 锥形渐变 (设置使用专用 QBrush 构造函数)。
Qt::RadialGradientPattern 16 径向渐变 (设置使用专用 QBrush 构造函数)。
Qt::TexturePattern 24 自定义图案 (见 QBrush::setTexture ()).

另请参阅 QBrush .

enum Qt:: CaseSensitivity

常量
Qt::CaseInsensitive 0
Qt::CaseSensitive 1

enum Qt:: CheckState

此枚举描述可复选项、控件及 Widget 的状态。

常量 描述
Qt::Unchecked 0 项被取消复选。
Qt::PartiallyChecked 1 项被部分复选。在分层模型中的项可能被部分复选,若复选某些而非全部子级。
Qt::Checked 2 项被复选。

另请参阅 QCheckBox , Qt::ItemFlags ,和 Qt::ItemDataRole .

enum Qt:: ClipOperation

常量 描述
Qt::NoClip 0 此操作关闭裁剪。
Qt::ReplaceClip 1 以函数调用中提供的,替换当前裁剪路径/矩形/区域。
Qt::IntersectClip 2 相交当前裁剪路径/矩形/区域与函数调用所提供的。
Qt::UniteClip 3 Unites the current clip path/rect/region with the one supplied in the function call.

enum Qt:: ConnectionType

此枚举描述可以用于信号和槽之间的连接类型。尤其,它确定是把特定信号立即交付给槽,还是在以后队列交付。

常量 描述
Qt::AutoConnection 0 (default) If the signal is emitted from a different thread than the receiving object, the signal is queued, behaving as Qt::QueuedConnection. Otherwise, the slot is invoked directly, behaving as Qt::DirectConnection. The type of connection is determined when the signal is emitted.
Qt::DirectConnection 1 The slot is invoked immediately, when the signal is emitted.
Qt::QueuedConnection 2 槽被援引当控制返回给接收者线程的事件循环时。槽在接收者线程中执行。
Qt::BlockingQueuedConnection 4 Same as QueuedConnection, except the current thread blocks until the slot returns. This connection type should only be used where the emitter and receiver are in different threads.

注意: Violating this rule can cause your application to deadlock.

常量 描述
Qt::UniqueConnection 0x80 Same as AutoConnection, but the connection is made only if it does not duplicate an existing connection. i.e., if the same signal is already connected to the same slot for the same pair of objects, then the connection will fail. This connection type was introduced in Qt 4.6.
Qt::AutoCompatConnection 3 The default type when Qt 3 support is enabled. Same as AutoConnection but will also cause warnings to be output in certain situations. See Compatibility Signals and Slots for further information.

采用队列连接,参数类型必须是 Qt 元对象系统知道的,因为 Qt 需要拷贝自变量以存储它们在幕后事件中。若试着队列排队连接并获得错误消息:

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

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

当使用信号和槽采用多个线程时,见 信号和槽跨线程 .

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

enum Qt:: ContextMenuPolicy

此枚举类型定义 Widget 在展示上下文菜单方面可以采用的各种策略。

常量 描述
Qt::NoContextMenu 0 Widget 不提供上下文菜单,上下文菜单的处理是推迟到 Widget 父级。
Qt::PreventContextMenu 4 Widget 不提供上下文菜单,且相比 NoContextMenu ,处理 not deferred to the widget's parent. This means that all right mouse button events are guaranteed to be delivered to the widget itself through mousePressEvent(), and mouseReleaseEvent().
Qt::DefaultContextMenu 1 Widget 的 QWidget::contextMenuEvent () 处理程序被调用。
Qt::ActionsContextMenu 2 Widget 显示其 QWidget::actions () 作为上下文菜单。
Qt::CustomContextMenu 3 Widget 发射 QWidget::customContextMenuRequested () 信号。

enum Qt:: CoordinateSystem

此枚举指定坐标系。

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

该枚举在 Qt 4.6 引入或被修改。

enum Qt:: Corner

此枚举类型指定矩形角落:

常量 描述
Qt::TopLeftCorner 0x00000 矩形左上角。
Qt::TopRightCorner 0x00001 矩形的右上角。
Qt::BottomLeftCorner 0x00002 矩形的左下角。
Qt::BottomRightCorner 0x00003 矩形的右下角。

enum Qt:: CursorMoveStyle

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

常量 描述
Qt::LogicalMoveStyle 0 在从左到右文本块中,按下向左箭头键时递减光标位置,按下向右箭头键时递增光标位置。若文本块是从右到左,则应用相反的行为。应用相反行为。
Qt::VisualMoveStyle 1 按左箭头键始终导致光标向左移动,不管文本书写方向。按右箭头键始终导致光标向右移动。

该枚举在 Qt 4.8 引入或被修改。

enum Qt:: CursorShape

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

标准箭头光标是处于正常状态的 Widget 的默认值。

常量 描述
Qt::ArrowCursor 0 标准箭头光标。
Qt::UpArrowCursor 1 向上指向屏幕顶部的箭头。
Qt::CrossCursor 2 十字瞄准线光标,通常用于帮助用户精确选择屏幕点。
Qt::WaitCursor 3 沙漏或手表光标,通常在阻止用户和应用程序交互的操作期间展示。
Qt::IBeamCursor 4 ^ 插入符号或 I-beam 光标,指示 Widget 可以接受和显示文本输入。
Qt::SizeVerCursor 5 用于垂直重置顶层窗口大小的元素的光标。
Qt::SizeHorCursor 6 用于水平重置顶层窗口大小的元素的光标。
Qt::SizeBDiagCursor 7 用于在右上角和左下角对角重置顶层窗口大小的元素的光标。
Qt::SizeFDiagCursor 8 用于在左上角和右下角对角重置顶层窗口大小的元素的光标。
Qt::SizeAllCursor 9 用于在任何方向重置顶层窗口大小的元素的光标。
Qt::BlankCursor 10 空白/不可见光标,通常在需要隐藏光标形状时使用。
Qt::SplitVCursor 11 用于垂直分割器的光标,指示可以水平拖拽手柄以调节可用空间的使用。
Qt::SplitHCursor 12 用于水平分割器的光标,指示可以垂直拖拽手柄以调节可用空间的使用。
Qt::PointingHandCursor 13 指向手形光标,通常用于可点击元素,譬如:超链接。
Qt::ForbiddenCursor 14 斜杠圆形光标,通常在拖放操作期间使用,指示拖拽内容不可以掉落在特定 Widget 中 (或某些区域内)。
Qt::OpenHandCursor 17 表示张开手的光标,通常用于指示光标下区域是画布的可见部分,用户可以单击并拖拽环绕卷动。
Qt::ClosedHandCursor 18 表示闭合手的光标,通常用于指示正涉及卷动的拖拽操作。
Qt::WhatsThisCursor 15 带问号的箭头,通常用于指示存在 What's This? 小部件帮助。
Qt::BusyCursor 16 沙漏或手表光标,通常在允许用户在后台履行与应用程序交互的操作期间展示。
Qt::DragMoveCursor 20 通常使用的光标当拖拽项时。
Qt::DragCopyCursor 19 通常使用的光标当拖拽项以拷贝它时。
Qt::DragLinkCursor 21 通常使用的光标当拖拽项以链接到它时。
Qt::BitmapCursor 24

enum Qt:: DateFormat

常量 描述
Qt::TextDate 0 The default Qt format, which includes the day and month name, the day number in the month, and the year in full. The day and month names will be short, localized names. This is basically equivalent to using the date format string, "ddd MMM d yyyy". See QDate::toString () 了解更多信息。
Qt::ISODate 1 ISO 8601 扩展格式:要么 YYYY-MM-DD for dates or YYYY-MM-DDTHH:mm:ss , YYYY-MM-DDTHH:mm:ssTZD (e.g., 1997-07-16T19:20:30+01:00) for combined dates and times.
Qt::SystemLocaleShortDate ? The short 格式 用于 操作系统 .
Qt::SystemLocaleLongDate ? The long 格式 用于 操作系统 .
Qt::DefaultLocaleShortDate ? The short 格式 指定通过 应用程序的区域设置 .
Qt::DefaultLocaleLongDate ? The long 格式 用于 应用程序的区域设置 .
Qt::SystemLocaleDate 2 此枚举值被弃用。 使用 Qt::SystemLocaleShortDate 代替 (或 Qt::SystemLocaleLongDate 若想要 long 日期)。
Qt::LocaleDate ? 此枚举值被弃用。 使用 Qt::DefaultLocaleShortDate 代替 (或 Qt::DefaultLocaleLongDate 若想要 long 日期)。
Qt::LocalDate SystemLocaleDate 此枚举值被弃用。 使用 Qt::SystemLocaleShortDate 代替 (或 Qt::SystemLocaleLongDate 若想要 long 日期)。

注意: For ISODate 格式,各 Y , M and D represents a single digit of the year, month and day used to specify the date. Each H , M and S represents a single digit of the hour, minute and second used to specify the time. The presence of a literal T character is used to separate the date and time when both are specified.

enum Qt:: DayOfWeek

常量
Qt::Monday 1
Qt::Tuesday 2
Qt::Wednesday 3
Qt::Thursday 4
Qt::Friday 5
Qt::Saturday 6
Qt::Sunday 7

enum Qt:: DockWidgetArea
flags Qt:: DockWidgetAreas

常量
Qt::LeftDockWidgetArea 0x1
Qt::RightDockWidgetArea 0x2
Qt::TopDockWidgetArea 0x4
Qt::BottomDockWidgetArea 0x8
Qt::AllDockWidgetAreas DockWidgetArea_Mask
Qt::NoDockWidgetArea 0

DockWidgetAreas 类型是 typedef 对于 QFlags <DockWidgetArea>。它存储 DockWidgetArea 值的 OR 组合。

enum Qt:: DropAction
flags Qt:: DropActions

常量 描述
Qt::CopyAction 0x1 将数据拷贝到目标。
Qt::MoveAction 0x2 将数据从源移到目标。
Qt::LinkAction 0x4 创建从源到目标的链接。
Qt::ActionMask 0xff
Qt::IgnoreAction 0x0 忽略动作 (对数据什么都不做)。
Qt::TargetMoveAction 0x8002 On Windows, this value is used when the ownership of the D&D data should be taken over by the target application, i.e., the source application should not delete the data.
On X11 this value is used to do a move.
TargetMoveAction is not used on the Mac.

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

enum Qt:: EventPriority

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

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

注意,提供这些值纯粹是为了方便,因为事件优先级可以是任意值介于 INT_MAX and INT_MIN (包括在内)。例如,可以将自定义优先级定义成彼此相对:

enum CustomEventPriority
{
    // An important event
    ImportantEventPriority = Qt::HighEventPriority,
    // A more important event
    MoreImportantEventPriority = ImportantEventPriority + 1,
    // A critical event
    CriticalEventPriority = 100 * MoreImportantEventPriority,
    // Not that important
    StatusEventPriority = Qt::LowEventPriority,
    // These are less important than Status events
    IdleProcessingDoneEventPriority = StatusEventPriority - 1
};
					

另请参阅 QCoreApplication::postEvent ().

enum Qt:: FillRule

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

常量 描述
Qt::OddEvenFill 0 指定使用奇偶填充规则填充区域。根据此规则,通过使用随后方法确定点是否在形状内。从该点绘制水平线到形状外部位置,计算交点数。若交点数为奇数,则点在形状内。这是默认模式。
Qt::WindingFill 1 指定使用非 0 卷绕规则填充区域。根据此规则,通过使用随后方法确定点是否在形状内。从该点绘制水平线到形状外部位置。确定每个交点处线的方向是向上,还是向下。通过求和每交叉点方向,确定卷绕数。若数字非 0,则点位于形状内。在大多数情况下,此填充模式还被认为是闭合形状的交集。

enum Qt:: FocusPolicy

此枚举类型定义 Widget 在获得键盘聚焦方面可以拥有的各种策略。

常量 描述
Qt::TabFocus 0x1 Widget 通过 Tab 键接受聚焦。
Qt::ClickFocus 0x2 Widget 通过点击接受聚焦。
Qt::StrongFocus TabFocus | ClickFocus | 0x8 the widget accepts focus by both tabbing and clicking. On Mac OS X this will also be indicate that the widget accepts tab focus when in 'Text/List focus mode'.
Qt::WheelFocus StrongFocus | 0x4 像 Qt::StrongFocus + 小部件通过使用鼠标滚轮接受聚焦。
Qt::NoFocus 0 Widget 不接受聚焦。

enum Qt:: FocusReason

此枚举指定聚焦为什么改变。它会被传递透过 QWidget::setFocus 且可以检索在 QFocusEvent 被发送给 Widget 当聚焦改变时。

常量 描述
Qt::MouseFocusReason 0 出现鼠标动作。
Qt::TabFocusReason 1 按下 Tab 键。
Qt::BacktabFocusReason 2 发生 Backtab。输入可能包括 Shift 或 Control 键;如 Shift+Tab。
Qt::ActiveWindowFocusReason 3 窗口系统使此窗口活动或不活动。
Qt::PopupFocusReason 4 应用程序打开/关闭弹出窗口,抓取/释放键盘焦点。
Qt::ShortcutFocusReason 5 用户键入标签的好友快捷方式
Qt::MenuBarFocusReason 6 菜单栏获得聚焦。
Qt::OtherFocusReason 7 另一原因,通常特定于应用程序。

另请参阅 键盘聚焦 .

enum Qt:: GestureFlag
flags Qt:: GestureFlags

此枚举类型描述可以使用的额外标志,当订阅手势时。

常量 描述
Qt::DontStartGestureOnChildren 0x01 默认情况下,手势可以从 Widget 或其任何子级开始。使用此标志可禁用此并仅允许从 Widget 开始手势。
Qt::ReceivePartialGestures 0x02 允许将任何忽略手势事件传播给有指定此提示的父级 Widget。默认情况下,手势处于 Qt::GestureStarted 状态才被传播且 Widget 始终获取完整手势序列开始采用手势处于 Qt::GestureStarted 状态和结束采用手势处于 Qt::GestureFinished or Qt::GestureCanceled 状态。
Qt::IgnoredGesturesPropagateToParent 0x04 从 Qt 4.7 起,此标志允许微调手势事件传播。通过设置标志当 grabbing 手势,全部忽略的部分手势将被传播给其父级项。

该枚举在 Qt 4.6 引入或被修改。

GestureFlags 类型是 typedef 对于 QFlags <GestureFlag>。它存储 GestureFlag 值的 OR 组合。

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

enum Qt:: GestureState

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

常量 描述
Qt::GestureStarted 1 连续手势已开始。
Qt::GestureUpdated 2 手势继续。
Qt::GestureFinished 3 手势已完成。
Qt::GestureCanceled 4 手势被取消。

该枚举在 Qt 4.6 引入或被修改。

另请参阅 QGesture .

enum Qt:: GestureType

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

常量 描述
Qt::TapGesture 1 敲击手势。
Qt::TapAndHoldGesture 2 敲击并保持 (长敲击) 手势。
Qt::PanGesture 3 平移手势。
Qt::PinchGesture 4 捏合手势。
Qt::SwipeGesture 5 轻扫手势。
Qt::CustomGesture 0x0100 可以用于测试的标志,若手势是用户定义手势 ID。

注册用户定义手势采用 QGestureRecognizer::registerRecognizer () 函数,其生成带 Qt::CustomGesture 设置标志的自定义手势 ID。

该枚举在 Qt 4.6 引入或被修改。

另请参阅 QGesture , QWidget::grabGesture (),和 QGraphicsObject::grabGesture ().

enum Qt:: GlobalColor

Qt 的预定义 QColor 对象:

常量 描述
Qt::white 3 白色 (#ffffff)
Qt::black 2 黑色 (#000000)
Qt::red 7 红色 (#ff0000)
Qt::darkRed 13 深红色 (#800000)
Qt::green 8 绿色 (#00ff00)
Qt::darkGreen 14 深绿色 (#008000)
Qt::blue 9 蓝色 (#0000ff)
Qt::darkBlue 15 深蓝色 (#000080)
Qt::cyan 10 青色 (#00ffff)
Qt::darkCyan 16 深青色 (#008080)
Qt::magenta 11 洋红色 (#ff00ff)
Qt::darkMagenta 17 深洋红色 (#800080)
Qt::yellow 12 黄色 (#ffff00)
Qt::darkYellow 18 深黄色 (#808000)
Qt::gray 5 灰色 (#a0a0a4)
Qt::darkGray 4 深灰色 (#808080)
Qt::lightGray 6 浅灰色 (#c0c0c0)
Qt::transparent 19 透明黑色值 (即, QColor (0, 0, 0, 0))
Qt::color0 0 0 像素值 (用于位图)
Qt::color1 1 1 像素值 (用于位图)

另请参阅 QColor .

typedef Qt:: HANDLE

Platform-specific handle type for system objects. This is equivalent to void * on Mac OS X and embedded Linux, and to unsigned long on X11. On Windows it is the DWORD returned by the Win32 function getCurrentThreadId().

警告: Using this type is not portable.

enum Qt:: HitTestAccuracy

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

常量 描述
Qt::ExactHit 0 输入出现点必须与文档的输入敏感部分准确重合。
Qt::FuzzyHit 1 输入出现点可以接近文档的输入敏感部分。

This enum is defined in the <QTextDocument> 头文件。

enum Qt:: ImageConversionFlag
flags Qt:: ImageConversionFlags

选项标记设置 default,若不包括来自列表的其它值 (由于默认为 0):

彩色/单色首选 (被忽略对于 QBitmap ):

常量 描述
Qt::AutoColor 0x00000000 (默认) - 若图像有 depth 1 且只包含黑色和白色像素,像素图变为单色。
Qt::ColorOnly 0x00000003 像素图抖动/转换为 本机显示深度 .
Qt::MonoOnly 0x00000002 像素图变成单色。若有必要,使用所选抖动算法进行抖动。

Dithering mode preference for RGB channels:

常量 描述
Qt::DiffuseDither 0x00000000 (default) - A high-quality dither.
Qt::OrderedDither 0x00000010 A faster, more ordered dither.
Qt::ThresholdDither 0x00000020 没有抖动;使用最接近的颜色。

Dithering mode preference for alpha channel:

常量 描述
Qt::ThresholdAlphaDither 0x00000000 (默认) - 没有抖动。
Qt::OrderedAlphaDither 0x00000004 A faster, more ordered dither.
Qt::DiffuseAlphaDither 0x00000008 A high-quality dither.

颜色匹配 vs 抖动偏好:

常量 描述
Qt::PreferDither 0x00000040 (default when converting to a pixmap) - Always dither 32-bit images when the image is converted to 8 bits.
Qt::AvoidDither 0x00000080 (default when converting for the purpose of saving to file) - Dither 32-bit images only if the image has more than 256 colors and it is being converted to 8 bits.
Qt::NoOpaqueDetection 0x00000100 不校验图像是否包含透明像素。使用这,若知道图像是半透明的,且想要避免校验图像像素 (直到找到不透明像素为止) 的开销,或者若出于某些其它原因想要像素图保留 Alpha 通道。若图像没有 Alpha 通道,此标志不起作用。

不对图像做任何格式转换。可能很有用当转换 QImage QPixmap for a one-time rendering operation for example.

ImageConversionFlags 类型是 typedef 对于 QFlags <ImageConversionFlag>。它存储 ImageConversionFlag 值的 OR 组合。

enum Qt:: InputMethodHint
flags Qt:: InputMethodHints

常量 描述
Qt::ImhNone 0x0 没有提示。

更改行为的标志:

常量 描述
Qt::ImhHiddenText 0x1 Characters should be hidden, as is typically used when entering passwords. This is automatically set when setting QLineEdit::echoMode to Password .
Qt::ImhNoAutoUppercase 0x2 输入法不应该试着自动切换到大写当句子结束时。
Qt::ImhPreferNumbers 0x4 数字是首选的 (但不是必需的)。
Qt::ImhPreferUppercase 0x8 大写字母是首选的 (但不是必需的)。
Qt::ImhPreferLowercase 0x10 小写字母是首选的 (但不是必需的)。
Qt::ImhNoPredictiveText 0x20 键入时不使用预测文本 (即:查找字典)。

限定输入的标志 (排斥标志):

常量 描述
Qt::ImhDigitsOnly 0x10000 只允许数字。
Qt::ImhFormattedNumbersOnly 0x20000 只允许输入数字。这包括小数点和负号。
Qt::ImhUppercaseOnly 0x40000 只允许输入大写字母。
Qt::ImhLowercaseOnly 0x80000 只允许输入小写字母。
Qt::ImhDialableCharactersOnly 0x100000 Only characters suitable for phone dialling are allowed.
Qt::ImhEmailCharactersOnly 0x200000 只允许适于 Email 地址的字符。
Qt::ImhUrlCharactersOnly 0x400000 只允许适于 URL 的字符。

掩码:

常量 描述
Qt::ImhExclusiveInputMask 0xffff0000 此掩码产生非 0 若使用任何排斥标志。

注意: If several exclusive flags are ORed together, the resulting character set will consist of the union of the specified sets. For instance specifying ImhNumbersOnly and ImhUppercaseOnly 将产生由数字和大写字母组成的集。

InputMethodHints 类型是 typedef 对于 QFlags <InputMethodHint>。它存储 InputMethodHint 值的 OR 组合。

另请参阅 QGraphicsItem::inputMethodHints ().

enum Qt:: InputMethodQuery

常量 描述
Qt::ImMicroFocus 0 在 Widget 坐标中覆盖输入光标区域的矩形。
Qt::ImFont 1 目前文本输入使用的字体。
Qt::ImCursorPosition 2 在环绕输入区域文本中的光标逻辑位置 (见 ImSurroundingText ).
Qt::ImSurroundingText 3 输入区域周围的纯文本,例如:当前段落。
Qt::ImCurrentSelection 4 目前选中的文本。
Qt::ImMaximumTextLength 5 The maximum number of characters that the widget can hold. If there is no limit, QVariant() is returned.
Qt::ImAnchorPosition 6 选定锚点的位置。这可能小于或大于 ImCursorPosition , 从属光标选择哪侧。若未选择,它的返回如同 ImCursorPosition .

enum Qt:: ItemDataRole

模型中每项拥有一组与之关联的数据元素,每数据元素带有其自己的角色。视图使用角色来指示模型,其需要哪种数据类型。自定义模型应该返回这些类型的数据。

一般用途的角色 (和关联的类型):

常量 描述
Qt::DisplayRole 0 要以文本形式渲染的关键数据。( QString )
Qt::DecorationRole 1 以图标形式被渲染作为装饰的数据。( QColor , QIcon or QPixmap )
Qt::EditRole 2 按适于在编辑器中编辑的形式表示数据。( QString )
Qt::ToolTipRole 3 被显示在项工具提示中的数据。( QString )
Qt::StatusTipRole 4 被显示在状态栏中的数据。( QString )
Qt::WhatsThisRole 5 在 What's This? 方式下被显示的项数据。( QString )
Qt::SizeHintRole 13 会被提供给视图的项大小提示。( QSize )

描述外观和元数据的角色 (与关联类型):

常量 描述
Qt::FontRole 6 用于采用默认委托渲染项的字体。( QFont )
Qt::TextAlignmentRole 7 采用默认委托渲染项的文本对齐方式。( Qt::AlignmentFlag )
Qt::BackgroundRole 8 用于采用默认委托渲染项的背景笔刷。( QBrush )
Qt::BackgroundColorRole 8 此角色已过时。使用 BackgroundRole 代替。
Qt::ForegroundRole 9 用于采用默认委托渲染项的前景笔刷 (文本颜色,通常)。( QBrush )
Qt::TextColorRole 9 此角色已过时。使用 ForegroundRole 代替。
Qt::CheckStateRole 10 此角色被用于获取项的被复选状态。( Qt::CheckState )
Qt::InitialSortOrderRole 14 此角色用于获取 Header (头) 视图区间的初始排序次序。( Qt::SortOrder )。此角色在 Qt 4.8 引入。

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

常量 描述
Qt::AccessibleTextRole 11 要被用于可访问性扩展和插件 (如:屏幕阅读器) 的文本。( QString )
Qt::AccessibleDescriptionRole 12 用于可访问性目的的项描述。( QString )

用户角色:

常量 描述
Qt::UserRole 32 可以被用于特定应用程序目的的第一角色。

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

enum Qt:: ItemFlag
flags Qt:: ItemFlags

此枚举描述项的特性:

常量 描述
Qt::NoItemFlags 0 它没有设置任何特性。
Qt::ItemIsSelectable 1 它可以被选中。
Qt::ItemIsEditable 2 它可以被编辑。
Qt::ItemIsDragEnabled 4 可以拖拽它。
Qt::ItemIsDropEnabled 8 可以将它用作掉落目标。
Qt::ItemIsUserCheckable 16 它可以被用户复选 (或取消复选)。
Qt::ItemIsEnabled 32 用户可以与项交互。
Qt::ItemIsTristate 64 The item is checkable with three separate states.

注意,需要为可复选项提供一组合适标志和初始状态,以指示项是否被选中。这是模型/视图组件自动处理的,但需要明确设置为实例化的 QListWidgetItem , QTableWidgetItem ,和 QTreeWidgetItem .

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

另请参阅 QAbstractItemModel .

enum Qt:: ItemSelectionMode

此枚举用于 QGraphicsItem , QGraphicsScene and QGraphicsView to specify how items are selected, or how to determine if a shapes and items collide.

常量 描述
Qt::ContainsItemShape 0x0 输出列表仅包含项, shape 完全包含在选定区域内。与区域轮廓相交的项不包括。
Qt::IntersectsItemShape 0x1 输出列表包含两者项, shape 完全包含在选定区域内,和与区域轮廓相交的项。这是橡皮筋选定的常用模式。
Qt::ContainsItemBoundingRect 0x2 输出列表仅包含项, 边界矩形 完全包含在选定区域内。与区域轮廓相交的项不包括。
Qt::IntersectsItemBoundingRect 0x3 输出列表包含两者项, 边界矩形 完全包含在选定区域内,和与区域轮廓相交的项。此方法常用于确定需要重新绘制的区域。

另请参阅 QGraphicsScene::items (), QGraphicsScene::collidingItems (), QGraphicsView::items (), QGraphicsItem::collidesWithItem (),和 QGraphicsItem::collidesWithPath ().

enum Qt:: Key

Qt 使用的键名。

常量 描述
Qt::Key_Escape 0x01000000
Qt::Key_Tab 0x01000001
Qt::Key_Backtab 0x01000002
Qt::Key_Backspace 0x01000003
Qt::Key_Return 0x01000004
Qt::Key_Enter 0x01000005 通常位于 Keypad (小键盘) 上。
Qt::Key_Insert 0x01000006
Qt::Key_Delete 0x01000007
Qt::Key_Pause 0x01000008 Pause/Break 键 (

注意: Not anything to do with pausing media)

常量 描述
Qt::Key_Print 0x01000009
Qt::Key_SysReq 0x0100000a
Qt::Key_Clear 0x0100000b
Qt::Key_Home 0x01000010
Qt::Key_End 0x01000011
Qt::Key_Left 0x01000012
Qt::Key_Up 0x01000013
Qt::Key_Right 0x01000014
Qt::Key_Down 0x01000015
Qt::Key_PageUp 0x01000016
Qt::Key_PageDown 0x01000017
Qt::Key_Shift 0x01000020
Qt::Key_Control 0x01000021 On Mac OS X, this corresponds to the Command keys.
Qt::Key_Meta 0x01000022 On Mac OS X, this corresponds to the Control keys. On Windows keyboards, this key is mapped to the Windows key.
Qt::Key_Alt 0x01000023
Qt::Key_AltGr 0x01001103 在 Windows 发送此键的 KeyDown 事件时,还会设置 Ctrl+Alt 修饰符。
Qt::Key_CapsLock 0x01000024
Qt::Key_NumLock 0x01000025
Qt::Key_ScrollLock 0x01000026
Qt::Key_F1 0x01000030
Qt::Key_F2 0x01000031
Qt::Key_F3 0x01000032
Qt::Key_F4 0x01000033
Qt::Key_F5 0x01000034
Qt::Key_F6 0x01000035
Qt::Key_F7 0x01000036
Qt::Key_F8 0x01000037
Qt::Key_F9 0x01000038
Qt::Key_F10 0x01000039
Qt::Key_F11 0x0100003a
Qt::Key_F12 0x0100003b
Qt::Key_F13 0x0100003c
Qt::Key_F14 0x0100003d
Qt::Key_F15 0x0100003e
Qt::Key_F16 0x0100003f
Qt::Key_F17 0x01000040
Qt::Key_F18 0x01000041
Qt::Key_F19 0x01000042
Qt::Key_F20 0x01000043
Qt::Key_F21 0x01000044
Qt::Key_F22 0x01000045
Qt::Key_F23 0x01000046
Qt::Key_F24 0x01000047
Qt::Key_F25 0x01000048
Qt::Key_F26 0x01000049
Qt::Key_F27 0x0100004a
Qt::Key_F28 0x0100004b
Qt::Key_F29 0x0100004c
Qt::Key_F30 0x0100004d
Qt::Key_F31 0x0100004e
Qt::Key_F32 0x0100004f
Qt::Key_F33 0x01000050
Qt::Key_F34 0x01000051
Qt::Key_F35 0x01000052
Qt::Key_Super_L 0x01000053
Qt::Key_Super_R 0x01000054
Qt::Key_Menu 0x01000055
Qt::Key_Hyper_L 0x01000056
Qt::Key_Hyper_R 0x01000057
Qt::Key_Help 0x01000058
Qt::Key_Direction_L 0x01000059
Qt::Key_Direction_R 0x01000060
Qt::Key_Space 0x20
Qt::Key_Any Key_Space
Qt::Key_Exclam 0x21
Qt::Key_QuoteDbl 0x22
Qt::Key_NumberSign 0x23
Qt::Key_Dollar 0x24
Qt::Key_Percent 0x25
Qt::Key_Ampersand 0x26
Qt::Key_Apostrophe 0x27
Qt::Key_ParenLeft 0x28
Qt::Key_ParenRight 0x29
Qt::Key_Asterisk 0x2a
Qt::Key_Plus 0x2b
Qt::Key_Comma 0x2c
Qt::Key_Minus 0x2d
Qt::Key_Period 0x2e
Qt::Key_Slash 0x2f
Qt::Key_0 0x30
Qt::Key_1 0x31
Qt::Key_2 0x32
Qt::Key_3 0x33
Qt::Key_4 0x34
Qt::Key_5 0x35
Qt::Key_6 0x36
Qt::Key_7 0x37
Qt::Key_8 0x38
Qt::Key_9 0x39
Qt::Key_Colon 0x3a
Qt::Key_Semicolon 0x3b
Qt::Key_Less 0x3c
Qt::Key_Equal 0x3d
Qt::Key_Greater 0x3e
Qt::Key_Question 0x3f
Qt::Key_At 0x40
Qt::Key_A 0x41
Qt::Key_B 0x42
Qt::Key_C 0x43
Qt::Key_D 0x44
Qt::Key_E 0x45
Qt::Key_F 0x46
Qt::Key_G 0x47
Qt::Key_H 0x48
Qt::Key_I 0x49
Qt::Key_J 0x4a
Qt::Key_K 0x4b
Qt::Key_L 0x4c
Qt::Key_M 0x4d
Qt::Key_N 0x4e
Qt::Key_O 0x4f
Qt::Key_P 0x50
Qt::Key_Q 0x51
Qt::Key_R 0x52
Qt::Key_S 0x53
Qt::Key_T 0x54
Qt::Key_U 0x55
Qt::Key_V 0x56
Qt::Key_W 0x57
Qt::Key_X 0x58
Qt::Key_Y 0x59
Qt::Key_Z 0x5a
Qt::Key_BracketLeft 0x5b
Qt::Key_Backslash 0x5c
Qt::Key_BracketRight 0x5d
Qt::Key_AsciiCircum 0x5e
Qt::Key_Underscore 0x5f
Qt::Key_QuoteLeft 0x60
Qt::Key_BraceLeft 0x7b
Qt::Key_Bar 0x7c
Qt::Key_BraceRight 0x7d
Qt::Key_AsciiTilde 0x7e
Qt::Key_nobreakspace 0x0a0
Qt::Key_exclamdown 0x0a1
Qt::Key_cent 0x0a2
Qt::Key_sterling 0x0a3
Qt::Key_currency 0x0a4
Qt::Key_yen 0x0a5
Qt::Key_brokenbar 0x0a6
Qt::Key_section 0x0a7
Qt::Key_diaeresis 0x0a8
Qt::Key_copyright 0x0a9
Qt::Key_ordfeminine 0x0aa
Qt::Key_guillemotleft 0x0ab
Qt::Key_notsign 0x0ac
Qt::Key_hyphen 0x0ad
Qt::Key_registered 0x0ae
Qt::Key_macron 0x0af
Qt::Key_degree 0x0b0
Qt::Key_plusminus 0x0b1
Qt::Key_twosuperior 0x0b2
Qt::Key_threesuperior 0x0b3
Qt::Key_acute 0x0b4
Qt::Key_mu 0x0b5
Qt::Key_paragraph 0x0b6
Qt::Key_periodcentered 0x0b7
Qt::Key_cedilla 0x0b8
Qt::Key_onesuperior 0x0b9
Qt::Key_masculine 0x0ba
Qt::Key_guillemotright 0x0bb
Qt::Key_onequarter 0x0bc
Qt::Key_onehalf 0x0bd
Qt::Key_threequarters 0x0be
Qt::Key_questiondown 0x0bf
Qt::Key_Agrave 0x0c0
Qt::Key_Aacute 0x0c1
Qt::Key_Acircumflex 0x0c2
Qt::Key_Atilde 0x0c3
Qt::Key_Adiaeresis 0x0c4
Qt::Key_Aring 0x0c5
Qt::Key_AE 0x0c6
Qt::Key_Ccedilla 0x0c7
Qt::Key_Egrave 0x0c8
Qt::Key_Eacute 0x0c9
Qt::Key_Ecircumflex 0x0ca
Qt::Key_Ediaeresis 0x0cb
Qt::Key_Igrave 0x0cc
Qt::Key_Iacute 0x0cd
Qt::Key_Icircumflex 0x0ce
Qt::Key_Idiaeresis 0x0cf
Qt::Key_ETH 0x0d0
Qt::Key_Ntilde 0x0d1
Qt::Key_Ograve 0x0d2
Qt::Key_Oacute 0x0d3
Qt::Key_Ocircumflex 0x0d4
Qt::Key_Otilde 0x0d5
Qt::Key_Odiaeresis 0x0d6
Qt::Key_multiply 0x0d7
Qt::Key_Ooblique 0x0d8
Qt::Key_Ugrave 0x0d9
Qt::Key_Uacute 0x0da
Qt::Key_Ucircumflex 0x0db
Qt::Key_Udiaeresis 0x0dc
Qt::Key_Yacute 0x0dd
Qt::Key_THORN 0x0de
Qt::Key_ssharp 0x0df
Qt::Key_division 0x0f7
Qt::Key_ydiaeresis 0x0ff
Qt::Key_Multi_key 0x01001120
Qt::Key_Codeinput 0x01001137
Qt::Key_SingleCandidate 0x0100113c
Qt::Key_MultipleCandidate 0x0100113d
Qt::Key_PreviousCandidate 0x0100113e
Qt::Key_Mode_switch 0x0100117e
Qt::Key_Kanji 0x01001121
Qt::Key_Muhenkan 0x01001122
Qt::Key_Henkan 0x01001123
Qt::Key_Romaji 0x01001124
Qt::Key_Hiragana 0x01001125
Qt::Key_Katakana 0x01001126
Qt::Key_Hiragana_Katakana 0x01001127
Qt::Key_Zenkaku 0x01001128
Qt::Key_Hankaku 0x01001129
Qt::Key_Zenkaku_Hankaku 0x0100112a
Qt::Key_Touroku 0x0100112b
Qt::Key_Massyo 0x0100112c
Qt::Key_Kana_Lock 0x0100112d
Qt::Key_Kana_Shift 0x0100112e
Qt::Key_Eisu_Shift 0x0100112f
Qt::Key_Eisu_toggle 0x01001130
Qt::Key_Hangul 0x01001131
Qt::Key_Hangul_Start 0x01001132
Qt::Key_Hangul_End 0x01001133
Qt::Key_Hangul_Hanja 0x01001134
Qt::Key_Hangul_Jamo 0x01001135
Qt::Key_Hangul_Romaja 0x01001136
Qt::Key_Hangul_Jeonja 0x01001138
Qt::Key_Hangul_Banja 0x01001139
Qt::Key_Hangul_PreHanja 0x0100113a
Qt::Key_Hangul_PostHanja 0x0100113b
Qt::Key_Hangul_Special 0x0100113f
Qt::Key_Dead_Grave 0x01001250
Qt::Key_Dead_Acute 0x01001251
Qt::Key_Dead_Circumflex 0x01001252
Qt::Key_Dead_Tilde 0x01001253
Qt::Key_Dead_Macron 0x01001254
Qt::Key_Dead_Breve 0x01001255
Qt::Key_Dead_Abovedot 0x01001256
Qt::Key_Dead_Diaeresis 0x01001257
Qt::Key_Dead_Abovering 0x01001258
Qt::Key_Dead_Doubleacute 0x01001259
Qt::Key_Dead_Caron 0x0100125a
Qt::Key_Dead_Cedilla 0x0100125b
Qt::Key_Dead_Ogonek 0x0100125c
Qt::Key_Dead_Iota 0x0100125d
Qt::Key_Dead_Voiced_Sound 0x0100125e
Qt::Key_Dead_Semivoiced_Sound 0x0100125f
Qt::Key_Dead_Belowdot 0x01001260
Qt::Key_Dead_Hook 0x01001261
Qt::Key_Dead_Horn 0x01001262
Qt::Key_Back 0x01000061
Qt::Key_Forward 0x01000062
Qt::Key_Stop 0x01000063
Qt::Key_Refresh 0x01000064
Qt::Key_VolumeDown 0x01000070
Qt::Key_VolumeMute 0x01000071
Qt::Key_VolumeUp 0x01000072
Qt::Key_BassBoost 0x01000073
Qt::Key_BassUp 0x01000074
Qt::Key_BassDown 0x01000075
Qt::Key_TrebleUp 0x01000076
Qt::Key_TrebleDown 0x01000077
Qt::Key_MediaPlay 0x01000080 设置媒体播放器播放状态的键
Qt::Key_MediaStop 0x01000081 设置媒体播放器停止状态的键
Qt::Key_MediaPrevious 0x01000082
Qt::Key_MediaNext 0x01000083
Qt::Key_MediaRecord 0x01000084
Qt::Key_MediaPause 0x1000085 设置媒体播放器暂停状态的键 (

注意: not the pause/break key)

常量 描述
Qt::Key_MediaTogglePlayPause 0x1000086 A key to toggle the play/pause state in the media player (rather than setting an absolute state)
Qt::Key_HomePage 0x01000090
Qt::Key_Favorites 0x01000091
Qt::Key_Search 0x01000092
Qt::Key_Standby 0x01000093
Qt::Key_OpenUrl 0x01000094
Qt::Key_LaunchMail 0x010000a0
Qt::Key_LaunchMedia 0x010000a1
Qt::Key_Launch0 0x010000a2 On X11 this key is mapped to "My Computer" (XF86XK_MyComputer) key for legacy reasons.
Qt::Key_Launch1 0x010000a3 On X11 this key is mapped to "Calculator" (XF86XK_Calculator) key for legacy reasons.
Qt::Key_Launch2 0x010000a4 On X11 this key is mapped to XF86XK_Launch0 key for legacy reasons.
Qt::Key_Launch3 0x010000a5 On X11 this key is mapped to XF86XK_Launch1 key for legacy reasons.
Qt::Key_Launch4 0x010000a6 On X11 this key is mapped to XF86XK_Launch2 key for legacy reasons.
Qt::Key_Launch5 0x010000a7 On X11 this key is mapped to XF86XK_Launch3 key for legacy reasons.
Qt::Key_Launch6 0x010000a8 On X11 this key is mapped to XF86XK_Launch4 key for legacy reasons.
Qt::Key_Launch7 0x010000a9 On X11 this key is mapped to XF86XK_Launch5 key for legacy reasons.
Qt::Key_Launch8 0x010000aa On X11 this key is mapped to XF86XK_Launch6 key for legacy reasons.
Qt::Key_Launch9 0x010000ab On X11 this key is mapped to XF86XK_Launch7 key for legacy reasons.
Qt::Key_LaunchA 0x010000ac On X11 this key is mapped to XF86XK_Launch8 key for legacy reasons.
Qt::Key_LaunchB 0x010000ad On X11 this key is mapped to XF86XK_Launch9 key for legacy reasons.
Qt::Key_LaunchC 0x010000ae On X11 this key is mapped to XF86XK_LaunchA key for legacy reasons.
Qt::Key_LaunchD 0x010000af On X11 this key is mapped to XF86XK_LaunchB key for legacy reasons.
Qt::Key_LaunchE 0x010000b0 On X11 this key is mapped to XF86XK_LaunchC key for legacy reasons.
Qt::Key_LaunchF 0x010000b1 On X11 this key is mapped to XF86XK_LaunchD key for legacy reasons.
Qt::Key_LaunchG 0x0100010e On X11 this key is mapped to XF86XK_LaunchE key for legacy reasons.
Qt::Key_LaunchH 0x0100010f On X11 this key is mapped to XF86XK_LaunchF key for legacy reasons.
Qt::Key_MonBrightnessUp 0x010000b2
Qt::Key_MonBrightnessDown 0x010000b3
Qt::Key_KeyboardLightOnOff 0x010000b4
Qt::Key_KeyboardBrightnessUp 0x010000b5
Qt::Key_KeyboardBrightnessDown 0x010000b6
Qt::Key_PowerOff 0x010000b7
Qt::Key_WakeUp 0x010000b8
Qt::Key_Eject 0x010000b9
Qt::Key_ScreenSaver 0x010000ba
Qt::Key_WWW 0x010000bb
Qt::Key_Memo 0x010000bc
Qt::Key_LightBulb 0x010000bd
Qt::Key_Shop 0x010000be
Qt::Key_History 0x010000bf
Qt::Key_AddFavorite 0x010000c0
Qt::Key_HotLinks 0x010000c1
Qt::Key_BrightnessAdjust 0x010000c2
Qt::Key_Finance 0x010000c3
Qt::Key_Community 0x010000c4
Qt::Key_AudioRewind 0x010000c5
Qt::Key_BackForward 0x010000c6
Qt::Key_ApplicationLeft 0x010000c7
Qt::Key_ApplicationRight 0x010000c8
Qt::Key_Book 0x010000c9
Qt::Key_CD 0x010000ca
Qt::Key_Calculator 0x010000cb On X11 this key is not mapped for legacy reasons. Use Qt::Key_Launch1 instead.
Qt::Key_ToDoList 0x010000cc
Qt::Key_ClearGrab 0x010000cd
Qt::Key_Close 0x010000ce
Qt::Key_Copy 0x010000cf
Qt::Key_Cut 0x010000d0
Qt::Key_Display 0x010000d1
Qt::Key_DOS 0x010000d2
Qt::Key_Documents 0x010000d3
Qt::Key_Excel 0x010000d4
Qt::Key_Explorer 0x010000d5
Qt::Key_Game 0x010000d6
Qt::Key_Go 0x010000d7
Qt::Key_iTouch 0x010000d8
Qt::Key_LogOff 0x010000d9
Qt::Key_Market 0x010000da
Qt::Key_Meeting 0x010000db
Qt::Key_MenuKB 0x010000dc
Qt::Key_MenuPB 0x010000dd
Qt::Key_MySites 0x010000de
Qt::Key_News 0x010000df
Qt::Key_OfficeHome 0x010000e0
Qt::Key_Option 0x010000e1
Qt::Key_Paste 0x010000e2
Qt::Key_Phone 0x010000e3
Qt::Key_Calendar 0x010000e4
Qt::Key_Reply 0x010000e5
Qt::Key_Reload 0x010000e6
Qt::Key_RotateWindows 0x010000e7
Qt::Key_RotationPB 0x010000e8
Qt::Key_RotationKB 0x010000e9
Qt::Key_Save 0x010000ea
Qt::Key_Send 0x010000eb
Qt::Key_Spell 0x010000ec
Qt::Key_SplitScreen 0x010000ed
Qt::Key_Support 0x010000ee
Qt::Key_TaskPane 0x010000ef
Qt::Key_Terminal 0x010000f0
Qt::Key_Tools 0x010000f1
Qt::Key_Travel 0x010000f2
Qt::Key_Video 0x010000f3
Qt::Key_Word 0x010000f4
Qt::Key_Xfer 0x010000f5
Qt::Key_ZoomIn 0x010000f6
Qt::Key_ZoomOut 0x010000f7
Qt::Key_Away 0x010000f8
Qt::Key_Messenger 0x010000f9
Qt::Key_WebCam 0x010000fa
Qt::Key_MailForward 0x010000fb
Qt::Key_Pictures 0x010000fc
Qt::Key_Music 0x010000fd
Qt::Key_Battery 0x010000fe
Qt::Key_Bluetooth 0x010000ff
Qt::Key_WLAN 0x01000100
Qt::Key_UWB 0x01000101
Qt::Key_AudioForward 0x01000102
Qt::Key_AudioRepeat 0x01000103
Qt::Key_AudioRandomPlay 0x01000104
Qt::Key_Subtitle 0x01000105
Qt::Key_AudioCycleTrack 0x01000106
Qt::Key_Time 0x01000107
Qt::Key_Hibernate 0x01000108
Qt::Key_View 0x01000109
Qt::Key_TopMenu 0x0100010a
Qt::Key_PowerDown 0x0100010b
Qt::Key_Suspend 0x0100010c
Qt::Key_ContrastAdjust 0x0100010d
Qt::Key_MediaLast 0x0100ffff
Qt::Key_unknown 0x01ffffff
Qt::Key_Call 0x01100004 A key to answer or initiate a call (see Qt::Key_ToggleCallHangup for a key to toggle current call state)
Qt::Key_Camera 0x01100020 A key to activate the camera shutter
Qt::Key_CameraFocus 0x01100021 A key to focus the camera
Qt::Key_Context1 0x01100000
Qt::Key_Context2 0x01100001
Qt::Key_Context3 0x01100002
Qt::Key_Context4 0x01100003
Qt::Key_Flip 0x01100006
Qt::Key_Hangup 0x01100005 A key to end an ongoing call (see Qt::Key_ToggleCallHangup for a key to toggle current call state)
Qt::Key_No 0x01010002
Qt::Key_Select 0x01010000
Qt::Key_Yes 0x01010001
Qt::Key_ToggleCallHangup 0x01100007 A key to toggle the current call state (ie. either answer, or hangup) depending on current call state
Qt::Key_VoiceDial 0x01100008
Qt::Key_LastNumberRedial 0x01100009
Qt::Key_Execute 0x01020003
Qt::Key_Printer 0x01020002
Qt::Key_Play 0x01020005
Qt::Key_Sleep 0x01020004
Qt::Key_Zoom 0x01020006
Qt::Key_Cancel 0x01020001

另请参阅 QKeyEvent::key ().

enum Qt:: KeyboardModifier
flags Qt:: KeyboardModifiers

此枚举描述修饰符键。

常量 描述
Qt::NoModifier 0x00000000 未按下修饰符键。
Qt::ShiftModifier 0x02000000 按下键盘 Shift 键。
Qt::ControlModifier 0x04000000 按下键盘 Ctrl 键。
Qt::AltModifier 0x08000000 按下键盘 Alt 键。
Qt::MetaModifier 0x10000000 按下键盘 Meta 键。
Qt::KeypadModifier 0x20000000 按下 Keypad (小键盘) 按钮。
Qt::GroupSwitchModifier 0x40000000 X11 only. A Mode_switch key on the keyboard is pressed.

注意: On Mac OS X, the ControlModifier value corresponds to the Command keys on the Macintosh keyboard, and the MetaModifier 值相当于 Control 键。 KeypadModifier 值也将在按下方向键时设置,因为方向键被认为是 Keypad (小键盘) 的一部分。

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

KeyboardModifiers 类型是 typedef 对于 QFlags <KeyboardModifier>。它存储 KeyboardModifier 值的 OR 组合。

另请参阅 MouseButton and Modifier .

enum Qt:: LayoutDirection

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

常量 描述
Qt::LeftToRight 0 从左到右布局。
Qt::RightToLeft 1 从右到左布局。
Qt::LayoutDirectionAuto 2 自动布局。

从右到左的布局对于某些语言有必要,尤其是阿拉伯语和希伯来语。

LayoutDirectionAuto 服务 2 种目的。当与 Widget 和布局结合使用时,暗示使用的布局方向设置是在父级小部件或 QApplication 。这有相同效果如 QWidget::unsetLayoutDirection ().

当 LayoutDirectionAuto 与文本布局结合使用时,暗示文本的方向是由要布局的字符串内容确定的。

另请参阅 QApplication::setLayoutDirection (), QWidget::setLayoutDirection (), QTextOption::setTextDirection (),和 QString::isRightToLeft ().

enum Qt:: MaskMode

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

常量 描述
Qt::MaskInColor 0 创建匹配给定颜色的所有像素都不透明的遮罩。
Qt::MaskOutColor 1 创建匹配给定颜色的所有像素都透明的遮罩。

enum Qt:: MatchFlag
flags Qt:: MatchFlags

此枚举描述可以使用的匹配类型,当搜索模型项时。

常量 描述
Qt::MatchExactly 0 履行 QVariant 的基匹配。
Qt::MatchFixedString 8 履行基于字符串的匹配。基于字符串的比较不区分大小写,除非 MatchCaseSensitive 标志也有指定。
Qt::MatchContains 1 搜索术语包含在项中。
Qt::MatchStartsWith 2 搜索术语匹配项开头。
Qt::MatchEndsWith 3 搜索术语匹配项末尾。
Qt::MatchCaseSensitive 16 搜索区分大小写。
Qt::MatchRegExp 4 Performs string-based matching using a regular expression as the search term.
Qt::MatchWildcard 5 使用具有通配符的字符串作为搜索术语履行基于字符串的匹配。
Qt::MatchWrap 32 履行环绕搜索,因此,当搜索到达模型中的最后项时,再次从第一个项开始,并继续直到所有项被审查。
Qt::MatchRecursive 64 搜索整个层次结构。

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

另请参阅 QString::compare () 和 QRegExp .

enum Qt:: Modifier

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

注意: On Mac OS X, the CTRL value corresponds to the Command keys on the Macintosh keyboard, and the META 值相当于 Control 键。

常量 描述
Qt::SHIFT Qt::ShiftModifier 所有标准键盘都提供的 Shift 键。
Qt::META Qt::MetaModifier Meta 键。
Qt::CTRL Qt::ControlModifier Ctrl 键。
Qt::ALT Qt::AltModifier 正常 Alt 键,但不像 AltGr 键。
Qt::UNICODE_ACCEL 0x00000000 快捷方式被指定成 Unicode 代码点,而不是 Qt Key。

另请参阅 KeyboardModifier and MouseButton .

enum Qt:: MouseButton
flags Qt:: MouseButtons

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

常量 描述
Qt::NoButton 0x00000000 按钮状态不引用任何按钮 (见 QMouseEvent::button ()).
Qt::LeftButton 0x00000001 按下左按钮,或事件引用左按钮 (左按钮可能是左手鼠标的右按钮)。
Qt::RightButton 0x00000002 右边按钮。
Qt::MidButton 0x00000004 中间按钮。
Qt::MiddleButton MidButton 中间按钮。
Qt::XButton1 0x00000008 The first X button.
Qt::XButton2 0x00000010 The second X button.

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

另请参阅 KeyboardModifier and Modifier .

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

常量 描述
Qt::NavigationModeNone 0 仅用于触摸屏。
Qt::NavigationModeKeypadTabOrder 1 Qt::Key_Up and Qt::Key_Down 可用于改变焦点。
Qt::NavigationModeKeypadDirectional 2 Qt::Key_Up , Qt::Key_Down , Qt::Key_Left and Qt::Key_Right 可用于改变焦点。
Qt::NavigationModeCursorAuto 3 使用鼠标光标改变聚焦,仅显示在非触摸屏设备中。使用 Keypad (小键盘) 实现虚拟光标,除非设备拥有模拟鼠标类型的输入设备 (如:触摸板)。推荐设置这,对于需要在触摸和非触摸设备两者中进行指针控制的应用程序 (譬如 Web 浏览器) 而言。
Qt::NavigationModeCursorForceVisible 4 使用鼠标光标改变聚焦,它的显示不管设备类型。使用 Keypad (小键盘) 实现虚拟光标,除非设备拥有模拟鼠标类型的输入设备 (如:触摸板)

注意: : in 4.6, cursor navigation is only implemented for Symbian OS. On other platforms, it behaves as NavigationModeNone.

该枚举在 Qt 4.6 引入或被修改。

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

enum Qt:: Orientation
flags Qt:: Orientations

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

常量
Qt::Horizontal 0x1
Qt::Vertical 0x2

取向被用于 QScrollBar 例如。

取向类型是 typedef 对于 QFlags <Orientation>。它存储 Orientation 值的 OR 组合。

enum Qt:: PenCapStyle

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

Qt::SquareCap Qt::FlatCap Qt::RoundCap
常量 描述
Qt::FlatCap 0x00 方形线端不覆盖线端点。
Qt::SquareCap 0x10 方形线端覆盖端点并延伸超出端点一半线宽。
Qt::RoundCap 0x20 圆形线端。

另请参阅 QPen .

enum Qt:: PenJoinStyle

此枚举类型定义 Qt 所支持的钢笔联接样式,即可以绘制 2 连接线间的联接使用 QPainter .

Qt::BevelJoin Qt::MiterJoin Qt::RoundJoin
常量 描述
Qt::MiterJoin 0x00 线外部边缘按角度延伸相交,并填充此区域。
Qt::BevelJoin 0x40 填充 2 线条之间的三角形凹槽。
Qt::RoundJoin 0x80 填充 2 条线之间的弧形。
Qt::SvgMiterJoin 0x100 斜接联接对应的斜接联接定义在 SVG 1.2 Tiny 规范。

另请参阅 QPen .

enum Qt:: PenStyle

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

Qt::SolidLine Qt::DashLine Qt::DotLine
Qt::DashDotLine Qt::DashDotDotLine Qt::CustomDashLine
常量 描述
Qt::NoPen 0 根本没有线条。例如, QPainter::drawRect () 填充但不绘制任何边界线。
Qt::SolidLine 1 纯线条。
Qt::DashLine 2 由几像素分隔的虚线。
Qt::DotLine 3 由几像素分隔的点。
Qt::DashDotLine 4 点和虚线交替。
Qt::DashDotDotLine 5 1 虚线,2 点,1 虚线,2 点。
Qt::CustomDashLine 6 自定义模式的定义是使用 QPainterPathStroker::setDashPattern ().

另请参阅 QPen .

enum Qt:: ScrollBarPolicy

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

常量 描述
Qt::ScrollBarAsNeeded 0 QAbstractScrollArea 展示滚动条当要拟合内容太大时,否则不展示。这为默认。
Qt::ScrollBarAlwaysOff 1 QAbstractScrollArea 从不展示滚动条。
Qt::ScrollBarAlwaysOn 2 QAbstractScrollArea always shows a scroll bar.

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

enum Qt:: ShortcutContext

对于 QEvent::Shortcut 事件发生,快捷方式的键序列必须由用户在快捷方式处于活动状态的上下文中键入。可能的上下文是这些:

常量 描述
Qt::WidgetShortcut 0 快捷方式是活动的当其父级 Widget 拥有聚焦时。
Qt::WidgetWithChildrenShortcut 3 快捷方式活动,当其父级 Widget 或其任何子级拥有聚焦时。顶层 Widget 的子级不受此快捷上下文的影响,除了弹出窗口。
Qt::WindowShortcut 1 快捷方式活动,当其父级 Widget 是活动顶层窗口的逻辑子 Widget 时。
Qt::ApplicationShortcut 2 快捷方式活动,当应用程序的某一窗口活动时。

enum Qt:: SizeHint

此枚举用于 QGraphicsLayoutItem::sizeHint ()

常量 描述
Qt::MinimumSize 0 用于指定图形布局项的最小尺寸。
Qt::PreferredSize 1 用于指定图形布局项的首选尺寸。
Qt::MaximumSize 2 用于指定图形布局项的最大尺寸。
Qt::MinimumDescent 3 用于指定图形布局项中文本字符串的最小下降。

该枚举在 Qt 4.4 引入或被修改。

另请参阅 QGraphicsLayoutItem::sizeHint ().

enum Qt:: SizeMode

此枚举用于 QPainter::drawRoundedRect () 和 QPainterPath::addRoundedRect () 函数根据指定边界矩形的尺度,指定矩形角的半径。

常量 描述
Qt::AbsoluteSize 0 使用绝对度量指定尺寸。
Qt::RelativeSize 1 指定相对于边界矩形的大小,通常使用百分比度量。

该枚举在 Qt 4.4 引入或被修改。

enum Qt:: SortOrder

此枚举描述如何排序 Widget 项。

常量 描述
Qt::AscendingOrder 0 项按升序排序,如:在 Latin-1 区域设置中以 AAA 开始以 ZZZ 结束
Qt::DescendingOrder 1 项按降序排序,如在 Latin-1 区域设置中以 ZZZ 开始以 AAA 结束

enum Qt:: TextElideMode

此枚举指定应在哪里出现省略号,当显示不拟合文本时:

常量 描述
Qt::ElideLeft 0 省略号应出现在文本开头。
Qt::ElideRight 1 省略号应出现在文本末尾。
Qt::ElideMiddle 2 省略号应出现在文本中间。
Qt::ElideNone 3 省略号不应出现在文本中。

Qt::ElideMiddle 通常是 URL 的最合适选择 (如 http://bugreports.qt.../QTWEBSITE-13/ ),而 Qt::ElideRight 适合其它字符串 (如 " 部署应用程序在 Ma... ").

另请参阅 QAbstractItemView::textElideMode , QFontMetrics::elidedText (), AlignmentFlag ,和 QTabBar::elideMode .

enum Qt:: TextFlag

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

常量 描述
Qt::TextSingleLine 0x0100 将所有空白视为空格,且仅仅打印一行。
Qt::TextDontClip 0x0200 若不可能停留在给定边界内,就在外侧打印它。
Qt::TextExpandTabs 0x0400 使 U+0009 (ASCII Tab) 字符移到下一 Tab 处停止。
Qt::TextShowMnemonic 0x0800 将字符串 &P 显示成 P (见 QButton for an example). For an ampersand, use "&&".
Qt::TextWordWrap 0x1000 在适当位置断行,如:在单词边界。
Qt::TextWrapAnywhere 0x2000 在任何地方断行,甚至在单词内。
Qt::TextHideMnemonic 0x8000 如同 Qt::TextShowMnemonic 但不绘制下划线。
Qt::TextDontPrint 0x4000 将此文本视为被隐藏且不打印它。
Qt::IncludeTrailingSpaces TextIncludeTrailingSpaces 当此选项有设置时, QTextLine::naturalTextWidth () and naturalTextRect() will return a value that includes the width of trailing spaces in the text; otherwise this width is excluded.
Qt::TextIncludeTrailingSpaces 0x08000000 Same as IncludeTrailingSpaces
Qt::TextJustificationForced 0x10000 确保文本行两端对齐。

Ensures that the longest variant is always used when computing the size of a multi-variant string. (Internal)

可以使用多个修饰符标志如想要,除 Qt::TextSingleLine 和 Qt::TextWordWrap 无法组合外。

不适合给定用法的标志通常会被忽略。

enum Qt:: TextFormat

This enum is used in widgets that can display both plain text and rich text, e.g. QLabel . It is used for deciding whether a text string should be interpreted as one or the other. This is normally done by passing one of the enum values to a setTextFormat() function.

常量 描述
Qt::PlainText 0 文本字符串被解释成纯文本字符串。
Qt::RichText 1 The text string is interpreted as a rich text string.
Qt::AutoText 2 The text string is interpreted as for Qt::RichText if Qt::mightBeRichText() returns true, otherwise as Qt::PlainText.
Qt::LogText 3 A special, limited text format which is only used by Q3TextEdit in an optimized mode.

enum Qt:: TextInteractionFlag
flags Qt:: TextInteractionFlags

此枚举指定文本显示 Widget,如何应答用户输入。

常量 描述
Qt::NoTextInteraction 0 不可能与文本进行交互。
Qt::TextSelectableByMouse 1 可以采用鼠标选择文本,然后使用上下文菜单 (或标准键盘快捷键) 将其拷贝到剪贴板。
Qt::TextSelectableByKeyboard 2 可以采用键盘光标键选择文本。展示文本光标。
Qt::LinksAccessibleByMouse 4 可以采用鼠标突显和激活链接。
Qt::LinksAccessibleByKeyboard 8 可以使用 Tab 聚焦链接,并采用 Enter 激活它们。
Qt::TextEditable 16 文本是完全可编辑的。
Qt::TextEditorInteraction TextSelectableByMouse | TextSelectableByKeyboard | TextEditable 默认文本编辑器。
Qt::TextBrowserInteraction TextSelectableByMouse | LinksAccessibleByMouse | LinksAccessibleByKeyboard 默认为 QTextBrowser .

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

enum Qt:: TileRule

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

常量 描述
Qt::StretchTile 0 比例缩放图像以拟合可用区域。
Qt::RepeatTile 1 重复图像,直到没有更多空间。可能裁剪最后一个图像。
Qt::RoundTile 2 类似于 Repeat,但会缩小图像,以确保不裁剪最后一个平铺。

该枚举在 Qt 4.6 引入或被修改。

enum Qt:: TimeSpec

常量 描述
Qt::LocalTime 0 Locale dependent time (Timezones and Daylight Savings Time).
Qt::UTC 1 Coordinated Universal Time, replaces Greenwich Mean Time.
Qt::OffsetFromUTC 2 以秒为单位的 UTC (协调世界时) 偏移。

enum Qt:: ToolBarArea
flags Qt:: ToolBarAreas

常量
Qt::LeftToolBarArea 0x1
Qt::RightToolBarArea 0x2
Qt::TopToolBarArea 0x4
Qt::BottomToolBarArea 0x8
Qt::AllToolBarAreas ToolBarArea_Mask
Qt::NoToolBarArea 0

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

enum Qt:: ToolButtonStyle

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

常量 描述
Qt::ToolButtonIconOnly 0 只显示图标。
Qt::ToolButtonTextOnly 1 只显示文本。
Qt::ToolButtonTextBesideIcon 2 文本出现在图标旁边。
Qt::ToolButtonTextUnderIcon 3 文本出现在图标下方。
Qt::ToolButtonFollowStyle 4 遵循 style .

enum Qt:: TouchPointState
flags Qt:: TouchPointStates

This enum represents the state of a touch point at the time the QTouchEvent 出现。

常量 描述
Qt::TouchPointPressed 0x01 触摸点现在被按下。
Qt::TouchPointMoved 0x02 触摸点移动。
Qt::TouchPointStationary 0x04 触摸点不移动。
Qt::TouchPointReleased 0x08 触摸点被释放。

该枚举在 Qt 4.6 引入或被修改。

TouchPointStates 类型是 typedef 对于 QFlags <TouchPointState>。它存储 TouchPointState 值的 OR 组合。

enum Qt:: TransformationMode

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

常量 描述
Qt::FastTransformation 0 快速履行变换,没有平滑。
Qt::SmoothTransformation 1 使用双线性过滤,变换结果图像。

另请参阅 QImage::scaled ().

enum Qt:: UIEffect

此枚举描述可用 UI 效果。

默认情况下,Qt 将试着为每个效果使用特定平台桌面设置。使用 QApplication::setDesktopSettingsAware () 函数 (传递 false 作为自变量) 以阻止这,和 QApplication::setEffectEnabled () 以启用或禁用特定效果。

注意:所有效果被禁用,当运行在低于 16 位颜色深度的屏幕。

常量 描述
Qt::UI_AnimateMenu 1 展示动画菜单。
Qt::UI_FadeMenu 2 展示淡化菜单。
Qt::UI_AnimateCombo 3 展示动画组合框。
Qt::UI_AnimateTooltip 4 展示工具提示动画。
Qt::UI_FadeTooltip 5 展示工具提示淡化效果。
Qt::UI_AnimateToolBox 6 预留

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

typedef Qt:: WFlags

同义词 Qt::WindowFlags .

enum Qt:: WhiteSpaceMode

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

常量 描述
Qt::WhiteSpaceNormal 0 用于显示正常段落单词换行文本的空白模式。
Qt::WhiteSpacePre 1 准确重现空白的预格式化文本模式。
Qt::WhiteSpaceNoWrap 2

This enum is defined in the <QTextDocument> 头文件。

enum Qt:: WidgetAttribute

此枚举类型用于指定各种 Widget 属性。设置和清零属性采用 QWidget::setAttribute (),和查询采用 QWidget::testAttribute (),尽管有些拥有如下所述的特别方便功能。

常量 描述
Qt::WA_AcceptDrops 78 允许来自拖放操作的数据掉落到 Widget (见 QWidget::setAcceptDrops ()).
Qt::WA_AlwaysShowToolTips 84 为不活动窗口启用工具提示。
Qt::WA_ContentsPropagated 3 此标志多余且过时;不再有任何效果。从 Qt 4.1 起,未设置 WA_PaintOnScreen 的所有 Widget 会传播其内容。
Qt::WA_CustomWhatsThis 47 指示 Widget 想要在 What's This? 模式下继续正常运转。这由 Widget 作者设置。
Qt::WA_DeleteOnClose 55 使 Qt 删除此 Widget 当小部件接受关闭事件时 (见 QWidget::closeEvent ()).
Qt::WA_Disabled 0 指示 Widget 被禁用 (即:不接收任何鼠标/键盘事件)。还有 Getter 函数 QWidget::isEnabled ()。这由 Qt 内核设置 (或清零)。
Qt::WA_DontShowOnScreen 103 指示 Widget 被隐藏 (或不属于可查看桌面)。
Qt::WA_ForceDisabled 32 Indicates that the widget is explicitly disabled, i.e. it will remain disabled even when all its ancestors are set to the enabled state. This implies WA_Disabled. This is set/cleared by QWidget::setEnabled () 和 QWidget::setDisabled ().
Qt::WA_ForceUpdatesDisabled 59 Indicates that updates are explicitly disabled for the widget; i.e. it will remain disabled even when all its ancestors are set to the updates-enabled state. This implies WA_UpdatesDisabled. This is set/cleared by QWidget::setUpdatesEnabled ().
Qt::WA_GroupLeader 72 此属性已弃用。 使用 QWidget::windowModality 代替。
Qt::WA_Hover 74 强制 Qt 生成描绘事件,当鼠标进入或离开 Widget 时。通常使用此特征,当实现自定义样式时;见 样式 范例了解细节。
Qt::WA_InputMethodEnabled 14 Enables input methods for Asian languages. Must be set when creating custom text editing widgets. On Windows CE and Symbian this flag can be used in addition to QApplication::autoSipEnabled to automatically display the SIP when entering a widget.
Qt::WA_KeyboardFocusChange 77 设置顶层窗口,当用户采用键盘 (Tab、BackTab 或快捷键) 更改聚焦时。
Qt::WA_KeyCompression 33 启用键事件压缩,若设置;否则禁用,若未设置。默认情况下,键压缩是关闭的,因此每次按键 (或更多,因为自动重复通常是打开的) Widget 只接收一个键事件。若打开,而程序却跟不上键输入,Qt 可能试着去压缩键事件,以便在每个事件中可以处理多个字符。例如:单词处理程序 Widget 可能接收 2、3 或更多字符,在各 QKeyEvent::text (), if the layout recalculation takes too long for the CPU. If a widget supports multiple character unicode input, it is always safe to turn the compression on. Qt performs key event compression only for printable characters. Qt::Modifier keys, cursor movement keys, function keys and miscellaneous action keys (e.g. Escape, Enter, Backspace, PrintScreen) will stop key event compression, even if there are more compressible key events available. Platforms other than Mac and X11 do not support this compression, in which case turning it on will have no effect. This is set/cleared by the widget's author.
Qt::WA_LayoutOnEntireRect 48 指示 Widget 想要 QLayout 要运转于整个 QWidget::rect (),不仅在 QWidget::contentsRect ()。这是由 Widget 作者设置的。
Qt::WA_LayoutUsesWidgetRect 92 Ignore the layout item rect from the style when laying out this widget with QLayout . This makes a difference in QMacStyle and QPlastiqueStyle for some widgets.
Qt::WA_MacNoClickThrough 12 When a widget that has this attribute set is clicked, and its window is inactive, the click will make the window active but won't be seen by the widget. Typical use of this attribute is on widgets with "destructive" actions, such as a "Delete" button. WA_MacNoClickThrough also applies to all child widgets of the widget that has it set.
Qt::WA_MacOpaqueSizeGrip 85 Indicates that the native Carbon size grip should be opaque instead of transparent (the default). This attribute is only applicable to Mac OS X and is set by the widget's author.
Qt::WA_MacShowFocusRect 88 Indicates that this widget should get a QFocusFrame around it. Some widgets draw their own focus halo regardless of this attribute. Not that the QWidget::focusPolicy also plays the main role in whether something is given focus or not, this only controls whether or not this gets the focus frame. This attribute is only applicable to Mac OS X.
Qt::WA_MacNormalSize 89 Indicates the widget should have the normal size for widgets in Mac OS X. This attribute is only applicable to Mac OS X.
Qt::WA_MacSmallSize 90 Indicates the widget should have the small size for widgets in Mac OS X. This attribute is only applicable to Mac OS X.
Qt::WA_MacMiniSize 91 Indicates the widget should have the mini size for widgets in Mac OS X. This attribute is only applicable to Mac OS X.
Qt::WA_MacVariableSize 102 Indicates the widget can choose between alternative sizes for widgets to avoid clipping. This attribute is only applicable to Mac OS X.
Qt::WA_MacBrushedMetal 46 Indicates the widget should be drawn in the brushed metal style as supported by the windowing system. This attribute is only applicable to Mac OS X.
Qt::WA_Mapped 11 指示 Widget 已映射到屏幕。这由 Qt 内核设置/清零。
Qt::WA_MouseNoMask 71 Makes the widget receive mouse events for the entire widget regardless of the currently set mask, overriding QWidget::setMask (). This is not applicable for top-level windows.
Qt::WA_MouseTracking 2 指示 Widget 有启用鼠标追踪。见 QWidget::mouseTracking .
Qt::WA_Moved 43 指示 Widget 拥有明确位置。这的设置/清零通过 QWidget::move () 和通过 QWidget::setGeometry ().
Qt::WA_MSWindowsUseDirect3D 94 此值已过时且不起作用。
Qt::WA_NoBackground WA_OpaquePaintEvent 此值已过时。使用 WA_OpaquePaintEvent 代替。
Qt::WA_NoChildEventsForParent 58 Indicates that the widget does not want ChildAdded or ChildRemoved events sent to its parent. This is rarely necessary but can help to avoid automatic insertion widgets like splitters and layouts. This is set by a widget's author.
Qt::WA_NoChildEventsFromChildren 39 Indicates that the widget does not want to receive ChildAdded or ChildRemoved events sent from its children. This is set by a widget's author.
Qt::WA_NoMouseReplay 54 Used for pop-up widgets. Indicates that the most recent mouse press event should not be replayed when the pop-up widget closes. The flag is set by the widget's author and cleared by the Qt kernel every time the widget receives a new mouse event.
Qt::WA_NoMousePropagation 73 禁止将鼠标事件传播给 Widget 父级。此属性默认禁用。
Qt::WA_TransparentForMouseEvents 51 When enabled, this attribute disables the delivery of mouse events to the widget and its children. Mouse events are delivered to other widgets as if the widget and its children were not present in the widget hierarchy; mouse clicks and other events effectively "pass through" them. This attribute is disabled by default.
Qt::WA_NoSystemBackground 9 指示 Widget 没有背景 (即:当 Widget 接收描绘事件时,不自动重新绘制背景)。

注意: Unlike WA_OpaquePaintEvent, newly exposed areas are never 填充背景 (如:在首次展示窗口后,用户可以看穿它,直到应用程序处理描绘事件为止)。此标志由 Widget 作者设置或清零。

常量 描述
Qt::WA_OpaquePaintEvent 4 指示 Widget 描绘其所有像素,当它接收描绘事件时。因此,不需要采用 (像更新、重置尺寸、卷动及聚焦改变的) 操作擦除 Widget,在生成描绘事件之前。使用 WA_OpaquePaintEvent 提供小的优化,通过帮助缩减在不支持双缓冲的系统上的闪烁,并在描绘之前避免擦除背景必要的计算周期。

注意: Unlike WA_NoSystemBackground, WA_OpaquePaintEvent makes an effort to avoid transparent window backgrounds. This flag is set or cleared by the widget's author.

常量 描述
Qt::WA_OutsideWSRange 49 Indicates that the widget is outside the valid range of the window system's coordinate system. A widget outside the valid range cannot be mapped on screen. This is set/cleared by the Qt kernel.
Qt::WA_PaintOnScreen 8 指示 Widget 想要直接绘制到屏幕中。具有此属性设置的 Widget 不参与合成管理 (即:它们不可以半透明或透过半透明重叠 Widget 照射)。

注意: This flag is only supported on X11 and it disables double buffering. On Qt for Embedded Linux, the flag only works when set on a top-level widget and it relies on support from the active screen driver. This flag is set or cleared by the widget's author. To render outside of Qt's paint system, e.g., if you require native painting primitives, you need to reimplement QWidget::paintEngine () 以返回 0 并设置此标志。

常量 描述
Qt::WA_PaintOutsidePaintEvent 13 Makes it possible to use QPainter to paint on the widget outside paintEvent() . This flag is not supported on Windows, Mac OS X or Embedded Linux. We recommend that you use it only when porting Qt 3 code to Qt 4.
Qt::WA_PaintUnclipped 52 使不裁剪此 Widget 中的所有描绘器操作。此 Widget 或在其前面的其它小部件的子级不会裁剪描绘器可以在其中描绘的区域。此标志仅支持有设置 WA_PaintOnScreen 标志的 Widget。以跨平台方式做到这的首选办法,是创建位于其它 Widget 前面的透明小部件。
Qt::WA_PendingMoveEvent 34 指示移动事件待决 (如:隐藏 Widget 被移动时)。此标志由 Qt 内核设置 (或清零)。
Qt::WA_PendingResizeEvent 35 指示重置大小事件待决 (如:隐藏 Widget 被重置大小时)。此标志由 Qt 内核设置 (或清零)。
Qt::WA_QuitOnClose 76 Makes Qt quit the application when the last widget with the attribute set has accepted closeEvent(). This behavior can be modified with the QApplication::quitOnLastWindowClosed 特性。默认情况下,有设置此属性当 Widget 类型为 Qt::Window .
Qt::WA_Resized 42 Indicates that the widget has an explicit size. This flag is set or cleared by QWidget::resize () 和 QWidget::setGeometry ().
Qt::WA_RightToLeft 56 指示 Widget 的布局方向是从右到左。
Qt::WA_SetCursor 38 指示 Widget 拥有其自己的光标。此标志的设置或清零通过 QWidget::setCursor () 和 QWidget::unsetCursor ().
Qt::WA_SetFont 37 指示 Widget 拥有其自己的字体。此标志的设置或清零通过 QWidget::setFont ().
Qt::WA_SetPalette 36 指示 Widget 拥有其自己的调色板。此标志的设置或清零通过 QWidget::setPalette ().
Qt::WA_SetStyle 86 指示 Widget 拥有其自己的样式。此标志的设置或清零通过 QWidget::setStyle ().
Qt::WA_ShowModal 70 此属性已弃用。 使用 QWidget::windowModality 代替。
Qt::WA_StaticContents 5 指示 Widget 内容西北对齐且静态。当重置大小时,这种 Widget 只接收自身新近可见部分的描绘事件。此标志由 Widget 作者设置或清零。
Qt::WA_StyleSheet 97 指示 Widget 的样式化是使用 样式表 .
Qt::WA_TranslucentBackground 120 指示 Widget 应该拥有半透明背景,即:Widget 任何不透明区域会半透明,因为 Widget 将拥有 Alpha 通道。设置此标志导致要设置 WA_NoSystemBackground。在 Windows 小部件还需要 Qt::FramelessWindowHint 窗口标志被设置。此标志由 Widget 的作者设置或清零。
Qt::WA_UnderMouse 1 Indicates that the widget is under the mouse cursor. The value is not updated correctly during drag and drop operations. There is also a getter function, QWidget::underMouse (). This flag is set or cleared by the Qt kernel.
Qt::WA_UpdatesDisabled 10 Indicates that updates are blocked (including the system background). This flag is set or cleared by the Qt kernel.

警告: This flag must never be set or cleared by the widget's author.

常量 描述
Qt::WA_WindowModified 41 Indicates that the window is marked as modified. On some platforms this flag will do nothing, on others (including Mac OS X and Windows) the window will take a modified appearance. This flag is set or cleared by QWidget::setWindowModified ().
Qt::WA_WindowPropagation 80 Makes a toplevel window inherit font and palette from its parent.
Qt::WA_MacAlwaysShowToolWindow 96 On Mac OS X, show the tool window even when the application is not active. By default, all tool windows are hidden when the application is inactive.
Qt::WA_SetLocale 87 指示区域设置应考虑 Widget 注意事项。
Qt::WA_StyledBackground 93 指示应使用样式化背景绘制 Widget。
Qt::WA_ShowWithoutActivating 98 不使之活动展示 Widget。
Qt::WA_NativeWindow 100 Indicates that a native window is created for the widget. Enabling this flag will also force a native window for the widget's ancestors unless Qt::WA_DontCreateNativeAncestors is set.
Qt::WA_DontCreateNativeAncestors 101 Indicates that the widget's ancestors are kept non-native even though the widget itself is native.
Qt::WA_X11NetWmWindowTypeDesktop 104 Adds _NET_WM_WINDOW_TYPE_DESKTOP to the window's _NET_WM_WINDOW_TYPE X11 window property. See http://standards.freedesktop.org/wm-spec/ for more details. This attribute has no effect on non-X11 platforms.
Qt::WA_X11NetWmWindowTypeDock 105 Adds _NET_WM_WINDOW_TYPE_DOCK to the window's _NET_WM_WINDOW_TYPE X11 window property. See http://standards.freedesktop.org/wm-spec/ for more details. This attribute has no effect on non-X11 platforms.
Qt::WA_X11NetWmWindowTypeToolBar 106 Adds _NET_WM_WINDOW_TYPE_TOOLBAR to the window's _NET_WM_WINDOW_TYPE X11 window property. See http://standards.freedesktop.org/wm-spec/ for more details. This attribute has no effect on non-X11 platforms.

注意: Qt automaticaly sets this attribute for QToolBar .

常量 描述
Qt::WA_X11NetWmWindowTypeMenu 107 Adds _NET_WM_WINDOW_TYPE_MENU to the window's _NET_WM_WINDOW_TYPE X11 window property. See http://standards.freedesktop.org/wm-spec/ for more details. This attribute has no effect on non-X11 platforms.

注意: Qt automatically sets this attribute for QMenu when torn-off.

常量 描述
Qt::WA_X11NetWmWindowTypeUtility 108 Adds _NET_WM_WINDOW_TYPE_UTILITY to the window's _NET_WM_WINDOW_TYPE X11 window property. See http://standards.freedesktop.org/wm-spec/ for more details. This attribute has no effect on non-X11 platforms.

注意: Qt automatically sets this attribute for the Qt::Tool 窗口类型。

常量 描述
Qt::WA_X11NetWmWindowTypeSplash 109 Adds _NET_WM_WINDOW_TYPE_SPLASH to the window's _NET_WM_WINDOW_TYPE X11 window property. See http://standards.freedesktop.org/wm-spec/ for more details. This attribute has no effect on non-X11 platforms.

注意: Qt automatically sets this attribute for the Qt::SplashScreen 窗口类型。

常量 描述
Qt::WA_X11NetWmWindowTypeDialog 110 Adds _NET_WM_WINDOW_TYPE_DIALOG to the window's _NET_WM_WINDOW_TYPE X11 window property. See http://standards.freedesktop.org/wm-spec/ for more details. This attribute has no effect on non-X11 platforms.

注意: Qt automatically sets this attribute for the Qt::Dialog and Qt::Sheet 窗口类型。

常量 描述
Qt::WA_X11NetWmWindowTypeDropDownMenu 111 Adds _NET_WM_WINDOW_TYPE_DROPDOWN_MENU to the window's _NET_WM_WINDOW_TYPE X11 window property. See http://standards.freedesktop.org/wm-spec/ for more details. This attribute has no effect on non-X11 platforms.

注意: Qt automatically sets this attribute for QMenus added to a QMenuBar .

常量 描述
Qt::WA_X11NetWmWindowTypePopupMenu 112 Adds _NET_WM_WINDOW_TYPE_POPUP_MENU to the window's _NET_WM_WINDOW_TYPE X11 window property. See http://standards.freedesktop.org/wm-spec/ for more details. This attribute has no effect on non-X11 platforms.

注意: Qt automatically sets this attribute for QMenu .

常量 描述
Qt::WA_X11NetWmWindowTypeToolTip 113 Adds _NET_WM_WINDOW_TYPE_TOOLTIP to the window's _NET_WM_WINDOW_TYPE X11 window property. See http://standards.freedesktop.org/wm-spec/ for more details. This attribute has no effect on non-X11 platforms.

注意: Qt automatically sets this attribute for the Qt::ToolTip 窗口类型。

常量 描述
Qt::WA_X11NetWmWindowTypeNotification 114 Adds _NET_WM_WINDOW_TYPE_NOTIFICATION to the window's _NET_WM_WINDOW_TYPE X11 window property. See http://standards.freedesktop.org/wm-spec/ for more details. This attribute has no effect on non-X11 platforms.
Qt::WA_X11NetWmWindowTypeCombo 115 Adds _NET_WM_WINDOW_TYPE_COMBO to the window's _NET_WM_WINDOW_TYPE X11 window property. See http://standards.freedesktop.org/wm-spec/ for more details. This attribute has no effect on non-X11 platforms.

注意: Qt automatically sets this attribute for the QComboBox pop-up.

常量 描述
Qt::WA_X11NetWmWindowTypeDND 116 Adds _NET_WM_WINDOW_TYPE_DND to the window's _NET_WM_WINDOW_TYPE X11 window property. See http://standards.freedesktop.org/wm-spec/ for more details. This attribute has no effect on non-X11 platforms.

注意: Qt automatically sets this attribute on the feedback widget used during a drag.

常量 描述
Qt::WA_MacFrameworkScaled 117 Enables resolution independence aware mode on Mac when using Carbon. This attribute has no effect on Cocoa. The attribute is off by default and can be enabled on a per-window basis.
Qt::WA_AcceptTouchEvents 121 允许触摸事件 (见 QTouchEvent ) 发送给 Widget。必须在可以处理触摸事件的所有 Widget 中设置。不设置此属性,来自触摸设备的事件将作为鼠标事件被发送。
Qt::WA_TouchPadAcceptSingleTouchEvents 123 允许将触摸板单触摸事件发送给 Widget。
Qt::WA_MergeSoftkeys 124 Allows widget to merge softkeys with parent widget, i.e. widget can set only one softkeys and request softkey implementation to take rest of the softkeys from the parent. Note parents are traversed until WA_MergeSoftkeys is not set. See also Qt::WA_MergeSoftkeysRecursively This attribute currently has effect only on Symbian platforms
Qt::WA_MergeSoftkeysRecursively 125 Allows widget to merge softkeys recursively with all parents. If this attribute is set, the widget parents are traversed until window boundary (widget without parent or dialog) is found. This attribute currently has effect only on Symbian platforms
Qt::WA_X11DoNotAcceptFocus 132 Asks the window manager to not give focus to this top level window. This attribute has no effect on non-X11 platforms.
Qt::WA_LockPortraitOrientation 128 Locks the widget to a portrait orientation, ignoring changes to the display's orientation with respect to the user.
Qt::WA_LockLandscapeOrientation 129 Locks the widget to a landscape orientation, ignoring changes to the display's orientation with respect to the user.
Qt::WA_AutoOrientation 130 Causes the widget to change orientation whenever the display changes orientation with respect to the user.
Qt::WA_MacNoShadow 134 Since Qt 4.8, this attribute disables drop shadows for this top level window. Only affects Cocoa builds of Qt for Mac OS X.

enum Qt:: WindowFrameSection

此枚举用于描述窗口框架的各部分。它的返回是通过 QGraphicsWidget::windowFrameSectionAt () 描述窗口框架的什么部分在鼠标下。

常量
Qt::NoSection 0
Qt::LeftSection 1
Qt::TopLeftSection 2
Qt::TopSection 3
Qt::TopRightSection 4
Qt::RightSection 5
Qt::BottomRightSection 6
Qt::BottomSection 7
Qt::BottomLeftSection 8
Qt::TitleBarArea 9

该枚举在 Qt 4.4 引入或被修改。

另请参阅 QGraphicsWidget::windowFrameEvent (), QGraphicsWidget::paintWindowFrame (),和 QGraphicsWidget::windowFrameSectionAt ().

enum Qt:: WindowModality

此枚举指定模态窗口的行为。模态窗口是阻塞输入到其它窗口的一种窗口。注意:模态窗口的子级窗口不会阻塞。

值是:

常量 描述
Qt::NonModal 0 窗口非模态,且不阻塞对其它窗口的输入。
Qt::WindowModal 1 窗口对单个窗口层次结构是模态的,并阻塞其父级窗口、所有祖父级窗口,及其父级窗口和祖父级窗口的所有同级窗口的输入。
Qt::ApplicationModal 2 窗口对应用程序是模态的,且会阻塞所有窗口的输入。

另请参阅 QWidget::windowModality and QDialog .

enum Qt:: WindowState
flags Qt:: WindowStates

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

状态是

常量 描述
Qt::WindowNoState 0x00000000 窗口不拥有状态设置 (在正常状态下)。
Qt::WindowMinimized 0x00000001 窗口被最小化 (即:图标化)。
Qt::WindowMaximized 0x00000002 最大化具有围绕它的框架的窗口。
Qt::WindowFullScreen 0x00000004 窗口填充整个屏幕,没有任何框架围绕它。
Qt::WindowActive 0x00000008 窗口是活动窗口,即:它拥有键盘聚焦。

WindowStates 类型是 typedef 对于 QFlags <WindowState>。它存储 WindowState 值的 OR 组合。

enum Qt:: WindowType
flags Qt:: WindowFlags

此枚举类型用于为 Widget 指定各种窗口系统特性。它们相当不寻常,但在某些情况下是必要的。其中一些标志从属底层窗口管理器是否支持它们。

主要类型是

常量 描述
Qt::Widget 0x00000000 这是默认类型对于 QWidget 。此类型的 Widget 为子级小部件若它们拥有父级,和为独立窗口若它们没有父级。另请参阅 Qt::Window 和 Qt::SubWindow。
Qt::Window 0x00000001 指示 Widget 通常是具有窗口系统框架和标题栏的窗口,不管小部件是否有父级。注意,不可能取消设置此标志,若 Widget 没有父级。
Qt::Dialog 0x00000002 | Window 指示 Widget 是应被装饰成对话框的窗口 (即:标题栏中通常没有最大化或最小化按钮)。这是默认类型对于 QDialog 。若想要将它用作模态对话框,发起它应该是从另一窗口,或拥有父级且使用具有 QWidget::windowModality 特性。若使之模态化,对话框将阻止应用程序的其它顶层窗口获得任何输入。拥有父级的顶层窗口称为 secondary 窗口。
Qt::Sheet 0x00000004 | Window Indicates that the window is a Macintosh sheet. Since using a sheet implies window modality, the recommended way is to use QWidget::setWindowModality (),或 QDialog::open (),代替。
Qt::Drawer 0x00000006 | Window Indicates that the widget is a Macintosh drawer.
Qt::Popup 0x00000008 | Window 指示 Widget 是弹出顶层窗口 (即:它是模态的),但拥有适合弹出菜单的窗口系统框架。
Qt::Tool 0x0000000a | Window Indicates that the widget is a tool window. A tool window is often a small window with a smaller than usual title bar and decoration, typically used for collections of tool buttons. If there is a parent, the tool window will always be kept on top of it. If there isn't a parent, you may consider using Qt::WindowStaysOnTopHint as well. If the window system supports it, a tool window can be decorated with a somewhat lighter frame. It can also be combined with Qt::FramelessWindowHint.

On Mac OS X, tool windows correspond to the Floating class of windows. This means that the window lives on a level above normal windows; it impossible to put a normal window on top of it. By default, tool windows will disappear when the application is inactive. This can be controlled by the Qt::WA_MacAlwaysShowToolWindow 属性。
Qt::ToolTip 0x0000000c | Window 指示 Widget 是工具提示。这在内部使用以实现 tooltips .
Qt::SplashScreen 0x0000000e | Window 指示窗口是闪屏。这是默认类型对于 QSplashScreen .
Qt::Desktop 0x00000010 | Window 指示此 Widget 是桌面。这是类型为 QDesktopWidget .
Qt::SubWindow 0x00000012 指示此 Widget 是子窗口,譬如 QMdiSubWindow 小部件。

还有很多标志可以用于定制顶层窗口外观。这些对其它窗口不起作用:

常量 描述
Qt::MSWindowsFixedSizeDialogHint 0x00000100 在 Windows 赋予窗口很薄的对话框边框。此样式传统上用于固定大小的对话框。
Qt::MSWindowsOwnDC 0x00000200 在 Windows 赋予窗口自身显示上下文。
Qt::X11BypassWindowManagerHint 0x00000400 完全绕过窗口管理器。这导致根本不受管理的无边界窗口 (即,无键盘输入除非调用 QWidget::activateWindow () 手动)。
Qt::FramelessWindowHint 0x00000800 产生无边框窗口。用户无法凭借窗口系统移动无边框窗口或重置大小。在 X11,标志结果从属窗口管理器及其理解 Motif 和/或 NETWM 提示的能力。大多数现有的现代窗口管理器都可以处理这。

The CustomizeWindowHint 标志用于启用窗口控件的定制。必须设置此标志以允许 WindowTitleHint , WindowSystemMenuHint , WindowMinimizeButtonHint , WindowMaximizeButtonHint and WindowCloseButtonHint 标志的改变。

常量 描述
Qt::CustomizeWindowHint 0x02000000 关闭默认窗口标题提示。
Qt::WindowTitleHint 0x00001000 赋予窗口标题栏。
Qt::WindowSystemMenuHint 0x00002000 添加窗口系统菜单,可能还有关闭按钮 (例如在 Mac)。若需要隐藏 (或展示) 关闭按钮,更可移植是使用 WindowCloseButtonHint .
Qt::WindowMinimizeButtonHint 0x00004000 添加最小化按钮。在某些平台,为了它能工作这隐含 Qt:WindowSystemMenuHint。
Qt::WindowMaximizeButtonHint 0x00008000 添加最大化按钮。在某些平台,为了它能工作这隐含 Qt:WindowSystemMenuHint。
Qt::WindowMinMaxButtonsHint WindowMinimizeButtonHint | WindowMaximizeButtonHint 添加最小化和最大化按钮。在某些平台,为了它能工作这隐含 Qt:WindowSystemMenuHint。
Qt::WindowCloseButtonHint 0x08000000 添加关闭按钮。在某些平台,为了它能工作这隐含 Qt:WindowSystemMenuHint。
Qt::WindowContextHelpButtonHint 0x00010000 将上下文帮助按钮添加到对话框。 在某些平台,为了它能工作这隐含 Qt:WindowSystemMenuHint。
Qt::MacWindowToolBarButtonHint 0x10000000 On Mac OS X adds a tool bar button (i.e., the oblong button that is on the top right of windows that have toolbars).
Qt::BypassGraphicsProxyWidget 0x20000000 阻止窗口及其子级自动将自身嵌入 QGraphicsProxyWidget 若父级 Widget 已嵌入。可以设置此标志若想要 Widget 始终是桌面顶层小部件,不管父级 Widget 是否嵌入场景。
Qt::WindowShadeButtonHint 0x00020000
Qt::WindowStaysOnTopHint 0x00040000 告知窗口系统窗口应停留在所有其它窗口之上。注意:在某些 X11 窗口管理器中,还必须传递 Qt::X11BypassWindowManagerHint 为此标志能正确工作。
Qt::WindowStaysOnBottomHint 0x04000000 Informs the window system that the window should stay on bottom of all other windows. Note that on X11 this hint will work only in window managers that support _NET_WM_STATE_BELOW atom. If a window always on the bottom has a parent, the parent will also be left on the bottom. This window hint is currently not implemented for Mac OS X.
Qt::WindowOkButtonHint 0x00080000 Adds an OK button to the window decoration of a dialog. Only supported for Windows CE.
Qt::WindowCancelButtonHint 0x00100000 Adds a Cancel button to the window decoration of a dialog. Only supported for Windows CE.
Qt::WindowSoftkeysVisibleHint 0x40000000 Makes softkeys visible when widget is fullscreen. Only supported for Symbian.
Qt::WindowSoftkeysRespondHint 0x80000000 Makes softkeys to receive key events even when invisible. With this hint the softkey actions are triggered even the softkeys are invisible i.e. the window is displayed with showFullscreen() . Only supported for Symbian.
Qt::WindowType_Mask 0x000000ff 用于提取窗口标志的窗口类型部分的掩码。

Obsolete flags:

常量 描述
Qt::WMouseNoMask 0x00080000 使用 Qt::WA_MouseNoMask 代替。
Qt::WDestructiveClose 0x00100000 使用 Qt::WA_DeleteOnClose 代替。
Qt::WStaticContents 0x00200000 使用 Qt::WA_StaticContents 代替。
Qt::WGroupLeader 0x00400000 No longer needed.
Qt::WShowModal 0x00800000 使用 QWidget::windowModality 代替。
Qt::WNoMousePropagation 0x01000000 使用 Qt::WA_NoMousePropagation 代替。
Qt::WType_TopLevel Window Use Qt::Window instead.
Qt::WType_Dialog Dialog Use Qt::Dialog instead.
Qt::WType_Popup Popup Use Qt::Popup instead.
Qt::WType_Desktop 桌面 Use Qt::Desktop instead.
Qt::WType_Mask WindowType_Mask Use Qt::WindowType_Mask instead.
Qt::WStyle_Customize 0 No longer needed.
Qt::WStyle_NormalBorder 0 No longer needed.
Qt::WStyle_DialogBorder MSWindowsFixedSizeDialogHint Use Qt::MSWindowsFixedSizeDialogHint instead.
Qt::WStyle_NoBorder FramelessWindowHint Use Qt::FramelessWindowHint instead.
Qt::WStyle_Title WindowTitleHint Use Qt::WindowTitleHint instead.
Qt::WStyle_SysMenu WindowSystemMenuHint Use Qt::WindowSystemMenuHint instead.
Qt::WStyle_Minimize WindowMinimizeButtonHint Use Qt::WindowMinimizeButtonHint instead.
Qt::WStyle_Maximize WindowMaximizeButtonHint Use Qt::WindowMaximizeButtonHint instead.
Qt::WStyle_MinMax WStyle_Minimize | WStyle_Maximize Use Qt::WindowMinMaxButtonsHint instead.
Qt::WStyle_Tool 工具 Use Qt::Tool instead.
Qt::WStyle_StaysOnTop WindowStaysOnTopHint Use Qt::WindowStaysOnTopHint instead.
Qt::WStyle_ContextHelp WindowContextHelpButtonHint Use Qt::WindowContextHelpButtonHint instead.
Qt::WPaintDesktop 0 No longer needed.
Qt::WPaintClever 0 No longer needed.
Qt::WX11BypassWM X11BypassWindowManagerHint Use Qt::X11BypassWindowManagerHint instead.
Qt::WWinOwnDC MSWindowsOwnDC Use Qt::MSWindowsOwnDC instead.
Qt::WMacSheet Sheet Use Qt::Sheet instead.
Qt::WMacDrawer Drawer Use Qt::Drawer instead.
Qt::WStyle_Splash SplashScreen Use Qt::SplashScreen instead.
Qt::WNoAutoErase 0 No longer needed.
Qt::WRepaintNoErase 0 No longer needed.
Qt::WNorthWestGravity WStaticContents 使用 Qt::WA_StaticContents 代替。
Qt::WType_Modal Dialog | WShowModal Use Qt::Dialog and QWidget::windowModality 代替。
Qt::WStyle_Dialog Dialog Use Qt::Dialog instead.
Qt::WStyle_NoBorderEx FramelessWindowHint Use Qt::FramelessWindowHint instead.
Qt::WResizeNoErase 0 No longer needed.
Qt::WMacNoSheet 0 No longer needed.

WindowFlags 类型是 typedef 对于 QFlags <WindowType>。它存储 WindowType 值的 OR 组合。

另请参阅 QWidget::windowFlags and 窗口标志范例 .

函数文档编制

QString Qt:: convertFromPlainText (const QString & plain , WhiteSpaceMode mode = WhiteSpacePre)

转换纯文本字符串 plain 到 HTML 格式段落,同时保留其大部分外观。

mode 定义如何处理空白。

此函数的定义在 <QTextDocument> 头文件。

另请参阅 escape () 和 mightBeRichText ().

QString Qt:: escape (const QString & plain )

转换纯文本字符串 plain to a HTML string with HTML metacharacters < , > , & ,和 " replaced by HTML entities.

范例:

QString plain = "#include <QtCore>"
QString html = Qt::escape(plain);
// html == "#include <QtCore>"
					

此函数的定义在 <QTextDocument> 头文件。

另请参阅 convertFromPlainText () 和 mightBeRichText ().

bool Qt:: mightBeRichText (const QString & text )

Returns true if the string text is likely to be rich text; otherwise returns false.

该函数使用快速,因此会简单试探。它主要校验第一换行符之前,是否存在看起来像标记的东西。尽管对于常见情况,结果可能是正确的,但不保证。

此函数的定义在 <QTextDocument> 头文件。