User Tools

Site Tools


File Property

File Property A File Property provides the ability to choose a specific file to apply to the scene selection. As a sub-type of the String Property, this property gives the option to provide text for the application; however, the File property only offers file strings (text) for selection.

As a specialized version of the string property, the File property always holds the path to a file, unless it is empty, and will contain a path if it has a value. This is a path to a file or directory. If no value is provided, the property is a path.

For scripting API documentation, see DzFileProperty.

Anatomy

File properties typically display the Default Anatomy features as well as features specific to the the String Property.

The Header of a File property displays the label of the property as well as icons that provide options for customizing how the property functions.

Body

The Body of a File property displays a drop-down arrow that displays a menu of options. Click the drop-down arrow to display a drop-down menu of options. Select the “None” option to specify that no file is linked to the selected property.

When the “Browse” option is selected, an OS dialog is displayed. Selecting the “Browse…” option causes an OS dialog to appear. Once a file is selected, and the dialog is closed, that name of that file is displayed in the body of the property.

Available files to open include:

  • File Open - OS file open dialog; “Open”: filters extensions/names of extensions that should be selectable
  • File Save - OS file open dialog; “Save”: filters extensions/names of extensions that should be selectable
  • Directory - see directories

By default, “file.txt” is display when a specific file is not selected. Selecting this option …