From a1f3482a57a482326f050bfb8995459694e7bbb1 Mon Sep 17 00:00:00 2001
From: ztyyLV <97287824+ztyyLV@users.noreply.github.com>
Date: Mon, 6 Jul 2026 18:24:48 +0800
Subject: [PATCH] add new faq

---
 _articles/faq/file-dialog-in-linux.md | 47 +++++++++++++++++++++++++++
 _articles/faq/index.md                |  1 +
 2 files changed, 48 insertions(+)
 create mode 100644 _articles/faq/file-dialog-in-linux.md

diff --git a/_articles/faq/file-dialog-in-linux.md b/_articles/faq/file-dialog-in-linux.md
new file mode 100644
index 00000000..79b08d1d
--- /dev/null
+++ b/_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
+```
diff --git a/_articles/faq/index.md b/_articles/faq/index.md
index 4b0a28dc..ef4cc129 100644
--- a/_articles/faq/index.md
+++ b/_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