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 image::images/legend5.png[] 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

image::images/legend30.png[]

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

Baseline

image::images/legend13.png[]

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

Edge

image::images/legend12.png[]

image::images/legend14.png[]

image::images/legend32.png[]

image::images/legend33.png[]

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

image::images/legend31b.png[]

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

image::images/legend34.png[]

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

top

Anchoring Indicators

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

Container image::images/legend50.png[] 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

image::images/legend51.png[]

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.

top

Sizing Indicators

Same Size

image::images/legend28.png[]

image::images/legend29.png[]

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

image::images/legend42.png[]

image::images/legend41.png[]

image::images/legend43.png[]

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.

top

Highlighting and Handles

* Highlighting* image::images/legend10.png[] Orange highlighting indicates where a selected component is going to be placed.

Handles

image::images/legend11.png[]

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.

top

link:/about/contact_form.html?to=3&subject=Feedback:%20GUI%20Builder%20Visual%20Feedback%20Legend,%20NetBeans%20IDE[+Send Feedback on This Tutorial+]



== See Also

* link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG920[+Implementing Java GUIs+] in _Developing Applications with NetBeans IDE_
* link:../../trails/matisse.html[+Java GUI Applications Learning Trail+]
* link:../../trails/java-se.html[+General Java Development Learning Trail+]