3. System Classes : ButtonField Class : ListviewField Class
 
Share this page                  
ListviewField Class
ListviewField Attributes
Attribute
Data Type
Description
Inherited
From
AbsXLeft
integer
Specifies a field's starting X coordinate, including the border and shadow, relative to the form (RW)
FormField
AbsXRight
integer
Specifies a field's ending X coordinate, including the border and shadow, relative to the form (RW)
FormField
AbsYBottom
integer
Specifies a field's ending Y coordinate, including the border and shadow, relative to the form (RW)
FormField
AbsYTop
integer
Specifies a field's starting Y coordinate, including the border and shadow, relative to the form (RW)
FormField
AllBias
smallint
Specifies a field's bias setting for all modes of a frame (W)
FormField
AnchorPoint
integer
Specifies one of nine predetermined anchor points for a field (RW)
FormField
BgBitmap
BitmapObject
Specifies the background setting for a field when BgPattern is FP_BITMAP (RW)
FormField
BgColor
integer
Specifies the background color of a field's bounding box (RW)
FieldObject
BgDisplayPolicy
integer
Controls the positioning and display of form field background images—either anchored to their own top left corner (fixed), or anchored relative to the closest parent field whose background is fixed (RW)
FormField
BgPattern
integer
Specifies the form's background pattern (RW)
FormField
ClassName
varchar(32)
Gives the name of an object's actual type (as opposed to its declared type) (R)
Object
ClientData
Object
Provides a way to associate data with an object (RW)
Object
ClientText
varchar(2000)
Stores text values; allows information to be assigned to a field at runtime (RW)
FieldObject
ColAttributes
array of ListviewColAttr
Specifies the associated ListviewColAttr array of the ListviewField (RW)
Defined
ControlField
smallint
Determines if a field manipulates the user interface instead of the underlying data (RW)
FieldObject
CurBias
smallint
Specifies the current bias setting for a field (RW)
FormField
CurEnumDisplay
varchar(256)
Contains the display text of the current selected item (RW)
ChoiceField
CurEnumText
varchar(256)
Contains the current text value associated with the field (RW)
ChoiceField
CurEnumValue
integer
Contains the current integer value associated with the field
ChoiceField
Cursor
CursorBitmap
Causes the mouse cursor to change to the cursor associated with the CursorBitmap when the pointer is over the FormField object (RW)
FormField
DataType
varchar(65)
Specifies the data type of the field's variable (RW1)
FieldObject
Declared
smallint
Controls whether OpenROAD declares a variable for the field at compile time (RW)
ActiveField
DefaultString
varchar(256)
Stores the default value that OpenROAD uses when the DefaultValue attribute is set to DV_STRING (RW1)
FieldObject
DefaultValue
smallint
Specifies the default value of the variable associated with the field (RW1)
FieldObject
Drag_Row
integer
During a drag-and-drop operation, this attribute is set to the row number from which the drag operation is initiated (RW)
Defined
DragItem
integer
Specifies that the items in the ListviewField can be dragged by the interactive user (RW)
Defined
DragObject
Object
Sets the object that will be transferred by a drag-and-drop operation when a user starts the operation over the field (RW)
ActiveField
Drop_Row
integer
During a drag-and-drop operation, this attribute is set to the row number on which the drop occurred (RW)
Defined
DropObject
varchar(32)
Holds the class name of the objects that can be dropped on the field (RW)
ActiveField
EditLabel
integer
Specifies that the text label of an item in the ListviewField can be edited by the interactive user (RW)
Defined
EventExec
FrameExec
Specifies the frame (FrameExec) to which this field's events will be queued and processed (RW)
FieldObject
FgColor
integer
Controls the color of the field's foreground (RW)
FieldObject
FocusBehavior
smallint
Controls behavior of the field relative to the input focus (RW)
ActiveField
FullName
varchar(256)
Contains the expanded name of variable (R)
FieldObject
FullRowSelect
smallint
When TRUE, the user can select a row in the ListviewField by clicking anywhere on the row; the entire selected row is highlighted (RW)
Defined
Gravity
integer
Specifies the alignment of a field that is within a stack field cell, a matrix field cell, or a subform (RW)
FormField
HasColumnHeaders
integer
Specifies that the column headers of the ListviewField will be displayed (RW)
Defined
HasDataChanged
smallint
Indicates if any interactive changes were made to the data associated with the field (RW)
FieldObject
HasFieldChanged
smallint
Is TRUE if any structural attributes of a field have been changed since the frame was initialized (RW)
FormField
Height
integer
Specifies the Y extent of the “inner rectangle” of the field, excluding borders and shadows (RW)
FormField
InstanceIdentifier
integer
Contains a value that uniquely identifies an instance of an allocated object (R)
Object
InstanceReferences
integer
Contains the current number of references to the object (R)
Object
IsBold
smallint
Sets the typeface to bold (RW)
EnumField
IsCurField
smallint
Is TRUE when a field has the current input focus for the frame (RW)
FormField
IsDragSource
integer
If set to TRUE, a drag-and-drop operation may be started over the field; DragObject is the object that is transferred (RW)
ActiveField
IsItalic
smallint
Sets the typeface to italics (RW)
EnumField
IsNullable
smallint
Is TRUE if the variable is nullable (RW1)
FieldObject
IsPlain
smallint
Is TRUE if bold, underlining, and italics are off for the type (RW)
EnumField
IsPropOptInherited
integer
If set to TRUE, indicates that the field is to use or inherit the PropertyOptMenu of the CompositeField that is nearest in scope (RW)
ActiveField
IsReverse
smallint
Is TRUE if reverse is on for a field's background and foreground colors (RW)
FormField
IsSelected
smallint
Is TRUE if a field is selected (for fields with bias settings that are selectable), defaults to FALSE (RW)
FormField
IsUnderlined
integer
If TRUE, text is underlined (RW)
EnumField
LargeImageHeight
smallint
Indicates the height, in pixels, of all large bitmaps to be associated with items in the ListviewField (RW)
Defined
LargeImageList
array of BitmapObject
Specifies the array of bitmaps to be displayed as large bitmaps for items in the ListviewField (RW)
Defined
LargeImageWidth
smallint
Indicates the width, in pixels, of all large bitmaps to be associated with items in the ListviewField (RW)
Defined
LayerSequence
integer
Specifies a field's sequence number within the field layer (RW)
FormField
MinimumWidth
smallint
Specifies the minimum outer width of an enumerated field (RW)
EnumField
MouseDownText
varchar(100)
Specifies the text displayed in the window status bar of the current frame when the mouse pointer is over the field and the select button is clicked (RW)
FormField
MouseMoveText
varchar(100)
Specifies the text displayed in the window status bar of the current frame when the mouse pointer is over the field (RW)
FormField
Name
varchar(32)
Contains the name of the field object (RW1)
FieldObject
OuterHeight
integer
Specifies the extent in Y direction of a field, including border lines and shadows (RW)
FormField
OuterWidth
integer
Specifies the extent in X direction of a field, including border lines and shadows (RW)
FormField
OutlineColor
integer
Controls the color of the border line or shadow of the bounding box around the field (RW)
ActiveField
OutlineStyle
integer
Controls the style of the outline of the field (RW)
ActiveField
OutlineWidth
integer
Controls the width of the border line or the shadow for the bounding box around the field (RW)
ActiveField
ParentField
CompositeField
Specifies the direct parent field for a field (RW)
FormField
PropertyOptMenu
OptionMenu
Contains the OptionMenu that is activated when the right mouse button is clicked while over the field (RW)
ActiveField
QueryBias
smallint
Specifies a field's bias setting when the CurMode attribute for the frame is set to FM_QUERY (RW)
FormField
ReadBias
smallint
Specifies the bias setting for a field when the CurMode attribute for the frame is set to FM_READ (RW)
FormField
RequireRealField
smallint
Indicates if a field must be associated with a toolkit control or widget (RW)
FormField
Script
StringObject
Contains the 4GL script associated with the field (RW)
FieldObject
SmallImageHeight
smallint
Indicates the height, in pixels, of all small bitmaps to be associated with items in the ListviewField (RW)
Defined
SmallImageList
array of BitmapObject
Specifies the array of bitmaps to be displayed as small bitmaps for items in the ListviewField (RW)
Defined
SmallImageWidth
smallint
Indicates the width, in pixels, of all small bitmaps to be associated with items in the ListviewField (RW)
Defined
Style
integer
Specifies the style of the ListviewField (RW)
Defined
TabSeqNum
integer
Set this attribute to the 1-relative number equal to the order in which you want this field to appear in the TabSequence for the containing CompositeField (RW)
ActiveField
ToolTipText
varchar(100)
Specifies the text to be displayed when the mouse pointer rests on the FormField (RW)
FormField
TopRow
integer
Indicates the index of the topmost visible item when the ListviewField is in LVFS_LIST or LVFS_DETAIL style (R)
Defined
TypeFace
integer
Specifies the typeface for the options text (RW)
EnumField
TypeFaceName
varchar(31)
Specifies the typeface name of any font installed on your system (RW)
EnumField
TypeSize
smallint
Specifies the size, in points, of the typeface (RW)
EnumField
UpdateBias
smallint
Specifies a field's bias setting when the CurMode attribute for the frame is set to FM_UPDATE (RW)
FormField
User1Bias
smallint
Specifies a field's bias setting when the CurMode attribute for the frame is set to FM_USER1 (RW)
FormField
User2Bias
smallint
Specifies a field's bias setting when the CurMode attribute for the frame is set to FM_USER2 (RW)
FormField
User3Bias
smallint
Specifies a field's bias setting when the CurMode attribute for the frame is set to FM_USER3 (RW)
FormField
ValueList
ChoiceList
Contains the list of values for the field (RW)
ChoiceField
VisibleRows
integer
Indicates the number of items that are fully visible in a ListviewField in LVFS_LIST or LVFS_DETAIL style (R)
Defined
WidgetID
integer
This is not supported. Represents the field's handle for the highest-level Windows control for the field. (R)
ActiveField
Width
integer
Specifies the X extent of the “inner rectangle” of the field, excluding border lines or shadows (RW)
FormField
XAnchorPoint
integer
Use with YAnchorPoint to position an object by setting relevant anchor point values (RW)
FormField
XLeft
integer
Specifies the relative X coordinate of the left edge of a field's bounding rectangle (RW)
FormField
XRight
integer
Specifies the relative X coordinate of the right edge of a field's bounding rectangle (RW)
FormField
YAnchorPoint
integer
Use with XAnchorPoint to position an object by setting relevant anchor point values (RW)
FormField
YBottom
integer
Specifies the relative Y coordinate of the lower edge of a field's bounding rectangle (RW)
FormField
YTop
integer
Specifies the relative Y coordinate of the top edge of a field's bounding rectangle (RW)
FormField
 
