Artcl::InsertPartSel (Interface: Artcl)
 
Inserts a new article part (with selectively given values).
 
void InsertPartSel (
    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
Article number is empty Existing article number
VT_EMPTY Use the programmatorical default (= 0.0) Use an automatically calculated value based on the article data
DOUBLE (VT_R8) Use the given value 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 Use the programmatorical default (= "")
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
Article number is empty Existing article number
VT_EMPTY Use the programmatorical default (= "") Use the description from the article card
BSTR (VT_BSTR) Use the given value 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
Article number is empty Existing article number
VT_EMPTY Use the programmatorical default (= prmWithoutParts) Use an automatically calculated value based on the article data
Numerical value (variant type VT_UI1, VT_INT, VT_I2 or VT_I4) Use the given value Use the given value
 
Remarks
The parameter sIndex can have the value -1. In this case the new article part is inserted after the existing ones.
If sIndex refers to an existing article part, the new article part is inserted at this index and all following articles parts are moved to the next index.
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++
 
// Insert the first article part of the current article. Only the article number is given and all other data is to be calculated by the SDK.
VARIANT vEmpty;
vEmpty.vt = VT_EMPTY;

pArtcl->PrepareParts (ppaModify);

pArtcl->InsertPartSel (-1, vEmpty, "ART_001", vEmpty, vEmpty);

pArtcl->WriteParts (rmFullReport);

C#
 
// Insert the first article part of the current article. Only the article number is given and all other data is to be calculated by the SDK.
oArtcl.PrepareParts (ePreparePartsAction.ppaModify);

oArtcl.InsertPartSel (-1, null, "ART_001", null, null);

oArtcl.WriteParts (eReportMode.rmFullReport);

VBS
 
' Insert the first article part of the current article. Only the article number is given and all other data is to be calculated by the SDK.
Call oArtcl.PrepareParts(ppaModify)

Call oArtcl.InsertPartSel(-1, Empty, "ART_001", Empty, Empty)

Call oArtcl.WriteParts(rmFullReport)

VB.NET
 
' Insert the first article part of the current article. Only the article number is given and all other data is to be calculated by the SDK.
oArtcl.PrepareParts(ePreparePartsAction.ppaModify)

oArtcl.InsertPartSel(-1, Nothing, "ART_001", Nothing, Nothing)

oArtcl.WriteParts(eReportMode.rmFullReport)