This specific group allows you to define the startup value of all the properties of the given bean that are detected as «java.awt.Color». For your convenience, three ways for selecting a color are provided.
Color Wheel
The color wheel lets you create the exact color that fits your needs. The black lines in the wheel cross at your preselected color, acting like a pointer. Drag this pointer with the mouse and position it exactly where needed.The brightness slider at the right of the wheel displays a selection of values, from light to dark, for the selected color in the color wheel. Drag the slider up or down to adjust the brightness.
To restore the default color the simplest way is certainly to select the Default item from the System Colors list. You may also use the "Reset item from the Group Chooser", in that case, you will be able to reset other properties at the same time.
For further information about the Color Wheel, see the "Color Wheel" chapter.
System
Colors
This list allows you either to apply one of the System Colors to your component, or to set the default color given by the Look and Feel. Relying on this presentation helps you to conform to any «company wide rule» for example.
RGB by Name
This list allows you to choose predefined colors, they will be automatically translated into RGB colors. It is just a facility provided also in order to allow a group of programmers to generate a rather consistent set of applications.
For further information, you may refer to the documentation from the Beans provider. If you have set the doc paths in the interface builder preferences, you may have a direct access to the documentation of the selected bean by clicking on the Bean Docs in the Group Chooser.
The Control Panel shows the hierarchy of the application's components. Clicking an icon will cause the component associated to this icon to be displayed with selected-state emphasis. The Group Chooser as well as the Settings Area will be updated immediately according to the selected component.This instance can be quite handy when you have added a group of components in sequence and want to set their properties (eg the columns of a JTable or the RadioButtons of a group). You don't have to go back to your design and select the next object, selecting it in this instance is much more effective. Note that even if VisualMust gives to any component a unique name, your application (or applet) will be more readable afterwards if you change the name of the used objects (Bean Name property) to something more meaningful than «TableColumn34».
You can notice that the properties associated with the given object are classified and organized by groups. These groups (as the properties they hold) are subject to changes in accordance with the selected object itself or its context (don't be afraid if, after having set a given layout for a panel, all the elements it contains are given a constraints group). This splitting tries to be as intuitive as possible and allows the use of specific interfaces in some cases (colors). Don't hesitate to click on any of the proposed groups to see what related items are made accessible. When clicking Group Chooser, you may choose one of the available groups according to the selected component.
Much more facilities are available through the control panel or this instance. Your are highly encouraged to browse the "Control Panel" chapter to discover some more goodies.
The Events window hosts another instance of the control panel which offers the same facilities.
Group chooser and Settings Area
As stated before, the properties of a given component are grouped in different families, this avoids huge lists of unrelated elements (the alphabetical order would have mixed up all the stuff) and allows to propose a more suitable interface in much cases.
The predefined groups are identified in this area by the following icons. The way of setting the associated properties has been tailored for any of these possibilities.
Please note that some properties of any components are a function of its context. The list given below is exhaustive but may not be proposed for every piece of your GUI. This doesn't mean in any case that the list you can see at a moment will be the one you will see forever : If you modify the context of the object, its properties list will change and so will do the proposed group.In a generic way, any bean property that cannot be associated to any other group will be added to the General group. This group will offer you some rather handy editors to select the correct value you want to assign to a given property, but is also able to use a bean specific Custom Property Editor provided with the given bean if it is available (we can regret that, as this facility is not implemented in the vast majority of the interface builders available, only few beans providers offer such editors). The user-friendliness of this feature is given in this example using a JBCSolutions DateChooser bean (see the "Properties - Custom Property Editor " chapter). For the technically inclined, in that case, the bean itself is used as an editor for its properties...).
Group | Descriptions | |
![]() | General | In a generic way, any bean property that cannot be associated to any other group will be added to the General group. |
![]() | Colors | Allows you to set any color defined as accessible in the given bean. |
![]() | Fonts | Allows you to select the used font and offers you a sample for your selection. |
![]() | Bounds | This group of properties allows you to fine tune the size and location of your components. |
![]() | Group | This Settings area is correlated with the multiple-exclusion, toggle buttons. |
![]() | Regions | Will appear if the parent has been set a BorderLayout, or if the component is a JToolBar. |
![]() | Images | This Settings area contains all properties that handle images. |
![]() | Constraints | Will appear if the parent's layout supports positional information (eg GridbagLayout). |
![]() | Layout | Will appear it the given component supports layouts. (Any JPanel will exhibit this). |
![]() | Reset | Guess what ... |
![]() | ScrollPane | This group of properties allows you to fine tune the ScrollBar policy that has to be used. |
![]() | Bean Docs | This can retrieve the documentation coming with the bean. |
![]() | Customizer Dialog | Customizer Dialog and Custom Property Editor provide a complete custom GUI for customizing a target bean. |