Skip to content

Commit 7c7fa64

Browse files
Merge pull request #1021 from dynamsoft-docs/preview
update
2 parents 050f6ac + 4480f84 commit 7c7fa64

2 files changed

Lines changed: 12 additions & 12 deletions

File tree

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,41 +2,41 @@
22
layout: default-layout
33
noTitleIndex: true
44
needAutoGenerateSidebar: true
5-
title: LoadImageEx File Dialog Closes Immediately on Linux
5+
title: File Dialog Closes Immediately on Linux
66
keywords: Dynamic Web TWAIN, Linux, LoadImageEx, File Dialog, GTK, libgtk2.0-0
7-
breadcrumbText: LoadImageEx File Dialog Closes Immediately on Linux
8-
description: LoadImageEx File Dialog Closes Immediately on Linux
7+
breadcrumbText: File Dialog Closes Immediately on Linux
8+
description: File Dialog Closes Immediately on Linux
99
date: 2026-07-06 10:14:50 +0000
10-
last_modified: 2026-07-06 10:14:50 +0000
10+
last_modified: 2026-07-07 07:45:50 +0000
1111
---
1212

13-
# LoadImageEx File Dialog Closes Immediately on Linux
13+
# File Dialog Closes Immediately on Linux
1414

15-
### Symptom
15+
## Symptom
1616

17-
When calling the `LoadImageEx` API on Linux, the native file selection dialog briefly appears and then immediately closes.
17+
When calling the Load or Save related APIs on Linux, the native file selection dialog briefly appears and then immediately closes.
1818

1919
The operation fails, and the following message may be reported in the browser console:
2020

2121
```text
2222
User cancelled the operation.
2323
```
2424

25-
### Issue characteristics
25+
## Issue characteristics
2626

2727
- Only occurs on Linux
28-
- Occurs when calling the `LoadImageEx` API
28+
- Occurs when calling file load or save APIs, such as `LoadImageEx`, `SaveAsXXX`, `SaveAllAsXXX`, and `SaveSelectedImagesAsXXX`
2929
- The native file dialog flashes briefly and then closes automatically
3030
- The user is unable to select a file
3131
- The browser console reports `User cancelled the operation`
3232

33-
### Reason
33+
## Reason
3434

3535
This issue is caused by a missing Linux system dependency.
3636

3737
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.
3838

39-
### Resolution
39+
## Resolution
4040

4141
Install the GTK2 runtime library on the Linux machine:
4242

_articles/faq/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -211,7 +211,7 @@ description: Dynamic Web TWAIN SDK Documentation FAQ
211211
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)
212212
34. [Error message - File is Damaged and Can’t Be Opened in macOS](/_articles/faq/file-damaged-on-macos.md)
213213
35. [Safari 26.2 Regression Causing Dynamic Web TWAIN v19.3 Auto-Reconnect Failure on macOS](/_articles/faq/safari-26-2-regression.md)
214-
36. [LoadImageEx File Dialog Closes Immediately on Linux](/_articles/faq/file-dialog-in-linux.md)
214+
36. [File Dialog Closes Immediately on Linux](/_articles/faq/file-dialog-on-linux.md)
215215

216216
## Licensing and Purchase
217217

0 commit comments

Comments
 (0)