From 80777e7579124e4504df53647c0199ec6d47cb1a Mon Sep 17 00:00:00 2001 From: Leena Miettinen Date: Wed, 18 Nov 2020 11:10:18 +0100 Subject: [PATCH] Doc: Document context menu commands for components - Add a table that lists commands available for components in Navigator and Form Editor - Include the table in Navigator and Form Editor topics using an include file - Add documentation for new commands (and those that were not documented for some reason) Task-number: QDS-2744 Change-Id: I6d2d886aaeb9d7f5e21ca5e8007e3b036c61f1d0 Reviewed-by: Thomas Hartmann --- .../qmldesigner-implement-signal-handler.png | Bin 0 -> 6492 bytes .../qmldesigner-merge-with-template.png | Bin 0 -> 3807 bytes .../qtquick-component-context-menu.qdocinc | 88 ++++++++++++++++++ .../src/qtquick/qtquick-components.qdoc | 32 +++++++ .../qtquick-connection-editor-signals.qdoc | 21 ++++- .../src/qtquick/qtquick-form-editor.qdoc | 1 + .../src/qtquick/qtquick-navigator.qdoc | 1 + 7 files changed, 142 insertions(+), 1 deletion(-) create mode 100644 doc/qtcreator/images/qmldesigner-implement-signal-handler.png create mode 100644 doc/qtcreator/images/qmldesigner-merge-with-template.png create mode 100644 doc/qtcreator/src/qtquick/qtquick-component-context-menu.qdocinc diff --git a/doc/qtcreator/images/qmldesigner-implement-signal-handler.png b/doc/qtcreator/images/qmldesigner-implement-signal-handler.png new file mode 100644 index 0000000000000000000000000000000000000000..6098f89b9accceb7f354113f2687d385cd97c081 GIT binary patch literal 6492 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 literal 0 HcmV?d00001 diff --git a/doc/qtcreator/src/qtquick/qtquick-component-context-menu.qdocinc b/doc/qtcreator/src/qtquick/qtquick-component-context-menu.qdocinc new file mode 100644 index 00000000000..5c73bcf1562 --- /dev/null +++ b/doc/qtcreator/src/qtquick/qtquick-component-context-menu.qdocinc @@ -0,0 +1,88 @@ +/**************************************************************************** +** +** Copyright (C) 2020 The Qt Company Ltd. +** Contact: https://www.qt.io/licensing/ +** +** This file is part of the Qt Creator documentation. +** +** 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. +** +****************************************************************************/ + +/*! +//! [context-menu] + \section1 Context Menu + + The following table summarizes the \uicontrol Navigator and + \uicontrol {Form Editor} context menu items and provides links + to more information about them. + + \table + \header + \li To Learn About + \li Go To + \row + \li Arrange + \li \l{Arranging Items} + \row + \li Edit + \li \l{Showing and Hiding Items} + \row + \li Anchors + \li \l{Setting Anchors and Margins} + \row + \li Group + \li \l Group + \row + \li Position + \li \l{Using Positioners} + \row + \li Layout + \li \l{Using Layouts} + \row + \li Stacked Container + \li \l{Lists and Other Data Models} + \row + \li Timeline + \li \l{Creating Timelines} + \row + \li Event List + \li \l{Simulating Events} + \row + \li Edit Color + \li \l{Editing Properties Inline} + \row + \li Edit Annotation + \li \l{Annotating Designs} + \row + \li Merge File with Template + \li \l{Merging Files with Templates} + \row + \li Move Component into Separate File + \li \l{Moving Components into Separate Files} + \row + \li Add New Signal Handler + \li \l{Adding Signal Handlers} + \row + \li Go to Implementation + \li \l{Using Qt Quick UI Forms} + \row + \li Go into Component + \li \l{Moving Within Components} + \endtable +//! [context-menu] +*/ diff --git a/doc/qtcreator/src/qtquick/qtquick-components.qdoc b/doc/qtcreator/src/qtquick/qtquick-components.qdoc index a082e23f848..82a90f702e0 100644 --- a/doc/qtcreator/src/qtquick/qtquick-components.qdoc +++ b/doc/qtcreator/src/qtquick/qtquick-components.qdoc @@ -246,6 +246,25 @@ \include qtdesignstudio-components.qdocinc creating studio components \endif + \section1 Moving Components into Separate Files + + An alternative way of creating reusable components is to move them into + separate QML files. Right-click a component in the \uicontrol Navigator + or \uicontrol {Form Editor} view and select + \uicontrol {Move Component into Separate File} in the context menu. + + \image qtcreator-move-component-into-separate-file.png + + Give the new component a name and select whether properties are set for + the new component or for the original one. + + For an example of creating a reusable custom component, see + \if defined(qtcreator) + \l{Creating a Mobile Application}. + \else + \l{Progress Bar}. + \endif + \section1 Moving Within Components Components can consist of several other components. To view the component @@ -256,4 +275,17 @@ component. \image qmldesigner-breadcrumbs.png "Go into Component command" + + \section1 Merging Files with Templates + + You can merge the current QML file against an existing second QML file and + using the second QML file in a way similar to using a CSS stylesheet. + + To use this experimental feature, right-click a component in the + \uicontrol Navigator or \uicontrol {Form Editor} view and select + \uicontrol {Merge File with Template} in the context menu. + + \image qmldesigner-merge-with-template.png "Merge with Template dialog" + + In the \uicontrol Template field, select the file to use as a template. */ diff --git a/doc/qtcreator/src/qtquick/qtquick-connection-editor-signals.qdoc b/doc/qtcreator/src/qtquick/qtquick-connection-editor-signals.qdoc index a9b04c79373..43679007285 100644 --- a/doc/qtcreator/src/qtquick/qtquick-connection-editor-signals.qdoc +++ b/doc/qtcreator/src/qtquick/qtquick-connection-editor-signals.qdoc @@ -44,7 +44,7 @@ A signal is automatically emitted when the value of a QML property changes. This type of signal is a \e{property change signal} and signal handlers - for these signals are written in the form \c onChanged, where + for these signals are written in the form \c onChanged, where \e is the name of the property, with the first letter capitalized. @@ -84,6 +84,25 @@ in the context menu to specify the connection in \uicontrol {Connection Editor}. + \section1 Adding Signal Handlers + + If a signal handler that you need is not listed in the + \uicontrol {Signal Handler} column, you can add it: + + \list 1 + \li Right-click a component in the \uicontrol Navigator or + \uicontrol {Form Editor} view and select + \uicontrol {Add New Signal Handler} in the context menu. + \li In the \uicontrol Signal field, select the signal to handle. + \image qmldesigner-implement-signal-handler.png "Implement Signal Handler dialog" + \li Select the radio buttons to filter the list to only display + frequently used signals or property changes. + \li Select \uicontrol OK. + \endlist + + The added signal handler is automatically \l{Using Qt Quick UI Forms} + {exported as a property}. + \if defined(qtdesignstudio) \section1 Adding Actions and Assignments diff --git a/doc/qtcreator/src/qtquick/qtquick-form-editor.qdoc b/doc/qtcreator/src/qtquick/qtquick-form-editor.qdoc index ef4cb184372..c7efa1ef8ef 100644 --- a/doc/qtcreator/src/qtquick/qtquick-form-editor.qdoc +++ b/doc/qtcreator/src/qtquick/qtquick-form-editor.qdoc @@ -148,4 +148,5 @@ select the \inlineimage reset.png (\uicontrol {Reset View}) button. + \include qtquick-component-context-menu.qdocinc context-menu */ diff --git a/doc/qtcreator/src/qtquick/qtquick-navigator.qdoc b/doc/qtcreator/src/qtquick/qtquick-navigator.qdoc index 3e14fd476cb..fc9e959d066 100644 --- a/doc/qtcreator/src/qtquick/qtquick-navigator.qdoc +++ b/doc/qtcreator/src/qtquick/qtquick-navigator.qdoc @@ -142,4 +142,5 @@ the item into a new position. The topmost item under the cursor becomes the new parent of the item. + \include qtquick-component-context-menu.qdocinc context-menu */