> ## Documentation Index
> Fetch the complete documentation index at: https://docs.projectreal.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# openfolderdialog

> Ouvre un Windows folder picker with Windows file picker avec folder selection mode et renvoie le dossier selectionne comme file item.

<div className="real-function-page">
  ```lua theme={null}
  openfolderdialog(options?: DialogOptions): FileSystemItem | nil
  ```

  ## Arguments

  <ParamField path={"options"} type={"DialogOptions"}>
    Optional table. Pour openfolderdialog, title et defaultPath sont utilises. defaultPath est applique seulement lorsqu il se resout en existing directory. extensionFilter est accepte par le shared dialog options parser, mais folder selection est active avec folder selection mode.
  </ParamField>

  ## Retours

  <ResponseField name={"folder"} type={"FileSystemItem | nil"}>
    Selected folder item, ou nil lorsque le dialog est annule. Dialog failures lancent Failed to open folder dialog.
  </ResponseField>

  ## Types

  ### DialogOptions

  Configure la boîte de dialogue de sélection de fichier ou de dossier.

  | Name               | Type                 | Required | Description                                                                                   |
  | ------------------ | -------------------- | -------- | --------------------------------------------------------------------------------------------- |
  | `title`            | `string`             | No       | Définit le titre de la fenêtre de dialogue.                                                   |
  | `defaultPath`      | `string`             | No       | Sélectionne le répertoire affiché lorsque la boîte de dialogue s'ouvre.                       |
  | `extensionFilter`  | `&#123;string&#125;` | No       | Limite les fichiers sélectionnables aux extensions répertoriées, avec ou sans point de début. |
  | `suggestedName`    | `string`             | No       | Fournit le nom de fichier initial dans les boîtes de dialogue d'enregistrement.               |
  | `defaultExtension` | `string`             | No       | Définit l'extension utilisée lorsque le nom de fichier saisi n'en a pas.                      |

  ## Exemple

  Ouvre un folder picker et traite le selected folder item ou cancellation.

  ```lua theme={null}
  local folder = openfolderdialog({
      title = "Choose a folder",
      defaultPath = ".",
  })

  if folder then
      print(folder:GetName())
      print(folder:IsFolder())
  else
      print("No folder selected")
  end
  ```
</div>