GUI Builder Visual Feedback Legend

This tutorial needs a review. You can open a JIRA issue, or edit it in GitHub following these contribution guidelines.

This document describes visual feedback the IDE’s GUI Builder (formerly code-named Matisse) provides during the process of Java GUI creation.

Alignment Guidelines

Alignment guidelines appear only when adding or moving components, indicating the preferred positions to which components snap when the mouse button is released. Once positioned, alignment guidelines are replaced by solid lines illustrating the common alignments shared among components as well as anchoring indicators.

Inset legend5 Insets are the preferred spacings between components and the containers within which they are located. Insets are suggested by dashed horizontal and vertical guidelines.

Offset

legend30

Offsets are the preferred spacings between adjacent components. Offsets are suggested by dashed horizontal and vertical guidelines.

Baseline

legend13

Baseline alignment is the preferred relationship between adjacent components containing display text. Baseline alignment is suggested by dashed a horizontal guideline.

Edge

legend12

legend14

legend32

legend33

Edge alignments (Top, Bottom, Left, and Right) are the alignment relationships possible between adjacent components. Edge alignments are suggested by dashed horizontal and vertical guidelines.

Indentation

legend31b

Indentation alignment is a special alignment relationship in which one component is located below another and offset slightly to the right. Indentation alignment is suggested by the appearance of two vertical dashed guidelines.

Preferred Distance

legend34

Preferred distances (Small, Medium, and Large) are gap sizes between adjacent components. Preferred distances are suggested by dashed horizontal or vertical guidelines.

Anchoring Indicators

Once components have snapped into position, solid anchoring indicators appear illustrating the common alignments shared among components.

Container legend50 Anchors connecting individual components to the containers within which they are located are represented by small semi-circular indicators with dashed lines extending from the container edge to the component itself.

Component

legend51

Anchors connecting individual components to adjacent components are represented by small semi-circular indicators with dashed lines extending from the one component to the other.

Sizing Indicators

Same Size

legend28 legend29

Same Sizing is the state in which a group of components (adjacent or otherwise) are all set to have the same width or height. Same Sizing is illustrated by the appearance of small rectangular indicators appearing on the top edge of each component for which the property is set.

Auto-Resizing

legend42 legend41 legend43

Auto-Resizing is the state in which a component’s width or height is set to resize dynamically at runtime. Auto-Resizing is indicated by the state of the horizontal and vertical Resizing buttons (called Change horizontal resizeability and Change vertical resizeability respectively) in the GUI Builder’s toolbar. Auto-Resizing is enabled by selecting resizable in the Other Properties list in the Properties window.

Highlighting and Handles

* Highlighting* legend10 Orange highlighting indicates where a selected component is going to be placed.

Handles

legend11

Small square resize handles appear around a component’s perimeter when a component is selected. Clicking, holding, and dragging a handle on the edge of a component resizes the latter.

See Also