[feature] Rework multipart geometry labeling (Request in QGIS) #10676
Description
Request for documentation
From pull request qgis/QGIS#64540
Author: @nyalldawson
QGIS version: 4.0
**[feature] Rework multipart geometry labeling **
PR Description:
(includes qgis/QGIS#64537)
The existing checkbox for “Label every part of multi-part features” has been re-worked to use a combobox to expose the choice of multi-part handling options.
The available options are:
- “Label largest part only”. This corresponds to the current default behavior, i.e. when the user has left the "label every part" checkbox unchecked.
- “Label every part with same text”. This corresponds to the current behavior which is activated when the user manually checks the "label every part" checkbox
- “Split label text lines over parts”. This is a brand new behavior, as described below.
The new behavior option splits the label text over the parts of a multi-geometry feature.
The label text will be split at new line characters, and each line will be placed separately over corresponding parts from the input
feature geometry. Note that the splitting will occur AFTER the existing setting for "Wrap on character" is applied, so any custom new line character the user has configured for that setting will be respected when placing labels for multipart geometries.
If the multipart geometry does not contain sufficient parts for the label text then the excess lines will be ignored.
Sponsored by LINZ
Commits tagged with [need-docs] or [FEATURE]
"[feature] Rework multipart geometry labeling\n\nThe existing checkbox for “Label every part of multi-part features” has been re-worked\nto use a combobox to expose the choice of multi-part handling options.\n\nThe available options are:\n\n- “Label largest part only”. This corresponds to the current default behavior,\n i.e. when the user has left the "label every part" checkbox unchecked.\n- “Label every part with same text”. This corresponds to the current\n behavior which is activated when the user manually checks the "label\n every part" checkbox\n- “Split label text lines over parts”. This is a brand new behavior,\n as described below.\n\nThe new behavior option splits the label text over the parts of a\nmulti-geometry feature.\n\nThe label text will be split at new line characters, and each line\nwill be placed separately over corresponding parts from the input\nfeature geometry. Note that the splitting will occur AFTER the existing\nsetting for "Wrap on character" is applied, so any custom new line\ncharacter the user has configured for that setting will be respected\nwhen placing labels for multipart geometries.\n\nIf the multipart geometry does not contain sufficient parts for the\nlabel text then the excess lines will be ignored."