TabStats

The TabStats object provides various information and statistics about the current folder displayed in a tab. Note that the Tab object provides two versions of this object. Tab.selstats takes Checkbox Mode into account, and in this mode the values of the "checked" and the "selected" properties will be the same. If the object was retrieved via Tab.stats and the file display is in Checkbox Mode, the two sets of properties will be different.

 

Property Name

Return Type

Description

bigimage_h

int

Returns the width in pixels of the largest image in the folder.

bigimage_w

int

Returns the height in pixels of the largest image in the folder.

bytes

object:FileSize 

Returns the total number of bytes in the folder as a FileSize object.

checkbox_mode

bool

Returns True if the tab is currently in Checkbox Mode.

checkedbytes

object:FileSize 

Returns the total number of bytes in checked items as a FileSize object.

checkeddirbytes

object:FileSize 

Returns the total number of bytes in checked folders as a FileSize object.

checkeddirs

int

Returns the total number of checked folders.

checkedfilebytes

object:FileSize 

Returns the total number of bytes in checked files as a FileSize object.

checkedfiles

int

Returns the total number of checked files.

checkeditems

int

Returns the total number of checked items.

checkedmusiclength

int

Returns the total length in seconds of all checked music files.

dirbytes

object:FileSize 

Returns the total number of bytes in all folders as a FileSize object.

dirs

int

Returns the total number of folders.

filebytes

object:FileSize 

Returns the total number of bytes in all files as a FileSize object.

filedate_max

date

Returns the latest (most recent) file date in the folder.

filedate_min

date

Returns the earliest (oldest) file date in the folder.

files

int

Returns the total number of files.

items

int

Returns the total number of items.

largestfile

object:FileSize 

Returns the size of the largest file in the folder as a FileSize object.

musiclength

int

Returns the total length in seconds of all music files.

selbytes

object:FileSize 

Returns the total number of bytes in all selected items as a FileSize object.

seldirbytes

object:FileSize 

Returns the total number of bytes in all selected folders as a FileSize object.

seldirs

int

Returns the number of selected folders.

selfilebytes

object:FileSize 

Returns the total number of bytes in all selected files as a FileSize object.

selfiles

int

Returns the number of selected files.

selitems

int

Returns the number of selected items.

selmusiclength

int

Returns the total length in seconds of all selected music files.

  

Method Name

Arguments

Return Type

Description

Update

none

none

The first time a script accesses a particular TabStats object, a snapshot is taken of the tab state. If the script then makes changes to that tab (e.g. it selects files, creates a new folder, etc), these changes will not be reflected by the object. To re-synchronize the object with the tab, call the TabStats.Update method.