Use the following properties to define initial characteristics
of an IEntryField* part.
- Part properties are displayed in the part property sheet.
- Style properties are displayed in the Part style
property sheet.
IEntryField properties
-
- activeColor
- The active color of the entry field. This is defined as a
color property.
- autoDeleteObject
- Specifies whether the C++ object is deleted when the user
closes the window. The default is false. This
property should be true only for objects that are
created dynamically using a Factory.
- autoDestroyWindow
- Specifies whether the system destroys the presentation
object when the C++ object is deleted. The default is false.
This inherited property is not appropriate for objects
created from VisualAge user interface parts. It is
applicable when a C++ class is a wrapper for a
presentation object that it did not create.
- backgroundColor
- The background color of the entry field. This is defined
as a color property.
- borderColor
- The border color of the entry field. This is defined as a
color property.
- charType
- The type of characters accepted by the entry field. This
pertains to the character set types that can define the
characters.
- Double-byte character sets (DBCS)
- Single-byte character sets (SBCS)
If a type is not specified, any is assumed. The
following types are available:
- any--SBCS characters, DBCS characters, or
a mixture. No text limit allowance is made for
potential conversion from ASCII to EBCDIC code
pages.
- dbcs--only DBCS characters.
- mixed--SBCS characters, DBCS characters,
or a mixture. In testing text length against the
limit, allowance is made for potential conversion
from ASCII to EBCDIC code pages. Shift-in and
shift-out characters that would be inserted by
conversion to EBCDIC are added to the text length
in testing the limit.
- sbcs--only SBCS characters.
- cursorPosition
- The offset of the text cursor from the beginning of the
text.
- disabledBackgroundColor
- The background color of the entry field when it is
disabled. This is defined as a color property.
- disabledForegroundColor
- The foreground color of the entry field when it is
disabled. This is defined as a color property.
- enabled
- Specifies whether the entry field is enabled for
selection.
- enabledForNotification
- Specifies whether the entry field is enabled for event
notification. The default is true. Visual
composition connections depend on event notification.
- Fly-over long text
- Text that is displayed in a text control when the mouse
pointer hovers over the entry field. To display the
fly-over text, you must add an IVBFlyText* part to the
composite part for the window and specify a text control
for the IVBFlyText* part.
- Fly-over short text
- Text that is displayed in a pop-up caption box when the
mouse pointer hovers over the entry field. To display the
fly-over text, you must add an IVBFlyText* part to the
composite part for the window.
- font
- Specifies the text font for the entry field. This is
defined as a font property.
- foregroundColor
- The foreground color of the entry field. This is defined
as a color property.
- handlers
- The list of attached handlers for the entry field. This
is defined as a handlers property.
- helpId
- The ID of the help panel for the entry field. To display
the help, you must add an IHelpWindow* part to the
composite part for the primary application window.
- hiliteBackgroundColor
- The background color of the entry field when it is
highlighted. This is defined as a color property.
- hiliteForegroundColor
- The foreground color of the entry field when it is
highlighted. This is defined as a color property.
- id
- The window ID of the entry field.
- inactiveColor
- The inactive color of the entry field. This is defined as
a color property.
- insertMode
- Specifies the keyboard input mode of the entry field.
- false--overtype mode.
- true--insert mode.
By default, true is assumed.
- itemProvider
- Specifies a direct manipulation item provider for
drag-drop operations. This is defined as a code property.
Enter a pointer to an IDMItemProvider object, or code
that produces this pointer. A connection can be used
instead of setting the code property.
- leftIndex
- The offset of the first character displayed at the left
of the entry field. If nothing is specified, 0 is
assumed.
- limit
- The maximum number of bytes allowed in the entry field.
The default value is determined by the system.
- minimumSize
- Specifies the minimum size of the entry field. Multicell
canvases and set canvases use the minimum size to lay out
controls. This is defined as an IVBMinSize property.
- partName
- The composition name of the part. This name is used for
the class instance in generated code.
- shadowColor
- The shadow color of the entry field. This is defined as a
color property.
- Size and position
- The size and position of the entry field. This is defined
as a framing property.
- style
- The style settings for the entry field. This is defined
as a style property. The individual styles are described
as IEntryField style properties.
- text
- Text for the entry field.
- writeable
- Specifies whether the user can edit the contents of the
entry field.
IEntryField style properties
-
- add default bits
- Specifies whether the default style settings are used as
a base for part styles. The initial value is true.
The default style is shipped with the following styles on:
- autoScroll
- leftAlign
- margin
- visible
- autoScroll
- Specifies whether the entry field automatically scrolls
horizontally when the user attempts to move the cursor
beyond the bounds of the entry field.
- autoTab
- Specifies whether the entry field automatically tabs to
the next tab stop control when the entry field text limit
is reached.
- centerAlign
- Specifies whether text is centered in the entry field.
This style is mutually exclusive with the leftAlign
and rightAlign styles. Ensure that only one of
these styles is on, either explicitly or by
default.
- clipChildren
- Specifies whether areas occupied by child windows are
painted by this window object. If this style is on,
child areas are not painted by this window object. This
inherited window style is most useful for frame windows
and composer parts.
- clipSiblings
- Specifies whether areas occupied by sibling windows are
painted by this window object. If this style is on,
sibling areas are not painted by this window object. This
inherited window style is most useful for frame windows.
- clipToParent
- Specifies whether a window object paints only within the
bounds of its parent window. If this style is on,
painting is restricted to the bounds of the parent.
- command
- Specifies whether the entry field can be used to request
command help. This style should be on for no more
than one entry field in a window.
- group
- Specifies whether the entry field is the first control in
a control group.
- leftAlign
- Specifies whether text is left-aligned in the entry
field. This style is mutually exclusive with the centerAlign
and rightAlign styles. Ensure that only one of
these styles is on, either explicitly or by
default.
- margin
- Specifies whether a margin is added around the entry
field, with a border drawn around the margin.
- readOnly
- Specifies whether user can edit the text. If this style
is on, the user cannot modify the contents of the
entry field.
- rightAlign
- Specifies whether text is right-aligned in the entry
field. This style is mutually exclusive with the centerAlign
and leftAlign styles. Ensure that only one of
these styles is on, either explicitly or by
default.
- saveBits
- Specifies whether the area under the window object is
saved as a bitmap to enable faster repainting.
- synchPaint
- Specifies whether the window object is painted
synchronously rather than waiting for other system events
to processed.
- tabStop
- Specifies whether the entry field is a tab stop.
- unreadable
- Specifies whether text in the entry field is readable. If
this style is on, each character in the entry
field is replaced by an asterisk (*). This is useful for
sensitive data, such as passwords.
- visible
- Specifies whether the entry field is visible.
Working with
IEntryField Parts
Editing Part Properties
Property Settings -- IVBMinSize
Style Properties
Color Properties
Font Properties
Handler Properties
Size and Position Properties
Code Properties
IEntryField
Portability -- IEntryField
VisualAge User Interface Part
Properties