AccProp::UpdateDetailSel (Interface: AccProp)
 
Updates an accounting detail in the proposal (with selectively given values).
 
void UpdateDetailSel (
    SHORT sIndex,
    VARIANT vAmountDocC,
    VARIANT vQuantity,
    VARIANT vValue1,
    VARIANT vAccount,
    VARIANT vRemark,
    VARIANT vText1
)
 
Parameters
sIndex
[in] The index of the detail, starting from 0.
vAmountDocC
[in] A VARIANT stating the updated monetary amount (in proposal currency) of the detail.
If a VARIANT of subtype VT_EMPTY is supplied, the existing value (on disk) is kept.
If a VARIANT of subtype DOUBLE (VT_R8) is supplied, the given value is used.
vQuantity
[in] A VARIANT stating the updated quantity of the detail.
If a VARIANT of subtype VT_EMPTY is supplied, the existing value (on disk) is kept.
If a VARIANT of subtype DOUBLE (VT_R8) is supplied, the given value is used.
vValue1
[in] A VARIANT stating the updated free value of the detail.
If a VARIANT of subtype VT_EMPTY is supplied, the existing value (on disk) is kept.
If a VARIANT of subtype DOUBLE (VT_R8) is supplied, the given value is used.
vAccount
[in] A VARIANT stating the updated account number of the detail.
If a VARIANT of subtype VT_EMPTY is supplied, the existing value (on disk) is kept.
If a VARIANT of subtype BSTR (VT_BSTR) is supplied, the given value is used.
vRemark
[in] A VARIANT stating the updated remark of the detail.
If a VARIANT of subtype VT_EMPTY is supplied, the existing value (on disk) is kept.
If a VARIANT of subtype BSTR (VT_BSTR) is supplied, the given value is used.
vText1
[in] A VARIANT stating the updated free text of the detail.
If a VARIANT of subtype VT_EMPTY is supplied, the existing value (on disk) is kept.
If a VARIANT of subtype BSTR (VT_BSTR) is supplied, the given value is used.
 
Remarks
If the parameter sIndex is an invalid index (refers to a not existing detail) an exception is thrown. You can use GetDetail to check whether an index is valid, in which case it returns true.
How to pass a VARIANT of type VT_EMPTY?
C++
Define a VARIANT and set the type to VT_EMPTY (vEmpty.vt = VT_EMPTY).
Pass this VARIANT.
C#
Pass 'null'.
VBS
Pass 'Empty'.
VB.NET
Pass 'Nothing'.
 
See Also
CreateAccProp
Handling accounting proposals using the SDK
PrepareProposal
WriteProposal
CancelProposal
 
Samples
 
C++
 
// Update the remark of the first detail of the current proposal to 'Updated via SDK', leaving all other data unchanged
VARIANT vEmpty;
vEmpty.vt = VT_EMPTY;

pAccProp->PrepareProposal (paUpdate);

pAccProp->UpdateDetailSel (0, vEmpty, vEmpty, vEmpty, vEmpty, "Updated via SDK", vEmpty);

pAccProp->WriteProposal (rmFullReport);

C#
 
// Update the remark of the first detail of the current proposal to 'Updated via SDK', leaving all other data unchanged
oAccProp.PrepareProposal (ePrepareAction.paUpdate);

oAccProp.UpdateDetailSel (0, null, null, null, null, "Updated via SDK", null);

oAccProp.WriteProposal (eReportMode.rmFullReport);

VBS
 
' Update the remark of the first detail of the current proposal to 'Updated via SDK', leaving all other data unchanged
Call oAccProp.PrepareProposal(paUpdate)

Call oAccProp.UpdateDetailSel(0, Empty, Empty, Empty, Empty, "Updated via SDK", Empty)

Call oAccProp.WriteProposal(rmFullReport)

VB.NET
 
' Update the remark of the first detail of the current proposal to 'Updated via SDK', leaving all other data unchanged
oAccProp.PrepareProposal(ePrepareAction.paUpdate)

oAccProp.UpdateDetailSel(0, Nothing, Nothing, Nothing, Nothing, "Updated via SDK", Nothing)

oAccProp.WriteProposal(eReportMode.rmFullReport)