Bar

BarEditItem.EditValue Property

Specifies the value for the BarEditItem's editor. This is a dependency property.

Namespace: DevExpress.Xpf.Bars

Assembly: DevExpress.Xpf.Core.v20.1.dll

Declaration

public object EditValue { get; set; }
Public Property EditValue As Object

Property Value

Type Description
Object

An object that represents the edit value for the in-place editor.

Remarks

Use the EditValue property to get and set an in-place editor's value. When setting the EditValue property, ensure that the new value is of the type that is accepted by the in-place editor. For instance, a SpinEdit editor accepts numeric values, while a TextEdit control is used to edit string values.

To respond to changing the EditValue property, handle the BarEditItem.EditValueChanged event.

If a text editor (TextEditSettings) or its descendant is assigned to the BarEditItem, the text being entered in the edit box is saved to the EditValue property with each keystroke by default. To change the trigger for the value validation and posting operation, use the TextEditSettings.ValidateOnTextInput and TextEditSettings.ValidateOnEnterKeyPressed properties. For instance, to validate the text and save it to the EditValue only when the ENTER key is pressed, set the TextEditSettings.ValidateOnTextInput property to false, and the TextEditSettings.ValidateOnEnterKeyPressed property to true.

Examples

This example shows how to embed in-place editors into a bar using BarEditItem objects. Two editors (DateEdit and SpinEdit) are added with the BarEditItem.EditSettings property. Values for the editors are provided using the EditValue property.

The following image shows the result:

E1549

<Window
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:dxb="http://schemas.devexpress.com/winfx/2008/xaml/bars" 
        xmlns:dxe="http://schemas.devexpress.com/winfx/2008/xaml/editors"
        xmlns:dx="http://schemas.devexpress.com/winfx/2008/xaml/core" 
        x:Class="CreateBarEditItems.Window2"
        Title="Window2" Height="300" Width="300">
    <Grid>

        <Grid.RowDefinitions>
            <RowDefinition Height="Auto" />
            <RowDefinition Height="*"/>
            <RowDefinition Height="Auto"/>
        </Grid.RowDefinitions>


        <dxb:BarContainerControl Grid.Row="0">
            <dxb:ToolBarControl>
                <!--Create a DateEdit and SpinEdit in-place editors -->
                <dxb:BarEditItem x:Name="editItemDateEdit1" Content="Date" EditValue="01/01/2010">
                    <dxb:BarEditItem.EditSettings>
                        <dxe:DateEditSettings />
                    </dxb:BarEditItem.EditSettings>
                </dxb:BarEditItem>
                <dxb:BarEditItem x:Name="editItemSpinEdit1" Content="Value" EditValue="123" EditWidth="50">
                    <dxb:BarEditItem.EditSettings>
                        <dxe:SpinEditSettings />
                    </dxb:BarEditItem.EditSettings>
                </dxb:BarEditItem>

            </dxb:ToolBarControl>
        </dxb:BarContainerControl>



        <DockPanel Name="dockPanel1" LastChildFill="False" VerticalAlignment="Stretch">
            <!--Create a BarContainerControl that will display bars at the top of the DockPanel-->
            <dxb:BarContainerControl x:Name="TopBarContainer" DockPanel.Dock="Right" ContainerType="Right">
            </dxb:BarContainerControl>
        </DockPanel>





    </Grid>

</Window>
See Also