> ## 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

> Membuka Windows folder picker melalui Windows file picker dengan folder selection mode dan mengembalikan folder yang dipilih sebagai file item.

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

  ## Argumen

  <ParamField path={"options"} type={"DialogOptions"}>
    Optional table. Untuk openfolderdialog, title dan defaultPath digunakan. defaultPath hanya diterapkan saat resolve ke existing directory. extensionFilter diterima oleh shared dialog options parser, tetapi folder selection diaktifkan dengan folder selection mode.
  </ParamField>

  ## Return

  <ResponseField name={"folder"} type={"FileSystemItem | nil"}>
    Selected folder item, atau nil saat dialog dibatalkan. Dialog failures melempar Failed to open folder dialog.
  </ResponseField>

  ## Tipe

  ### DialogOptions

  Mengonfigurasi dialog pemilihan file atau folder asli.

  | Name               | Type                 | Required | Deskripsi                                                                                          |
  | ------------------ | -------------------- | -------- | -------------------------------------------------------------------------------------------------- |
  | `title`            | `string`             | No       | Menetapkan judul jendela dialog.                                                                   |
  | `defaultPath`      | `string`             | No       | Memilih direktori yang ditampilkan saat dialog terbuka.                                            |
  | `extensionFilter`  | `&#123;string&#125;` | No       | Membatasi file yang dapat dipilih ke ekstensi yang tercantum, dengan atau tanpa titik di depannya. |
  | `suggestedName`    | `string`             | No       | Memberikan nama file awal dalam dialog penyimpanan.                                                |
  | `defaultExtension` | `string`             | No       | Menetapkan ekstensi yang digunakan ketika nama file yang dimasukkan tidak ada.                     |

  ## Contoh

  Buka folder picker dan tangani selected folder item atau 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>