PureFORM Designer

The gadget properties window

With the gadget properties window you can set many gadget properties like position, size, flags, font, color and more.



Enum

You can set the gadget enumeration value (must be unique).
You have to validate the enumeration with [RETURN] or the þ button.

Special properties

- Not in event loop :
If checked, no code is generated in the event-loop for this gadget.
- Disable / Hide :
You can hide and/or disable the gadget in the form. This can be handy if you have several layers of gadgets.
The hidden or disabled state is not translated during code generation.

Coordinates

You can set the gadget X, Y, Width and Height

Properties

Flags
You can set the gadget flags (Purebasic flags and Windows API flags).
You may define custom gadget flags by creating a PureFORM.Flags file.
Gadget text
You can change the gadget text.
The escape characters \n [CRLF] (handy for multiline gadgets), \t [TAB] and \q ["] are supported.
Gadget tooltip
You can change the gadget tooltip text
If  'Balloon' is checked, PureFORM will generate code for balloon tooltips instead of standard tooltips.
The escape character \n [CRLF] is supported (handy for multiline balloon tooltips).
Other settings
Other settings are available depending on the gadget class :
- ScrollAreaGadget : scroll area width and height ;
- ImageGadget : image path and image ID ;
- ButtonImageGadget : image path and image ID for 1st and 2nd image (pressed state image [PB4.20+ only]) ;
Note : the 2nd image is supported in the generated code but is not shown in the form. Use 'Compile/Run' for preview.
- ProgressBarGadget, ScrollBarGadget, TrackBarGadget, SpinGadget : minimum and maximum ;
- ListIconGadget : 1st column width ;
- ExplorerTreeGadget, ExplorerListGadget, ExplorerComboGadget : directory ;
- DateGadget : date mask ;
- SplitterGadget : splitter position, minimum size for 1st and 2nd child gadgets ;
- PanelGadget : tab (icon) width and height (default is 16 x 16) ;
etc ...



Automatic resize

With this feature your gadget will be automatically resized with the window.
Lock :    PureRESIZE_SetGadgetResize()
Top : set top anchor ;
Left : set left anchor ;
Bottom : set bottom anchor ;
Right : set right anchor.
Center :    PureRESIZE_CenterGadget()
Horiz(ontal) : enables horizontal centering ;
Verti(cal) : enables vertical centering ;
Proportional :    PureRESIZE_SetGadgetProportionalResize()
Horiz(ontal) : enables horizontal proportional resizing ;
Lock : gadget moves proportionally to the parent, but the width is locked (useful for separators) ;
Verti(cal) : enables vertical proportional resizing ;
Lock : gadget moves proportionally to the parent, but the height is locked (useful for separators).
Notes :
- this feature needs the PureRESIZE library (freely available at Gnozal's place or at PureArea)
  Note : if you work with splitters, it is important to activate PureResize ONLY for the splittergadget and NOT for the gadgets within the splitter.

- it can be tested in Preview mode (F5).

Colors

With this feature your gadget will be colored (enable or disable this feature with the 'Enable' checkbox).
Note : this feature may need the PureCOLOR library (freely available at Gnozal's place or at PureArea)
See Preferences.

Font

You can set the gadget font



This tab is only enabled if the current gadget is a PanelGadget or a ListiconGadget.
Here you can :
- rename PanelGadget tabs and/or select a tab icon ;
- rename, move and/or set the width of ListiconGadget columns (if width is set to 'auto', the generated code will use #LVSCW_AUTOSIZE_USEHEADER).
Remember that a ListIconGadget's 1st column name is the gadget text.