# FileProps Package
{: .no_toc }

**Author:** WaynePhillipsEA. **Version:** 1.7.1.0

The **FileProps** contributed package provides access to Windows shell file properties through a Virtual-COM wrapper. It exposes a predeclared **FilePropertyExplorer** class that opens a file and returns a **FileProperties** collection; each entry in that collection is a **FileProperty** object with the system name, localized name, unique ID, and current value of one shell property.

## Classes

- [FileProperties](/tB/Packages/Contributed/FileProps/FileProperties/index.md) -- a read-only collection of Windows shell properties for a single file, returned by FilePropertyExplorer
  - [Count](/tB/Packages/Contributed/FileProps/FileProperties/Count.md) -- returns the number of properties in the collection
  - [FilePath](/tB/Packages/Contributed/FileProps/FileProperties/FilePath.md) -- returns the full file path of the file that was opened
  - [Item](/tB/Packages/Contributed/FileProps/FileProperties/Item.md) -- returns the FileProperty object at the given index, name, or ID in the collection
- [FileProperty](/tB/Packages/Contributed/FileProps/FileProperty/index.md) -- one Windows shell property of a file
  - [ID](/tB/Packages/Contributed/FileProps/FileProperty/ID.md) -- returns a unique identifier string for the shell property
  - [Name](/tB/Packages/Contributed/FileProps/FileProperty/Name.md) -- returns the system identity name of the property
  - [NameDesc](/tB/Packages/Contributed/FileProps/FileProperty/NameDesc.md) -- returns the localized display name of the property
  - [Value](/tB/Packages/Contributed/FileProps/FileProperty/Value.md) -- returns or sets the current value of the shell property as a Variant
  - [ValueDesc](/tB/Packages/Contributed/FileProps/FileProperty/ValueDesc.md) -- returns the current value of the property as a localized string
- [FilePropertyExplorer](/tB/Packages/Contributed/FileProps/FilePropertyExplorer/index.md) -- a predeclared factory class that opens a file and returns a FileProperties collection of its Windows shell properties
  - [BrowseAndOpenFile](/tB/Packages/Contributed/FileProps/FilePropertyExplorer/BrowseAndOpenFile.md) -- displays a file-open dialog and returns a FileProperties collection for the selected file
  - [OpenFile](/tB/Packages/Contributed/FileProps/FilePropertyExplorer/OpenFile.md) -- opens a file by path and returns a FileProperties collection of its shell properties

## Test cases

The notes and warnings of this section are checked by the test cases in [FileProps-tests.twinproj](FileProps-tests.twinproj), a twinBASIC project. It uses FileProps as a [linked package](/Features/Packages/Linked.md#manual-management): put the package's `.twinpack` in `%APPDATA%\twinBASIC\packages`, then run the project, and each case prints whether it passes.
