diff options
Diffstat (limited to 'src/corelib/global/qnamespace.qdoc')
| -rw-r--r-- | src/corelib/global/qnamespace.qdoc | 431 |
1 files changed, 292 insertions, 139 deletions
diff --git a/src/corelib/global/qnamespace.qdoc b/src/corelib/global/qnamespace.qdoc index b5d44cb1cb..ddfade675a 100644 --- a/src/corelib/global/qnamespace.qdoc +++ b/src/corelib/global/qnamespace.qdoc @@ -1,30 +1,6 @@ -/**************************************************************************** -** -** Copyright (C) 2020 The Qt Company Ltd. -** Copyright (C) 2020 Klaralvdalens Datakonsult AB, a KDAB Group company, info@kdab.com, author Giuseppe D'Angelo <giuseppe.dangelo@kdab.com> -** Contact: https://www.qt.io/licensing/ -** -** This file is part of the documentation of the Qt Toolkit. -** -** $QT_BEGIN_LICENSE:FDL$ -** Commercial License Usage -** Licensees holding valid commercial Qt licenses may use this file in -** accordance with the commercial license agreement provided with the -** Software or, alternatively, in accordance with the terms contained in -** a written agreement between you and The Qt Company. For licensing terms -** and conditions see https://www.qt.io/terms-conditions. For further -** information use the contact form at https://www.qt.io/contact-us. -** -** GNU Free Documentation License Usage -** Alternatively, this file may be used under the terms of the GNU Free -** Documentation License version 1.3 as published by the Free Software -** Foundation and appearing in the file included in the packaging of -** this file. Please review the following information to ensure -** the GNU Free Documentation License version 1.3 requirements -** will be met: https://www.gnu.org/licenses/fdl-1.3.html. -** $QT_END_LICENSE$ -** -****************************************************************************/ +// Copyright (C) 2022 The Qt Company Ltd. +// Copyright (C) 2020 Klaralvdalens Datakonsult AB, a KDAB Group company, info@kdab.com, author Giuseppe D'Angelo <giuseppe.dangelo@kdab.com> +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! \namespace Qt @@ -108,6 +84,19 @@ QCoreApplication::testAttribute(). + \value [since 6.7] AA_QtQuickUseDefaultSizePolicy Qt Quick Layouts use the built-in size + policy of \l Item. For example, when this is set, \l Button fills the available + width, but has a fixed height. When this is not set, it will use the default + sizing behavior of the layout it's in, which is to use its implicit size as the + preferred size. This is explained in detail in \l {Specifying preferred size} and + \l {Size constraints}. When this is set, the default size policy of the item + with the layout can be overridden by explicitly setting + \l{Layout::fillWidth}{Layout.fillWidth} or + \l{Layout::fillHeight}{Layout.fillHeight}. + \b Note: This API is considered tech preview and may change or be removed in future + versions of Qt. + + \value AA_DontShowIconsInMenus Actions with the Icon property won't be shown in any menus unless specifically set by the QAction::iconVisibleInMenu property. @@ -118,7 +107,11 @@ \value AA_DontShowShortcutsInContextMenus Actions with the Shortcut property won't be shown in any shortcut menus unless specifically set by the QAction::shortcutVisibleInContextMenu property. This value was added - in Qt 5.10. + in Qt 5.10, and is by default based on the value reported by + QStyleHints::showShortcutsInContextMenus(). To override the default + behavior, set the style hint before QCoreApplication has been + instantiated, or set this attribute after QCoreApplication has + been instantiated. \value AA_NativeWindows Ensures that widgets have native windows. @@ -140,15 +133,15 @@ set to true won't be used as a native menubar (e.g, the menubar at the top of the main screen on \macos). - \value AA_MacDontSwapCtrlAndMeta Keyboard shortcuts on \macos are typically + \value AA_MacDontSwapCtrlAndMeta Keyboard shortcuts on Apple platforms are typically based on the Command (or Cmd) keyboard modifier, represented by the ⌘ symbol. For example, the 'Copy' action is Command+C (⌘+C). To ease cross platform development Qt will by default remap Command to the Qt::ControlModifier, to align with other platforms. This allows creating keyboard shortcuts such as "Ctrl+J", which on \macos will then map to Command+J, as expected by \macos users. The - actual Control (or Ctrl) modifier on \macos, represented by ⌃, is - mapped to Qt::MetaModifier. + actual Control (or Ctrl) modifier on Apple platforms, represented by ⌃, + is mapped to Qt::MetaModifier. When this attribute is true Qt will not do the remapping, and pressing the Command modifier will result in Qt::MetaModifier, while pressing @@ -211,9 +204,9 @@ \value AA_UseStyleSheetPropagationInWidgetStyles By default, Qt Style Sheets disable regular QWidget palette and font propagation. When this flag - is enabled, font and palette changes propagate as though the user had - manually called the corresponding QWidget methods. See - \l{The Style Sheet Syntax#Inheritance}{The Style Sheet Syntax - Inheritance} + is enabled, font and palette changes done from a style sheet will propagate + a single time, when the style sheet is set. + See \l{The Style Sheet Syntax#Inheritance}{The Style Sheet Syntax - Inheritance} for more details. This value was added in Qt 5.7. @@ -262,10 +255,10 @@ on disk. By default Qt Quick, QPainter's OpenGL backend, and any application using QOpenGLShaderProgram with one of its \e addCacheableShaderFromSource overloads will employ a disk-based - \l{Caching Program Binaries}{program binary cache} in either the shared - or per-process cache storage location, on systems that support - \e glProgramBinary(). In the unlikely event of this being problematic, - set this attribute to disable all disk-based caching of shaders. + program binary cache in either the shared or per-process cache storage + location, on systems that support \e glProgramBinary(). In the unlikely + event of this being problematic, set this attribute to disable all + disk-based caching of shaders. \value AA_DisableSessionManager Disables the QSessionManager. By default Qt will connect to a running session manager for a GUI @@ -280,6 +273,17 @@ Currently supported on the Windows platform only. This value was added in 5.15 + \value AA_DontUseNativeMenuWindows Menu popup windows (e.g. context menus, + combo box menus, and non-native menubar menus) created while this + attribute is set to true will not be represented as native top + level windows, unless required by the implementation. + This value was added in Qt 6.8. + + \value AA_DontUsePopupWindows When this attribute is set, popups will always appear + as items in the scene, rather than having their own dedicated windows. + Setting this attribute will only affect Qt Quick applications. + This value was added in Qt 6.8. + \omitvalue AA_AttributeCount \omitvalue AA_EnableHighDpiScaling \omitvalue AA_UseHighDpiPixmaps @@ -637,7 +641,7 @@ connection types, using a bitwise OR. When Qt::UniqueConnection is set, QObject::connect() will fail if the connection already exists (i.e. if the same signal is already connected to the same slot - for the same pair of objects). This flag was introduced in Qt 4.6. + for the same pair of objects). \value SingleShotConnection This is a flag that can be combined with any one of the above @@ -664,48 +668,111 @@ /*! \enum Qt::DateFormat - \value TextDate 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 names in English. This is basically equivalent to using the date format - string, "ddd MMM d yyyy". See QDate::toString() for more information. - - \value ISODate \l{ISO 8601} extended format: either \c{yyyy-MM-dd} for dates or - \c{yyyy-MM-ddTHH:mm:ss} (e.g. 2017-07-24T15:46:29), or with a time-zone - suffix (Z for UTC otherwise an offset as [+|-]HH:mm) where appropriate - for combined dates and times. - - \value ISODateWithMs \l{ISO 8601} extended format, including milliseconds if applicable. - - \value RFC2822Date \l{RFC 2822}, \l{RFC 850} and \l{RFC 1036} format: - either \c{[ddd,] dd MMM yyyy [HH:mm[:ss]][ ±tzoff]} - or \c{ddd MMM dd[ HH:mm:ss] yyyy[ ±tzoff]} are recognized for combined dates - and times, where \c{tzoff} is a timezone offset in \c{HHmm} format. For - dates and times separately, the same formats are matched and the unwanted - parts are ignored. In particular, note that a time is not recognized without - an accompanying date. When converting dates to string form, - format \c{dd MMM yyyy} is used, for times the format is \c{HH:mm:ss}. For - combined date and time, these are combined + \value TextDate 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 names in English (C locale). This effectively uses, for + a date, format \c{ddd MMM d yyyy}, for a time \c{HH:mm:ss} and combines + these as \c{ddd MMM d HH:mm:ss yyyy} for a date-time, with an optional + zone-offset suffix, where relevant. When reading from a string, a + fractional part is also recognized on the seconds of a time part, as + \c{HH:mm:ss.zzz}, and some minor variants on the format may be recognized, + for compatibility with earlier versions of Qt and with changes to the format + planned for the future. In particular, the zone-offset suffix presently uses + \c{GMT[±tzoff]} with a \c{tzoff} in \c{HH[[:]mm]} format (two-digit hour and + optional two-digit minutes, with optional colon separator); this shall + change to use \c{UTC} in place of \c{GMT} in a future release of Qt, so the + planned \c{UTC} format is recognized. + + \value ISODateWithMs \l{ISO 8601} extended format: uses \c{yyyy-MM-dd} for + dates, \c{HH:mm:ss.zzz} for times or \c{yyyy-MM-ddTHH:mm:ss.zzz} + (e.g. 2017-07-24T15:46:29.739) for combined dates and times, optionally with + a time-zone suffix (Z for UTC otherwise an offset as ±HH:mm) where + appropriate. When parsed, a single space, \c{' '}, may be used in place of + the \c{'T'} separator between date and time; no other spacing characters are + permitted. This format also accepts \c{HH:mm} and plain \c{HH} formats for + the time part, either of which may include a fractional part, \c{HH:mm.zzz} + or \c{HH.zzz}, applied to the last field present (hour or minute). + + \value ISODate \l{ISO 8601} extended format, as for \c ISODateWithMs, but + omitting the milliseconds (\c{.zzz}) part when converting to a string. There + is no difference when reading from a string: if a fractional part is present + on the last time field, either format will accept it. + + \value RFC2822Date \l{RFC 2822}, \l{RFC 850} and \l{RFC 1036} format: when + converting dates to string form, format \c{dd MMM yyyy} is used, for times + the format is \c{HH:mm:ss}. For combined date and time, these are combined as \c{dd MMM yyyy HH:mm:ss ±tzoff} (omitting the optional leading day of the - week from the first format recognized). + week from the first format recognized). When reading from a string either + \c{[ddd,] dd MMM yyyy [HH:mm[:ss]][ ±tzoff]} or \c{ddd MMM dd[ HH:mm:ss] + yyyy[ ±tzoff]} will be recognized for combined dates and times, where + \c{tzoff} is a timezone offset in \c{HHmm} format. Arbitrary spacing may + appear before or after the text and any non-empty spacing may replace the + spaces in this format. For dates and times separately, the same formats are + matched and the unwanted parts are ignored. In particular, note that a time + is not recognized without an accompanying date. \note For \c ISODate formats, each \c y, \c M and \c d represents a single digit of the year, month, and day used to specify the date. Each \c H, \c m, and \c s represents a single digit of the hour (up to 24), minute and second - used to specify the time. The presence of a literal \c T character is used - to separate the date and time when both are specified. For the \c - RFC2822Date format, MMM stands for the first three letters of the month name - in English, the other format characters have the same meaning as for the - ISODate format. + used to specify the time. An hour of 24, with zero for all other time + fields, is understood as the start of the next day. A \c{.zzz} stands for a + fractional part suffix on the preceding field, which may be separated from + that field either by a comma \c{','} or the dot \c{'.'} shown. Precision + beyond milliseconds is accepted but discarded, rounding to the nearest + representable millisecond. The presence of a literal \c T character is used + to separate the date and time when both are specified. For the \c TextDate + and \c RFC2822Date formats, \c{ddd} stands for the first three letters of + the name of the day of the week and \c{MMM} stands for the first three + letters of the month name. The names of days and months are always in + English (C locale) regardless of user preferences or system settings. The + other format characters have the same meaning as for the ISODate format, + except that 24 is not accepted as an hour. Parts of a format enclosed in + square brackets \c{[...]} are optional; the square brackets do not form part + of the format. The plus-or-minus character \c{'±'} here stands for either + sign character, \c{'-'} for minus or \c{'+'} for plus. + + \note Zone offsets are measured positive to the east of Greenwich, negative + to the west, as is usual for UTC-based offset notations (conflicting with + some GMT-based zones-names, such as \c{Etc/GMT+3}, which use the opposite + convention). + + \sa QDate::toString(), QTime::toString(), QDateTime::toString(), + QDate::fromString(), QTime::fromString(), QDateTime::fromString() */ - /*! \enum Qt::TimeSpec - \value LocalTime Locale dependent time (Timezones and Daylight Savings Time). - \value UTC Coordinated Universal Time, replaces Greenwich Mean Time. + \value LocalTime Local time, controlled by a system time-zone setting. + \value UTC Coordinated Universal Time. \value OffsetFromUTC An offset in seconds from Coordinated Universal Time. - \value TimeZone A named time zone using a specific set of Daylight Savings rules. + \value TimeZone A named time zone. + + Both LocalTime and TimeZone will take care of transitions, such as + the start and end of daylight-saving time. UTC is the standard + time relative to which time-zones are usually specified: Greenwich + Mean Time has zero offset from it. Neither UTC nor OffsetFromUTC + has any transitions. + + When specifying a datetime using OffsetFromUTC, the offset from UTC must + also be supplied (it is measured in seconds). To specify a datetime using + TimeZone, a QTimeZone must be supplied. From Qt 6.5, a QTimeZone can now + package a timespec with, where needed, an offset as a lightweight time + description, so that passing a QTimeZone now provides a uniform way to use + datetime APIs, saving the need to call them differently for different + timespecs. + + \note After a change to the system time-zone setting, the behavior + of LocalTime-based QDateTime objects created before the change is + undefined: QDateTime may have cached data that the change + invalidates. (This is not triggered by \e transitions of the system + time-zone.) In long-running processes, updates to the system's + time-zone data (e.g. when politicians change the rules for a zone) + may likewise lead to conflicts between the updated time-zone + information and data cached by QDateTime objects created before + the update, using either LocalTime or TimeZone. + + \sa QTimeZone, QDateTime */ /*! @@ -743,14 +810,29 @@ /*! \enum Qt::DockWidgetArea - \value LeftDockWidgetArea - \value RightDockWidgetArea - \value TopDockWidgetArea - \value BottomDockWidgetArea - \value AllDockWidgetAreas - \value NoDockWidgetArea + Represents the areas a QDockWidget can be plugged to. + \note A floating dock widget with tabs can be docked anywhere. + + \value LeftDockWidgetArea The left dock area of a QMainWindow. + \value RightDockWidgetArea The right dock area of a QMainWindow. + \value TopDockWidgetArea The top dock area of a QMainWindow. + \value BottomDockWidgetArea The bottom dock area of a QMainWindow. + \value AllDockWidgetAreas All dock widget areas (default). + \value NoDockWidgetArea No dock widget areas. \omitvalue DockWidgetArea_Mask + \sa QDockWidget::setAllowedAreas, QDockWidget::isAreaAllowed +*/ + +/*! + \enum Qt::ColorScheme + + Represents the appearance of an application's theme, + defined by QGuiApplication::palette(). + + \value Unknown The appearance is unknown. + \value Light The background colors are lighter than the text color, i.e. the theme is light. + \value Dark The background colors are darker than the text color, i.e. the theme is dark. */ /*! @@ -920,13 +1002,9 @@ This implies WA_UpdatesDisabled. This is set/cleared by QWidget::setUpdatesEnabled(). - \value WA_GroupLeader \e{This attribute has been deprecated.} Use - QWidget::windowModality instead. - \value WA_Hover Forces Qt to generate paint events when the mouse enters or leaves the widget. This feature is typically used when - implementing custom styles; see the \l{widgets/styles}{Styles} - example for details. + implementing custom styles. \value WA_InputMethodEnabled Enables input methods for Asian languages. Must be set when creating custom text editing widgets. @@ -985,10 +1063,6 @@ size for widgets in \macos. This attribute is only applicable to \macos. - \value WA_MacVariableSize Indicates the widget can choose between - alternative sizes for widgets to avoid clipping. - This attribute is only applicable to \macos. - \value WA_Mapped Indicates that the widget is mapped on screen. This is set/cleared by the Qt kernel. @@ -1078,10 +1152,10 @@ e.g., when a hidden widget was resized. This flag is set or cleared by the Qt kernel. - \value WA_QuitOnClose 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 property. By default - this attribute is set for all widgets of type Qt::Window. + \value WA_QuitOnClose Indicates that the widget should be taken into account + when deciding whether to quit the application when the last window is closed. + This behavior can be modified with the QGuiApplication::quitOnLastWindowClosed + property. By default this attribute is set for all widgets of type Qt::Window. \value WA_Resized Indicates that the widget has an explicit size. This flag is set or cleared by QWidget::resize() and QWidget::setGeometry(). @@ -1124,9 +1198,12 @@ \value WA_TranslucentBackground Indicates that the widget should have a translucent background, i.e., any non-opaque regions of the widgets will be translucent because the widget will have an alpha channel. Setting this - flag causes WA_NoSystemBackground to be set. On Windows the - widget also needs the Qt::FramelessWindowHint window flag to be set. - This flag is set or cleared by the widget's author. + flag causes WA_NoSystemBackground to be set. On Windows the widget also + needs the Qt::FramelessWindowHint window flag to be set. This flag is set + or cleared by the widget's author. As of Qt 5.0, toggling this attribute + after the widget has been shown is not uniformly supported across + platforms. When translucent background is desired, set the attribute early + when creating the widget, and avoid altering it afterwards. \value WA_UnderMouse Indicates that the widget is under the mouse cursor. The value is not updated correctly during drag and drop operations. There @@ -1252,7 +1329,7 @@ to this top level window. This attribute has no effect on non-X11 platforms. - \value WA_AlwaysStackOnTop Since Qt 5.4, this value forces QOpenGLWidget and + \value [since 5.4] WA_AlwaysStackOnTop Forces QOpenGLWidget and QQuickWidget to be drawn last, on top of other widgets. Ignored for other type of widgets. Setting this attribute breaks the stacking order, but allows having a semi-transparent OpenGL widget with other widgets visible @@ -1287,7 +1364,6 @@ \omitvalue WA_WState_ExplicitShowHide \omitvalue WA_InputMethodTransparent \omitvalue WA_DropSiteRegistered - \omitvalue WA_ForceAcceptDrops \omitvalue WA_NoX11EventCompression \omitvalue WA_TintedBackground \omitvalue WA_X11OpenGLOverlay @@ -1297,7 +1373,6 @@ \omitvalue WA_SetWindowModality \omitvalue WA_WState_WindowOpacitySet \omitvalue WA_WState_AcceptedTouchBeginEvent - \omitvalue WA_MacNoShadow \omitvalue WA_StyleSheet \omitvalue WA_AttributeCount */ @@ -1390,6 +1465,7 @@ \value Key_Help \value Key_Direction_L \value Key_Direction_R + \value Key_Space \value Key_Any \value Key_Exclam @@ -1481,7 +1557,8 @@ \value Key_twosuperior \value Key_threesuperior \value Key_acute - \value Key_mu + \value [since 6.7] Key_micro + \value Key_mu Deprecated alias for Key_micro \value Key_paragraph \value Key_periodcentered \value Key_cedilla @@ -1526,6 +1603,7 @@ \value Key_ssharp \value Key_division \value Key_ydiaeresis + \value Key_Multi_key \value Key_Codeinput \value Key_SingleCandidate @@ -1634,24 +1712,24 @@ \value Key_OpenUrl \value Key_LaunchMail \value Key_LaunchMedia - \value Key_Launch0 On X11 this key is mapped to "My Computer" (XF86XK_MyComputer) key for legacy reasons. - \value Key_Launch1 On X11 this key is mapped to "Calculator" (XF86XK_Calculator) key for legacy reasons. - \value Key_Launch2 On X11 this key is mapped to XF86XK_Launch0 key for legacy reasons. - \value Key_Launch3 On X11 this key is mapped to XF86XK_Launch1 key for legacy reasons. - \value Key_Launch4 On X11 this key is mapped to XF86XK_Launch2 key for legacy reasons. - \value Key_Launch5 On X11 this key is mapped to XF86XK_Launch3 key for legacy reasons. - \value Key_Launch6 On X11 this key is mapped to XF86XK_Launch4 key for legacy reasons. - \value Key_Launch7 On X11 this key is mapped to XF86XK_Launch5 key for legacy reasons. - \value Key_Launch8 On X11 this key is mapped to XF86XK_Launch6 key for legacy reasons. - \value Key_Launch9 On X11 this key is mapped to XF86XK_Launch7 key for legacy reasons. - \value Key_LaunchA On X11 this key is mapped to XF86XK_Launch8 key for legacy reasons. - \value Key_LaunchB On X11 this key is mapped to XF86XK_Launch9 key for legacy reasons. - \value Key_LaunchC On X11 this key is mapped to XF86XK_LaunchA key for legacy reasons. - \value Key_LaunchD On X11 this key is mapped to XF86XK_LaunchB key for legacy reasons. - \value Key_LaunchE On X11 this key is mapped to XF86XK_LaunchC key for legacy reasons. - \value Key_LaunchF On X11 this key is mapped to XF86XK_LaunchD key for legacy reasons. - \value Key_LaunchG On X11 this key is mapped to XF86XK_LaunchE key for legacy reasons. - \value Key_LaunchH On X11 this key is mapped to XF86XK_LaunchF key for legacy reasons. + \value Key_Launch0 + \value Key_Launch1 + \value Key_Launch2 + \value Key_Launch3 + \value Key_Launch4 + \value Key_Launch5 + \value Key_Launch6 + \value Key_Launch7 + \value Key_Launch8 + \value Key_Launch9 + \value Key_LaunchA + \value Key_LaunchB + \value Key_LaunchC + \value Key_LaunchD + \value Key_LaunchE + \value Key_LaunchF + \value Key_LaunchG + \value Key_LaunchH \value Key_MonBrightnessUp \value Key_MonBrightnessDown \value Key_KeyboardLightOnOff @@ -1677,7 +1755,7 @@ \value Key_ApplicationRight \value Key_Book \value Key_CD - \value Key_Calculator On X11 this key is not mapped for legacy reasons. Use Qt::Key_Launch1 instead. + \value Key_Calculator \value Key_ToDoList \value Key_ClearGrab \value Key_Close @@ -2100,6 +2178,8 @@ QDialog::open(), instead. \value Drawer Indicates that the widget is a drawer on \macos. + This feature is obsolete. Setting the flag + has no effect. \value Popup Indicates that the widget is a pop-up top-level window, i.e. that it is modal, but has a window @@ -2130,8 +2210,7 @@ \value SplashScreen Indicates that the window is a splash screen. This is the default type for QSplashScreen. - \omitvalue Desktop Indicates that this widget is the desktop. This - is the type for QDesktopWidget. + \omitvalue Desktop Indicates that this widget is the desktop. \value SubWindow Indicates that this widget is a sub-window, such as a QMdiSubWindow widget. @@ -2172,11 +2251,17 @@ you call QWidget::activateWindow() manually). \value FramelessWindowHint Produces a borderless window. - The user cannot move or resize a borderless window via the window - system. On X11, the result of the flag is dependent on the window manager and its + + On X11, the result of the flag is dependent on the window manager and its ability to understand Motif and/or NETWM hints. Most existing modern window managers can handle this. + \note If the window manager relies on the frame to interactively manipulate + the window, the user can no longer move or resize the window via the window + system, but this side effect should not be relied on. To produce a fixed + size window that can not be resized, please set QWindow::setMinimumSize() + and QWindow::setMaximumSize() to the same size. + \value NoDropShadowWindowHint Disables window drop shadow on supporting platforms. The \c CustomizeWindowHint flag is used to enable customization of @@ -2609,7 +2694,8 @@ \value ImCursorRectangle The rectangle covering the area of the input cursor in widget coordinates. \value ImFont The currently used font for text input. \value ImCursorPosition The logical position of the cursor within the text surrounding the input area - (see \c ImSurroundingText). + (see \c ImSurroundingText). The position does not incorporate the offset of + the cursor within the preedit area, as controlled by QInputMethodEvent::Cursor. \value ImSurroundingText The plain text around the input area, for example the current paragraph. \value ImCurrentSelection The currently selected text. \value ImMaximumTextLength The maximum number of characters that the widget can hold. If there is no limit, @@ -2620,7 +2706,9 @@ \value ImHints The hints for input method on expected input. (See Qt::InputMethodHints) \value ImPreferredLanguage The preferred input language. \value ImPlatformData Platform specific data for input method. - \value ImAbsolutePosition The logical position of the cursor within the entire document. + \value ImAbsolutePosition The logical position of the cursor within the entire document. The position does + not incorporate the offset of the cursor within the preedit area, as controlled + by QInputMethodEvent::Cursor. \value ImTextBeforeCursor The plain text before the cursor. The widget can decide how much text to return, but \b{must} not return an empty string unless the cursor is at the start of the document. \value ImTextAfterCursor The plain text after the cursor. The widget can decide how much text to return, @@ -2631,6 +2719,7 @@ \value ImInputItemClipRectangle The actual exposed input item rectangle. Parts of the input item might be clipped. This value will take clipping into consideration and return the actual painted item rectangle. The rectangle is in widget coordinates. + \value ImReadOnly The widget is read only. This value was added in Qt 6.2. Masks: @@ -2707,8 +2796,7 @@ \value CheckStateRole This role is used to obtain the checked state of an item. (Qt::CheckState) \value InitialSortOrderRole This role is used to obtain the initial sort order - of a header view section. (Qt::SortOrder). This - role was introduced in Qt 4.8. + of a header view section. (Qt::SortOrder). Accessibility roles (with associated types): @@ -2792,6 +2880,12 @@ the search reaches the last item in the model, it begins again at the first item and continues until all items have been examined. \value MatchRecursive Searches the entire hierarchy. + \omitvalue MatchTypeMask + + \note Qt::MatchExactly, Qt::MatchContains, Qt::MatchStartsWith, + Qt::MatchEndsWith, Qt::MatchRegularExpression, Qt::MatchWildcard, and + Qt::MatchFixedString are mutually exclusive. The behavior achieved by + setting several of them in a Qt::MatchFlags argument is undefined. \sa QString::compare(), QRegularExpression */ @@ -2805,7 +2899,10 @@ \value ElideLeft The ellipsis should appear at the beginning of the text. \value ElideRight The ellipsis should appear at the end of the text. \value ElideMiddle The ellipsis should appear in the middle of the text. - \value ElideNone Ellipsis should NOT appear in the text. + \value ElideNone Ellipsis should NOT appear in the text. When passed to functions such as + QFontMetrics::elidedText(), this will cause the full string to return unless + the text contains multi-length variants. Elision in this case must be done + by clipping to the component width. Qt::ElideMiddle is normally the most appropriate choice for URLs (e.g., "\l{http://bugreports.qt.io/browse/QTWEBSITE-13}{http://bugreports.qt.../QTWEBSITE-13/}"), @@ -2970,6 +3067,11 @@ */ /*! + \enum Qt::Disambiguated_t + \internal +*/ + +/*! \enum Qt::CoordinateSystem \since 4.6 @@ -2988,6 +3090,7 @@ This enum represents the state of a touch point at the time a QTouchEvent occurred. + \value TouchPointUnknownState The state of the touch point is not known. \value TouchPointPressed The touch point is now pressed. \value TouchPointMoved The touch point moved. \value TouchPointStationary The touch point did not move. @@ -3049,8 +3152,8 @@ the Qt::GestureStarted state and ending with a gesture in the Qt::GestureFinished or Qt::GestureCanceled states. - \value IgnoredGesturesPropagateToParent Since Qt 4.7, this flag allows you - to fine-tune gesture event propagation. By setting the flag when + \value [since 4.7] IgnoredGesturesPropagateToParent Allows fine-tuning of + gesture event propagation. By setting the flag when \l{QGraphicsObject::grabGesture()}{grabbing} a gesture all ignored partial gestures will propagate to their parent items. @@ -3065,12 +3168,11 @@ \value BeginNativeGesture Sent before gesture event stream. \value EndNativeGesture Sent after gesture event stream. - \value PanNativeGesture Sent after a panning gesture. - Similar to a click-and-drag mouse movement. + \value PanNativeGesture Specifies the displacement delta in pixels. \value ZoomNativeGesture Specifies the magnification delta in percent. \value SmartZoomNativeGesture Boolean magnification state. - \value RotateNativeGesture Rotation delta in degrees. - \value SwipeNativeGesture Sent after a swipe movements. + \value RotateNativeGesture Specifies the rotation delta in degrees. + \value SwipeNativeGesture Sent after a swipe movement. */ @@ -3139,6 +3241,26 @@ */ /*! + \enum Qt::TimerId + \since 6.8 + \relates QObject + \relates QTimer + \relates QChronoTimer + + This is used to represent timer IDs (for example, QTimer and QChronoTimer). + The underlying type is \c int. You can use \l qToUnderlying() to convert + Qt::TimerId to \c int. + + \value Invalid Represents a no-op timer ID; it's usage depends on the + context, for example, this is the value returned by QObject::startTimer() + to indicate it failed to start a timer; whereas QChronoTimer::id() returns + this value when the timer is inactive, that is, \c timer.isActive() + returns \c false. + + \sa QTimer::id(), QChronoTimer::id(), QObject::startTimer() +*/ + +/*! \enum Qt::ScrollPhase \since 5.2 @@ -3221,8 +3343,7 @@ decide how non-integer scale factors (such as Windows 150%) are handled. The active policy is set by calling QGuiApplication::setHighDdpiScaleFactorRoundingPolicy() before - the application object is created, or by setting the QT_SCALE_FACTOR_ROUNDING_POLICY - environment variable. + the application object is created. \sa QGuiApplication::setHighDpiScaleFactorRoundingPolicy() @@ -3235,6 +3356,38 @@ */ /*! + \enum Qt::PermissionStatus + + This enum describes the possible statuses of a permissions. + + \value Undetermined + The permission status is not yet known. Permission should be requested + via QCoreApplication::requestPermission() to determine the actual status. + This status will never be the result of requesting a permission. + + \value Granted + The user has explicitly granted the application the permission, + or the permission is known to not require user authorization on + the given platform. + + \value Denied + The user has explicitly denied the application the requested permission, + or the permission is known to not be accessible or applicable to applications + on the given platform. + + \note On Android, there is no \c Undetermined status by the platform's APIs. + Thus, if a permission is denied for an app, + \l QCoreApplication::checkPermission() returns \c Undetermined + by default until \l QCoreApplication::requestPermission() is called. + After that \l QCoreApplication::checkPermission() reports a non \c Undetermined + status. + + \since 6.5 + \sa QCoreApplication::requestPermission(), QCoreApplication::checkPermission(), + {Application Permissions} +*/ + +/*! \enum Qt::ReturnByValueConstant \since 5.15 @@ -3254,6 +3407,8 @@ \since 6.0 \brief The QKeyCombination class stores a combination of a key with optional modifiers. + \compares equality + The QKeyCombination class can be used to represent a combination of a key with zero or more keyboard modifiers. @@ -3329,23 +3484,21 @@ #if QT_DEPRECATED_SINCE(6, 0) /*! \fn QKeyCombination::operator int() const noexcept - \obsolete + \deprecated Use toCombined() instead. */ #endif /*! - \fn bool operator==(QKeyCombination lhs, QKeyCombination rhs) noexcept - \relates QKeyCombination + \fn bool QKeyCombination::operator==(const QKeyCombination &lhs, const QKeyCombination &rhs) Returns \c true if \a lhs and \a rhs have the same combination of key and modifiers, and \c false otherwise. */ /*! - \fn bool operator!=(QKeyCombination lhs, QKeyCombination rhs) noexcept - \relates QKeyCombination + \fn bool QKeyCombination::operator!=(const QKeyCombination &lhs, const QKeyCombination &rhs) Returns \c true if \a lhs and \a rhs have different combinations of key and modifiers, otherwise \c false. @@ -3382,7 +3535,7 @@ \fn QKeyCombination operator+(Qt::Key key, Qt::KeyboardModifier modifier) noexcept \relates QKeyCombination - \obsolete + \deprecated Use operator| instead. @@ -3397,7 +3550,7 @@ \fn QKeyCombination operator+(Qt::Key key, Qt::KeyboardModifiers modifiers) noexcept \relates QKeyCombination - \obsolete + \deprecated Use operator| instead. |