| |
| Gets the value of a field as a variant. |
| |
 |
VARIANT GetFieldVal (
enum eArtclFld eFieldID
) |
|
| |
| Parameters | | eFieldID | [in] Identifier of the field, e.g. artfSysNum (C++) or eArtclFld.artfSysNum (C# / VB.NET).
| |
| Warning: DO NOT hardcode numeric values for field identifiers. The numeric value of a field (i.e. the enum value) can change from one version to the next. Always use the enum or use GetFieldID |
| Warning: DO NOT assume the order of fields will remain the same (do not calculate relative fields). artfSysNum + 15 may not be valid or the same in future versions. |
| Remark: In VBS, this field identifier enumerations cannot be used! You should use GetFieldID to get a valid field identifier. |
| Remark: Within an object, field identifiers will not change as long as the object persists. You can obtain a value with GetFieldID once and then continue using the value. However, note that custom calculation fields are unique per dossier; even if they have the same field name, they may not have the same numeric value in all dossiers. |
| | | | 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 |
|
|
|
| |
| Samples |
| |
 |
C++ |
| |
// Retrieving the value of all standard fields (excludes calculation fields)
_variant_t vValue;
for (int nFieldID = 0; nFieldID <= artfMax; nFieldID++)
{
vValue = pArtcl->GetFieldVal ((eArtclFld)nFieldID);
if (vValue.vt != VT_EMPTY)
{
// Process data
}
}
|
|
|
C# |
| |
// Retrieving the value of all standard fields (excludes calculation fields)
object oValue = null;
for (int nFieldID = 0; nFieldID <= (int)eArtclFld.artfMax; nFieldID++)
{
oValue = oArtcl.GetFieldVal ((eArtclFld)nFieldID);
if (oValue != null)
{
// Process data
}
}
|
|
|
VBS |
| |
' Retrieving the value of all standard fields (excludes calculation fields)
Dim vValue
Dim iFld
For iFld=0 To oArtcl.GetFieldID("FutureUse")
vValue = oArtcl.GetFieldVal(iFld)
If VarType(vValue) <> vbNull Then
' Process data
End If
Next
|
|
|
VB.NET |
| |
' Retrieving the value of all standard fields (excludes calculation fields)
Dim oValue As Object
For iFieldID As Integer = 0 To eArtclFld.artfMax
oValue = oArtcl.GetFieldVal(iFieldID)
If Not oValue Is Nothing Then
' Process data
End If
Next
|
|
