Fenêtre Propriétés d’une couche vecteur¶

Rendu Symbole Unique¶

The Single Symbol renderer is used to render all features of the layer using a single user-defined symbol. See The Symbol Selector for further information about symbol representation.

Propriétés “Symbole Unique” de ligne

Aucun rendu de symbole¶

Le type de rendu Aucun Symbole est un cas particulier du rendu en Symbole unique car il applique le même style à toutes les entités. Avec ce rendu, aucun symbole ne sera dessiné pour représenter les entités mais les étiquettes, les diagrammes et tout ce qui ne concerne pas les symboles seront affichés.

Il est toujours possible de faire des sélections sur la couche dans le canevas et les entités sélectionnées seront affichées avec un symbole par défaut. Les entités en cours d’édition seront également affichées.

Cela permet de faire un raccourci pour les couches dont vous voulez uniquement afficher les étiquettes ou les diagrammes et évite de générer des symboles avec un remplissage/bordure complètement transparent.

Rendu Catégorisé¶

The Categorized renderer is used to render the features of a layer, using a user-defined symbol whose aspect reflects the discrete values of a field or an expression. The Categorized menu allows you to

• sélectionner un champ existant (en utilisant la liste déroulante Colonne) ;

• tapez ou construire une expression en utilisant le ^{Calculateur d’expressions}. Le résultat de l’expression peut être de n’importe quel type, par exemple :

  • être une comparaison comme monChamp >= 100, $id = @atlas_featureid, monChamp % 2 = 0, within( $geometry, @atlas_geometry ). Dans ce cas, QGIS renvoie les valeurs 1 (Vrai) ou 0 (Faut).

  • combiner différents champs, comme concat( champ1, ‘ ‘, champ2 )`, particulièrement utile lorsque vous souhaitez classer vos entités sur les valeurs de deux ou plusieurs champs en même temps.

  • être un résultat d’un calcul de champs, comme monChamp % 2, year( monChamp ) champ_1 + champ_2`.

  • transformer des valeurs continues en classes discrètes, comme :

    CASE WHEN x > 1000 THEN 'Big' ELSE 'Small' END

  • combiner plusieurs valeurs discrètes en une seule catégorie, comme :

    CASE
    WHEN building IN ('residence', 'mobile home') THEN 'residential'
    WHEN building IN ('commercial', 'industrial') THEN 'Commercial and Industrial'
    END

  Note

  Même si vous pouvez utiliser n’importe quel type d’expression pour classer vos entités, pour les expressions les plus complexes, il est sans doute plus simple d’utiliser le :ref:`rule-based rendering `.

• choisir le symbole (en utilisant la fenêtre The Symbol Selector) qui sera utilisé comme symbole de base pour chaque classe ;

• les couleurs (en utilisant la liste des palettes de couleur) parmi lesquelles la couleur appliquée au symbole est choisie.

Then click on [Classify] button to create classes from the distinct value of the attribute column. Each class can be disabled unchecking the checkbox at the left of the class name.

Pour changer le symbole, la valeur et / ou la légende, double-cliquez sur l’élément à modifier.

Un clic-droit vous propose de Copier / Coller, Modifier la couleur, Modifier la transparence, Modifier l’unité de sortie ou Modifier la taille.

L’exemple de la figure figure_categorized_symbology montre le rendu des catégories de la couche des rivières de l’échantillon de données de QGIS.

Options du mode de rendu Catégorisé

Rendu Gradué¶

The Graduated renderer is used to render all the features from a layer, using an user-defined symbol whose color or size reflects the assignment of a selected feature’s attribute to a class.

De la même manière que le rendu catégorisé, le rendu Gradué permet de faire varier l’angle de rotation et la taille des symboles selon les valeurs des champs spécifiés.

De la même façon que le rendu Catégorisé, il vous permet de choisir :

• L’attribut (en utilisant la liste déroulante de Colonne ou la fonction ^{Définir une expression de colonne})

• le symbole (en utilisant la fenêtre de Sélection de symbole)

• Le format de la légende et la précision des valeurs numériques

• La méthode à utiliser pour modifier la couleur ou la taille des symboles

• Les couleurs (en utilisant la liste des palettes de couleur), si la méthode couleur est sélectionnée

• La taille (en choisissant une plage de valeurs et les unités)

Ensuite vous pouvez utiliser l’onglet Histogramme qui permet d’afficher un histogramme interactif des valeurs du champ ou de l’expression utilisé pour le rendu. Les classes peuvent être définies ou ajoutées depuis l’histogramme.

