Skip to content

add new faq #1020

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Ellie-dynamsoft merged 1 commit into from
Jul 7, 2026
+48 −0
Merged

add new faq #1020

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 47 additions & 0 deletions _articles/faq/file-dialog-in-linux.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
```
1 change: 1 addition & 0 deletions _articles/faq/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down