#

# LogiView

## Command 'field_write'

| Use this command to write to a mask field. Using an additional argument, it is possible to execute the field userexits when writing to a field (by default the userexits are not triggered by this command, since it is usually used for display purposes). It is also possible to suppress the setting of the "dirty flag" (which is evaluated by DataView to indicate the modification of the field contents). This argument can be transferred using an additional string using the syntax "/FLD_USX /NO_DIRTY". The command works similar to the DataView programming interface function 'mas_wri_fld'.
| This command allows long-text fields. This command must not be called in a conditional instruction. Entries in this field are also possible if write access of this field is not enabled or if the field is invisible. The database is not accessed!
| ### Syntax:
| field_write({WDG_ID},{FLD},{ROW},{EXPR})or field_write({WDG_ID},{FLD},{ROW},{EXPR},{STR_EXPR})
| ### I/O parameters:
| {WDG_ID} | ID of mask widget.
| {FLD} | Name of field.
| {ROW} | Row
| {EXPR} | Expression of arbitrary type to be written to the field.
| {STR_EXPR} | Optional:
/NO_DIRTY | dirty flags are not set.
/FLD_USX | field userexits are triggered.
| - |
| ### Return value:
| - |
| ### Example:
| Declaration of Variables
    10 field_write(DOCU_INT_1,"T_DOC_DAT.DOC_NAME_GER",1,"Wave",
       "/NO_DIRTY")
| Result:
| In the mask of the specified widget (DOCU_INT_1), the name of the first document is set to "Wave". The dirty flag is not set.
| Functions and commands: Modification of Fields