CardFormatRuleLayoutElement.CreateTextElement(String) Method

Creates a text layout element to which a format rule applies.

Namespace: DevExpress.DashboardCommon

Assembly: DevExpress.Dashboard.v22.2.Core.dll

NuGet Packages: DevExpress.Dashboard.Core, DevExpress.Win.Dashboard.Design

Declaration

C#

public static CardFormatRuleLayoutElement CreateTextElement(
    string text
)

VB.NET

Public Shared Function CreateTextElement(
    text As String
) As CardFormatRuleLayoutElement

Parameters

Name	Type	Description
text	String	The text layout element’s display text.

Returns

Type	Description
CardFormatRuleLayoutElement	The card’s text layout element.

Remarks

The following example shows how to apply the Value format rule to cards whose actual value is greater than the set condition value. The rule applies the green check icon to the card’s text layout element. The CreateTextElement method obtains the text layout element by the element’s display text.

C#

using System.Windows.Forms;
using DevExpress.DashboardCommon;

CardDashboardItem cardItem = (CardDashboardItem)dashboardDesigner1.Dashboard.Items["cardDashboardItem1"];

CardItemDeltaFormatRule iconRule = new CardItemDeltaFormatRule();
iconRule.DeltaValueType = DeltaValueType.ActualValue;
iconRule.Card = cardItem.Cards[0];
FormatConditionValue valueCondition2 = new FormatConditionValue(DashboardFormatCondition.Greater, 1000000);
valueCondition2.StyleSettings = new IconSettings(FormatConditionIconType.IndicatorGreenCheck);
iconRule.Condition = valueCondition2;
CardFormatRuleLayoutElement text = CardFormatRuleLayoutElement.CreateTextElement("Sales: ");
iconRule.ApplyToLayoutElement = text;
cardItem.FormatRules.Add(iconRule);

VB.NET

Imports System.Windows.Forms
Imports DevExpress.DashboardCommon

Dim card As CardDashboardItem = CType(dashboardDesigner1.Dashboard.Items("cardDashboardItem1"), CardDashboardItem)

Dim iconRule As New CardItemDeltaFormatRule()
iconRule.DeltaValueType = DeltaValueType.ActualValue
iconRule.Card = cardItem.Cards(0)
Dim valueCondition2 As New FormatConditionValue(DashboardFormatCondition.Greater, 1000000)
valueCondition2.StyleSettings = New IconSettings(FormatConditionIconType.IndicatorGreenCheck)
iconRule.Condition = valueCondition2
Dim text As CardFormatRuleLayoutElement = CardFormatRuleLayoutElement.CreateTextElement("Sales: ")
iconRule.ApplyToLayoutElement = text
cardItem.FormatRules.Add(iconRule)

Tip

Documentation:

• Cards - Conditional Formatting
• Cards - Layout