---
title: "dirChooser"
canonical: "https://help.vicon.com/space/ShogunPost121/1253736965/dirChooser"
format: markdown
---
# Description

Shows the system File Browser dialog box, which allows users to choose a folder.

## Functional area

User Window

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `dirChooser [-owner integer] [-title string] [-path string] [-failOnCancel]` |

### Arguments

None

### Flags

> Macro (scroll-tablelayout)

| Name | Flag arguments | Argument type | Exclusive to | Comments |
| --- | --- | --- | --- | --- |
| `owner` | 1 | integer | — | Specifies the window ID of a user window to be the "owner" of the File Browser. Essentially, centers the browser to the user window. |
| `title` | 1 | string | — | Specifies the title of the file browser window. The default is "Please select a folder". |
| `path` | 1 | string | — | Specifies the initial directory of the file browser when it is displayed. |
| `failOnCancel` | 0 | — | — | Causes execution to stop with an error. If this is not specified, an empty string is returned and execution will continue. |

## Return value

string