Jaa


OPTIONCAPTION Function (FieldRef)

Gets the option caption of the field that is currently selected.

Syntax

  
OptionCaption := FieldRef.OPTIONCAPTION  

Parameters

FieldRef
Type: FieldRef

Refers to the current field.

Property Value/Return Value

Type: Text

The option caption of the field.

Remarks

The option caption of the field is returned as a comma separated string.

If the field is not an Option, an empty string is returned.

This function returns an error if no field is selected.

Example

The following example opens the Item table as a RecordRef variable that is named ItemRecref. and creates a reference to field 19 (Price/Profit Calculation field), which is an Option field. The OPTIONCAPTION function retrieves the caption of the option field and displays the options as a comma separated list. This example requires that you create the following variables in the C/AL Globals windows.

Variable name DataType
ItemRecref RecordRef
MyFieldRef FieldRef
OptionCaption Text
  
ItemRecref.OPEN(DATABASE::Item);  
MyFieldRef := ItemRecref.FIELD(19);  
OptionCaption := MyFieldRef.OPTIONCAPTION;  
MESSAGE('%1', OptionCaption);  

See Also

FieldRef Data Type