ActiveXPowUpload 1.0.1 control documentation
FileItem object provides a way to access individual elements of the file list. Each element either represents a file or a folder. See IsFile property to know exact. You cannot create an FileItem object directly. You must obtain it by GetItem() method of an ActiveXPowUpload object.

FileItem object properties 



Index property

Name property

FullName property

Size property

Selected property

SelectedPath property

RootPath property

CreationTime property

LastAccessTime property

LastWriteTime property

IsFile property


Index

Long Index {read only}

0-based index of file at the list.

Description

0-based index of file at the list.

Example

var index=ActiveXPowUpload.GetItem(0).Index; // index of first file at the list. Value should be 0.



Name

String Name {read only}

File name without full path.

Description

File name without full path.

Example

var name=ActiveXPowUpload.GetItem(0).Name;



FullName

String Fullname {read only}

File name with a full path.

Description

File name with a full path. Some available values: “c:\some\folder\file.ext”, “\\network_share\some\folder\file.ext”

Example

var path=ActiveXPowUpload.GetItem(0).FullName;



Size

Long Size {read only}

File size.

Description

File size, in bytes.

Example

var size=ActiveXPowUpload.GetItem(0).Size;



Selected

Bool Selected {read-only}

Determines if file selected (highlighted) in the list.

Description

Determines if file selected (highlighted) in the list.

Example

var isSelected=ActiveXPowUpload.GetItem(0).Selected;



SelectedPath

String SelectedPath {read only}

The relative path of the file if a folder containing this file was selected.

Description

The relative path of the file if a folder containing this file was selected. The relative path starts with the name of the folder that was selected. In case a disk root was selected (e.g. “c:\”) SelectedPath is a path of the file relative to the disk root. In case a network share folder was selected SelectedPath is a path of the file relative to the server. For better understanding of SelectedPath and RootPath properties see examples bellow:

Example

Existing disk structure:
C:\dir1\dir2\file1
C:\dir1\dir2\file2
C:\file3

1. File selected explicitly: “C:\dir1\dir2\file1”
SelectedPath = “file1”, RootPath = “C:\dir1\dir2\”

2. Folder selected: “C:\dir1\dir2\”
SelectedPath = “dir2\file1”, RootPath = “C:\dir1\”
SelectedPath = “dir2\file2”, RootPath = “C:\dir1\”


3. Disk root selected: “C:\”
SelectedPath = “dir1\dir2\file1”, RootPath = “C:\”
SelectedPath = “dir1\dir2\file1”, RootPath = “C:\”
SelectedPath = “file3”, RootPath=”C:\”


Complete network share structure:
\\srv\share\dir1\dir2\file1
\\srv\share\dir1\dir2\file2
\\srv\share\file3

1. Network share folder selected: “\\srv\share\”
SelectedPath = “share\dir1\dir2\file1”, RootPath = “\\srv\”
SelectedPath = “share\dir1\dir2\file2”, RootPath = “\\srv\”
SelectedPath = “share\file3”, RootPath = “\\srv\”


RootPath

String RootPath {read only}

A head of the full file path.

Description

A head of the full file path. Concatenation of RootPath and SelectedPath is FullName i.e RootPath+SelectedPath=FullName. See examples of SelectedPath property.



CreationTime

Date CreationTime {read only}

File creation time.

Description

File creation time.

Example

var cDate=new Date(ActiveXPowUpload.GetItem(0).CreationTime);



LastAccessTime

Date LastAccessTime {read only}

File last access time

Description

File last access time

Example

var aDate=new Date(ActiveXPowUpload.GetItem(0).LastAccessTime);



LastWriteTime

Date LastWriteTime {read only}

File last write time.

Description

File last write time.

Example

var wDate=new Date(ActiveXPowUpload.GetItem(0).LastWriteTime);



IsFile

Bool IsFile {read-only}

Determines if the current item is a file or a folder.

Description

true - it is a file, false - it is a folder.

Example

var isFile=ActiveXPowUpload.GetItem(0).IsFile;