Property Settings -- IEntryField

Use the following properties to define initial characteristics of an IEntryField* part.

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.

If a type is not specified, any is assumed. The following types are available:

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.

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
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.


Related procedures
Working with IEntryField Parts
Editing Part Properties

Related references
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