udefentity (Default Entity Widget )
The udefentity widget is the default widget for entities in form components. It is a multi-occurrence list, with a minimum of one occurrence, in which fields can be freely arranged. Uniface provides a default logical widget called DefEntity that is mapped to this widget.
For more information, see Layout of Repeated Occurrences.
| Logical widget name: | DefEntity |
| Maps to physical widget: |
|
| Default definition: | DefEntity=udefentity(backcolor=#deefff)
|
| Use for: | Entity definition and layout in form components |
| Supported triggers: | Entity and occurrence-level triggers. For more information, see Entity . |
| Supported properties: | See Widget Properties |
Description
The default entity widget supports all entity- and field-level widgets, Unifields, labels, area frames, and lines. In the component layout, these elements can be arranged in any way that fits within the boundaries of the first entity occurrence.
Configuring the Widget
You can configure the udefentity widget by defining the DefEntity logical widget. If it is not defined, the widget follows Windows conventions.
It is also possible define logical widgets using specific entity names. For more information, see DefEntity and [entities].
Widget Properties
To modify properties that control the border appearance and gradient background color, click the More icon in the entity's FRM Widget Properties, then click More button .
To set the property values at runtime, use the ProcScript commands $EntityProperties and $CurEntProperties.
| Property | Technical Property Name |
|---|---|
| Attach to Window Border (attach) | Attach |
| Attach Margin (AttachMargin) | AttachMargin |
| BorderType | BorderType |
| Border Radius (BorderRadius) | BorderRadius |
| Color Properties | |
| Background Color (BackColor) | BackColor |
| Foreground Color (ForeColor) | ForeColor |
| Border Color (BorderColor) | BorderColor |
| Gradient Fill Style (BackColorFill) | BackColorFill |
| Gradient Color Start (BackColorStart) | BackcolorStart |
| Gradient Start (GradientStart) | GradientStart |
| Drop Shadow Color (DropShadowColor) | DropShadowColor |
| Background Image Properties | |
| Background Image (BackImage) | BackImage |
| Horizontal Alignment (Halign) | HAlign |
| Vertical Alignment (Valign) | VAlign |
| Horizontal Scaling (Hscale) | Hscale |
| Vertical Scaling (Vscale) | VScale |
| Preserve Aspect Ratio (PreserveAspect) | PreserveAspect |
Compatibility
Compatibility issues can arise when setting the Border and or Color in combination with the entity frame properties that can be set in the initialization file.
- If both the Border and BorderType properties are set, two borders are displayed.
- If the Color is set for an area frame or entity, it overrides all properties set in the initialization file, including BorderType and colors.
To prevent these issues in existing components, it
is recommended that you use BorderType and its styling properties only for new
and modified components, and for new named area frames. If you modify a component to use
BorderType for an entity or area frame, it is recommended that you set
Color to No and turn Border off.
For more information, see Border and Index Color .
