Copy Method, SftTreeItems Object


	SftTreeItems.Copy Method	Softel vdm, Inc.

Copies items to a new position in the tree control.

Syntax

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

object

A SftTreeItems object.

FromIndex

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

Count

The number of items to be copied.

InsertIndex

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

CountCopied

Returns the number of items copied.

Comments

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

The Copy 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 InsertIndex cannot be inside the group of items to be copied.

Items can also be copied using the Items.CopyAfter method.

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