SEC_TREECLASS::InsertBatch

BOOLSEC_TREECLASS::InsertBatch(TV_ITEM**ppItems, HTREEITEMhParent, intcItems, BOOLbInvalidate= TRUE)

SEC_TREECLASS

Defined in: trcore.inl

Return Value

BOOL TRUE if the items were inserted; otherwise FALSE

Parameters

ppItems

an array of TV_ITEM pointers

hParent

The common parent to insert all items under

cItems

The number of items in ppItems

Comments

This call has better performance for inserting large numbers of ordered items under a common parent than individual InsertItem calls. Each item will be inserted in array order, following the last existing child of the parent. The handles for the items will be placed in the individual hItem members of the TV_ITEM structures in the array, and the mask for each item will have the TVIF_HANDLE flag set

bInvalidate

If TRUE, all items will be remeasured and the control will be invalidated after all items are inserted