3. System Classes : ButtonField Class : TabBar Class
 
Share this page                  
TabBar Class
TabBar 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
BarPosition
integer
Determines whether tabs are placed at the top or bottom of a TabFolder (RW)
Defined
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
BitmapPosition
integer
Specifies which side of the tab the bitmap label is placed on (RW)
Defined
ChildFields
array of FormField
Contains an unordered list of the fields that make up the composite field (R)
CompositeField
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
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
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
DisplayBitmap
integer
Indicates whether a bitmap label is displayed on the tab (RW)
Defined
DisplayText
integer
Indicates whether a text label is displayed on the tab (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
DropObject
varchar(32)
Holds the class name of the objects that can be dropped on the field (RW)
ActiveField
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
Gravity
integer
Specifies the alignment of a field that is within a stack field cell, a matrix field cell, or a subform (RW)
FormField
GroupBoxLabel
varchar(100)
Permits the identification of a Composite field object as a group box by assigning a descriptive name to the GroupBoxLabel field (RW)
CompositeField
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
integer
If set to TRUE, all non-selected tab text is bold (RW)
Defined
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
IsFixedWidth
integer
Indicates whether all tabs are of equal width (RW)
Defined
IsItalic
integer
If set to TRUE, all non-selected tab text is italic (RW)
Defined
IsMoveBounded
smallint
Specifies if the component fields of the composite field can move beyond the composite field's boundaries (RW)
CompositeField
IsNullable
smallint
Is TRUE if the variable is nullable (RW1)
FieldObject
IsPlain
integer
If set to TRUE, all non-selected tab text is plain (RW)
Defined
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
IsResizeBounded
smallint
Is TRUE if resizing of child fields within the composite is bounded by the borders of the composite itself, when the child fields are resizable (RW)
CompositeField
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)
Defined
LayerSequence
integer
Specifies a field's sequence number within the field layer (RW)
FormField
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
MultiTabStyle
integer
Indicates what style to use if there are too many tabs to fit in the tab bar's display area (RW)
Defined
Name
varchar(32)
Contains the name of the field object (RW1)
FieldObject
NormalTabColor
integer
Specifies the color of the selected tab (RW)
Defined
NormalTextColor
integer
Specifies text color of an unselected tab (RW)
Defined
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
Specifies the color used to outline the tab (RW)
Defined
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
SelectedIsBold
integer
Specifies that the text label of the selected tab is bold (RW)
Defined
SelectedIsItalic
integer
Specifies that the text label of the selected tab is italic (RW)
Defined
SelectedIsPlain
integer
Specifies that the text label of the selected tab is plain (RW)
Defined
SelectedIsUnderlined
integer
Specifies that the text label of the selected tab is underlined (RW)
Defined
SelectedTabColor
integer
Specifies the color of the selected tab (RW)
Defined
SelectedTextColor
integer
Specifies the text color of the selected tab (RW)
Defined
SelectedTypeFace
integer
Specifies the typeface of the text on a selected tab (RW)
Defined
SelectedTypeFaceName
varchar(31)
Specifies the typeface name of the text on a selected tab (RW)
Defined
SelectedTypeSize
integer
Specifies the size of the text of a selected tab (RW)
Defined
Separation
integer
Specifies the number of pixels separating a text label from a bitmap label (RW)
Defined
ShadowColor
integer
Specifies the color used to draw the shadow of a tab (RW)
Defined
TabFieldArray
array of TabField
Specifies the array containing the TabFields of the TabBar (R)
Defined
TabGap
integer
Specifies the gap between tabs, in pixels (RW)
Defined
TabJustification
integer
Specifies on which side of the TabBar the tabs are justified (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
TabShape
integer
Specifies the shape of the tab (RW)
Defined
ToolTipText
varchar(100)
Specifies the text to be displayed when the mouse pointer rests on the FormField (RW)
FormField
TypeFace
integer
Specifies the typeface of the text on an unselected tab (RW)
Defined
TypeFaceName
varchar(31)
Specifies the typeface name of any font installed on your system (RW)
Defined
TypeSize
integer
Specifies the size of the text of an unselected tab (RW)
Defined
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
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
XMargin
integer
Specifies the horizontal margin between the outside of the tab and the label, in pixels (RW)
Defined
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
YMargin
integer
Specifies the vertical margin between the outside of the tab and the label, in pixels (RW)
Defined
YTop
integer
Specifies the relative Y coordinate of the top edge of a field's bounding rectangle (RW)
FormField
 
TabBar Methods
Method
Return
Value
Description
Inherited
From
CheckFailedMandatory
(
[setfocusonfailure = smallint])
ActiveField
Checks all child mandatory fields 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()
FlexibleForm
Makes a duplicate of the object, placing a reference to the new object in a reference variable
Object
FieldByName
(name =
varchar(256))
FieldObject
Finds a field object that matches a specified name
CompositeField
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
IsAncestorOf
(descendant =
FormField)
smallint
Is TRUE if the composite is an ancestor at any level of a specified form field
CompositeField
IsDescendantOf
(ancestor =
FieldObject)
smallint
Is TRUE if the field object is a descendant at any level of the specified ancestor
FieldObject
SelectAll()
none
Sets all selectable direct descendants of a composite field to the selected state
CompositeField
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
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