ueditbox (EditBox)

The ueditbox widget is a field-level input control that enables the user to view and enter data in a field. It is applicable only to form components.

EditBox widget

Default Logical Widgets

Uniface provides the following logical widgets mapped to ueditbox:

EditBox—the default logical widget for ueditbox.
NoEditBox—logical widget for styling non-editable fields.
MessageBox—logical widget for styling a field that displays a message.

Note: In Uniface 10, the NoEditBox and MessageBox logical widgets are made available for compatibility with previous Uniface versions.

Widget Properties

uEditBox Properties
Technical Property Name	UI Property Name	Dynamic
3D	3-D Effect (3d)	No
Attach	Attach to Window Border (attach)	Yes
AutoSelect	Auto Select (autoselect)	Yes
WordWrap	Automatic Word Wrap	No
BackColor	Background Color (BackColor)	Yes
BottomLine	Bottom Line (BottomLine)	Yes
DimmedBackColor	Dimmed Background Color (DimmedBackColor)	Yes
DblClk	Double-Click (DblClk)	Yes
DrawOutside	Draw 3-D Frame Outside (DrawOutside)	No
Dynamic	Dynamic	Yes
XAutoSelect	Extended Auto Select (XAutoSelect)	Yes
ForeColor	Foreground Color (ForeColor)	Yes
Frame	Frame	No
Hscroll	Horizontal Scroll Bar	No
HoverView	Hover View (HoverView)	Yes
LabelFont	Label Font (LabelFont)	Yes
Cursor	Mouse Pointer (Cursor)	Yes
Multiline	Multiline	No
NoDisplay	No Display Character	Yes
ShowEllipsis	Show Ellipsis	No
StrictSysColor	StrictSysColor	Yes
ToolTipText	Tool Tip Text (ToolTipText)	Yes
Transparency	Transparency	Yes
Vscroll	Vertical Scroll Bar (VScroll)	No
Font	Widget Font (Font)	Yes
AttachMargin	Attach Margin (AttachMargin)	Yes
InheritColors	Inherit Colors (InheritColors)	Yes
EditDelay	Edit Delay (EditDelay)	Yes
OnEdit	On Edit (OnEdit)	Yes
PopupRect	Popup Rectangle (PopupRect)	Yes

Triggers

On Windows, also:

Grid and MSAA Support

Supported in Grid?	Yes. Some properties may not be applicable. For more information, see egrid (Grid) and Widgets and Properties Supported in Grid Widget.
Supports MSAA?	Yes, for testing purposes only. For more information, see Accessibility.

Description

The ueditbox widget supports:

All Uniface data types except Image.
Proportional fonts.
Insert mode, but not overwrite mode. (The Microsoft Windows edit control, which the ueditbox uses, does not support overwrite mode.)

When using an ueditbox widget, note the following:

If it is drawn as a multi-line box, ensure that the Multiline property is True. Otherwise, only one line of text can be printed.
On 32-bit platforms, if you open a new form and the first widget that gets focus is a ueditbox, the text in the widget is automatically selected. However, if you clear the form, move focus to a ueditbox, and perform a retrieve without changing focus, the text in the widget is not selected because no focus change has taken place.
In Microsoft Windows, hard carriage returns, specified by the user with Enter or Control+Enter, are stored as carriage return/linefeed combinations (two bytes). On some other systems however, only one byte is used.
If you specify Detail for the Double Click property, you can activate the Detail trigger for a ueditbox widget by double-clicking or by using the structure editor function ^DETAIL.

In character mode, ueditbox widgets are not supported and are therefore mapped to Unifields. For more information, see Unifields.