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

# openfilesdialog

> Membuka Windows file-open dialog melalui Windows file picker dengan multi-select aktif dan mengembalikan file yang dipilih sebagai nilai file item.

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

  ## Argumen

  <ParamField path={"options"} type={"DialogOptions"}>
    Optional table. Untuk openfilesdialog, title, defaultPath, dan extensionFilter digunakan. extensionFilter adalah table berisi extension strings; awalan . atau \*. dihapus sebelum setiap filter menjadi \*.\<extension>.
  </ParamField>

  ## Return

  <ResponseField name={"files"} type={"{ FileSystemItem } | nil"}>
    Array table berisi nilai file item untuk file yang dipilih, atau nil saat dialog dibatalkan atau tidak ada selected filesystem paths yang dikembalikan. Dialog failures melempar Failed to open file 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 file picker untuk memilih satu atau beberapa file dan tangani setiap selected file item.

  ```lua theme={null}
  local files = openfilesdialog({
      title = "Choose source files",
      defaultPath = ".",
      extensionFilter = { "lua", "luau", "txt" },
  })

  if files then
      for _, file in ipairs(files) do
          print(file:GetName())
          print(file:IsFile())
      end
  else
      print("No files selected")
  end
  ```
</div>