Merge pull request #1020 from dynamsoft-docs/preview

add new faq

Author: Ellie-dynamsoft

_articles/faq/file-dialog-in-linux.md

@@ -0,0 +1,47 @@
+---
+layout: default-layout
+noTitleIndex: true
+needAutoGenerateSidebar: true
+title: LoadImageEx File Dialog Closes Immediately on Linux
+keywords: Dynamic Web TWAIN, Linux, LoadImageEx, File Dialog, GTK, libgtk2.0-0
+breadcrumbText: LoadImageEx File Dialog Closes Immediately on Linux
+description: LoadImageEx File Dialog Closes Immediately on Linux
+date: 2026-07-06 10:14:50 +0000
+last_modified: 2026-07-06 10:14:50 +0000
+---
+
+# LoadImageEx File Dialog Closes Immediately on Linux
+
+### Symptom
+
+When calling the `LoadImageEx` API on Linux, the native file selection dialog briefly appears and then immediately closes.
+
+The operation fails, and the following message may be reported in the browser console:
+
+```text
+User cancelled the operation.
+```
+
+### Issue characteristics
+
+- Only occurs on Linux
+- Occurs when calling the `LoadImageEx` API
+- The native file dialog flashes briefly and then closes automatically
+- The user is unable to select a file
+- The browser console reports `User cancelled the operation`
+
+### Reason
+
+This issue is caused by a missing Linux system dependency.
+
+Dynamic Web TWAIN relies on the GTK2 runtime library (`libgtk2.0-0`) to display the native file selection dialog on Linux. If this library is not installed, the dialog cannot be initialized correctly and is immediately closed by the operating system. Dynamic Web TWAIN therefore reports the operation as being cancelled by the user.
+
+### Resolution
+
+Install the GTK2 runtime library on the Linux machine:
+
+**Debian-based distributions**
+
+```bash
+sudo apt install libgtk2.0-0
+```

_articles/faq/index.md

@@ -211,6 +211,7 @@ description: Dynamic Web TWAIN SDK Documentation FAQ
 33.  [Error message - CORS Errors caused by local network access permissions when using Chromium 142 and later](/_articles/faq/chromium-142-local-network-access-issue.md)
 34.  [Error message - File is Damaged and Can’t Be Opened in macOS](/_articles/faq/file-damaged-on-macos.md)
 35.  [Safari 26.2 Regression Causing Dynamic Web TWAIN v19.3 Auto-Reconnect Failure on macOS](/_articles/faq/safari-26-2-regression.md)
+36.  [LoadImageEx File Dialog Closes Immediately on Linux](/_articles/faq/file-dialog-in-linux.md)
 
 ## Licensing and Purchase