Doc: Update custom property documentation

Task-number: QDS-7735
Change-Id: I1f4551e6d5f1319c73bc6e1b05c3c0390feecda9
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>

doc/qtdesignstudio/src/components/qtquick-component-instances.qdoc

@@ -51,7 +51,7 @@
             custom properties on the \uicontrol {Properties} tab in the
             \l {Connections} view.
             \image qmldesigner-dynamicprops.png "Connections View Properties tab"
-            For more information, see \l{Specifying Dynamic Properties}.
+            For more information, see \l{Specifying Custom Properties}.
         \li To enable users to interact with the component instances, connect
             the instances to signals on the \uicontrol Connections tab in the
             \uicontrol {Connections} view. For example, you can specify what

doc/qtdesignstudio/src/components/qtquick-components-custom.qdoc

@@ -63,7 +63,7 @@
             \uicontrol Navigator or the \uicontrol {2D} view.
         \li Edit component properties in the \uicontrol Properties view.
             The available properties depend on the component type. You can
-            \l{Specifying Dynamic Properties}{add properties for
+            \l{Specifying Custom Properties}{add properties for
             components} on the \uicontrol {Properties} tab in the
             \uicontrol Connections view.
         \li To change the appearance and behavior of the component instances

doc/qtdesignstudio/src/overviews/qtquick-creating-ui-logic.qdoc

@@ -136,7 +136,7 @@
     \endif
     \row
         \li Adding custom properties for a particular component type
-        \li \l{Specifying Dynamic Properties}
+        \li \l{Specifying Custom Properties}
     \omit
     \row
         \li Adding properties for controlling states

doc/qtdesignstudio/src/qtdesignstudio-components.qdocinc

@@ -71,7 +71,7 @@
         \li Edit component properties in the \l Properties view.
 
             The available properties depend on the component type. You can
-            \l{Specifying Dynamic Properties}{add properties for components} on
+            \l{Specifying Custom Properties}{add properties for components} on
             the \uicontrol Properties tab in the {Connections} view.
     \endlist
 

doc/qtdesignstudio/src/qtdesignstudio-simulink.qdoc

@@ -165,7 +165,7 @@
     Navigator to add the properties on the \uicontrol Properties tab in the
     \l Connections view.
 
-    See \l {Specifying Dynamic Properties} for a detailed description of how
+    See \l {Specifying Custom Properties} for a detailed description of how
     to add a custom property. The name of the property and the data type
     need to match those of the send or receive property of the Simulink model.
 

doc/qtdesignstudio/src/qtdesignstudio-terms.qdoc

@@ -219,7 +219,7 @@
         \li \l{Preset Components}
         \li \l{Specifying Component Properties}
         \li \l{Adding Bindings Between Properties}
-        \li \l{Specifying Dynamic Properties}
+        \li \l{Specifying Custom Properties}
     \endlist
 
     \section1 Signal

doc/qtdesignstudio/src/qtdesignstudio-toc.qdoc

@@ -144,7 +144,7 @@
                             \list
                                 \li\l{Connecting Components to Signals}
                                 \li\l{Adding Bindings Between Properties}
-                                \li\l{Specifying Dynamic Properties}
+                                \li\l{Specifying Custom Properties}
                             \endlist
                         \li \l{Adding States}
                     \endlist

doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-custom-effects-materials.qdoc

@@ -217,5 +217,5 @@
     \image studio-custom-material-uniform-properties.png "Uniforms as properties in Connections view Properties tab"
 
     For more information about adding properties, see
-    \l{Specifying Dynamic Properties}.
+    \l{Specifying Custom Properties}.
 */

doc/qtdesignstudio/src/views/qtquick-connection-editor-properties.qdoc

@@ -31,10 +31,10 @@
     \else
     \nextpage quick-connections-backend.html
     \endif
+    \sa {Specifying Component Properties}
+    \title Specifying Custom Properties
 
-    \title Specifying Dynamic Properties
-
-    Each preset \l{glossary-component}{component} has a set of preset properties
+    Each \l{Preset Components}{preset component }has a set of preset properties
     that you can specify values for. You can add custom properties that would
     not otherwise exist for a particular \l{Component Types}{component type}.
     You bind the properties to dynamic expressions to define global properties
@@ -55,50 +55,36 @@
     should have an \e int or \e real property for speed to which the UI is
     bound.
 
-    You can add properties for components on the \uicontrol Properties tab in
-    in the \l {Connections} view.
+    \section1 Adding Properties for a Component
 
-    \image qmldesigner-dynamicprops.png "Custom properties in the Connections view Custom Properties tab"
-
-    To add properties for a component:
+    To add a custom property for a component:
 
     \list 1
-        \li Go to the \uicontrol Properties tab in the \l Connections view.
+        \li Go to the \uicontrol {Local Custom Properties} section in the
+        \uicontrol Properties view.
         \li Select the \inlineimage icons/plus.png
-            (\uicontrol Add) button to add a dynamic property for the currently
-            selected component. The component ID is displayed in the \uicontrol Item
-            column.
-        \li Double-click the value in the \uicontrol Property column to give a
-            name to the property. Property names must begin with a lower case
-            letter and can only contain letters, numbers, and underscores.
-            JavaScript \e {reserved words} are not valid property names.
-        \li Double-click the value in the \uicontrol {Property Type} column to
-            specify the \l{Supported Property Types}{type of the property}.
-        \li Double-click the value in the \uicontrol {Property Value} column
-            to specify the value of the property.
+            (\uicontrol Add) button to add a custom property for the currently
+            selected component.
+            \image add-local-custom-property.png
+        \li Set the \uicontrol Name and \uicontrol Type for the property.
+            \image add-new-property-dialog.png
+    \endlist
+
+    \section1 Binding a Property Value
+
+    To bind the value of the property to that of another one or to data
+    accessible in the application.
+
+    \list 1
+      \li In the \uicontrol Properties view, select
+        \inlineimage icons/action-icon.png
+        next to the property.
+      \li Select \uicontrol {Set Binding}.
+        \image qmldesigner-binding-editor.png "Binding Editor"
     \endlist
 
-    Right-click a property and select \uicontrol {Open Binding Editor} in
-    the context menu to bind the value of the property to that of another one
-    or to data accessible in the application in \uicontrol {Binding Editor}.
     For more information, see \l{Setting Bindings}.
 
-    \image qmldesigner-binding-editor.png "Binding Editor"
-
-    The properties you add for a component are displayed in the \l Properties
-    view when you select a component of that type in the \l Navigator or
-    \l {2D} view.
-
-    \image qtquick-custom-properties.png "Custom properties in Properties view"
-
-    For more information about setting property values in the
-    \l Properties view, see \l{Specifying Component Properties}.
-
-    \if defined(qtcreator)
-    For an example of using custom properties in an application, see
-    \l{Creating a Mobile Application}.
-    \endif
-
     \section1 Supported Property Types
 
     The following table describes the supported property types:
@@ -134,6 +120,9 @@
     \row
         \li string
         \li Free form text string
+    \row
+        \li TextureInput
+        \li Specifies a texture exposed to the shaders of a CustomMaterial or Effect.
     \row
         \li url
         \li Resource locator, such as a file name. It can be either  absolute,
@@ -144,5 +133,14 @@
         \li variant
         \li Generic property type. For example, variant properties can store
             numbers, strings, objects, arrays, and functions.
+    \row
+        \li vector2d
+        \li Refers to a value with x and y attributes.
+    \row
+        \li vector3d
+        \li Refers to a value with x, y, and z attributes.
+    \row
+        \li vector4d
+        \li Refers to a value with x, y, z, and w attributes.
     \endtable
 */

doc/qtdesignstudio/src/views/qtquick-connection-editor.qdoc

@@ -48,7 +48,7 @@
             the value of a property changes, the values of any properties that
             are bound to it are automatically updated accordingly.
 
-        \li \l{Specifying Dynamic Properties}
+        \li \l{Specifying Custom Properties}
 
             Each preset component has a set of preset properties that you
             can specify values for. You can add custom properties that would

doc/qtdesignstudio/src/views/qtquick-connection-view.qdoc

@@ -85,7 +85,7 @@
         \li \uicontrol Properties
         \li Add custom properties that would not otherwise exist for a
             particular preset component or your own custom component.
-        \li \l{Specifying Dynamic Properties}
+        \li \l{Specifying Custom Properties}
     \if defined(qtcreator)
     \row
         \li \uicontrol Backends

doc/qtdesignstudio/src/views/qtquick-properties-view.qdoc

@@ -44,6 +44,26 @@
 
     \image qmldesigner-element-properties.png "Rectangle and Text properties"
 
+    \section1 Custom Properties
+
+    Custom Properties are properties that the user has added to the component.
+
+    There are two types of custom properties:
+
+    \table
+      \header
+        \li Custom Property Type
+        \li Description
+      \row
+        \li Local Custom Property
+        \li A property that has been added for a \l{Preset Components}{preset component}.
+      \row
+        \li Exposed Custom Property
+        \li A property that has been added inside a component.
+    \endtable
+
+    \image custom-properties.png
+
     \section1 Summary of Properties View Buttons
 
     The following table lists the \uicontrol Properties view buttons: