# TabStats The **TabStats** object provides various information and statistics about the current folder displayed in a tab. Note that the [**Tab**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/tab) object provides two versions of this object. **Tab.selstats** takes [Checkbox Mode](https://chaoses-ib.gitbook.io/directory-opus/manual/basic_concepts/selecting_files/selecting_with_the_mouse_and_keyboard/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**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) | Returns the total number of bytes in the folder as a [**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) object. | | checkbox\_mode | *bool* | Returns **True** if the tab is currently in [Checkbox Mode](https://chaoses-ib.gitbook.io/directory-opus/manual/basic_concepts/selecting_files/selecting_with_the_mouse_and_keyboard/checkbox_mode). | | checkedbytes | *object:*[**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) | Returns the total number of bytes in checked items as a [**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) object. | | checkeddirbytes | *object:*[**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) | Returns the total number of bytes in checked folders as a [**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) object. | | checkeddirs | *int* | Returns the total number of checked folders. | | checkedfilebytes | *object:*[**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) | Returns the total number of bytes in checked files as a [**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/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**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) | Returns the total number of bytes in all folders as a [**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) object. | | dirs | *int* | Returns the total number of folders. | | filebytes | *object:*[**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) | Returns the total number of bytes in all files as a [**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/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**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) | Returns the size of the largest file in the folder as a [**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) object. | | musiclength | *int* | Returns the total length in seconds of all music files. | | selbytes | *object:*[**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) | Returns the total number of bytes in all selected items as a [**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) object. | | seldirbytes | *object:*[**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) | Returns the total number of bytes in all selected folders as a [**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) object. | | seldirs | *int* | Returns the number of selected folders. | | selfilebytes | *object:*[**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/filesize) | Returns the total number of bytes in all selected files as a [**FileSize**](https://chaoses-ib.gitbook.io/directory-opus/manual/reference/scripting_reference/scripting_objects/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. |