| |
| Sets the value of a field. |
| |
 |
void SetFieldVal (
enum eCtLnkFld eFieldID,
VARIANT vFieldValue
) |
|
| |
| Parameters | | eFieldID | [in] Identifier of the field, e.g. ctlfSysNum (C++) or eCtLnkFld.ctlfSysNum (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). ctlfSysNum + 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. |
| | vFieldValue | | [in] A VARIANT containing the value you want to give the requested field. |
| |
| See Also |
|
|
|
| |
| Samples |
| |
 |
C++ |
| |
// Set the value of the e-mail address to 'firstname.lastname@someserver.com'
pCtLnk->SetFieldVal (ctlfEmail, "firstname.lastname@someserver.com");
|
|
|
C# |
| |
// Set the value of the e-mail address to 'firstname.lastname@someserver.com'
oCtLnk.SetFieldVal (eCtLnkFld.ctlfEmail, "firstname.lastname@someserver.com");
|
|
|
VBS |
| |
' Set the value of the e-mail address to 'firstname.lastname@someserver.com'
Call oCtLnk.SetFieldVal(oCtLnk.GetFieldID("Email"), "firstname.lastname@someserver.com")
|
|
|
VB.NET |
| |
' Set the value of the e-mail address to 'firstname.lastname@someserver.com'
oCtLnk.SetFieldVal(eCtLnkFld.ctlfEmail, "firstname.lastname@someserver.com")
|
|
