CopyItems Method, SftTree Object


	SftTree.CopyItems Method	Softel vdm, Inc.

Copies items to a new position in the tree control.

Deprecated - Provided for compatibility with earlier versions only - Use Items.Copy instead

Syntax

		VB.NET	CountCopied = object.CopyItems(ByVal FromIndex As Integer, ByVal Count As Integer, ByVal ToIndex As Integer) As Integer
		VB	CountCopied = object.CopyItems(ByVal FromIndex As Long, ByVal Count As Long, ByVal ToIndex As Long) As Long
		C#.NET	int CountCopied = object.CopyItems(int FromIndex, int Count, int ToIndex);
		VC++	long CountCopied = object->CopyItems(long FromIndex, long Count, long ToIndex);
		C	HRESULT object->raw_CopyItems(long FromIndex, long Count, long ToIndex, long* CountCopied);
		Delphi	CountCopied := object.CopyItems(FromIndex : Integer; Count : Integer; ToIndex : Integer) : Integer;

object

A SftTree object.

FromIndex

The zero-based index of the first item to be copied.

Count

The number of items to be copied.

ToIndex

The zero-based index of the position where the items are to be inserted. If ToIndex is -1, the items will be added at the end of the list.

CountCopied

Returns the number of items copied.

Comments

Deprecated - Provided for compatibility with earlier versions only - Use Items.Copy instead

The CopyItems method copies items to a new position in the tree control.

The CopyItems method copies all item attributes, including cell text, graphics, level, row header contents, etc. Also copied are all data attributes such as Cell.Data, Cell.DataString, Item.Data, etc. If these values should remain unique in an application, they have to be explicitly changed after copying an item. The CopyItemDataString property has no effect.

The target ToIndex cannot be inside the group of items to be copied.

Items can be moved using the Items.Move and Items.MoveAfter methods.