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

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.