Customize Rules Manager | ComponentOne RulesManager for WinForms

Customize Rules Manager

In This Topic

Rules Manager allows you to customize the appearance of its UI elements. It provides individual properties for various elements of the RulesManager UI which can be used to control their appearance in the UI at runtime. These properties can be set using Options property of the C1RulesManager class, which is used to access the appearance parameters of the Rules Manager and these properties belong to the IViewOptions interface.

Some of these properties, such as IsHeaderVisible, IsAddButtonVisible, IsRuleNameVisible, AllowedRules, etc are used in the following example to control the appearance of the elements of the Rules Manager control, such as the header, Add rule button, rule name, type of rule, respectively.

Appearance customization of the Rules Manager control

This example uses the sample created in the Quick Start section. In this example, we have added check boxes for each element to control their visibility and set their Checked property to true except the checkbox used to for the rule type.

C#	Copy Code
private void headerChkBox_CheckedChanged(object sender, EventArgs e) { if (headerChkBox == null) { return; } rulesManager.Options.IsHeaderVisible = headerChkBox.Checked; } private void AddChkBox_CheckedChanged(object sender, EventArgs e) { if (addChkBox == null) { return; } rulesManager.Options.IsAddButtonVisible = addChkBox.Checked; } private void removeChkBox_CheckedChanged(object sender, EventArgs e) { if (removeChkBox == null) { return; } rulesManager.Options.IsRemoveButtonVisible = removeChkBox.Checked; } private void ruleNameChkBox_CheckedChanged(object sender, EventArgs e) { if (ruleNameChkBox == null) { return; } rulesManager.Options.IsRuleNameVisible = ruleNameChkBox.Checked; } private void rangeSelectorChkBox_CheckedChanged(object sender, EventArgs e) { if (rangeSelectorChkBox == null) { return; } rulesManager.Options.IsRangeSelectorVisible = rangeSelectorChkBox.Checked; } private void conditionChkBox_CheckedChanged(object sender, EventArgs e) { if (conditionChkBox == null) { return; } rulesManager.Options.IsConditionVisible = conditionChkBox.Checked; } private void tabChkBox_CheckedChanged(object sender, EventArgs e) { if (tabChkBox == null) { return; } //Restrict rule that can be created using RulesManager rulesManager.Options.AllowedRules = RuleTypes.Gradient; }

Copy Code

private void headerChkBox_CheckedChanged(object sender, EventArgs e)
{
    if (headerChkBox == null)
    {
        return;
    }
    rulesManager.Options.IsHeaderVisible = headerChkBox.Checked;
}

private void AddChkBox_CheckedChanged(object sender, EventArgs e)
{
    if (addChkBox == null)
    {
        return;
    }
    rulesManager.Options.IsAddButtonVisible = addChkBox.Checked;
}

private void removeChkBox_CheckedChanged(object sender, EventArgs e)
{
    if (removeChkBox == null)
    {
        return;
    }
    rulesManager.Options.IsRemoveButtonVisible = removeChkBox.Checked;
}

private void ruleNameChkBox_CheckedChanged(object sender, EventArgs e)
{
    if (ruleNameChkBox == null)
    {
        return;
    }
    rulesManager.Options.IsRuleNameVisible = ruleNameChkBox.Checked;
}

private void rangeSelectorChkBox_CheckedChanged(object sender, EventArgs e)
{
    if (rangeSelectorChkBox == null)
    {
        return;
    }
    rulesManager.Options.IsRangeSelectorVisible = rangeSelectorChkBox.Checked;
}

private void conditionChkBox_CheckedChanged(object sender, EventArgs e)
{
    if (conditionChkBox == null)
    {
        return;
    }
    rulesManager.Options.IsConditionVisible = conditionChkBox.Checked;
}

private void tabChkBox_CheckedChanged(object sender, EventArgs e)
{
    if (tabChkBox == null)
    {
        return;
    }
    //Restrict rule that can be created using RulesManager
    rulesManager.Options.AllowedRules = RuleTypes.Gradient;
}

Similarly, you can play around with other appearance parameters of the Rules Manager control to change its appearance. For example, you can choose whether the RulesManager control should display tooltips by setting ShowToolTips property of the C1RulesManager class to true.