21.2.5. 凡例アイテム

凡例アイテムは、地図上で使用されているシンボルの意味を説明するボックス、あるいはテーブルです。このため、凡例は地図アイテムに関連付けられます。凡例アイテムはアイテムの作成手順に従って凡例を追加ツールを使用して追加でき、レイアウトアイテムの操作と同じ方法で操作できます。

デフォルトでは、凡例アイテムは全ての利用可能なレイヤを表示しますが、これはアイテムプロパティパネルを使用して改良できます。アイテムの共通プロパティの他に、凡例アイテムには以下の機能があります（図 21.26 参照）。

../../../../_images/legend_properties.png — 図 21.26 凡例アイテムプロパティパネル

21.2.5.1. メインプロパティ 

凡例のアイテムプロパティパネルのメインプロパティグループには、下記の機能があります（図 21.27 参照）：

../../../../_images/legend_mainproperties.png — 図 21.27 凡例メインプロパティグループ

メインプロパティでは、以下の設定ができます。

凡例のタイトルの変更。データによって定義された上書きの設定を使用すれば、タイトルを動的に変更することもでき、例えば地図帳の作成時に便利です。
現在の凡例がどの地図アイテムを参照しているかの選択。デフォルトでは、描画した凡例アイテムの下にある地図が選ばれます。もし下に地図アイテムが無ければ、参照マップにフォールバックします。

注釈

リンクしている地図アイテムの変数（@map_id, @map_scale, @map_extent...）は、凡例のデータ定義のプロパティからもアクセス可能です。
指定した文字による凡例テキストの折り返し。凡例テキストにその文字が現れるたびに、改行文字で置き換えられます。
凡例内でのシンボルとテキストの配置の設定。配置は、左側のシンボルまたは右側のシンボルとすることができます。デフォルト値は使用しているロケール（右から左へと書く言語か、そうでないか）によります。
大きさを内容に合わせるを使用すると、コンテンツに合わせて凡例を自動的にサイズ変更するかどうかを制御できます。チェックしない場合には凡例のサイズ変更は行われず、ユーザーが設定した大きさに固定されます。サイズが合わないコンテンツはすべて切り取られます。

21.2.5.2. 凡例アイテム 

凡例のアイテムプロパティパネルの凡例アイテムグループには、下記の機能があります（図 21.28 参照）：

../../../../_images/legend_items.png — 図 21.28 凡例アイテムグループ

自動更新にチェックが入っていると、凡例は自動的に更新されます。When 自動更新がチェックされていない時には、凡例アイテムをより細かくコントロールすることができます。凡例アイテムのリスト下にある全てのアイコンが有効です。
凡例アイテムウィンドウにはすべての凡例アイテムが一覧表示されており、アイテムの順番の変更やレイヤのグループ化、リスト内のアイテムの削除と復元、レイヤ名とシンボロジの編集、フィルタの追加などができます。
- やボタンを使用するか、ドラッグ＆ドロップでアイテムの順序を変更できます。 WMS凡例グラフィックは順序を変更できません。
- ボタンを使用して凡例のグループを追加します。
- ボタンを使用してレイヤを追加し、ボタンを使用してグループ、レイヤまたはシンボルクラスを削除します。
- ボタンを使用して、レイヤ名やグループ名、タイトルを編集できます。最初に凡例アイテムを選択する必要があります。アイテムをダブルクリックしても、テキストボックスが開き、名前の変更ができます。
- ボタンは、選択したレイヤの各シンボルラベルをカスタマイズするために式を使用します（データ定義による凡例ラベル参照）
- ボタンは、ベクタレイヤの各クラスの地物数を凡例に追加します。
- ^{式による凡例フィルタ} は、レイヤのどの凡例アイテムを表示するかをフィルタリングするのに役立ちます。例えば、異なる凡例アイテムを持つレイヤ（ルールに基づいた、あるいはカテゴリ値によるシンボロジなど）を使って、条件式を満たす地物が無い場合にはそのスタイルを凡例ツリーから除外するためのブール式を指定することができます。ただし、そのような地物はレイアウトの地図アイテムでは残っており、表示されることに注意してください。
凡例アイテムのデフォルトの動作は、レイヤパネルツリーを模倣し、同じグループ、レイヤ、シンボロジのクラスを表示しますが、アイテムを右クリックするとレイヤ名を隠したり、グループやサブグループとして表示するオプションがあります。レイヤに何らかの変更を加えた場合は、凡例エントリのコンテキストメニューからデフォルトにリセットを選択することで、変更を元に戻すことができます。

