reference:scripting_reference:scripting

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.