FormatConditionBase.PredefinedFormatName Property

Gets or sets the name of the predefined format to be applied to the cells. This is a dependency property.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v18.2.Core.dll

Declaration

C#

public string PredefinedFormatName { get; set; }

VB.NET

Public Property PredefinedFormatName As String

Property Value

Type	Description
String	A String value that is the predefined format name.

Remarks

The table below presents the collections that store predefined formats.

Conditional Format	Predefined Formats Collection
Basic conditional formats	TableView.PredefinedFormats (TreeListView.PredefinedFormats)
Data Update	TableView.PredefinedFormats (TreeListView.PredefinedFormats)
Icon Sets	TableView.PredefinedIconSetFormats (TreeListView.PredefinedIconSetFormats)
Color Scales	TableView.PredefinedColorScaleFormats (TreeListView.PredefinedColorScaleFormats)
Data Bars	TableView.PredefinedDataBarFormats (TreeListView.PredefinedDataBarFormats)

You cannot modify a predefined format collection. To define a new predefined format, create a new predefined format collection.

The following code sample illustrates how to create a collection of predefined formats in markup:

XAML

<dxg:TableView AllowConditionalFormattingMenu="True">
   <dxg:TableView.PredefinedFormats>
      <dx:FormatInfoCollection>
         <dx:FormatInfo FormatName="PurpleFill" DisplayName="Purple Fill">
            <dx:FormatInfo.Format>
               <dxg:Format Background="Purple"/>
            </dx:FormatInfo.Format>
         </dx:FormatInfo>
      </dx:FormatInfoCollection>
   </dxg:TableView.PredefinedFormats>
   <!----> 
</dxg:TableView>

The code sample below illustrates how to create a collection of predefined formats in code-behind:

C#

FormatInfoCollection predefinedFormats = new FormatInfoCollection();
foreach (FormatInfo formatInfo in view.PredefinedFormats) {
   predefinedFormats.Add(formatInfo);
}
predefinedFormats.Add(new FormatInfo() {
   FormatName = "PurpleFill",
   DisplayName = "Purple Fill",
   Format = new Format() {
      Background = Brushes.Purple
   }
});
view.PredefinedFormats = predefinedFormats;

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the PredefinedFormatName property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-apply-conditional-formatting-t135593/CS/ConditionalFormatting/MainWindow.xaml#L25

<dxg:TableView.FormatConditions>
    <dxg:FormatCondition Expression="[SalesVsTarget] &lt; 0.0m" FieldName="SalesVsTarget" PredefinedFormatName="RedText"/>
    <dxg:FormatCondition Expression="[Profit] &lt; 0.0" FieldName="Profit">

how-to-change-a-modified-cell-appearance-e4025/VB/DXGrid_ConditionalFormatting/Window1.xaml#L26

<dxg:TableView.FormatConditions>
    <dxg:DataBarFormatCondition FieldName="OldPrice" PredefinedFormatName="GreenSolidDataBar" MaxValue="100" MinValue="0"/>
    <dxg:DataBarFormatCondition FieldName="NewPrice" PredefinedFormatName="BlueSolidDataBar" MaxValue="1000" MinValue="0"/>