2.9.79 FFDataBits

The FFDataBits structure specifies the type and properties for a form field that is specified by a FFData.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

A

iRes

B

C

D

E

F

G

H

A - iType (2 bits): An unsigned integer that specifies the type of the form field. This value MUST be one of the following.

Value

Name

Description

0

iTypeText

Specifies that the form field is a textbox.

1

iTypeChck

Specifies that the form field is a checkbox.

2

iTypeDrop

Specifies that the form field is a dropdown list box.

iRes (5 bits): An unsigned integer. If iType is iTypeText (0), then iRes MUST be 0. If iType is iTypeChck (1), iRes specifies the state of the checkbox and MUST be 0 (unchecked), 1 (checked), or 25 (undefined). Undefined checkboxes are treated as unchecked. If iType is iTypeDrop (2), iRes specifies the current selected list box item. A value of 25 specifies the selection is undefined. Otherwise, iRes is a zero-based index into FFData.hsttbDropList.

B - fOwnHelp (1 bit): A bit that specifies whether the form field has custom help text in FFData.xstzHelpText. If fOwnHelp is 0, FFData.xstzHelpText contains an empty or auto-generated string.

C - fOwnStat (1 bit): A bit that specifies whether the form field has custom status bar text in FFData.xstzStatText. If fOwnStat is 0, FFData.xstzStatText contains an empty or auto-generated string.

D - fProt (1 bit): A bit that specifies whether the form field is protected and its value cannot be changed.

E - iSize (1 bit): A bit that specifies whether the size of a checkbox is automatically determined by the text size where the checkbox is located. This value MUST be 0 if iType is not iTypeChck (1).

F - iTypeTxt (3 bits): An unsigned integer that specifies the type of the textbox. This MUST be one of the following values.

Value

Name

Description

0

iTypeTxtReg

Specifies that the textbox value is regular text.

1

iTypeTxtNum

Specifies that the textbox value is a number.

2

iTypeTxtDate

Specifies that the textbox value is a date or time.

3

iTypeTxtCurDate

Specifies that the textbox value is the current date.

4

iTypeTxtCurTime

Specifies that the textbox value is the current time.

5

iTypeTxtCalc

Specifies that the textbox value is calculated from an expression. The expression is given by FFData.xstzTextDef.

If iType is not iTypeText (0), iTypeTxt MUST be 0 and MUST be ignored.

G - fRecalc (1 bit): A bit that specifies whether the value of the field is automatically calculated after the field is modified.

H - fHasListBox (1 bit): A bit that specifies that the form field has a list box. This value MUST be 1 if iType is iTypeDrop (2). Otherwise, this value MUST be 0.