WIA.ItemPropertyValue
---------------------

Queries an item property value.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [WIA](component_WIA.md) | [6.5](newinversion65.md) | ❌ No | ✅ Yes | ❌ No | ❌ No | ❌ No |

MBS( "WIA.ItemPropertyValue"; Item; Key ) 

**MBS**( **"WIA.ItemPropertyValue";** /\* Queries an item property value. \*/  
**$Item**; /\* The item of current device to query.  
For a scanner this is typical Flatbed or Feeder.  
see [WIA.ListItems](WIAListItems.md)e.g. "Flatbed" \*/   
**$Key**) /\* The property key.  
Can be a text with the name of the property or the corresponding ID.e.g. "Name" \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| Item | The item of current device to query.   For a scanner this is typical Flatbed or Feeder.   see [WIA.ListItems](WIAListItems.md) | "Flatbed" |
| Key | The property key.   Can be a text with the name of the property or the corresponding ID. | "Name" |

### Result

Returns value or error.

### Description

Queries an item property value.  
  
File formats UUIDs:  
| BMP | B96B3CAB-0728-11D3-9D7B0000F81EF32E |
|---|---|
| JPEG | B96B3CAE-0728-11D3-9D7B0000F81EF32E |
| PNG | B96B3CAF-0728-11D3-9D7B0000F81EF32E |
| GIF | B96B3CB0-0728-11D3-9D7B0000F81EF32E |
| TIFF | B96B3CB1-0728-11D3-9D7B0000F81EF32E |

  
Document Handling Flags:  
  
| Name | Value | Description |
|---|---|---|
| FEEDER | 1 | Scan by using the document feeder. |
| FLATBED | 2 | Scan by using the flatbed. |
| DUPLEX | 4 | Scan by using duplexer operations. |
| FRONT\_FIRST | 8 | Scan the front of the document first. This value is valid only when DUPLEX is set. |
| BACK\_FIRST | 16 | Scan the back of the document first. This value is valid only when DUPLEX is set. |
| FRONT\_ONLY | 32 | Scan the front only. |
| BACK\_ONLY | 64 | Scan the back only. This value is valid only when DUPLEX is set. |
| NEXT\_PAGE | 128 | Scan the next page of the document. |
| PREFEED | 256 | Enable pre-feed mode. Position the next document while scanning. |
| AUTO\_ADVANCE | 512 | Enable automatic feeding of the next document after a scan. |
| ADVANCED\_DUPLEX | 1024 | Scan by using individual configuration settings for each child feeder item (WIA\_CATEGORY\_FEEDER\_FRONT and WIA\_CATEGORY\_FEEDER\_BACK). This flag cannot be set together with DUPLEX. A device that supports different scan settings for the front and back items should implement the optional ADF front and back items and it should support both DUPLEX and ADVANCED\_DUPLEX. |

  
Use [WIA.ItemProperties](WIAItemProperties.md) to query all values with keys as JSON.  
Use [WIA.SetItemPropertyValue](WIASetItemPropertyValue.md) to set a value.  
### Examples

Queries resolution:

 MBS ( "WIA.ItemPropertyValue"; "Flatbed"; "Horizontal Resolution" )  
Queries file extension:

 MBS ( "WIA.ItemPropertyValue"; "Flatbed"; "Filename extension" )  
Queries media type:

 MBS ( "WIA.ItemPropertyValue"; "Flatbed"; "Media Type" )  
Queries orientation:

 MBS ( "WIA.ItemPropertyValue"; "Flatbed"; "Orientation" )  
// 0 = Portrait, 1 = Landscape, 2 = Rotate 180, 3 = Rotate 270  
List properties of feeder:

 Set Variable \[ $item ; Value: "Feeder" \]   
Set Variable \[ $list ; Value: MBS ("[WIA.ItemPropertyKeys](WIAItemPropertyKeys.md)"; $item ) \]   
If \[ MBS ("IsError") \]   
 Show Custom Dialog \[ "Error" ; $list \]   
Else  
 Set Variable \[ $count ; Value: ValueCount ( $list ) \]   
 If \[ $count > 0 \]   
 Set Variable \[ $i ; Value: 1 \]   
 Loop  
 Set Variable \[ $key ; Value: GetValue ( $list ; $i ) \]   
 Set Variable \[ $value ; Value: MBS ("WIA.ItemPropertyValue"; $item ; $key ) \]   
 New Record/Request  
 Set Field \[ WIA Scan::Device ; $item \]   
 Set Field \[ WIA Scan::Key ; $key \]   
 Set Field \[ WIA Scan::Value ; $value \]   
 Commit Records/Requests \[ With dialog: Off \]   
 # Next  
 Set Variable \[ $i ; Value: $i +1 \]   
 Exit Loop If \[ $i > $count \]   
 End Loop  
 End If  
End If  
Query document handling select:

 MBS ( "WIA.ItemPropertyValue"; "feeder"; "Document Handling Select")  
Query format:

 Set Variable \[ $format ; Value: MBS ( "WIA.ItemPropertyValue"; "Flatbed"; "Format") \]  
<small>  
Example result: {B96B3CAB-0728-11D3-9D7B-0000F81EF32E}</small>### See also

- [IsError](IsError.md)
- [WIA.DevicePropertyValue](WIADevicePropertyValue.md)
- [WIA.ItemProperties](WIAItemProperties.md)
- [WIA.ItemPropertyKeys](WIAItemPropertyKeys.md)
- [WIA.ListItems](WIAListItems.md)
- [WIA.SetItemPropertyValue](WIASetItemPropertyValue.md)

### Release notes

- **Version 15.5**
    - Improved [WIA.DevicePropertyValue](https://www.mbsplugins.eu/WIADevicePropertyValue.shtml), [WIA.ItemPropertyValue](https://www.mbsplugins.eu/WIAItemPropertyValue.shtml) and [WMIQuery.PropertyValue](https://www.mbsplugins.eu/WMIQueryPropertyValue.shtml) to better return various numeric array types.

### Blog Entries

- [MBS FileMaker Plugin, version 15.5pr2](https://www.mbsplugins.de/archive/2025-10-08/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 6.5pr9](https://www.mbsplugins.de/archive/2016-12-05/MBS_FileMaker_Plugin_version_6/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 28th November 2016 , last changed 7th July 2025

  
[WIA.ItemPropertyKeys](WIAItemPropertyKeys.md) - [WIA.ListItems](WIAListItems.md)

[HTML Version](WIAItemPropertyValue.shtml)