Example: Add Labels to a Map

In this example we manually add labels to a map.   We can create labels automatically from fields in objects, or we can add them manually by clicking and entering the text for the label.  This example shows how to click and add a label manually.

 

Suppose we have a map with a variety of layers in it.  We want to add labels to the map manually.   We do that in two steps: first we add a new, blank labels layer to the map, and then we click into that layer to add the labels we want.    See the Example: Add Labels to a Map  topic for a step by step illustrated example of the following.

 

Creating labels manually:

 

  1. Right-click onto a blank location in the Project pane and choose Create - New Labels.

  2. Specify a Name for the new labels component.

  3. The Based on box automatically will be loaded with <new drawing> to indicate a new drawing will be created.

  4. Press Create Labels.  A new labels component will appear in the project, along with a new, blank drawing and new table to support that labels component.  

  5. Drag and drop the new labels component into the map as the uppermost layer in the map.  

  6. Nothing appears since the layer is empty.   But the lower layers will provide visual context so we can add labels in the desired locations.

 

Adding labels to a new, blank labels layer:

 

  1. In the main toolbar, choose the Create Point tool for the cursor mode.

  2. Click into the map where a label is desired.   The Record pane will pop open.

  3. In the Record pane's Text box, enter the text desired for the label.  Press Ctrl-Enter or Add Record to create the label.

  4. To format the labels layer, use the Style pane.

 

 

eg_add_labels_to_map01_01.png

 

We start with a map that has one layer in it, a drawing that shows the regions of France as areas.   We would like to add labels that give the names of surrounding oceans and countries.

 

eg_add_labels_to_map01_02.png

 

We Right-click onto a blank location in the Project pane and choose Create - New Labels.  In the New Labels dialog we accept the defaults that are offered and press Create Labels.

 

eg_add_labels_to_map01_03.png

 

 A new labels component called Labels will appear in the project, along with a new, blank drawing and new table to support that labels component.  We drag and drop the new Labels component into the map as the uppermost layer in the map.  

 

il_create_point_command.png

 

With the focus on the Labels layer, in the main toolbar's cursor mode button, we choose Create Point.  We will create point labels, that is, labels which are anchored to a specific point wherever we click.

 

eg_add_labels_to_map01_04.png

 

We click onto the location for the first label.

 

eg_add_labels_to_map01_05.png

 

A blue preview square icon appears at that location.

 

eg_add_labels_to_map01_06.png

 

The Values tab in the Record pane pops open.  We double-click into the Text box to edit the text there, entering Atlantic Ocean as the text for the label.

 

eg_add_labels_to_map01_07.png

 

We press Enter to enter the text and then we click Add Record.

 

eg_add_labels_to_map01_08.png

 

A new label appears at the spot we clicked, with the text we entered.    The cursor is still in Create Point mode, so we can click again at a different spot to create another label.

 

eg_add_labels_to_map01_09.png

 

We enter the text English Channel for this label, and then we press Add Record.

 

eg_add_labels_to_map01_10.png

 

A new label appears at the location we clicked, with the text that we specified.

 

eg_add_labels_to_map01_11.png

 

We click a few more times, specifying the desired text and then pressing Add Record for each label.    We create a series of labels surrounding France, which show the names of ocean regions and countries on the borders of France.

 

eg_add_labels_to_map01_12.png

 

To change the appearance of the labels, we use the Style pane.

 

Move Labels

We may want to shift the positions of labels.

 

eg_add_labels_to_map01_13.png

 

Begin by switching the cursor back into Default mode.   All of the standard moves now used for editing drawings now will apply.  

 

eg_add_labels_to_map01_14.png

 

We Alt-Click the label to be moved to pick it.  The Record pane pops open to show attributes, like the text, for the picked label.

 

eg_add_labels_to_map01_14a.png

 

We click the label's handle to enable it for editing.  We can also click the Coordinates tab in the Record pane to enable it for editing.

 

eg_add_labels_to_map01_15.png

 

That chooses it for editing and immediately marks the anchor point for the label with a larger, blue square icon, indicating it may be dragged to a different position.

 

eg_add_labels_to_map01_16.png

 

We drag the square to a different location, and then we click Update Record in the Record pane or simply press Ctrl-Enter to apply the change.

 

eg_add_labels_to_map01_17.png

 

After being moved, the label is still in edit mode, with the Values tab of the Record pane engaged.  That allows us to change the text if we like.  If we are happy with the new position, we press Esc to exit the editing mode or simply Alt-click onto any blank spot of the map.

 

Edit Labels

To edit the text of a label we Alt-click it.   For example, we could Alt-click the Atlantic Ocean label.

 

eg_add_labels_to_map01_18.png

 

A small blue square appears on the label, as seen in the prior map illustration, and the Record pane opens.   We Double-click onto the label's text.

 

eg_add_labels_to_map01_19.png

 

Change the label text to whatever we want and press Update Record.

 

eg_add_labels_to_map01_20.png

 

Immediately, the label updates in the map to use the new text.

 

Multiline Labels

If the text in the field used by the label for text contains multiple lines, the label will also contain multiple lines.

 

eg_add_labels_to_map01_21.pngeg_add_labels_to_map01_22.png

 

To enter text as multiple lines into a cell of a table or into the Text cell of the Record pane, we Right-click onto the cell and then choose Edit in the context menu.

 

eg_add_labels_to_map01_23.png

 

The Edit dialog allows us to edit the text more conveniently than in a one line cell.  If we press Enter at the end of a desired line, a new line starts.

 

eg_add_labels_to_map01_24.png

 

That enables us to enter multiple lines.   When we are happy with the result, we can press OK.

 

eg_add_labels_to_map01_25.png

 

The new text appears in the Record pane, with three dots ... to indicate there are other lines.  Press Update Record to apply the change.

 

eg_add_labels_to_map01_26.png

 

Instantly, the map updates to show the multiline text.    In the illustration above we have Alt-clicked onto a blank spot of the map to clear the picked status of the "Go West" label, so the text can more clearly be seen.

Notes

Better multiline formatting - Release 9 is evolving very rapidly.  Multiline labels for now are left justified, but as the system evolves more text formatting controls will appear for multiline labels.

 

eg_add_labels_to_map01_27.png

 

Background maps -  We can create labels and move labels about based on some background layer reference, such as a web server layer as seen above, which later we remove.

 

 

See Also

Getting Started

 

Maps

 

Drawings

 

Images

 

Labels

 

Layer Opacity

 

Style

 

Project Pane

 

Layers Pane

 

Example: Project Pane Tutorial - In this example we take an extended tour of the Project pane, engaging in a variety of simple but typical moves that are illustrated step by step.

 

Example: Layers Tutorial - We take a tour of the Layers pane, learning how to manage layer display order, select layers, turn several layers on and off at the same time, alter opacity settings for one or more layers and how to change background color.

 

Example: Create Maps - Maps are used to show layers that can be drawings, images, and labels.  This topic shows how to create new, blank maps, how to create maps from existing components, and how to create maps from other maps.