Important

翻译是一项社区工作:ref:你可以加入<translation_guidelines>。此页面目前翻译进度为 98.89%。

18.2.5. 图例项

图例 项是一个方框或表格，用于说明地图中所用符号的含义。图例随后会绑定到一个地图项上。您可以使用 添加图例 工具，按照 items creation instructions 的说明添加图例项，并以 Interacting with layout items 中所述的方式对其进行操作。

默认情况下，图例项会显示所有可用图层，并可通过其 项属性 面板进行细化。除了 items common properties 中所述的通用属性外，该功能还具有以下特性（见 Fig. 18.27）：

Fig. 18.27 图例的项属性面板

18.2.5.1. 主要属性

图例 项属性 面板的 主要属性 组提供了以下功能 (看图:numref:figure_layout_legend_ppt):

Fig. 18.28 图例的主要属性组

在主要属性，你可以

• 更改图例的 标题 。可以使用 data-defined override 设置使其动态，例如在生成地图集时很有用；

• 选择哪个 地图 做当前图例参考的项目。默认情况下，会选择绘制图例项所在的地图。如果没有，则回退到 reference map。

  Note

  链接的地图项的 Variables 例如(@map_id, @map_scale, @map_extent...) 也可以从图例的数据定义属性中访问。

• 在给定字符上换行图例的文本：每当该字符出现时，它就被换行符替换；

• 设置图例中的符号和文本位置：排列 可以是 符号居左 或者 符号居右。默认值取决于所使用的语言环境（是否从右向左）。

• 使用 调整至内容大小 来控制图例是否应该自动调整大小以适合其内容。如果取消勾选，则图例将永远不会调整大小，而只是坚持用户设置的大小。任何不适合尺寸的内容都会被裁剪掉。

18.2.5.2. 图例项

图例 项属性 面板的 图例项 组提供了以下功能 (看图 Fig. 18.29)：

Fig. 18.29 图例项组

• 如果选中 自动更新 ，图例将自动更新。当 自动更新 被选中时，这将给你更多的控制图例项目。图例项目列表下面的所有图标将被激活。

• 图例项窗口列出了所有图例项目，并允许您更改项目顺序、组层、删除和恢复列表中的项目、编辑图层名称和符号或添加过滤器。

  • 使用 ^全部展开 和|collapseTree| ^全部折叠 按钮分别展开或折叠图例树中的所有组和子组。确保 自动更新 未选中以使用这些按钮。

  • 可以使用 向上和 向下按钮或使用“拖放”功能更改项目顺序。不能更改WMS图例图形的顺序。

  • 使用 按钮添加图例组。

  • 使用 按钮添加层，使用 按钮删除组，层或符号类。

  •   按钮用于编辑图层、组名或标题。首先，您需要选择图例项。双击该项还会打开文本框以重命名它。

  • 按钮使用表达式来定制所选图层的每个符号标签 (参见 数据定义图例标签)

  • 按钮为每一类向量层添加一个特征计数。

  • ^{过滤表达式} 可以帮助你过滤一个层的哪些图例项将被显示，即使用一个有不同图例项的层（例如，来自基于规则的或分类的符号），你可以指定一个布尔表达式从图例树中删除，样式没有满足条件的特征。请注意，这些特性仍然保留并显示在布局地图项中。

  虽然图例项的默认行为是模仿 图层 面板树，显示相同的组，层和符号类，右键单击任何项目为您提供隐藏层的名称或将其提升为组或子组的选项。如果你对一个图层做了一些改变，你可以通过在图例条目的上下文菜单中选择 重置为默认 来恢复它们。

  在QGIS主窗口更改符号后，您可以单击 全部更新 来适应打印布局的图例元素的更改。

• 使用 仅显示当前地图内容关联的图例项，只有在链接地图中可见的图例项目将在图例中列出。如果你有多个地图，你可以点击 ... 并从布局中选择其他地图。当 自动更新 激活时，此工具仍然可用。

• 在生成具有多边形特征的地图集时，您可以过滤掉位于当前地图集要素之外的图例项目。要做到这一点，勾选 只显示当前地图集要素内部的项 选项。

数据定义图例标签

