FormatRuleBase.StopIfTrue Property

Gets or sets whether subsequent format rules that target a specific cell should be ignored if the current format rule evaluates to true for this cell.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.2.dll

Declaration

C#

[DefaultValue(false)]
[DXCategory("Behavior")]
[XtraSerializableProperty]
public bool StopIfTrue { get; set; }

VB.NET

<DefaultValue(False)>
<XtraSerializableProperty>
<DXCategory("Behavior")>
Public Property StopIfTrue As Boolean

Property Value

Type	Default	Description
Boolean	false	true if subsequent format rules that target a specific cell should be ignored if the current format rule evaluates to true for this cell; otherwise, false.

Remarks

Multiple style format rules can be created in a container control. All of them are stored in the container control’s dedicated collection and they are applied in the order specified by this collection.

If a FormatRuleBase object evaluates to true and its StopIfTrue property is enabled, the Data Grid ignores all subsequent style format rules that target the same object (row or cell).

• If a rule applied to cells (see ColumnApplyTo) evaluates to true, it discards all following rules with the same ColumnApplyTo value.
• If a rule applied to rows (see ApplyToRow) evaluates to true, it discards all following rules whose ApplyToRow is enabled.

Otherwise, the row or cell appearance is affected by all corresponding style format rules. Subsequent format rules may override the appearance settings imposed on this cell by preceding format rules.