[[TranslatedPages(outdated=Contribute to this page with images for the panel buttons.)]]
= Relations window =

[[Image(source:trunk/images/dialogs/relationlist.png,middle)]] ''Keyboard shortcut'': **`Alt+R`** — one of the [Help/ToggleDialogs#Toactivateawindow JOSM windows]. Don't confuse it with the [wiki:/Help/Dialog/RelationEditor Relation Editor] ''dialog''.

The Relations window displays the list of [wiki:/Help/Concepts/Object relations] in the [Help/Dialog/LayerList#ActivateLayer active data layer].

You can type in the box above the list to filter the relations. It searches in all keys and values of the relations.

[[Image(relation-list-dialog.png)]]


=== Right click menu ===
The right click menu (context menu) provides the following features:

||Icon || Name || Description and notes ||
|| [[Image(source:trunk/images/dialogs/select.png,middle)]] ||  \
|| Select relation ||  \
||Sets the current selection in the [wiki:Help/Dialog/SelectionList Selection window] to the in the relation list selected relations. This is the double-click action too. ||
|| [[Image(source:trunk/images/dialogs/select.png,middle)]] ||  \
|| Select relation (add)||  \
||Adds the in the relation list selected relations to the selection in the Selection window. ||
||[[Image(source:trunk/images/selectall.png,middle)]] ||  \
|| Select members ||  \
||Sets the current selection in the Selection window to all members of the in the relation list selected relations. ||
|| [[Image(source:trunk/images/selectall.png,middle)]] ||  \
|| Select members (add) ||  \
||Adds the members of the in the relation list selected relations to the selection in the Selection window. ||
||||||||
|| [[Image(source:trunk/images/dialogs/downloadincomplete.png,middle)]] ||  \
|| Download members ||  \
||Downloads all members of the in the relation list selected relations, except for new relations. ||
|| [[Image(source:trunk/images/dialogs/relation/downloadincompleteselected.png,middle)]] ||  \
|| Download incomplete members ||  \
||Downloads all incomplete members of the in the relation list selected relations. ||
||||||||
|| [[Image(source:trunk/images/exportgpx.png,middle)]] ||  \
|| Export GPX file starting from first member ||  \
||Flattens this relation to a single gpx track recursively, starting with the first member, successively continuing to the last and exports it as a gpx file ''(Route relation only)''. ||
|| [[Image(source:trunk/images/exportgpx.png,middle)]]||  \
|| Export GPX file starting from last member ||  \
||Flattens this relation to a single gpx track recursively, starting with the last member, successively continuing to the first and exports it as a gpx file. ''(Route relation only)''.||
||||||||
|| [[Image(source:trunk/images/dialogs/layerlist.png,middle)]] ||  \
||Convert to GPX layer starting from first member||  \
||Flattens this relation to a single gpx track recursively, starting with the first member, successively continuing to the last and converts it to a [wiki:Help/Dialog/LayerList gpx layer]. ''(Route relation only)''. ||
|| [[Image(source:trunk/images/dialogs/layerlist.png,middle)]] ||  \
|| Convert to GPX layer starting from last member ||   \
||Flattens this relation to a single gpx track recursively, starting with the last member, successively continuing to the first and converts it to a gpx layer. ''(Route relation only)''. ||
||||||||
|| [[Image(source:trunk/images/dialogs/conflict/copyendright.svg,middle)]] ||  \
|| Add selection to `X` relation ||  \
||Adds the in the in the Selection window selected objects to the in the relation list selected relations. `X` is replaced by the number of the in the relation list selected relations. ([ExpertMode expert mode] only) ||
||||||||
|| [[Image(osm:source:/applications/editors/josm/plugins/imagery-xml-bounds/images/xml_24.png)]] ||  \
|| XML Imagery Bounds ||  \
||Creates a shape for the source code of an Imagery entry. Requires a multipolygon or boundary relation. Requires the [wiki:/Plugins plugin] [osmwiki:JOSM/Plugins/Imagery-XML-Bounds Imagery-XML-Bounds] ||

It is possible to select multiple relations in the relation list: Hold down `Ctrl` to select one by one or `Shift` to select a range. Then you can do actions for all selected relations at once.

=== Panel Buttons ===
{{{#!comment
[[Image(source:trunk/images/dialogs/add.png,bottom,margin-right=10,inline)]]
}}}
IMG Create
 Calls the Relation editor to create a new relation.

[[Image(source:trunk/images/dialogs/edit.png,bottom,margin-right=10,inline)]] Edit 
 Calls the Relation editor with the relation chosen in the panel. With the [[Image(source:/trunk/images/svpDown.svg)]] small arrow the recently edited relations can be called again.

IMG Duplicate
 Duplicates the relation chosen and opens it with the Relation editor. 

==== [[Image(source:trunk/images/dialogs/delete.png,bottom,margin-right=10,inline,nolink)]] Delete  
 Deletes the relation chosen in the panel. 

==== [[Image(source:trunk/images/dialogs/select.png,nolink)]] Select relation ====
 Selects those relations on the map which were chosen in this panel.

== See also ==
* [wiki:/Help/Dialog/RelationEditor RelationEditor]

----
Back to [wiki:/Help/ToggleDialogs Windows][[BR]]
Back to [wiki:/Help Main Help]