允许您为给定图层的每个符号标签添加 expressions 新增变量(@symbol_label ，@symbol_id 和``@symbol_count``) 可以帮助您与图例条目进行交互。

例如，对于一个按 type 字段进行分类的 regions 图层，您可以在图例中每个类别后附加其要素数量和总面积，例如：Borough (3) - 850ha。

1. 在图例树中选择图层条目

2. 按 按钮，打开 表达式构建器 对话框

3. 输入如下表达式 (假设没有编辑过符号标签):

   format( '%1 (%2) - %3ha',
           @symbol_label,
           @symbol_count,
           round( aggregate(@layer, 'sum', $area, filter:= "type"=@symbol_label)/10000 )
         )
   

4. 按 OK 按钮

自定义图例项

图例项目也可以在 图例项属性`中单独定制。 但是这些定制只能在 |checkbox| :guilabel:`自动更新 禁用时使用.

双击一个项或按 ^{编辑所选项的属性} 允许进一步定制。

标注

对于所有项目类型，它允许通过使用 插入或编辑一个表达式... 输入或插入表达式来修改标签文本。表达式也可以通过使用[% expression %]表示法直接添加到条目标签的任何位置。

列

图例项属性还允许您通过强制列分割发生在特定项或层的所有符号之后来控制列分割行为。在这个控件中，还可以允许或阻止层及其子层的自动分割。

图斑

对于带有符号的项，图例项属性允许您指定符号占用的最大高度和宽度。

对于矢量符号，您可以为符号指定自定义形状。形状通常由表达式定义，以表示简单平面中的几何形状，但这些符号也可以保存在样式管理器中，以后再导入。每个几何图形类型的默认符号也可以通过样式管理器来控制。

自定义符号

也可以为矢量符号指定自定义符号。这在需要微调某个特定符号的渲染效果、在图例中对其进行增强，或使用一个与其真实符号预览无关的符号时非常有用。该自定义符号将覆盖图例中的符号，但仍会考虑所指定的符号 图斑 设置。

18.2.5.3. 字体和文本格式

图例 项目属性 面板的 字体与文本格式 组提供以下功能：

Fig. 18.30 图例字体属性

• 您可以使用 font selector 控件，分别更改图例项中的图例标题、组、子组和项（要素）的字体，并享有 text formatting 的全部功能（包括字间距控制、混合 HTML 格式、颜色、混合模式、背景、文字缓冲、阴影等）。

• 对于这些内容，你可以设置文本:guilabel:对齐 ：它可以是 左对齐 （默认为从左到右的区域）， 水平居中 或 右对齐 （默认为从右到左的区域）。

18.2.5.4. 列

在“图例项属性”面板的 列 组下，图例项 可以排列在几个列上：

• 设置 计数 字段中的列数。这个值可以是动态的，例如：图集特征、图例内容、帧大小……

• 列宽相等 设置图例列的调整方式。

• 分割图层 选项允许在列之间划分分类或分级图层图例。

Fig. 18.31 图例列设置

18.2.5.5. 符号

图例 项属性 面板的 符号 组配置图例标签旁边显示的符号的大小。您可以:

• 设置 符号宽度 和 符号高度

• 设置标记的' 最小符号大小 和 最大符号大小: 0.00mm 表示没有设置值。

• 为栅格符号绘制描边：这将为栅格图层的波段符号添加一个轮廓； 你可以设置 描边颜色 和 厚度。

Fig. 18.32 图例的符号配置

18.2.5.6. WMS 图例图形

图例的 项属性 面板中的 WMS 图例图形`（WMS LegendGraphic）部分提供以下功能（参见 :numref:`figure_layout_legend_wms）：

Fig. 18.33 WMS 图例图形

当您添加了 WMS 图层并插入图例项时，系统会向 WMS 服务器发送请求以获取 WMS 图例。该图例仅在 WMS 服务器支持 GetLegendGraphic 功能时才会显示，且图例内容将以栅格图像形式提供。

WMS 图例图形 用于调整 WMS 图例栅格图像的 图例宽度 和 图例高度。

18.2.5.7. 间距

The Spacing section allows you to customize the spacing within the legend. Spacing can greatly help denote the groupement of items in the legend and their relation.

标题、组、子组、符号、标签、框、列和行周围和之前的 间距 可以通过这个对话框自定义。