Artcl::UpdatePartSel (Interface: Artcl)
 
Updates an article part (with selectively given values).
 
void UpdatePartSel (
    SHORT sIndex,
    VARIANT vQuantity,
    VARIANT vArtNumPart,
    VARIANT vArtDsc,
    VARIANT vPrintMode
)
 
Parameters
sIndex
[in] The index of the detail, starting from 0.
vQuantity
[in] A VARIANT stating the quantity of the article part. The type of this VARIANT determines the action to be taken by the SDK:
Subtype Action
VT_EMPTY Keep the existing value (on disk)
DOUBLE (VT_R8) Use the given value
vArtNumPart
[in] A VARIANT stating the article number of the part. The type of this VARIANT determines the action to be taken by the SDK:
Subtype Action
VT_EMPTY Keep the existing value (on disk)
BSTR (VT_BSTR) Use the given value
vArtDsc
[in] A VARIANT stating the article description of the part. The type of this VARIANT determines the action to be taken by the SDK:
Subtype Action
VT_EMPTY Keep the existing value (on disk)
BSTR (VT_BSTR) Use the given value
vPrintMode
[in] A VARIANT stating the printing mode (see ePrintMode for possible values) of the part. The type of this VARIANT determines the action to be taken by the SDK:
Subtype Action
VT_EMPTY Keep the existing value (on disk)
Numerical value (variant type VT_UI1, VT_INT, VT_I2 or VT_I4) Use the given value
 
Remarks
If the parameter sIndex is an invalid index (refers to a not existing article part) an exception is thrown. You can use GetPart 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
CreateArtcl
Handling article parts using the SDK
PrepareParts
CancelParts
WriteParts
 
Samples
 
C++
 
// Update the description of the first article part of the current article to 'Updated via SDK'
VARIANT vEmpty;
vEmpty.vt = VT_EMPTY;

pArtcl->PrepareParts (ppaModify);

pArtcl->UpdatePartSel (0, vEmpty, vEmpty, "Updated via SDK", vEmpty);

pArtcl->WriteParts (rmFullReport);

C#
 
// Update the description of the first article part of the current article to 'Updated via SDK'
oArtcl.PrepareParts (ePreparePartsAction.ppaModify);

oArtcl.UpdatePartSel (0, null, null, "Updated via SDK", null);

oArtcl.WriteParts (eReportMode.rmFullReport);

VBS
 
' Update the description of the first article part of the current article to 'Updated via SDK'
Call oArtcl.PrepareParts(ppaModify)

Call oArtcl.UpdatePartSel(0, Empty, Empty, "Updated via SDK", Empty)

Call oArtcl.WriteParts(rmFullReport)

VB.NET
 
' Update the description of the first article part of the current article to 'Updated via SDK'
oArtcl.PrepareParts(ePreparePartsAction.ppaModify)

oArtcl.UpdatePartSel(0, Nothing, Nothing, "Updated via SDK", Nothing)

oArtcl.WriteParts(eReportMode.rmFullReport)