De retour dans l’onglet Classes, vous pouvez choisir le nombre de classes et la méthode de classification (depuis la liste déroulante Mode). Les modes disponibles sont :

• Equal Interval: each class has the same size (e.g. values from 0 to 16 and 4 classes, each class has a size of 4);
• Quantile: each class will have the same number of element inside (the idea of a boxplot);
• Natural Breaks (Jenks): the variance within each class is minimal while the variance between classes is maximal;
• Standard Deviation: classes are built depending on the standard deviation of the values;

• Jolies ruptures: Calcule une séquence d’environ n+1 valeurs d’espacement équidistantes qui couvrent la plage des valeurs de x. Les valeurs sont choisies de sorte qu’elles soient 1, 2 ou 5 fois une puissance de 10. (basé sur ‘jolis points d’arrêt’ de l’environnement statistique de R http://astrostatistics.psu.edu/datasets/R/html/base/html/pretty.html)

The listbox in the center part of the Style tab lists the classes together with their ranges, labels and symbols that will be rendered.

Cliquez sur le bouton Classer pour générer les classes selon le mode choisi. Chaque classe peut être désactivée en décochant la case située à gauche du symbole de classe.

Pour changer le symbole, la valeur et / ou la légende, double-cliquez sur l’élément à modifier.

Un clic-droit vous propose de Copier / Coller, Modifier la couleur, Modifier la transparence, Modifier l’unité de sortie ou Modifier la taille.

L’exemple de la figure figure_graduated_symbology montre le rendu gradué de la couche des rivières de l’échantillon de données de QGIS.

Options du mode de rendu Gradué

Symboles Proportionnels et Analyse Multivariée¶

Proportional Symbol and Multivariate Analysis are not rendering types available from the Style rendering drop-down list. However with the Size Assistant options applied over any of the previous rendering options, QGIS allows you to display your point and line data with such representation.

Créer des Symboles Proportionnels

Proportional rendering is done by first applying to the layer the Rendu Symbole Unique. Once you set the symbol, at the upper level of the symbol tree, the Data-defined override button available beside Size or Width options (for point or line layers respectively) provides tool to create proportional symbology for the layer. An assistant is moreover accessible through the menu to help you define size expression.

Varying size assistant

The assistant lets you define:

• The attribute to represent, using the Field listbox or the ^{Set column expression} function (see Expressions)
• the scale method of representation which can be ‘Flannery’, ‘Surface’ or ‘Radius’
• The minimum and maximum size of the symbol
• The range of values to represent: The down pointing arrow helps you fill automatically these fields with the minimum (or zero) and maximum values returned by the chosen attribute or the expression applied to your data.
• An unique size to represent NULL values.

To the right side of the dialog, you can preview the features representation within a live-update widget. This representation is added to the layer tree in the layer legend and is also used to shape the layer representation in the print composer legend item.

The values presented in the varying size assistant above will set the size ‘Data-defined override’ with:

coalesce(scale_exp(Importance, 1, 20, 2, 10, 0.57), 1)

Créer une analyse multivariée

Un rendu d’analyse multivariée vous aide à évaluer la relation entre deux ou plus de variables, par exemple, l’une peut être représenté par une palette de couleur alors que l’autre est représenté par une variation de taille.

The simplest way to create multivariate analysis in QGIS is to first apply a categorized or graduated rendering on a layer, using the same type of symbol for all the classes. Then, clicking on the symbol [Change] button above the classification frame, you get the The Symbol Selector dialog from which, as seen above, you can activate and set the size assistant option either on size (for point layer) or width (for line layer).

Like the proportional symbol, the size-related symbol is added to the layer tree, at the top of the categorized or graduated classes symbols. And both representation are also available in the print composer legend item.

Multivariate example

Rule-based Renderer¶

The Rule-based renderer is used to render all the features from a layer, using rule-based symbols whose aspect reflects the assignment of a selected feature’s attribute to a class. The rules are based on SQL statements. The dialog allows rule grouping by filter or scale, and you can decide if you want to enable symbol levels or use only the first-matched rule.

To create a rule, activate an existing row by double-clicking on it, or click on ‘+’ and click on the new rule. In the Rule properties dialog, you can define a label for the rule. Press the button to open the expression string builder. In the Function List, click on Fields and Values to view all attributes of the attribute table to be searched. To add an attribute to the field calculator Expression field, double click on its name in the Fields and Values list. Generally, you can use the various fields, values and functions to construct the calculation expression, or you can just type it into the box (see Expressions). You can create a new rule by copying and pasting an existing rule with the right mouse button. You can also use the ‘ELSE’ rule that will be run if none of the other rules on that level matches. Since QGIS 2.8 the rules appear in a tree hierarchy in the map legend. Just double-click the rules in the map legend and the Style tab of the layer properties appears showing the rule that is the background for the symbol in the tree.

L’exemple de la figure figure_rule_based_symbology montre le rendu basé sur des règles pour la couche des rivières de l’échantillon de données de QGIS.

Options du mode de rendu par Ensemble de Règles

Point displacement Renderer¶

The Point Displacement renderer works to visualize all features of a point layer, even if they have the same location. To do this, the symbols of the points are placed on a displacement circle around one center symbol or on several concentric circles.

Fenêtre Déplacement de points

Inverted Polygon Renderer¶

Le rendu en Polygones inversés permet de définir un symbole à appliquer à l’extérieur des polygones de la couche. Comme précédemment, vous pouvez alors choisir parmi des sous-modes de rendu : Symbole unique, Gradué, Catégorisé, Ensemble de règles ou 2.5 D.

Fenêtre du mode de rendu en Polygones Inversés

Heatmap Renderer¶

With the Heatmap renderer you can create live dynamic heatmaps for (multi)point layers. You can specify the heatmap radius in pixels, mm or map units, choose and edit a color ramp for the heatmap style and use a slider for selecting a trade-off between render speed and quality. You can also define a maximum value limit and give a weight to points using a field or an expression. When adding or removing a feature the heatmap renderer updates the heatmap style automatically.

Fenêtre Carte de chaleur

2.5D Renderer¶

L’utilisation du rendu 2.5D permet de créer un effet 2.5D sur les entités de votre couche. Commencez par choisir une valeur de Hauteur (en unités cartographiques). Vous pouvez utiliser une valeur fixe, l’un des champs de votre calque ou une expression. Vous devez également choisir un Angle (en degrés) pour recréer la position du spectateur (0° à l’ouest, sens croissant dans le sens inverse des aiguilles d’une montre). Utilisez les options de configuration avancées pour définir la Couleur du toît et la Couleur de mur. Si vous souhaitez simuler le rayonnement solaire sur les entités de murs, cocher la case Ombrager les murs en se basant sur leur aspect. Vous pouvez également simuler une ombre en définissant une Couleur et une Taille (en unités cartographiques).

Fenêtre 2.5D

Symbols levels¶

Pour les moteurs de rendu qui permettent l’empilement des couches de symbole (seul carte de chaleur ne le permet pas), il existe une option pour contrôler l’ordre de rendu de chaque niveau de symbole.

For most of the renderers, you can access the Symbols levels option by clicking the [Advanced] button below the saved symbols list and choosing Symbol levels. For the Rule-based Renderer the option is directly available through [Symbols levels] button, while for Point displacement Renderer renderer the same button is inside the Rendering settings dialog.

Pour activer les niveaux de symbole, sélectionnez Niveaux de symboles.... Chaque ligne représentera un exemple de symbole combiné avec son étiquette et la couche de symbole divisée en colonnes avec numéro dans chacune d’elles. Ces nombres représentent l’ordre de représentation de la couche. Les valeurs faibles sont dessinées en premier, en restant vers le bas alors que les valeurs les plus importantes sont dessinées plus tard, au dessus des autres.

Fenêtre Niveaux de symbole

Différence de rendu selon que les niveaux de symboles sont activés (A) ou non (B)

Effets¶

Pour améliorer le rendu de la couche et éviter (ou au moins réduire) d’utiliser un autre logiciel pour l’édition finale des cartes, QGIS fournit une autre fonctionnalité puissante: les options d’ Effets qui ajoute des effets d’affichage afin de personnaliser la visualisation des couches vecteur.

The option is available in the Layer Properties –> Style dialog, under the Layer rendering group (applying to the whole layer) or in symbol layer properties (applying to corresponding features). You can combine both usage.

Paint effects can be activated by checking the Draw effects option and clicking the ^{Customize effects} button, that will open the Effect Properties Dialog (see figure_effects_source). The following effect types, with custom options are available:

• Source: Draws the feature’s original style according to the configuration of the layer’s properties. The transparency of its style can be adjusted.

  

  Effets: boîte de dialogue pour Source.

• Blur: Adds a blur effect on the vector layer. The options that someone can change are the Blur type (Stack or Gaussian blur), the strength and transparency of the blur effect.

  

  Effets: boîte de dialogue Flou.

• Colorize: This effect can be used to make a version of the style using one single hue. The base will always be a grayscale version of the symbol and you can use the Grayscale to select how to create it (options are: ‘lightness’, ‘luminosity’ and ‘average’). If Colorise is selected, it will be possible to mix another color and choose how strong it should be. You can also control the Brightness, contrast and saturation levels of the resulting symbol.

  

  Effets: boîte de dialogue Coloriser.

• Drop Shadow: Using this effect adds a shadow on the feature, which looks like adding an extra dimension. This effect can be customized by changing the offset degrees and radius, determining where the shadow shifts towards to and the proximity to the source object. Drop Shadow also has the option to change the blur radius, the transparency and the color of the effect.

  

  Effets: boîte de dialogue de l’ombre portée.

• Inner Shadow: This effect is similar to the Drop Shadow effect, but it adds the shadow effect on the inside of the edges of the feature. The available options for customization are the same as the Drop Shadow effect.

  

  Effets: boîte de dialogue de l’ombre intérieure.

• Inner Glow: Adds a glow effect inside the feature. This effect can be customized by adjusting the spread (width) of the glow, or the Blur radius. The latter specifies the proximity from the edge of the feature where you want any blurring to happen. Additionally, there are options to customize the color of the glow, with a single color or a color ramp.

  

  Effets: boîte de dialogue de luminescence interne.

• Outer Glow: This effect is similar to the Inner Glow effect, but it adds the glow effect on the outside of the edges of the feature. The available options for customization are the same as the Inner Glow effect.

  

  Effets: boîte de dialogue de luminescence externe.

• Transform: Adds the possibility of transforming the shape of the symbol. The first options available for customization are the Reflect horizontal and Reflect vertical, which actually create a reflection on the horizontal and/or vertical axes. The 4 other options are:

  • Shear: slants the feature along the x and/or y axis
  • Scale: enlarges or minimizes the feature along the x and/or y axis by the given percentage
  • Rotation: turns the feature around its center point
  • and Translate changes the position of the item based on a distance given on the x and/or the y axis.
  

  Effets: boîte de dialogue Transformer.

There are some common options available for all draw effect types. Transparency and Blend mode options work similar to the ones described in Rendu de couche and can be used in all draw effects except for the transform one.

One or more draw effects can used at the same time. You activate/deactivate an effect using its checkbox in the effects list. You can change the selected effect type by using the Effect type option. You can reorder the effects using ^{Move up} and ^{Move down} buttons, and also add/remove effects using the ^{Add effect} and ^{Remove effect} buttons.

There is also a Draw mode option available for every draw effect, and you can choose whether to render and/or to modify the symbol. Effects render from top to bottom.’Render only’ mode means that the effect will be visible while the ‘Modify only’ mode means that the effect will not be visible but the changes that it applies will be passed to the next effect (the one immediately below). The ‘Render and Modify’ mode will make the effect visible and pass any changes to the next effect. If the effect is in the top of the effects list or if the immediately above effect is not in modify mode, then it will use the original source symbol from the layers properties (similar to source).

Onglet Texte¶

In the Text tab, you can define the Font, Style, and Size of your labels’ text (see Figure_labels). There are options available to set the labels’ Color and Transparency. Use the Type case option to change the capitalization style of the text. You have the possibility to render the text as ‘All uppercase’, ‘All lowercase’ or ‘Capitalize first letter’. In Spacing, you can change the space between words and between individual letters. Finally, use the Blend mode option to determine how your labels will mix with the map features below them (see more about it in Modes de fusion).

The Apply label text substitutes option gives you ability to specify a list of texts to substitute to texts in feature labels (e.g., abbreviating street types). Replacement texts are thus used to display labels in the map canvas. Users can also export and import lists of substitutes to make reuse and sharing easier.

Onglet Formatage¶

In the Formatting tab, you can define a character for a line break in the labels with the Wrap on character option. You can also format the Line Height and the alignment. For the latter, typical values are available (left, right, and center), plus Follow label placement for point layers. When set to this mode, text alignment for labels will be dependent on the final placement of the label relative to the point. E.g., if the label is placed to the left of the point, then the label will be right aligned, while if it is placed to the right, it will be left aligned.

For line vector layers you can include Line directions symbols to help determine the lines directions. They work particularly well when used with the curved or Parallel placement options from the Placement tab. There are options to set the symbols position, and to reverse direction.

Use the Formatted numbers option to format numeric labels. You can set the number of Decimal places. By default, 3 decimal places will be used. Use the Show plus sign if you want to show the plus sign in positive numbers.

Onglet Tampon¶

To create a buffer around the labels, activate the Draw text buffer checkbox in the Buffer tab. You can set the buffer’s Size, color, and Transparency. The buffer expands from the label’s outline , so, if the color buffer’s fill checkbox is activated, the buffer interior is filled. This may be relevant when using partially transparent labels or with non-normal blending modes, which will allow seeing behind the label’s text. Deactivating color buffer’s fill checkbox (while using totally transparent labels) will allow you to create outlined text labels.

Onglet Fond¶

In the Background tab, you can define with Size X and Size Y the shape of your background. Use Size type to insert an additional ‘Buffer’ into your background. The buffer size is set by default here. The background then consists of the buffer plus the background in Size X and Size Y. You can set a Rotation where you can choose between ‘Sync with label’, ‘Offset of label’ and ‘Fixed’. Using ‘Offset of label’ and ‘Fixed’, you can rotate the background. Define an Offset X,Y with X and Y values, and the background will be shifted. When applying Radius X,Y, the background gets rounded corners. Again, it is possible to mix the background with the underlying layers in the map canvas using the Blend mode (see Modes de fusion).

Onglet Ombre¶

Use the Shadow tab for a user-defined Drop shadow. The drawing of the background is very variable. Choose between ‘Lowest label component’, ‘Text’, ‘Buffer’ and ‘Background’. The Offset angle depends on the orientation of the label. If you choose the Use global shadow checkbox, then the zero point of the angle is always oriented to the north and doesn’t depend on the orientation of the label. You can influence the appearance of the shadow with the Blur radius. The higher the number, the softer the shadows. The appearance of the drop shadow can also be altered by choosing a blend mode.

Onglet Emplacement¶

Choose the Placement tab for configuring label placement and labeling priority. Note that the placement options differ according to the type of vector layer, namely point, line or polygon.

Emplacement pour les couches de lignes¶

Label options for line layers include Parallel, Curved or Horizontal. For the Parallel and Curved options, you can set the position to Above line, On line and Below line. It’s possible to select several options at once. In that case, QGIS will look for the optimal label position. For Parallel and curved placement options, you can also use the line orientation for the position of the label. Additionally, you can define a Maximum angle between curved characters when selecting the Curved option (see Figure_labels_placement_line).

Exemples d’emplacements d’étiquettes pour une ligne

Pour les trois options d’emplacement, vous pouvez Répéter les étiquettes en spécifiant une distance minimale entre les étiquettes. Cette distance peut être en millimètres ou en Unités de la carte.

Emplacement pour les couches de polygones¶

Vous pouvez choisir parmi les options suivantes pour l’emplacement des étiquettes sur une couche de polygones (voir figure_labels_placement_polygon) :

• Décalé par rapport au centroide,

• Horizontal (lent),

• Autour du centroïde,

• Libre (lent),

• Selon le périmètre,

• Selon le périmètre (incurvé).

In the Offset from centroid settings you can specify if the centroid is of the visible polygon or whole polygon. That means that either the centroid is used for the polygon you can see on the map or the centroid is determined for the whole polygon, no matter if you can see the whole feature on the map. You can place your label within a specific quadrant, and define offset and rotation.

The Around centroid setting places the label at a specified distance around the centroid. Again, you can define visible polygon or whole polygon for the centroid.

With the Horizontal (slow) or Free (slow) options, QGIS places at the best position either a horizontal or a rotated label inside the polygon.

With the Using perimeter option, the label will be drawn next to the polygon boundary. The label will behave like the parallel option for lines. You can define a position and a distance for the label. For the position, Above line, On line, Below line and Line orientation dependent position are possible. You can specify the distance between the label and the polygon outline, as well as the repeat interval for the label.

The Using perimeter (curved) option helps you draw the label along the polygon boundary, using a curved labeling. In addition to the parameters available with Using perimeter setting, you can set the Maximum angle between curved characters polygon, either inside or outside.

Exemples d’emplacements d’étiquettes pour un polygone

In the priority section you can define the priority with which labels are rendered for all three vector layer types (point, line, polygon). This placement option interacts with the labels from other vector layers in the map canvas. If there are labels from different layers in the same location, the label with the higher priority will be displayed and the others will be left out.

Onglet Rendu¶

In the Rendering tab, you can tune when the labels can be rendered and their interaction with other labels and features.

Sous les Options des étiquettes, vous trouverez les paramètres de ref:visibilité selon l’échelle <label_scaledepend> et de visibilité basée sur la taille des pixels.

L’index z des étiquettes détermine l’ordre dans lequel les étiquettes sont générées ainsi que la relation avec les autres étiquettes dans la couche (en utilisant une expression basée sur des données) et avec les étiquettes des autres couches. Les étiquettes avec un index z élevé sont affichées au dessus des étiquettes (de n’importe qu’elle autre couche) avec une valeur d’index plus faible.

De plus, la logique a été affinée pour gérer les cas où 2 étiquettes ont un index z identique :

• Si elles sont dans la même couche, une étiquette plus petite sera toujours tracée au dessus de l’étiquette plus large.

• Si elles sont issues de couches différentes, les étiquettes sont tracées dans le même ordre que les couches (pour respecter l’ordre des couches dans la légende).

À noter que ce paramètre ne définit par comment sont tracées les étiquettes par rapport aux entités d’autres couches, il contrôle uniquement l’ordre dans lequel les étiquettes sont tracées au dessus des entités de la couche.

Lors de la génération des étiquettes et pour pouvoir afficher des étiquettes lisibles, QGIS évalue automatiquement la position des étiquettes et peut masquer certaines d’entre elles en cas de collision. Vous pouvez néanmoins choisir d’ Afficher toutes les étiquettes pour cette couche (même celles en conflit) pour pouvoir gérer manuellement leur placement.

Vous pouvez affiner quelles étiquettes seront générées en utilisant des expressions de valeurs définies par les données pour les options guilabel:Afficher l’étiquette et Toujours afficher.

Sous les Options des entités, vous pouvez choisir d’Étiqueter toutes les parties d’une entité multi-parties et vous pouvez paramétrer une de Limite du nombre d’étiquettes à afficher. Les couches de polygones et de lignes permettent d’indiquer une taille minimum d’entité pour afficher les étiquettes en utilisant Ne pas afficher d’étiquette pour les entités plus petites que. Pour les entités polygones, vous pouvez également filtrer les étiquettes à afficher selon qu’elles sont situées complètement dans l’entité ou non. Pour les entités linéaires, vous pouvez choisir de Fusionner les lignes connectées pour éviter la duplication d’étiquettes, ce qui permettra un rendu plus aéré, lorsque conjugué avec les options Distance ou Répéter de l’onglet Emplacement.

Dans la groupe Obstacles, vous pouvez gérer la manière dont les étiquettes et les entités se recouvrent. Activez l’option Éviter que les étiquettes ne recouvrent des entités pour faire en sorte que les entités de la couche agissent comme obstacle pour toute étiquette (en incluant les étiquettes des autres entités de la même couche). Un obstacle est une entité au dessus de laquelle QGIS essaye, dans la mesure du possible, de ne pas placer d’étiquette. Au lieu d’une couche tout entière, vous pouvez définir un sous-ensemble d’entités comme obstacle en utilisant le contrôle de ^{valeurs définies par les données} sur le côté de l’option.

La jauge de priorité des obstacles vous permet de modifier les préférences de recouvrement de vos étiquettes par rapport aux entités de certaines couches plutôt qu’à d’autres. Un obstacle de Poids faible signifie que les entités de la couche sont moins considérées comme des obstacles et ont plus de chances d’être recouvertes par des étiquettes. Cette priorité peut être définie par des données de telle manière qu’au sein de la même couche, certaines entités auront plus de chances d’être recouvertes que d’autres.

Pour les couches de polygones, vous pouvez choisir le type d’obstacle que les étiquettes chercheront à éviter :

• Au-dessus de l’entité : évite de placer les étiquettes à l’intérieur du polygone (les étiquettes seront placées de préférence totalement en dehors ou légèrement à l’intérieur du polygone).

• Au-dessus des limites de l’entité : évite de placer les étiquettes sur la limite du polygone (les étiquettes seront placées de préférence en dehors ou complètement à l’intérieur du polygone). Cela peut être utile pour les limites de régions où les entités recouvrent complètement une surface. Dans ce cas, il est impossible d’éviter de placer des étiquettes à l’intérieur de ces entités et l’affichage sera meilleur si on évite de placer les étiquettes sur les limites entre les entités.

La barre d’outils des Étiquettes¶

The Label Toolbar provides some tools to manipulate label or diagram properties, but only if the corresponding data-defined option is indicated (otherwise, buttons are disabled). Layer might also need to be in edit mode.

La barre d’outils des Étiquettes

While for readability, label has been used below to describe the Label toolbar, note that when mentioned in their name, the tools work almost the same way with diagrams:

• ^{Pin/Unpin Labels And Diagrams} that has data-defined position. By clicking or draging an area, you pin label(s). If you click or drag an area holding Shift, label(s) are unpinned. Finally, you can also click or drag an area holding Ctrl to toggle the pin status of label(s).
• ^{Highlight Pinned Labels And Diagrams}. If the vector layer of the label is editable, then the highlighting is green, otherwise it’s blue.
• ^{Move Label And Diagram} that has data-defined position. You just have to drag the label to the desired place.
• ^{Show/Hide Labels And Diagrams} that has data-defined visbility. If you click or drag an area holding Shift, then label(s) are hidden. When a label is hidden, you just have to click or drag an area around the feature’s point to restore its visibility.
• ^{Rotate Label}. Click the label and move around and you get the text rotated.
• ^{Change Label}. It opens a dialog to change the clicked label properties; it can be the label itself, its coordinates, angle, font, size... as long as this property has been mapped to a field.

Customize the labels from the map canvas¶

Combined with the Label Toolbar, the data defined override setting helps you manipulate labels in the map canvas (move, edit, rotate). We now describe an example using the data-defined override function for the ^{Move label} function (see figure_labels_data_defined).

1. Importez la couche lakes.shp depuis le jeu de données test de QGIS.

2. Double-cliquez la couche pour ouvrir la fenêtre des Propriétés. Sélectionnez Etiquettes puis Emplacement et enfin Décalage par rapport au centroïde.

3. Dans le cadre Défini par les données, cliquez sur l’icône pour définir le champ correspondant à la coordonnée. Choisissez xlabel pour X et ylabel pour Y. Les icônes revêtent maintenant une surbrillance jaune.

   

   Étiquetage d’une couche vectorielle de polygones avec l’option ‘Défini par les données’

4. Zoomez sur un lac.

5. Set editable the layer using the ^{Toggle Editing} button.

6. Sélectionnez l’outil de la barre d’outils des Étiquettes. Vous pouvez maintenant déplacer l’étiquette manuellement vers une autre position (voir figure_labels_move). La nouvelle position est sauvegardée dans les colonnes xlabel et ylabel de votre table attributaire.

7. Using The Geometry Generator with the expression below, you can also add a linestring symbol layer to connect each lake to its moved label:

   make_line( centroid( $geometry ), make_point( "xlabel", "ylabel" ) )

   

   Moved labels

Paramètres généraux¶

Regardless the type of widget applied to the field, there are some common properties you can set to control whether and how a field can be edited:

• Editable: uncheck this to set the field read-only (not manually modifiable) when the layer is in edit mode. Note that checking this setting doesn’t override any edit limitation from the provider.

• Label on top: places the field name above or beside the widget in the feature form

• Default value: for new features, automatically populates by default the field with a predefined value or an expression-based one. For example, you can:

  • use $x, $length, $area to populate a field with the feature’s x coordinate, length, area or any geometric information at its creation;
  • incremente a field by 1 for each new feature using maximum("field")+1;
  • save the feature creation datetime using now();
  • use variables in expressions, making it easier to e.g. insert the operator name (@user_full_name), the project file path (@project_path), ...

  A preview of the resulting default value is displayed at the bottom of the widget.

  Note

  The Default value option is not aware of the values in any other field of the feature being created so it won’t be possible to use an expression combining any of those values i.e using an expression like concat(field1, field2) may not work.

• Constraints: you can constrain the value to insert in the field. This constraint can be:

  • Not null: force the user to provide a value

  • based on a custom expression: e.g. regexp_match(col0,'A-Za-z') to ensure that the value of the field col0 has only alphabetical letter.

    A short description of the constraint can be added and will be displayed at the top of the form as a warning message when the value supplied does not match the constraint.

Edit widgets¶

The available widgets are:

• Checkbox: Displays a checkbox, and you can define what attribute is added to the column when the checkbox is activated or not.
• Classification: Displays a combo box with the values used for classification, if you have chosen ‘unique value’ as legend type in the Style tab of the properties dialog.
• Color: Displays a color button allowing user to choose a color from the color dialog window.

• Date/Heure : Affiche un champ de type date/heure qui peut ouvrir un calendrier permettant de choisir une date, une heure ou les deux. Le champ doit être de type texte. Vous pouvez choisir un format personnalisé, l’affichage d’un calendrier, etc.

• Enumeration: Opens a combo box with values that can be used within the columns type. This is currently only supported by the PostgreSQL provider.
• External Resource: Uses a “Open file” dialog to store file path in a relative or absolute mode. It can also be used to display a hyperlink (to document path), a picture or a web page.
• File Name: Simplifies the selection by adding a file chooser dialog.

• Cachée : Un attribut caché sera invisible. L’utilisateur ne pourra pas visualiser son contenu.

• Photo: Field contains a filename for a picture. The width and height of the field can be defined.

• Plage : Vous permet de spécifier une plage de valeurs numériques disponibles. Il peut s’agir d’une barre coulissante ou d’une zone de texte éditable.

• Relation Reference: This widget lets you embed the feature form of the referenced layer on the feature form of the actual layer. See Créer des relations un ou plusieurs à plusieurs.
• Text Edit (default): This opens a text edit field that allows simple text or multiple lines to be used. If you choose multiple lines you can also choose html content.
• Unique Values: You can select one of the values already used in the attribute table. If ‘Editable’ is activated, a line edit is shown with autocompletion support, otherwise a combo box is used.
• UUID Generator: Generates a read-only UUID (Universally Unique Identifiers) field, if empty.
• Value Map: A combo box with predefined items. The value is stored in the attribute, the description is shown in the combo box. You can define values manually or load them from a layer or a CSV file.
• Value Relation: Offers values from a related table in a combobox. You can select layer, key column and value column. Several options are available to change the standard behaviours: allow null value, order by value, allow multiple selections and use of autocompleter. The forms will display either a drop-down list or a line edit field when completer checkbox is enabled.
• Web View: Field contains a URL. The width and height of the field is variable.

The drag and drop designer¶

Choose Drag and drop designer from the Attribute editor layout combobox to layout the features form within QGIS. Then, drag and drop rows from the Fields frame to the Label panel to have fields added to your custom form.

You can also use categories (tab or group frames) to better structure the form. The first step is to use the icon to create a tab in which fields and groups will be displayed (see figure_fields_layout). You can create as many categories as you want. The next step will be to assign to each category the relevant fields, using the icon. You’d need to select the targeted category beforehand. You can use the same fields many times.

Fenêtre de création de catégories avec la Mise en page de l’éditeur d’attribut

You can configure tabs or groups with a double-click. QGIS opens a form in which you can:

• choose to hide or show the item label
• rename the category
• set over how many columns the fields under the category should be distributed
• enter an expression to control the category visibility. The expression will be re-evaluated everytime values in the form change and the tab or groupbox shown/hidden accordingly.
• show the category as a group box (only available for tabs)

With a double-click on a field label, you can also specify whether the label of its widget should be visible or not in the form.

In case the layer is involved in one to many relations (see Créer des relations un ou plusieurs à plusieurs), referencing layers are listed in the Relations frame and their form can be embedded in the current layer form by drag-and-drop. Like the other items, double-click the relation label to configure some options:

• choose to hide or show the item label
• show the link button
• show the unlink button

Provide an ui-file¶

The Provide ui-file option allows you to use complex dialogs made with Qt-Designer. Using a UI-file allows a great deal of freedom in creating a dialog. Note that, in order to link the graphical objects (textbox, combobox...) to the layer’s fields, you need to give them the same name.

Use the Edit UI to define the path to the file to use.

You’ll find some example in the Creating a new form lesson of the Manuel d’exercice Qgis. For more advanced information, see http://nathanw.net/2011/09/05/qgis-tips-custom-feature-forms-with-python-logic/.

Enhance your form with custom functions¶

QGIS forms can have a Python function that is called when the dialog is opened. Use this function to add extra logic to your dialogs. The form code can be specified in three different ways:

• load from the environment: use a function, for example in startup.py or from an installed plugin)
• load from an external file: a file chooser will appear in that case to allow you to select a Python file from your filesystem
• provide code in this dialog: a Python editor will appear where you can directly type the function to use.

In all cases you must enter the name of the function that will be called (open in the example below).

Un exemple (dans le module MyForms.py):

def open(dialog,layer,feature):
    geom = feature.geometry()
    control = dialog.findChild(QWidged,"My line edit")

Reference in Python Init Function like so: open