Properties - ScrollPane
 

Instance of ControlPanel Group chooser SettingsArea


 Settings Area

If you have already designed some GUIs in java, you do know that some beans must (or may) be included into ScrollPanes. As this embedding is almost general, VisualMust, by default will embed these beans into a JScrollPane. This group of properties allows you to override this behavior and to fine tune the ScrollBar policy that has to be used. To be complete, this has been added upon a request of one of our beta testers. We do hope that this facility will help you as much as it helped him. Even if you never use it, the cluttering of the interface has been as reduced as possible by the introduction of this properties group.

To get further information for these properties, see the Java documentation about JScrollPane.


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.


Instance of Control Panel

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...).


Here is a complete list of the groups handled by VisualMust.
 
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.