WpclsInsertMultipleObjects

This class method inserts multiple objects into a container at one time. It is specific to version 3 or higher of the OS/2 operating system.

Syntax

rc = _wpclsInsertMultipleObjects(somSelf, hwndCnr, pptlIcon, pObjectArray, pRecordParent, NumRecords);

Parameters

somSelf (M_WPObject *) - input

Pointer to the WPObject class object.

hwndCnr (HWND) - input

Handle to the container window in which objects are to be inserted.

pptlIcon (PPOINTL) - input

Pointer to the initial icon position of the first icon inserted.

pObjectArray (PVOID *) - input

Pointer to an array of object pointers. The objects in this array are to be inserted into the container.

pRecordParent (PVOID) - input

Pointer to the parent record. This parameter should be set to NULL if the records being inserted will not have a parent or tree view is not supported.

NumRecords (ULONG) - input

Number of records in `pObjectArray` to be inserted. This parameter must be greater than 0.

Returns

rc (BOOL) - returns

Success indicator.

Value	Description
TRUE	Successful completion.
FALSE	Errors occurred.

Remarks

This method provides rapid insertion of multiple objects into a container at once. wpCnrInsertObject performs the same function as this method, but operates only on one object at a time. This method adds each object to the in-use list.

Usage

This method can be called at any time to add multiple objects to a container.

How to Override

This method is generally not overridden.

Related Methods

• wpCnrInsertObject
• wpCnrRemoveObject
• wpclsRemoveObjects