ActiveXPowUpload 1.2.0.5
FileItem object properties
  Home page
Contact support

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 from GetItem() method of the ActiveXPowUpload object.

Index property

Name property

FullName property

Size property

Selected property

Focused 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 {set/get}

Determines whether the item is selected (highlighted) in the list.

Description

Determines whether the item is selected (highlighted) in the list and allows to change selection.

Example

var isSelected=ActiveXPowUpload.GetItem(0).Selected;
// select the first item of the list
ActiveXPowUpload.GetItem(0).Selected = true;

Focused

Bool Focused {set/get}

Determines whether the item has the focus in the list.

Description

Determines whether the item has the focus in the list and allows to change the focus. Only one item in a list may have the focus, but it is possible that none has the focus.

Example

var isFocused=ActiveXPowUpload.GetItem(0).Focused;
// set the focus to the first item of the list
ActiveXPowUpload.GetItem(0).Focused = true;

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;