diff --git a/_articles/faq/file-dialog-in-linux.md b/_articles/faq/file-dialog-on-linux.md similarity index 65% rename from _articles/faq/file-dialog-in-linux.md rename to _articles/faq/file-dialog-on-linux.md index 79b08d1d..d8cd1924 100644 --- a/_articles/faq/file-dialog-in-linux.md +++ b/_articles/faq/file-dialog-on-linux.md @@ -2,19 +2,19 @@ layout: default-layout noTitleIndex: true needAutoGenerateSidebar: true -title: LoadImageEx File Dialog Closes Immediately on Linux +title: 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 +breadcrumbText: File Dialog Closes Immediately on Linux +description: File Dialog Closes Immediately on Linux date: 2026-07-06 10:14:50 +0000 -last_modified: 2026-07-06 10:14:50 +0000 +last_modified: 2026-07-07 07:45:50 +0000 --- -# LoadImageEx File Dialog Closes Immediately on Linux +# File Dialog Closes Immediately on Linux -### Symptom +## Symptom -When calling the `LoadImageEx` API on Linux, the native file selection dialog briefly appears and then immediately closes. +When calling the Load or Save related APIs 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: @@ -22,21 +22,21 @@ The operation fails, and the following message may be reported in the browser co User cancelled the operation. ``` -### Issue characteristics +## Issue characteristics - Only occurs on Linux -- Occurs when calling the `LoadImageEx` API +- Occurs when calling file load or save APIs, such as `LoadImageEx`, `SaveAsXXX`, `SaveAllAsXXX`, and `SaveSelectedImagesAsXXX` - 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 +## 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 +## Resolution Install the GTK2 runtime library on the Linux machine: diff --git a/_articles/faq/index.md b/_articles/faq/index.md index ef4cc129..5ca5a7da 100644 --- a/_articles/faq/index.md +++ b/_articles/faq/index.md @@ -211,7 +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) +36. [File Dialog Closes Immediately on Linux](/_articles/faq/file-dialog-on-linux.md) ## Licensing and Purchase