MenuItem.GetMixedStateImage
---------------------------

Returns the image used to depict a mixed state.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Menu](component_Menu.md) | [4.1](newinversion41.md) | ✅ Yes | ✅ Yes | ❌ No | ❌ No | ❌ No |

MBS( "MenuItem.GetMixedStateImage"; Item { ; ImageType; FileName } ) 

**MBS**( **"MenuItem.GetMixedStateImage";** /\* Returns the image used to depict a mixed state. \*/  
**$Item**; /\* The reference to the menu item.   
Please create one with [MenuItem.CreateMenuItem](MenuItemCreateMenuItem.md) or [MenuItem.CreateSeparator](MenuItemCreateSeparator.md). \*/   
**$ImageType**; /\* Optional; The type of image to return.   
Either JPEG, PNG, GIF or BMP. Default is JPEG.e.g. "JPEG" \*/   
**$FileName**) /\* Optional; The filename to use for the picture.   
Default is "image" with the extension matching the image type.e.g. "test.jpg" \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| Item | The reference to the menu item.    Please create one with [MenuItem.CreateMenuItem](MenuItemCreateMenuItem.md) or [MenuItem.CreateSeparator](MenuItemCreateSeparator.md). | $item |  |
| ImageType | The type of image to return.    Either JPEG, PNG, GIF or BMP. Default is JPEG. | "JPEG" | Optional |
| FileName | The filename to use for the picture.    Default is "image" with the extension matching the image type. | "test.jpg" | Optional |

### Result

Returns image or error.

### Description

Returns the image used to depict a mixed state.  
A mixed state is useful for indicating a mix of "off" and "on" attribute values in a group of selected objects, such as a selection of text containing boldface and plain (non-boldface) words. By default this is a horizontal line.  
Please call [GMImage.Release](GMImageRelease.md) later to free memory for this image.  
### See also

- [GMImage.Release](GMImageRelease.md)
- [MenuItem.CreateMenuItem](MenuItemCreateMenuItem.md)
- [MenuItem.CreateSeparator](MenuItemCreateSeparator.md)
- [MenuItem.GetOffStateImage](MenuItemGetOffStateImage.md)
- [MenuItem.GetOnStateImage](MenuItemGetOnStateImage.md)
- [MenuItem.SetMixedStateImage](MenuItemSetMixedStateImage.md)
- [MenuItem.SetOffStateImage](MenuItemSetOffStateImage.md)
- [MenuItem.SetOnStateImage](MenuItemSetOnStateImage.md)

This function checks for a license.

Created 18th August 2014 , last changed 29th September 2020

  
[MenuItem.GetKeyEquivalentModifierMask](MenuItemGetKeyEquivalentModifierMask.md) - [MenuItem.GetOffStateImage](MenuItemGetOffStateImage.md)

[HTML Version](MenuItemGetMixedStateImage.shtml)