RepositoryItemCheckedComboBoxEdit.ForceUpdateEditValue Property
Gets or sets whether the check states of check items in the dropdown are automatically changed according to the new edit value.
Namespace: DevExpress.XtraEditors.Repository
Assembly: DevExpress.XtraEditors.v24.2.dll
Declaration
[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Data")]
public virtual DefaultBoolean ForceUpdateEditValue { get; set; }
Property Value
Type | Default | Description |
---|---|---|
DefaultBoolean | Default | A DefaultBoolean value that specifies check item synchronization mode. |
Available values:
Name | Description | Return Value |
---|---|---|
True | The value is true. |
|
False | The value is false. |
|
Default | The value is specified by a global option or a higher-level object. |
|
Remarks
The DefaultBoolean.Default option is regarded as DefaultBoolean.True when the editor’s edit value is bound to a data source, and as DefaultBoolean.False in unbound mode.
If the ForceUpdateEditValue property is set to DefaultBoolean.True, the check states of check items in the dropdown are automatically synchronized with the edit value. This is accomplished by calling the CheckedComboBoxEdit.RefreshEditValue method.
If the ForceUpdateEditValue property is set to DefaultBoolean.False, the items are not in sync with the edit value. You may need to call the CheckedComboBoxEdit.RefreshEditValue method to manually perform synchronization.
In unbound mode, to assign an edit value, we recommend using the CheckedComboBoxEdit.SetEditValue method, which also performs all necessary synchronization.