Articles in this section
Category / Section

How to improve the performance when working with fonts inside the QueryCellInfo?

2 mins read

 

Description

In WinForms GridControl, specifying the font in the QueryCellInfo is fine in most cases since the font usually does not vary much for cells; but, in extreme cases when each cell gets its font changed in the QueryCellInfo, it is recommended to use the base styles.

 

Some definitions

  1. The GridBaseStyle represents base styles in the grid. A base style has a name and the GridStyleInfo object holds the style information. Cells in the grid can reference a base style by using BaseStyle.
  2. The GridBaseStylesMap holds a collection of base styles for a grid and lets you add, remove, and change base styles.

 

Solution

When the Font property is set in the QueryCellInfo event, the grid internally calls the GridFontInfo.GetGdipFont method that allocates a Font object and caches in the GridFontInfo class.

When base styles are defined, then the GDI font object is allocated only once per base style and all other cells that use these styles do not have to allocate a GDI font object. Instead, they can use the GDI font that is allocated in the base style.

 

The following code example explains the way to initialize and use the base style.

C#

//To add the New BaseStyleMap.
this.gridControl1.BaseStylesMap.CellTypes.Add("ItalicStyle");
this.gridControl1.BaseStylesMap.CellTypes.Add("BoldStyle");
this.gridControl1.BaseStylesMap.CellTypes.Add("StrikeOutStyle");
this.gridControl1.BaseStylesMa.p.CellTypes.Add("UnderlineStyle");
//Setting the Style Properties.
this.gridControl1.BaseStylesMap["ItalicStyle"].StyleInfo.Font.Italic = true;
this.gridControl1.BaseStylesMap["BoldStyle"].StyleInfo.Font.Bold = true;
this.gridControl1.BaseStylesMap["StrikeOutStyle"].StyleInfo.Font.Strikeout = true;
this.gridControl1.BaseStylesMap["UnderlineStyle"].StyleInfo.Font.Underline = true;
//Hook the event in Form_Load to apply the BaseStyle to the cells
this.gridControl1.QueryCellInfo += gridControl1_QueryCellInfo;
 
//Accessing the new base style property in QueryCellInfo event.
private void gridControl1_QueryCellInfo(object sender, Syncfusion.Windows.Forms.Grid.GridQueryCellInfoEventArgs e)
{
    if (e.RowIndex > 0 && e.ColIndex > 0)
    {
         switch (e.ColIndex % 4)
         {
             case 0:
                    e.Style.BaseStyle = "BoldStyle";
             break;
             case 1:
                    e.Style.BaseStyle = "StrikeOutStyle";
             break;
             case 2:
                    e.Style.BaseStyle = "UnderlineStyle";
             break;
             case 3:
                    e.Style.BaseStyle = "ItalicStyle";
             break;
         }
    }
}

 

VB

'To add the New BaseStyleMap.
Me.gridControl1.BaseStylesMap.CellTypes.Add("ItalicStyle")
Me.gridControl1.BaseStylesMap.CellTypes.Add("BoldStyle")
Me.gridControl1.BaseStylesMap.CellTypes.Add("StrikeOutStyle")
Me.gridControl1.BaseStylesMap.CellTypes.Add("UnderlineStyle")
'Setting the Style Properties.
Me.gridControl1.BaseStylesMap("ItalicStyle").StyleInfo.Font.Italic = True
Me.gridControl1.BaseStylesMap("BoldStyle").StyleInfo.Font.Bold = True
Me.gridControl1.BaseStylesMap("StrikeOutStyle").StyleInfo.Font.Strikeout = True
Me.gridControl1.BaseStylesMap("UnderlineStyle").StyleInfo.Font.Underline = True
'Hook the event in Form_Load to apply the BaseStyle to the cells
Me.gridControl1.QueryCellInfo += gridControl1_QueryCellInfo
 
'Accessing the new base style property in QueryCellInfo event.
Private Sub gridControl1_QueryCellInfo(ByVal sender As Object, ByVal e As Syncfusion.Windows.Forms.Grid.GridQueryCellInfoEventArgs)
    If e.RowIndex > 0 AndAlso e.ColIndex > 0 Then
         Select Case e.ColIndex Mod 4
             Case 0
                    e.Style.BaseStyle = "BoldStyle"
             Case 1
                    e.Style.BaseStyle = "StrikeOutStyle"
             Case 2
                    e.Style.BaseStyle = "UnderlineStyle"
             Case 3
                    e.Style.BaseStyle = "ItalicStyle"
         End Select
    End If
End Sub

 

 

Showing different font style in GridControl

Figure 1: GridControl with different font styles

Sample Link:

 

C#: WorkingWithFont

 

VB: WorkingWithFont

 

Conclusion

I hope you enjoyed learning how to improve the performance when working with fonts inside the QueryCellInfo.

 

Refer to our WinForms GridControl’s feature tour page for its other groundbreaking feature representations. You can also explore our WinForms GridControl documentation to understand how to present and manipulate data.

 

For current customers, check out our WinForms components from the License and Downloads page. If you are new to Syncfusion, try our 30-day free trial to check out our WinForms GridControl and other WinForms components.

 

Please let us know in the following comment section if you have any queries or require clarifications. Contact us through our support forums, Direct-Trac, or feedback portal. We are always happy to assist you!

 

 

 

 

Did you find this information helpful?
Yes
No
Help us improve this page
Please provide feedback or comments
Comments (0)
Please sign in to leave a comment
Access denied
Access denied