From 01d42dfb3c3259533c4564b486b4c499e886e822 Mon Sep 17 00:00:00 2001 From: DelazJ Date: Tue, 16 Apr 2024 16:49:38 +0200 Subject: [PATCH 1/4] Clarify other possible interactions in attribute table also add a few syntax fixes --- .../working_with_vector/attribute_table.rst | 50 +++++++++---------- 1 file changed, 24 insertions(+), 26 deletions(-) diff --git a/docs/user_manual/working_with_vector/attribute_table.rst b/docs/user_manual/working_with_vector/attribute_table.rst index b048810e55a..10e35c966d2 100644 --- a/docs/user_manual/working_with_vector/attribute_table.rst +++ b/docs/user_manual/working_with_vector/attribute_table.rst @@ -302,11 +302,11 @@ selects the row in the attribute table. If the set of features selected in the map canvas (or attribute table) is changed, then the selection is also updated in the attribute table (or map canvas) accordingly. -Rows can be selected by clicking on the row number on the left side of the -row. **Multiple rows** can be marked by holding the :kbd:`Ctrl` key. +Rows can be selected by clicking on the row number on the left side of the row. +**Multiple rows** can be marked by holding the :kbd:`Ctrl` key. A **continuous selection** can be made by holding the :kbd:`Shift` key and -clicking on several row headers on the left side of the rows. All rows -between the current cursor position and the clicked row are selected. +clicking on several row headers on the left side of the rows. +All rows between the current cursor position and the clicked row are selected. Moving the cursor position in the attribute table, by clicking a cell in the table, does not change the row selection. Changing the selection in the main canvas does not move the cursor position in the attribute table. @@ -328,7 +328,7 @@ combinations previously exposed. Beyond selecting features with the mouse, you can perform automatic selection based on feature's attribute using tools available in the attribute table -toolbar, such as (see section :ref:`automatic_selection` and following one for +toolbar, such as (see section :ref:`automatic_selection` and subsequent for more information and use case): * |expressionSelect| :guilabel:`Select By Expression...` @@ -337,7 +337,7 @@ more information and use case): * |selectAll| :guilabel:`Select All Features` * |invertSelection| :guilabel:`Invert Feature Selection`. -It is also possible to select features using the :ref:`filter_select_form`. +It is also possible to :ref:`select features using forms `. .. _filter_features: @@ -451,11 +451,11 @@ To clear the filter, either select the :guilabel:`Show all features` option from the bottom left pull-down menu, or clear the expression and click :guilabel:`Apply` or press :kbd:`Enter`. -Using action on features -======================== +More actions on features +------------------------ -Users have several possibilities to manipulate feature with the contextual menu -like: +Users have several possibilities to manipulate feature in an attribute table. +Right-click in a cell and you can: * :guilabel:`Select all` (:kbd:`Ctrl+A`) the features; * Copy the content of a cell in the clipboard with :guilabel:`Copy cell content`; @@ -464,6 +464,8 @@ like: * :guilabel:`Flash feature`, to highlight it in the map canvas; * :guilabel:`Open form`: it toggles attribute table into form view with a focus on the clicked feature. +* Display a :ref:`list of actions `, previously enabled + in the :menuselection:`Layer properties --> Actions` tab. .. _figure_copy_cell: @@ -472,27 +474,23 @@ like: Copy cell content button -If you want to use attribute data in external programs (such as Excel, -LibreOffice, QGIS or a custom web application), select one or more row(s) and -use the |copySelected| :sup:`Copy selected rows to clipboard` button or press -:kbd:`Ctrl+C`. - .. _geometry_format: -In :menuselection:`Settings --> Options --> Data Sources` menu you can -define the format to paste to with :guilabel:`Copy features as` dropdown -list: - -* Plain text, no geometry, -* Plain text, WKT geometry, -* GeoJSON +If you want to use attribute data in external programs (such as Excel, +LibreOffice, or a custom web application), select one or more row(s) and +use the |copySelected| :sup:`Copy selected rows to clipboard` button +or press :kbd:`Ctrl+C`. -You can also display a list of actions in this contextual menu. This is enabled -in the :menuselection:`Layer properties --> Actions` tab. -See :ref:`actions_menu` for more information on actions. +In :menuselection:`Settings --> Options --> Data Sources` menu you can +define the format to paste to with :guilabel:`Copy features as` dropdown list: Saving selected features as new layer ------------------------------------- +* :guilabel:`Plain text, no geometry`: attributes are copied as text + but the geometry is skipped +* :guilabel:`Plain text, WKT geometry`: attributes are copied as text + and the geometry is returned in WKT +* :guilabel:`GeoJSON`: attributes and geometry are formatted as GeoJSON data The selected features can be saved as any OGR-supported vector format and also transformed into another coordinate reference system (CRS). In the @@ -721,7 +719,7 @@ Under the :guilabel:`Feature` column, panel will display following information: * Depending on the geometry type, cartesian measurements of length, perimeter, or area in the layer's CRS units. For 3D line vectors, the cartesian line length is available. * Depending on the geometry type and if an ellipsoid is set in the :guilabel:`Project Properties` - dialog (:guilabel:`General` --> :guilabel:`Measurements`), ellipsoidal values + dialog (:menuselection:`General --> Measurements`), ellipsoidal values of length, perimeter, or area using the specified units. * The count of geometry parts in the feature and the number of the part clicked. * The count of vertices in the feature. From 76897f455c727fb863aa215cf766095274b1f384 Mon Sep 17 00:00:00 2001 From: DelazJ Date: Tue, 16 Apr 2024 17:03:40 +0200 Subject: [PATCH 2/4] Introduce editing in attribute table and mention some more related tools --- .../working_with_vector/attribute_table.rst | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/docs/user_manual/working_with_vector/attribute_table.rst b/docs/user_manual/working_with_vector/attribute_table.rst index 10e35c966d2..5c6f3acd6c9 100644 --- a/docs/user_manual/working_with_vector/attribute_table.rst +++ b/docs/user_manual/working_with_vector/attribute_table.rst @@ -506,7 +506,12 @@ It is also possible to specify GDAL creation options within the dialog. Editing attribute values ========================= -Editing attribute values can be done by: +In order to modify data in an attribute table, you should first toggle the layer into edit. +Press the |toggleEditing| :sup:`Toggle Editing` button. +Depending on the layer geometry type and the clipboard state, +a few more tools are enabled in the attribute table top toolbar. + +Editing attribute values can then be done by: * typing the new value directly in the cell, whether the attribute table is in table or form view. Changes are hence done cell by cell, feature by feature; @@ -518,6 +523,12 @@ Editing attribute values can be done by: * or using the :ref:`multi edit ` mode: update in a row multiple fields for multiple features. +Putting the layer into edit mode will also allow you to +|editPaste| :sup:`Paste features from clipboard` (:kbd:`Ctrl+V`) +|editCut| :sup:`Cut selected rows to clipboard` (:kbd:`Ctrl+X`) +or |deleteSelectedFeatures| :sup:`Delete selected features`. +More details at :ref:`editing_vector`. + .. _vector_field_calculator: Using the Field Calculator From 75c2e0199a86e63d370a3f7d43fd8a60fef493e1 Mon Sep 17 00:00:00 2001 From: DelazJ Date: Tue, 16 Apr 2024 17:05:17 +0200 Subject: [PATCH 3/4] Remove mention of save as new layer procedure - not really related to the attributes table context --- docs/user_manual/working_with_vector/attribute_table.rst | 9 --------- 1 file changed, 9 deletions(-) diff --git a/docs/user_manual/working_with_vector/attribute_table.rst b/docs/user_manual/working_with_vector/attribute_table.rst index 5c6f3acd6c9..80b52f328b7 100644 --- a/docs/user_manual/working_with_vector/attribute_table.rst +++ b/docs/user_manual/working_with_vector/attribute_table.rst @@ -484,21 +484,12 @@ or press :kbd:`Ctrl+C`. In :menuselection:`Settings --> Options --> Data Sources` menu you can define the format to paste to with :guilabel:`Copy features as` dropdown list: -Saving selected features as new layer -------------------------------------- * :guilabel:`Plain text, no geometry`: attributes are copied as text but the geometry is skipped * :guilabel:`Plain text, WKT geometry`: attributes are copied as text and the geometry is returned in WKT * :guilabel:`GeoJSON`: attributes and geometry are formatted as GeoJSON data -The selected features can be saved as any OGR-supported vector format and -also transformed into another coordinate reference system (CRS). In the -contextual menu of the layer, from the :guilabel:`Layers` panel, click on -:menuselection:`Export --> Save selected features as...` to define the name of -the output dataset, its format and CRS (see section :ref:`general_saveas`). You'll -notice that |checkbox| :menuselection:`Save only selected features` is checked. -It is also possible to specify GDAL creation options within the dialog. .. index:: Field Calculator, Derived Fields, Virtual Fields, Fields edit .. _calculate_fields_values: From 00eccd5d690236e01a2ea484d19dac423c05ae73 Mon Sep 17 00:00:00 2001 From: Harrissou Sant-anna Date: Sat, 20 Apr 2024 16:06:12 +0000 Subject: [PATCH 4/4] Fixes typo --- docs/user_manual/working_with_vector/attribute_table.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/user_manual/working_with_vector/attribute_table.rst b/docs/user_manual/working_with_vector/attribute_table.rst index 80b52f328b7..1f01a0c2c8b 100644 --- a/docs/user_manual/working_with_vector/attribute_table.rst +++ b/docs/user_manual/working_with_vector/attribute_table.rst @@ -518,7 +518,7 @@ Putting the layer into edit mode will also allow you to |editPaste| :sup:`Paste features from clipboard` (:kbd:`Ctrl+V`) |editCut| :sup:`Cut selected rows to clipboard` (:kbd:`Ctrl+X`) or |deleteSelectedFeatures| :sup:`Delete selected features`. -More details at :ref:`editing_vector`. +More details at :ref:`editingvector`. .. _vector_field_calculator: