Node labels

A node can have one label.

For example:

      GraphMLNode node = diagram.addNode();
      node.setLabel("The Label");

Settings the label

To set the label of a node, you can use one of the following methods:

• GraphMLNode.setLabel(NodeLabel) to create a label on a node
• GraphMLNode.setLabel(String) to create a label on a nodeusing the String of the Label

For example:

      GraphMLNode node = diagram.addNode();
      node.setLabel("The Label");

By default the text color is black, and the label has no background and no border. However it is possible to set the text color of the label. For example:

      NodeLabel label = node.setLabel("The Label");
      label.setTextColor(Color.RED);

Node label placement

To customize the position of the label on the node, you must access the label placement through the AbstractLabel.createLabelPlacement(). The resulting LabelPlacement class allows to customize the position of the label relative to the box of the node.

For example, to have the label on the top of the node, you can use:

      GraphMLNode node = diagram.addNode();
      node.setLabel("The Label");
      LabelPlacement placement = label.createLabelPlacement();
      placement.setPlacementModel(LabelPlacement.MODEL_INTERNAL);
      placement.setPlacement(LabelPlacement.PLACEMENT_TOP);

The result will be:

Adding an icon to the label

It is possible to add an icon to a node label with one of the following methods:

• NodeLabel.setIcon(BufferedImage) to use a an image
• NodeLabel.setIcon(File) to use a File
• NodeLabel.setIcon(URL) to use an URL

Additional methods allow to set the scale of the image representation on the node:

• The NodeLabel.setIconScaleX(float) to set the X scale fo the image
• The NodeLabel.setIconScaleY(float) to set the Y scale fo the image
• The NodeLabel.keepIconAspectRatio(boolean) to specify if the aspect ratio of the image must be kept