ImageEdit.ConvertEditValue Event
Allows you to manually encode the editor’s value in the required image format before it is posted to a data source.
Namespace: DevExpress.Xpf.Editors
Assembly: DevExpress.Xpf.Core.v21.2.dll
NuGet Package: DevExpress.Wpf.Core
Declaration
Event Data
The ConvertEditValue event's data class is ConvertEditValueEventArgs. The following properties provide information specific to this event:
Property | Description |
---|---|
EditValue | Gets or sets the editor’s value. |
Handled | Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route. Inherited from RoutedEventArgs. |
ImageSource | Gets the image displayed by the image editor. |
OriginalSource | Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class. Inherited from RoutedEventArgs. |
RoutedEvent | Gets or sets the RoutedEvent associated with this RoutedEventArgs instance. Inherited from RoutedEventArgs. |
Source | Gets or sets a reference to the object that raised the event. Inherited from RoutedEventArgs. |
The event data class exposes the following methods:
Method | Description |
---|---|
InvokeEventHandler(Delegate, Object) | When overridden in a derived class, provides a way to invoke event handlers in a type-specific way, which can increase efficiency over the base implementation. Inherited from RoutedEventArgs. |
OnSetSource(Object) | When overridden in a derived class, provides a notification callback entry point whenever the value of the Source property of an instance changes. Inherited from RoutedEventArgs. |
Remarks
By default, the image is stored as image source. Handle the ConvertEditValue event to manually encode the editor’s value before it is posted to a data source.
Example
This example shows how to save images displayed within the DXGrid control to a data source in JPEG format. To do this, the image editor's Convert__EditValue event is handled to encode JPEG format images before they are posted to a data source.
<Window x:Class="InplaceImageEdit.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:dxg="http://schemas.devexpress.com/winfx/2008/xaml/grid"
xmlns:dxe="http://schemas.devexpress.com/winfx/2008/xaml/editors"
Title="MainWindow" Height="350" Width="525">
<Grid>
<dxg:GridControl Name="grid">
<dxg:GridControl.Columns>
<dxg:GridColumn FieldName="Picture">
<dxg:GridColumn.EditSettings>
<dxe:ImageEditSettings ConvertEditValue="ImageEditSettings_ConvertEditValue" ShowLoadDialogOnClickMode="Always" ShowMenu="False"/>
</dxg:GridColumn.EditSettings>
</dxg:GridColumn>
<dxg:GridColumn FieldName="CategoryName" />
</dxg:GridControl.Columns>
<dxg:GridControl.View>
<dxg:TableView AutoWidth="True" />
</dxg:GridControl.View>
</dxg:GridControl>
</Grid>
</Window>