Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

What it Does

Set all the fields of a given partial field name (e.g. "FName", usually level 2 and level 3 field parts) to a property setting (e.g. read only, hidden, required, etc.).

...

Parameter

Type

Description

FieldNameStringThe partial field name to be used. All fields containing this string will have the properties set up. E.g. "Name" will cover fields "FName", "MName", "LName", etc.
FieldVisibilityQFD.FieldVisibility

Sets the visibility of the field. Values:        

  • NotSet = -1       
  • NotSet = -1 None = 0       
  • Visible_No_Print = 1      
  • Hidden = 2       
  • Visible = 4
FieldReadOnlyQFD.FieldReadOnly

Sets the read-only level of the field. Values: 

  • NotSet = -1
  • NoRestrictions = 0
  • Read_Only = 1
FieldRequiredQFD.FieldRequired

Sets the required level of the field. Values:

  • NotSet = -1
  • NotRequired = 0
  • Required = 1
FieldMaskFlagBooleanIf true, the field will be masked (password field)
FieldFormatStringSets the format to be applied to the value of the field
FieldCalcOverrideBooleanIf true, calculations are not enabled for the field. Usually used with calculated fields, like FullName or Addr123
HiddenFieldBooleanIf true, the field will be a hidden input (input type = "hidden")
FieldBackgroundColorStringSets the background color of the field. E.g "#CCC", or "#AABBCC"
MaxCharLengthStringSets the maximum character length that may be entered into a field. For example, if MaxCharLength = "5", then users may not type a value into a given field that is more than 5 characters long–the value will cut off after the 5th character. However, this field may still be prefilled with data that is longer than 5 characters (maximum length only takes effect when values are manually typed onto the form by users).


Sample Code

Code Block
languagevb
themeConfluence
Dim objQFE As New QuikFormsEngine        
Dim fieldProperties As New FieldPropertiesInBulkByFieldName() With {.FieldName = "FName", .FieldBackgroundColor = "#CCC"}
objQFE.SetFieldPropertyByFieldName(fieldProperties)

Dim fieldProperties2 As New FieldPropertiesInBulkByFieldName() With {.FieldName = "Addr123", .FieldCalcOverride = True}
objQFE.SetFieldPropertyByFieldName(fieldProperties2)

...