ListviewField Methods
Method
Return
Value
Description
Inherited From
CheckFailedMandatory
(
[setfocusonfailure = smallint])
ActiveField
Checks a mandatory field for entered values
ActiveField
DeclareData
(
[result = byref(variable)]
[,userclass = byref(UserClassObject)])
integer
Declares a specified active field so that you can refer to it in a dynamic expression
ActiveField
Duplicate()
ListViewField
Makes a duplicate of the object, placing a reference to the new object in a reference variable
Object
GetAttribute
(
attributename = byref(variable)
{,attributename = byref(variable)})
integer
Gets the values of any number of attributes for the object
Object
GetFieldValue
(value = byref(
variable))
integer
Gets the current value of a field
FieldObject
IsA
(class =
classname)
integer
Is TRUE if the object is of the same class as, or one of the subclasses of, the class specified by classname
Object
IsDescendantOf
(ancestor =
FieldObject)
smallint
Is TRUE if the field object is a descendant at any level of the specified ancestor
FieldObject
SetAttribute
(
attributename = value
{,attributename = value})
integer
Sets any number of attributes for the object
Object
SetFieldValue
(value =
value)
integer
Sets the value of a field
FieldObject
SetToDefault()
none
Sets the value of the field to its default value
ActiveField
UndeclareData()
integer
Dissociates the named active field from variables previously associated with the DeclareData method
ActiveField
UpdBackground()
none
Changes a field's background
FormField
UpdChoiceList()
ChoiceField
Refreshes the display to reflect changes in the value list
ChoiceField
UpdField
(
[clearhasdatachanged = integer])
none
Refreshes a displayed field
ActiveField
UpdValue()
integer
Loads the internal memory area that stores a field's value with the value contained with the visual representation of the value
FieldObject
WhichTableField()
TableField
Determines which table field contains the field that triggered this method
FieldObject