Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 7.5   8.0   8.1   8.2   8.3   8.4   8.5   9.0   9.1   9.2    Statistic  


Queries a device property value.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
WIA 6.5 No Yes No No No
MBS( "WIA.DevicePropertyValue"; Device; Key )   More


Parameter Description Example value
Device You can pass index of device to check them in a row.
Or pass name or unique ID of device.
Pass empty string for current device.
Key The property key.
Can be a text with the name of the property or the corresponding ID.


Returns value or error.


Queries a device property value.
You can use WIA.DevicePropertyKeys to learn about available keys.
Values are returned as numbers, booleans or converted to text.


Query name of current device:

MBS( "WIA.DevicePropertyValue"; ""; "Name" )

List properties:

Set Variable [$device; Value:Get(ScriptParameter)]
Set Variable [$list; Value:MBS("WIA.DevicePropertyKeys"; $device)]
If [MBS("IsError")]
    Show Custom Dialog ["Error"; $list]
    Set Variable [$count; Value:ValueCount ( $list )]
    If [$count > 0]
        Set Variable [$i; Value:1]
            Set Variable [$key; Value:GetValue ( $list; $i)]
            Set Variable [$value; Value:MBS("WIA.DevicePropertyValue"; $device; $key)]
            New Record/Request
            Set Field [WIA Scan::Device; $device]
            Set Field [WIA Scan::Key; $key]
            Set Field [WIA Scan::Value; $value]
            Commit Records/Requests [No dialog]
            Set Variable [$i; Value:$i+1]
            Exit Loop If [$i > $count]
        End Loop
    End If
End If

Query maximum vertical optical resolution:

// via name
MBS("WIA.DevicePropertyValue"; ""; "Vertical Optical Resolution")
// via ID
MBS("WIA.DevicePropertyValue"; ""; 3091)

Query Manufacturer of first device:

MBS( "WIA.DevicePropertyValue"; 0; "Manufacturer")

Example result: "Brother"

See also

Example Databases

Blog Entries

Created 6th November 2016, last changed 19th February 2019

WIA.DevicePropertyKeys   -   WIA.GetCurrentDevice

Feedback: Report problem or ask question.

MBS Xojo PDF Plugins