Entry Field Control Styles

ES_LEFT

The text in the control is left-justified. This is the default style if neither ES_RIGHT nor ES_CENTER is specified.
ES_RIGHT
The text in the control is right-justified.
ES_CENTER
The text in the control is centered.
ES_AUTOSIZE
The text will be sized to make sure the contents fit.
ES_AUTOSCROLL
If the user tries to move off the end of a line, the control automatically scrolls one-third the width of the window in the appropriate direction.
ES_MARGIN
This style can be used to cause a border to be drawn around the control, with a margin around the editable text. The margin is half a character-width wide and half a character-height high.

When an entry field control with this style is positioned, it adjusts the position so that the text is placed at the position specified. This position differs from the original position by the width of the border and the margin.

ES_READONLY
This style causes a single line entry field to be created in read only state.

When an entry field is in read only state, characters do not get inserted into the text. However the insertion interface is still functional.

The entry field read only state can be altered by use of the EM_SETREADONLY message.

ES_UNREADABLE
This style causes the text to be displayed as an asterisk for each character. It can be used for passwords.
ES_COMMAND
This style identifies the entry field as a command entry field. This information is used by the Help Manager to provide command help if the end user requests help for this field.

Not more than one entry field on each dialog should be given this style.

ES_AUTOTAB
This style indicates that when the field is filled by adding a character to the end of the entry field text, the effect of a tab key will be generated. Inserting or replacing a character in the middle of the text, however, does not result in an autotab.

This style is recommended for use with fixed-length, non-scrollable fields that are filled completely. The maximum length of the entry field text is held in the control data, see ENTRYFDATA.

These entry field controls are intended for countries that use a double-byte character encoding scheme:

ES_SBCS

The text is purely single-byte.

If the number of characters entered exceeds EM_SETTEXTLIMIT, or a DBCS character is entered, the alarm sounds and the last character entered is ignored.

ES_DBCS
The text is purely double byte.

If the number of bytes in the entry field exceeds EM_SETTEXTLIMIT, or an SBCS character is entered, the alarm sounds and the last character entered is ignored.

ES_ANY
The text is a mixture of SBCS and DBCS characters.

If the number of bytes in the input field exceeds EM_SETTEXTLIMIT, the alarm sounds and the last character entered is ignored.

ES_ANY is the default.

Note: If the queue code page is an ASCII code page and the data in the entry field is to be converted to an EBCDIC code page, there is a possibility that shift-in and shift-out characters introduced by the conversion process can cause the converted data to overrun the target field. Coding ES_MIXED protects the target field from overrun in this situation.

ES_MIXED
The text is a mixture of SBCS and DBCS characters which may subsequently be converted from an ASCII DBCS code page to an EBCDIC DBCS code page with a consequent possible increase in the length of the data.

If

DBCSchars*2 + SBCSchars + N > EM_SETTEXTLIMIT

where N starts at 0 and is incremented whenever the string goes from SBCS to DBCS or DBCS to SBCS, the alarm sounds and the last character entered is ignored.

Note: For every conversion from SBCS to DBCS there must be a corresponding return to SBCS (N must be an even number).

---

[Back: Entry Field Control Window Processing]
[Next: Default Colors]