Suppl::GetFieldVal (Interface: Suppl)
 
Gets the value of a field as a variant.
 
VARIANT GetFieldVal (
    enum eSupplFld eFieldID
)
 
Parameters
eFieldID
[in] Identifier of the field, e.g. supfSysNum (C++) or eSupplFld.supfSysNum (C# / VB.NET).
 
Remark: In VBS, this field identifier enumerations cannot be used! You should use GetFieldID to get a valid field identifier.
 
Return value
A VARIANT containing the value of the requested field.
Be aware that this can be a null-object in some cases, e.g. if the value of a system field (e.g. Crc1) is requested.
 
See Also
CreateSuppl
GetFieldStr
SetFieldVal
 
Samples
 
C++
 
// Retrieving the value of all (non system) fields
_variant_t vValue;
for (int nFieldID = 0; nFieldID < supfMax; nFieldID++)
{
    vValue = pSuppl->GetFieldVal ((eSupplFld)nFieldID);
    if (vValue.vt != VT_EMPTY)
    {
        // Process data
    }
}

C#
 
// Retrieving the value of all (non system) fields
object oValue = null;
for (int nFieldID = 0; nFieldID < (int)eSupplFld.supfMax; nFieldID++)
{
    oValue = oSuppl.GetFieldVal ((eSupplFld)nFieldID);
    if (oValue != null)
    {
        // Process data
    }
}

VBS
 
' Retrieving the value of all (non system) fields
Dim vValue
Dim iFld
For iFld=0 To oSuppl.GetFieldID("FutureUse")
    vValue = oSuppl.GetFieldVal(iFld)
    If VarType(vValue) <> vbNull Then
        ' Process data
    End If    
Next

VB.NET
 
' Retrieving the value of all (non system) fields
Dim oValue As Object
For iFieldID As Integer = 0 To eSupplFld.supfMax
    oValue = oSuppl.GetFieldVal(iFieldID)
    If Not oValue Is Nothing Then
        ' Process data
    End If
Next