Function EN Version 2.97

@GetVarWithFieldFlags

Float IDList List Misc Note NUMBER RichText Text TimeDate VStack

Syntax

@GetVarWithFieldFlags(NAME1;GROUP2);
@GetVarWithFieldFlags(NAME1);

Description

Returns the value of the variable named TEXT NAME1 . If the variable belongs to a group (e.g. a document), the group name (e.g. the NOTEHANDLE of the document) as TEXT GROUP2 must be specified. This enables an alternative way of accessing variables.
Unlike @GetVar, @GetVarWithFieldFlags also retrieves the flags of the source variable VAR3.
*****************************************************************
IMPORTANT:
Field flags cannot be set by the assignment operator.
The only exception is the direct assignment before @GetVarWithFieldFlags.

Example:

XXX:=YYY;

The flags are not taken over from YYY.

XXX:=@GetVarWithFieldFlags("YYY");

The flags are taken over from YYY.

ZZZ:=XXX:=@GetVarWithFieldFlags("YYY");

The flags are taken over for XXX von YYY but not for ZZZ.
*****************************************************************

Example: @GetVarWithFieldFlags(NAME1)

VAR1:="TEST";
NAME1:="VAR1";
@GetVarWithFieldFlags(NAME1);

returns "TEST"

Example: @GetVarWithFieldFlags(NAME1;GROUP2)

DBHANDLE:=@OpenDB("TEST.NSF");
NOTEHANDLE1:=@OpenNoteByID(DBHANDLE;37386;NOTEHANDLE1);
@LogReport(@GetVarWithFieldFlags("Form";"NOTEHANDLE1"));
NOTEHANDLE1:=@CloseNote(NOTEHANDLE1;0);
DBHANDLE:=@CloseDB(DBHANDLE);

returns the form name of the document with ID 37386 in "TEST.NSF"

Note : This text was machine-translated and may contain inaccuracies.