| Components | All | New | MacOS | Windows | Linux | iOS | ||||
| Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old | |
WIA.ImageDialog
Offer dialog to user to acquire image.
| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
| WIA | 6.5 | ❌ No | ✅ Yes | ❌ No | ❌ No | ❌ No |
Parameters
| Parameter | Description | Example | Flags |
|---|---|---|---|
| Flags | Specifies dialog box behavior. Currently only UseCommonUI is available. Use this flag to use the system UI instead of the vendor-supplied UI. |
"UseCommonUI" | |
| FolderPath | The native path to the folder where images are stored. Your application must have write permissions for this folder. |
"C:\Scans\" | |
| FileName | The file name ot use. Extensions and/or numbers are added if needed. |
"Scan" | Optional |
Result
Returns Cancel, OK or error.
Description
Offer dialog to user to acquire image.This may ask the user for the device to use.
If a current device is selected, this one will be used.
When the functions returns, you can use WIA.ImageCount to query how many images got scanned.
Even if the user cancels, there may be some images already available.
This function requires a native path. Use Path.FileMakerPathToNativePath to convert a FileMaker path to a native path if required. If you like to have the user choose the path, you can use FileDialog functions.
Examples
Show image dialog:
Set Variable [$folder; Value:MBS( "Folders.UserTemporary" )]
Set Variable [$path; Value:MBS( "Path.AddPathComponent"; $folder; "FileMakerScans")]
Set Variable [$r; Value:MBS( "Files.CreateDirectory"; $path)]
#Scan...
Set Variable [$r; Value:MBS("WIA.ImageDialog"; "Default"; $path; "scan")]
Set Variable [$count; Value:MBS( "WIA.ImageCount")]
#Result can be OK or Cancel and in both cases some images may be there
If [$r ≠ "OK"]
Show Custom Dialog ["Scan Result"; $r]
End If
If [$count > 0]
Set Variable [$i; Value:0]
Go to Layout [“Images” (Images)]
Loop
Set Variable [$ImagePath; Value:MBS( "WIA.Image"; $i)]
Set Variable [$image; Value:MBS( "Container.ReadFile"; $ImagePath)]
New Record/Request
Set Field [Images::Name; MBS( "Path.LastPathComponent"; $ImagePath )]
Set Field [Images::Image; $image]
Commit Records/Requests [No dialog]
#Next
Set Variable [$i; Value:$i + 1]
Exit Loop If [$i >= $count]
End Loop
End If
See also
- Container.ReadFile
- Files.CreateDirectory
- Folders.UserTemporary
- Path.AddPathComponent
- Path.FileMakerPathToNativePath
- Path.LastPathComponent
- WIA.Image
- WIA.ImageCount
Release notes
- Version 10.3
- Changed WIA.ImageDialog and WIA.SelectDeviceDialog to call FM.InitMessageFilter internally to avoid running into COM error dialogs.
Example Databases
Blog Entries
- Seven things to add to your FileMaker solution today with MBS Plugin
- MBS FileMaker Plugin, version 10.3pr1
This function checks for a license.
Created 6th November 2016, last changed 18th April 2024
