aboutsummaryrefslogtreecommitdiffstats
path: root/src/quickcontrols/doc
Commit message (Collapse)AuthorAgeFilesLines
* Doc: Fix QML markup and module linksDavid Boddie5 days5-13/+13
| | | | | | | | | Prevent auto-linking from occurring in places where QDoc will create an incorrect link. Pick-to: 6.8 6.10 6.11 Change-Id: I8a031a3545ea3a785e0cbe762e84c179899e694f Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
* SearchField: Update the control's documentationDilek Akcay7 days1-0/+22
| | | | | | | | | | | SearchField documentation was outdated. The description of currentIndex was updated, and a note was added for the iOS style explaining that the control doesn't provide a popup in order to preserve the native look. Pick-to: 6.11 6.10 Change-Id: I6ff23f51c0cf73a44baad7236c176363b3970f8e Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
* Doc: Remove stale version information from Qt Quick ControlsAlexei Cazacov14 days8-104/+116
| | | | | | | Fixes: QTBUG-141045 Pick-to: 6.11 6.10 Change-Id: Ieb8882f4f07c0893095481e7f9104069cf92a389 Reviewed-by: Ulf Hermann <ulf.hermann@qt.io>
* Qt Quick Controls: add DoubleSpinBoxXavier BESSON2025-12-045-40/+131
| | | | | | | | [ChangeLog][Controls] Added DoubleSpinBox. Fixes: QTBUG-67349 Change-Id: Icb2f02162825daf74778de725f80af63874a5d16 Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
* Doc: Add alternate text for Qt Quick and Qt Quick Controls imagesJerome Pasion2025-11-2621-0/+420
| | | | | | | | | | Alternate text (alt text) improves the documentation experience for screen readers and for other accessibility tools. Pick-to: 6.9 6.10 Task-number: QTBUG-135120 Change-Id: I975c3de11f893882fb9a27218079f244bd38a622 Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
* Doc: add a Varying Delegate Sizes sectionMitch Curtis2025-08-191-0/+8
| | | | | | | | | | | | 2436de31bc48b0576d2f48507a89ffbb719e52c1 added documentation for this to ListView, but we also need it in other places so that users don't miss it. Task-number: QTBUG-139026 Pick-to: 6.8 6.9 6.10 Change-Id: I7274bf4524baee4711f370e012009c97a140fd4e Reviewed-by: Richard Moe Gustavsen <richard.gustavsen@qt.io> Reviewed-by: Matthias Rauter <matthias.rauter@qt.io>
* Doc: Fix incorrect usage of \generatelistTopi Reinio2025-08-071-1/+1
| | | | | | | | | | | | | | | | | | | | | The \generatelist command takes an optional argument that affect how the members are listed, for example, `classesbymodule` which creates an annotated list of the classes in a named C++ module. `groupsbymodule` is not recognized or documented. QDoc falls back to generating a list of all members of a group in this case. While the end result is correct, this relies on an undocumented feature that is likely to change and break. Replace these instances with an explicit \annotatedlist command that produces the same output. Pick-to: 6.10 Task-number: QTBUG-138901 Change-Id: Icebe063937cdf1e2ef034b723cce646cd6c96bbe Reviewed-by: Paul Wicking <paul.wicking@qt.io>
* Spinbox example: Make the first * non greedyAlbert Astals Cid2025-08-071-4/+5
| | | | | | | | | | Otherwise it will consume the - as part of it, and we want to keep the - for negative numbers. For it to work we have to add the $ at the end Pick-to: 6.10 6.9 6.8 Change-Id: Ibe4750ccd4d36fef604ae424fea34ee9d64432cd Reviewed-by: Fabian Kosmale <fabian.kosmale@qt.io>
* Remove link to deprecated MS documentationBenedikte Holm2025-07-302-2/+2
| | | | | | | | The documentation on the MS site does not exist anymore. Pick-to: 6.10 6.9 6.8 Change-Id: Id8093840ac84c0b8d77305dd7b9db28067c3c575 Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>
* Shortcut: Fix nativeText and portableText when using sequencesFabian Kosmale2025-07-241-0/+5
| | | | | | | | | | | | | | | | | | | | So far, nativeText and portableText only considered the singular key `sequence` property; however, we nowadays promote `sequences` in the case where you have multiple possible values (which notably happens when using StandardKey enum entries that map to more than one entry). To fix the issue, we pick the first entry of the `sequences` list if it is non-empty, and otherwise fall back to the existing `sequence` member. Moreover, we decouple the change signals for the two text properties from the `sequenceChanged` signal, so that we can also signal a change when `sequences` changes instead. Amends 15a07dbd30e3b242a0495eb6a3316411b493fab3 Pick-to: 6.10 Fixes: QTBUG-96350 Change-Id: I49f9b5a17020a8417a95652c759756cc7fdda1b1 Reviewed-by: Jan Arve Sæther <jan-arve.saether@qt.io>
* Don't delete component delegatesMitch Curtis2025-06-251-0/+7
| | | | | | | | | | | | | | | | | This makes it impossible to e.g. swap between two delegates. Similar to 80f1186338bcf8c7d692b4fadfc46531c002c6b0 except for QQmlComponents. [ChangeLog][Controls][Important Behavior Changes] Old QQmlComponent delegates (not the item instances created by them) are no longer destroyed when a new one is set, as they are technically owned by user code. They will still eventually be garbage-collected as expected, assuming there are no references to them. Fixes: QTBUG-137777 Change-Id: Icbe6971727d684a266b12a0b41474397e536bfdc Reviewed-by: Ulf Hermann <ulf.hermann@qt.io>
* Doc: add a section about mixing style selection methodsMitch Curtis2025-06-231-4/+46
| | | | | | | | | | | | | | We don't want to encourage this, but as mentioned in the change itself: in the case of applications that load third party QML code, it may not be possible to control which imports are used. So, this change documents the limitations to be aware of when mixing the two. Task-number: QTBUG-117526 Task-number: QTBUG-136709 Pick-to: 6.5 6.8 6.9 6.10 Change-Id: I5601266758f123998d3ae5d03892fba42c6c5b8f Reviewed-by: Ulf Hermann <ulf.hermann@qt.io> Reviewed-by: Richard Moe Gustavsen <richard.gustavsen@qt.io>
* Allow SelectionRectangle dragging if TableView doesn't flick via mouseShawn Rutledge2025-06-201-12/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Setting `interactive: false` on TableView is drastic (except perhaps in some mode that the user can enter somehow), but setting `acceptedButtons: Qt.NoButton` should be the default, to have flicking on touchscreens but avoid dragging by mouse. This is possible since cbc694491b8431fd3dcf82c3d17a17a06cbccebc (but the default was not changed, for fear of surprising users with a behavior change). So now QQuickSelectionRectanglePrivate::updateSelectionMode() allows dragging in either case, via all devices if the TableView is not interactive, or mouse-only if the flicking is touch-only. Long-press has so far been allowed to select only in the case when dragging cannot select. But if the TableView has interactive: true, then you can flick it on a touchscreen, regardless of how acceptedButtons is set, even though we may expect the user to select dragging the mouse. So now if `selectionMode: Auto` is declared, and touch flicking works, we allow the long-press to select, because otherwise there would not be a way to make a selection on a touchscreen. We should not consider `interactive: false` to be normal (unless the developer finds a need to disable scrolling in some unique modal use case that can be exited somehow). `acceptedButtons: Qt.LeftButton` is not a very useful setting either (even though it's still the default). The snippet is improved to illustrate, along with some drive-by's. Docs explain the behavior in more detail. Test coverage is added in the manual test and the autotest. Pick-to: 6.9 6.10 Task-number: QTBUG-97111 Task-number: QTBUG-132268 Change-Id: I912dbc7bf8de536794b5bdcc1269bf2860645de9 Reviewed-by: Richard Moe Gustavsen <richard.gustavsen@qt.io>
* Documentation: close \styleproperty properlyThibaut Cuvelier2025-06-031-0/+2
| | | | | | | | | | By design, \styleproperty should be closed with \endstyleproperty. This was not the case for one subsection. While mostly harmless in HTML, this cause the DocBook export to be invalid. Pick-to: 6.5 6.8 6.9 6.10 Change-Id: Ie4172535ffb9183e9105bf7e9b407d834459486c Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
* Introduce SearchField for Quick ControlsDilek Akcay2025-06-011-0/+0
| | | | | | | | | Add a new QQuickSearchField as part of the Qt Quick Controls to simplify implementing search functionality for lists of items. Task-number: QTBUG-126188 Change-Id: I634131161447616a2d66e7f301bd8a24adac2d7f Reviewed-by: Jan Arve Sæther <jan-arve.saether@qt.io>
* Doc: Remove transparent backgrounds from calendar imagesKai Köhne2025-05-2212-0/+0
| | | | | | | | | | | | These don't work well in dark mode: https://doc.qt.io/qt-6/qml-qtquick-controls-monthgrid.html While at it, also convert to webp. Pick-to: 6.9 Change-Id: I9b0cd1cb479145c17f37533ade8b09564d2f5534 Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
* Doc: Remove transparent backgrounds from wireframe imagesKai Köhne2025-05-2115-9/+9
| | | | | | | | These don't work well in dark mode. Also, convert to webp while at it. Pick-to: 6.9 Change-Id: Ie210c7cc03f742f2cfbd5af3d3b692309ccf6aae Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
* Doc: Fix Linking issuesTopi Reinio2025-05-201-2/+3
| | | | | | | | | | | | | | | | - Fix linking to `QtQuickView` Android class - Fix incorrect link target to section - Fix \sa link to QLocale::createSeparatedList() - Remove link to undocumented header `qqmlregistration.h` - Replace link to non-existent QML type HeaderViewDelegate with actual type name(s). - Fix links to (Horizontal|Vertical)HeaderView::delegate property, as the property is documented in the base type. - Remove \sa links to private member QSGTextNode::doAddTextDocument() Pick-to: 6.9 Change-Id: I3bab7155f8d73af6d51f8cfe890ece6d31671f1d Reviewed-by: Nicholas Bennett <nicholas.bennett@qt.io>
* Doc: Remove mentioning of Qt Quick Calendar moduleKai Köhne2025-05-141-5/+5
| | | | | | | | | | | This seems to be a left-over from the 'Qt Quick Calendar' extension that is not supported anymore since Qt 6.3 (?). While at it, rewrite the whole paragraph for brevity. Pick-to: 6.9 Change-Id: Id1bef92d2e745fc4cbf761555d8aba0271edfc10 Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
* Docs: Update contentItem info in qtquickcontrols-customizeZhang Hongyuan2025-04-161-29/+28
| | | | | | | | | Change the "content item" field to match the contentItem attribute of the Control Type Fixes: QTBUG-135956 Pick-to: 6.8 6.9 Change-Id: I493c02fbd1670344dda462e44b8fb98b1f13fab3 Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
* Doc: improve "Context Menus" section of Menu's documentationMitch Curtis2025-04-141-5/+1
| | | | | | | | | | | - Simplify code snippet. - Simplify note about desktop platforms. Task-number: QTBUG-134903 Pick-to: 6.9 Change-Id: Ibc0db63fd3f0692c42d0b2e6685d4437850cb5a8 Reviewed-by: Jan Arve Sæther <jan-arve.saether@qt.io> Reviewed-by: Shawn Rutledge <shawn.rutledge@qt.io>
* Doc: Code snippet shows a function reference from inside ComponentAlexei Cazacov2025-04-101-5/+5
| | | | | | | | | | | This commit fixes a code snippet, that called a function from inside Component, which led to "ReferenceError: formatText is not defined" error. Fixes: QTBUG-135437 Pick-to: 6.9 6.8 Change-Id: Ic72e04feb74df7fd35315a2542a3178eb4356f00 Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
* Close all other Menus when showing non-sub-menuMitch Curtis2025-04-092-14/+68
| | | | | | | | | | | | | | | | | | | | | | This fixes the linked bug, but also generally makes sense, as there shouldn't be a use case where two menus are open at once. Adjust the documentation to reflect the current state of context menus and use best practices. [ChangeLog][Controls][Important Behavior Changes] All non-sub-menus are now closed when a menu is opened. This is to fix an issue (QTBUG-134903) where duplicate menus are shown when opening a custom non-ContextMenu on a text editing control like TextField or TextArea. This means that rather than two context menus incorrectly being opened, an extra one will briefly be visible before immediately being closed. For information on how to avoid this, please see the "Context menus" section of Menu's documentation. Fixes: QTBUG-134903 Pick-to: 6.9 Change-Id: I158295b72176935c2dc8072a72a4df66678be824 Reviewed-by: Shawn Rutledge <shawn.rutledge@qt.io>
* tst_Snippets: fail on warningsMitch Curtis2025-03-241-1/+5
| | | | | | | Task-number: QTBUG-98718 Pick-to: 6.8 6.9 Change-Id: I24e641952ca4570f85928c53fb9752a595d50122 Reviewed-by: Santhosh Kumar <santhosh.kumar.selvaraj@qt.io>
* Doc: move Menu's detailed description snippets into snippet filesMitch Curtis2025-03-244-0/+94
| | | | | | | | | | Ensure that they're auto-tested, which would prevent issues like QTBUG-128520 when combined with failOnWarning, which will be done in a follow-up patch. Pick-to: 6.8 6.9 Change-Id: Ib773dd2780e8ffe0a554852bd20ef20a4ab65c1a Reviewed-by: Santhosh Kumar <santhosh.kumar.selvaraj@qt.io>
* HeaderViewDelegate: Add documentationMohammadHossein Qanbari2025-03-065-0/+202
| | | | | | | | | This patch adds documentation for the delegates of both horizontal and vertical header views, improving understanding and customization of header behaviors in the application. Change-Id: If6a59e0e0aad67bb26765c76f265d21de84a2498 Reviewed-by: Richard Moe Gustavsen <richard.gustavsen@qt.io>
* Overlay: ignore right button clicksMitch Curtis2025-02-211-0/+2
| | | | | | | | | | | | | So that ContextMenu can open when e.g. a Drawer is in the scene. [ChangeLog][Important Behavior Changes][Controls][Overlay] The pressed and released signals are no longer emitted for right clicks. This is to allow ContextMenu to work when controls like Drawer are used. Fixes: QTBUG-132765 Pick-to: 6.9 Change-Id: If329a2ddaaf76e498e7ae2cd48a899fc23dba6b9 Reviewed-by: Shawn Rutledge <shawn.rutledge@qt.io>
* ContextMenu: defer creation of Menu until it's shownMitch Curtis2025-02-031-0/+17
| | | | | | | | | | This enables adding a Cut/Copy/Paste context menu to our text editing controls without a Menu being created at startup for each control. Fixes: QTBUG-132265 Pick-to: 6.9 Change-Id: I2fbbce457208cfeb0df8f043746615b7c52f65e0 Reviewed-by: Shawn Rutledge <shawn.rutledge@qt.io>
* Controls: Make ComboBox currentValue property writablePierre-Yves Siret2025-01-281-6/+6
| | | | | | | | | | | | | | | | | | | | | This offers another way besides currentIndex to select the current item, enabling more "declarative" code with bindings. The current advertised way to select an index based on its value is using findValue in onCompleted. This doesn't react to backend value changes like a binding and is quite brittle depending on the model. I often use hacks like the following: `currentIndex: count, indexOfValue(backend.value)`. The solution offered here is both cleaner and more robust (it accounts for model changes too). [ChangeLog][Controls][ComboBox] It is now possible to write to the ComboBox currentValue property as way to set its current item. Fixes: QTBUG-100345 Change-Id: I5b544fc890ad937ef88cb8eca1a5c2dd3e5def98 Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
* Docs: Update the published QML code to reflect current best practicesAlexei Cazacov2025-01-241-1/+1
| | | | | | | | | This commit addresses the edit proposals mentioned in the QTBUG-131978. Task-number: QTBUG-131978 Pick-to: 6.9 6.8 Change-Id: Ib94379c6dc0778f5aee8e53c5f1015ad7b10779f Reviewed-by: Fabian Kosmale <fabian.kosmale@qt.io>
* Doc: add more ContextMenu documentationMitch Curtis2025-01-182-0/+97
| | | | | | | Fixes: QTBUG-132553 Pick-to: 6.9 Change-Id: I305908d25022b091cba94c7753f69ac9030ae9fd Reviewed-by: Shawn Rutledge <shawn.rutledge@qt.io>
* Add ContextMenu::requested signalCarl Schwan2025-01-181-0/+25
| | | | | | | | | | | | | This signal allow to open a custom menu, which might not inherit from QQuickMenu. The usecase is for KDE: we already have a ContextMenu which opens a bottom drawer on mobile platforms and a traditional menu on desktop platforms. See https://invent.kde.org/libraries/kirigami-addons/-/merge_requests/337 Pick-to: 6.9 Change-Id: I5dafbd6314ebdd066ccc6a386b4e2c07caab285e Reviewed-by: Shawn Rutledge <shawn.rutledge@qt.io>
* Doc: Update HorizontalHeaderView Documentation of the property textRoleDheerendra Purohit2024-12-231-0/+4
| | | | | | | | | | The textRole property in HorizontalHeaderView doc is not applicable when the custom delegate is defined. Update documentation HorizontalHeaderView::textRole. textRole is not applicable when the custom delegate is defined by the developer. Fixes: QTBUG-131322 Change-Id: Iafda84d97d5cae3fd769561c3a048029e5a0d50e Reviewed-by: Paul Wicking <paul.wicking@qt.io>
* Teach ApplicationWindow about safe area marginsTor Arne Vestbø2024-12-091-0/+39
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | If the window has non-safe areas, as reflected by the window's safe area margins, ApplicationWindow will now automatically pad the content item accordingly, ensuring that the content item is within the safe area of the window. To implement this we piggy-back on QQuickControl, letting the control manage the size and position of the content item. This allows us to use the built in padding of QQuickControl to inset the content. Internally the item hierarchy of ApplicationWindow no longer represents the header, footer, and menu bar as children of the ApplicationWindow's content item, but rather as sibling items in the QQuickWindow content item, similar to the window's background item. Doing this is a slight behavior change, but for something that should have been an implementation detail as far as users are concerned. The content control and header, footer and menu bar now all live within the same root QQuickWindow::contentItem, which is a focus scope on its own. End users can override the automatic padding that we do for the contentItem by setting any of the four new padding properties that we expose, mirroring the properties on QQuickControl. [ChangeLog][Important Behavior Changes] The contentItem of ApplicationWindow is now automatically padded to account for safe area margins. To override the automatic padding, set the padding explicitly, via e.g. `topPadding: 0`. Task-number: QTBUG-125373 Change-Id: I986e425a7f316db244c7fc86283b8b333978e3ad Reviewed-by: Tor Arne Vestbø <tor.arne.vestbo@qt.io>
* Controls: Add TableViewDelegateMohammadHossein Qanbari2024-11-276-0/+248
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This patch introduces TableViewDelegate to the Controls module. Key features: - Ready-made delegate assignable to TableView - Handles table drawing using predefined styles - Usable without customization - Implements all required properties set by TableView - Provides API for changing background and label Test Suite: - Verifies TableViewDelegate properties and functionalities - Tests include: - Verification of selected, current, and content text properties - Validation of selection behavior and item clicking BLACKLISTing two tests (dragToSelect and pressAndHoldToSelect), which will be removed from the BLACKLIST in the next patch (to fix cell selection on the Android platform). Implementation derived from TreeViewDelegate, adapted for TableView use. TreeViewDelegate patch: 0ddb0d4b9b0c70c4fd4058ef4660e38fd933523e [ChangeLog][Controls] New delegate added: TableViewDelegate Fixes: QTBUG-114636 Change-Id: Ibb8b0a7622016e0c6fd58d696e507e7bb76daced Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
* Docs: Qt Quick Controls style selection at runtime has faulty examplesAlexei Cazacov2024-11-261-2/+2
| | | | | | | | | | This commit fixes the code snippets in the Run-Time Style Selection section of the Styling Qt Quick Controls article. Fixes: QTBUG-112453 Pick-to: 6.8 Change-Id: I522f9731214278467e1aa45a156a10f189ec1f1a Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
* Doc: fix ComboBox customization exampleMitch Curtis2024-11-151-1/+1
| | | | | | | | | | | | | 90a0d4023206cfeed1bec43cb11e026ff0379d3d changed the height calculation of ComboBox's popup, but forgot to update the customization docs. This fixes the popup not being scrollable when it exceeds the height of the window. Pick-to: 6.5 6.8 Change-Id: I822888c3d979d06c21cd7ca081dae48115bb375e Reviewed-by: Doris Verria <doris.verria@qt.io> Reviewed-by: Oliver Eftevaag <oliver.eftevaag@qt.io>
* Doc: Show that style import needs to come firstSafiyyah Moosa2024-11-081-0/+3
| | | | | | | | | | | | | | | | Currently, the Styling Qt Quick Controls docs contain a code snippet to show how to import a style. This fix adds a comment to the code snippet to let users know that the style import should precede all other imports. If the user imports something else before the style import, the style does not display correctly, namely, some of the controls follow the style, whilst some do not. Fixes: QTBUG-130792 Pick-to: 6.8 Change-Id: I556fc987fe7c15193aa2657fc76b61079acd72f4 Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
* Docs: Revamp Quick Controls overview/types pageAlexei Cazacov2024-11-012-0/+42
| | | | | | | | | | | This commit brings a list of controls to the index page of the Qt Quick Controls documentation. This should help the visibility and discoverability of the available controls. Task-number: QTBUG-129909 Pick-to: 6.8 Change-Id: Ida4f269d973ea575773aac36d8415cfeaf16e29c Reviewed-by: Mats Honkamaa <mats.honkamaa@qt.io>
* Docs: Remove unused images in qtdeclarativeAlexei Cazacov2024-11-0123-0/+0
| | | | | | | Pick-to: 6.8 Change-Id: I81ffcbfb3e6df66e49cc36fea2273cea19240099 Reviewed-by: Paul Wicking <paul.wicking@qt.io> Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
* Doc: import the Basic style in more customization examplesMitch Curtis2024-10-212-3/+3
| | | | | | | | | | | A follow-up of e4577eb6bb9308d2b84bfe66216333b001ac670b. This ensures that the user won't inadvertently base the customizations on top of the native styles. Pick-to: 6.5 6.8 Change-Id: Ibfeebfdb5ddad377947481deeb8de46976109daa Reviewed-by: Richard Moe Gustavsen <richard.gustavsen@qt.io>
* Style docs: Add link to the FluentWinUI3 style at the end of pageDoris Verria2024-10-091-0/+1
| | | | | | Pick-to: 6.8 Change-Id: I723dc8740a37f6aa92c73cca1b5ecc364578185d Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
* Docs: Add FluentWinUI3 style to the list of available stylesDoris Verria2024-10-081-0/+8
| | | | | | Pick-to: 6.8 Change-Id: I40c103020432540c038932a4fe0516cac3b1ad3b Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>
* doc: Update list of controls that the windows style doesn't implementOliver Eftevaag2024-09-201-2/+2
| | | | | | | | | The list was a bit outdated, since the windows style now includes the DelayButton, Menu, MenuBar, RangeSlider and Switch. Pick-to: 6.8 6.8.0 Change-Id: Iadadac59ca01e03032db3ceb5d6d0f2575d931f2 Reviewed-by: Richard Moe Gustavsen <richard.gustavsen@qt.io>
* QQuickHeaderView: for explicitly assigned models, document that data() will ↵Richard Moe Gustavsen2024-08-301-17/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | be used The detailed documentation for HeaderView says that if you assign a QAIM to the model property, the models headerData() will be used. But in the documentation for the model property itself, it says that data() will be used (except when using a QAbstractTableModel). Both cannot be true. The actual behavior is that we use data() when the model is assigned explicit to the model property, and headerData() when the syncView's model is used. It's debatable whether or not we should have always used headerData(), but changing that now could cause regressions. Such a change would also stop e.g QML ListModel from being used as a model, which is also an argument for keeping it as-is. This patch will therefore fix up the documention to be consistent, and to inform that data() will be used. Fixes: QTBUG-123595 Pick-to: 6.8 6.7 6.5 6.2 Change-Id: Id64977a3db5f00b4269f0e5ffb6a31e5ad607725 Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
* Doc: Fix links to Qt Creator documentationLeena Miettinen2024-08-303-9/+4
| | | | | | | | | | - Update the link targets to 14.0 level - Use the \QC and \QDS macros - Remove \externalpage entries from the repository to use \qtbase\doc\global\externalsites\qtcreator.qdoc Change-Id: I5b63b4f5fab2e4e6aceec385b3ce5516b803c682 Reviewed-by: Andreas Eliasson <andreas.eliasson@qt.io>
* FluentWinUI3 Style: Add Dialog/DialogButtonBoxDoris Verria2024-08-301-3/+3
| | | | | | | | | | | Add Dialog and DialogButtonBox. While at it, remove them from the list of not-yet supported controls in the Fluent style docs, together with other controls that have already been implemented. Pick-to: 6.8 Change-Id: I6abe0cae8712a999a5491b5ec1a904df56d38d0d Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
* doc, QQuickHeaderView: ensure example snippet worksRichard Moe Gustavsen2024-08-231-1/+1
| | | | | | | | | | | | | | As it stood, the qdoc marker in the example code left the final curly brace out of the snippet. A copy paste of this example would therefore not compile. This patch will make sure the brace is a part of the snippet shown in the docs. Task-number: QTBUG-123595 Pick-to: 6.8 6.7 6.5 6.2 Change-Id: I68bfac0cfc3dcecd487bfb69de07c317f787552e Reviewed-by: Santhosh Kumar <santhosh.kumar.selvaraj@qt.io>
* doc, QQuickHeaderView: syncView should point to the TableView, not the other ↵Richard Moe Gustavsen2024-08-211-2/+2
| | | | | | | | | | | | way around The docs suggest that the syncView for a TableView should point to the HeaderView. But it's actually the other way around. Task-number: QTBUG-123595 Pick-to: 6.8 6.7 6.5 6.2 Change-Id: I303ac50321aad581fd3472b3e3ff8ad93ecad701 Reviewed-by: Santhosh Kumar <santhosh.kumar.selvaraj@qt.io>
* FluentWinUI3 Style: Add documentationDoris Verria2024-08-093-0/+46
| | | | | | | Task-number: QTBUG-125748 Pick-to: 6.8 Change-Id: Iaeedd4044c686d1dce4ef611a4cf9a7ea8060f83 Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>