QGISのメインウィンドウでシンボロジを変更したあと、全て更新ボタンをクリックすると、印刷レイアウトの凡例要素に変更が反映されます。
リンク先地図の内側にあるアイテムだけ表示するにチェックを入れると、リンクした地図で表示されている凡例アイテムのみが凡例にリストされます。このツールは、自動更新が有効な場合にも利用可能です。
ポリゴン地物を使用して地図帳を作成する際に、現在の地図帳地物の外にある地物の凡例アイテムをフィルタして除外できます。これを行うには、現在の地図帳地物の内部のアイテムのみを表示するオプションにチェックを入れてください。

データ定義による凡例ラベル 

により、与えられたレイヤの各シンボルラベルに式を追加できます。新しい変数（ @symbol_label 、 @symbol_id と @symbol_count ）は、凡例エントリを操作する上で役立ちます。

例えば、 regions レイヤがあり、 type フィールドで分類されているとしましょう。この凡例の各クラスに、 Borough (3) - 850ha のように地物の数と面積を追加できます：

凡例ツリー内で設定したいレイヤのエントリを選択します。
ボタンを押し、式文字列ビルダダイアログを開きます。

以下の式を入力します（ シンボルラベルは編集されていないことを仮定しています ）:

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

OK ボタンを押します。

凡例をカスタマイズする 

../../../../_images/legend_item_properties.png

凡例アイテムは凡例アイテムプロパティで個別にカスタマイズすることもできます。しかし、これらのカスタマイズは自動更新が無効になっている場合のみ可能です。

アイテムをダブルクリックするか、 ^{アイテムのプロパティを編集} を押すと、さらにカスタマイズすることができます。

ラベル

すべてのアイテムタイプについて、式の挿入・編集を使って式を入力または挿入することでラベルのテキストを変更することができます。式は[%式 %]記法を使ってアイテムのラベルの任意の場所に直接追加することもできます。

カラム

凡例プロパティは、列分割を特定のアイテムの後またはレイヤのすべてのシンボルに強制的に発生させることによって、列分割の動作を制御することもできます。このウィジェットではレイヤを基にレイヤとその子の自動分割を許可またはブロックすることもできます。

パッチ

シンボルを持つアイテムの場合、凡例アイテムプロパティでシンボルが占有できる最大の高さと幅を指定できます。

ベクタシンボルの場合、シンボルにカスタムシェイプを指定することができます。シェイプは通常、単純な平面でジオメトリを表現する式で定義されますが、これらのシンボルはスタイルマネージャに保存して後でインポートすることもできます。各ジオメトリタイプのデフォルトシンボルもスタイルマネージャで制御できます。

カスタムシンボル

カスタムシンボルはベクタシンボルにも指定できます。これは特定のシンボルのレンダリングを微調整したり、凡例でそのシンボルを強調したり、真のシンボルのプレビューから独立したシンボルを持つのに便利です。このカスタムシンボルは凡例シンボルを上書きしますが、指定されたシンボルパッチを考慮します。

21.2.5.3. フォント 

凡例のアイテムプロパティパネルのフォントグループには、下記の機能があります：

../../../../_images/legend_fonts.png — 図 21.29 凡例フォントプロパティ

フォントセレクタウィジェットを使用して、凡例アイテム内の凡例タイトル、グループ見出し、サブグループ見出しとアイテム（地物）のフォントを変更できます。
これらの各レベルで、テキストの整列の設定ができます。設定値には、左（左から右に文字を書くロケールでのデフォルト）、中央、または右（右から左に文字を書くロケールでのデフォルト）があります。
色セレクタウィジェットを使用して、ラベルの色を設定できます。選択した色は、凡例内の全てのフォントアイテムに適用されます。