---
name: "al_show_native_file_dialog"
section: "3alleg5"
platform: "linux"
package: "allegro5-doc"
version: "2:5.2.10.1+dfsg-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/al_show_native_file_dialog/3alleg5"
---

# al\_show\_native\_file\_dialog(3alleg5)

Allegro 5 API

## NAME

al\_show\_native\_file\_dialog - Allegro 5 API

## SYNOPSIS

-

  ```
  #include <allegro5/allegro_native_dialog.h>
  bool al_show_native_file_dialog(ALLEGRO_DISPLAY *display,
     ALLEGRO_FILECHOOSER *dialog)
  ```

## DESCRIPTION

Show the dialog window. The display may be NULL, otherwise the given display is treated as the parent if possible.

This function blocks the calling thread until it returns, so you may want to spawn a thread with al\_create\_thread(3alleg5) and call it from inside that thread.

Returns true on success, false on failure.

*Note:* On Android, ALLEGRO\_EVENT\_DISPLAY\_HALT\_DRAWING(3alleg5) and ALLEGRO\_EVENT\_DISPLAY\_RESUME\_DRAWING(3alleg5) need to be handled before this function returns. This means that you must call it from a different thread.