Use Bitmap or Vector Icons

This document illustrates the difference between bitmap and vector icons, and describes how to switch to using bitmap icons in your WinForms reporting application.

The Document Viewer and Report Designer display vector icons by deafult, which ensures a proper look of an application on high-DPI displays and with different skins applied.

  • A ribbon with the "Office 2016 Light" theme:

    toolbar-icons-report-designer-ribbon-svg

  • A ribbon with the "Office 2016 Dark" theme:

    toolbar-icons-report-designer-ribbon-svg-dark

To make your WinForms application use bitmap icons everywhere in the application GUI, set the static WindowsFormsSettings.AllowDefaultSvgImages property to DefaultBoolean.False.

static void Main() {
    DevExpress.XtraEditors.WindowsFormsSettings.AllowDefaultSvgImages = DevExpress.Utils.DefaultBoolean.False;
    // ...
}

To make specific controls use bitmap icons, use the following properties.

  • Standard Document Preview

    The following images illustrate the standard Document Preview toolbar with default bitmap and vector icons.

    SVG Icons
    toolbar-icons-preview-bars-svg
    Bitmap Icons
    toolbar-icons-preview-bars-bitmap

    The following code makes the standard Document Preview display bitmap icons by disabling the PrintBarManager.AllowDefaultSvgImages property.

    using DevExpress.XtraReports.UI;
    // ...
    
    private void button1_Click(object sender, System.EventArgs e) {
        ReportPrintTool printTool = new ReportPrintTool(new XtraReport1());
        printTool.PreviewForm.PrintBarManager.AllowDefaultSvgImages = DevExpress.Utils.DefaultBoolean.False;
        printTool.ShowPreviewDialog();
    }
    
  • Ribbon Document Preview

    The following images illustrate the ribbon Document Preview toolbar with default bitmap and vector icons.

    SVG Icons
    toolbar-icons-preview-ribbon-svg
    Bitmap Icons
    toolbar-icons-preview-ribbon-bitmap

    The following code makes the ribbon Document Preview display bitmap icons by disabling the PrintRibbonController.AllowDefaultSvgImages property.

    using DevExpress.XtraReports.UI;
    // ...
    
    private void button1_Click(object sender, System.EventArgs e) {
        ReportPrintTool printTool = new ReportPrintTool(new XtraReport1());
        printTool.PreviewRibbonForm.PrintRibbonController.AllowDefaultSvgImages = DevExpress.Utils.DefaultBoolean.False;
        printTool.ShowRibbonPreviewDialog();
    }
    
  • Standard Report Designer

    The following images illustrate a standard Report Designer toolbar with default bitmap and vector icons.

    SVG Icons
    toolbar-icons-report-designer-bars-svg
    Bitmap Icons
    toolbar-icons-report-designer-bars-bitmap

    The following code makes the standard Report Designer display bitmap icons by disabling the XRDesignMdiController.AllowDefaultSvgImages property.

    using DevExpress.XtraReports.UI;
    // ...
    
    private void button1_Click(object sender, System.EventArgs e) {
        ReportDesignTool designTool = new ReportDesignTool(new XtraReport1());
        designTool.DesignForm.DesignMdiController.AllowDefaultSvgImages = DevExpress.Utils.DefaultBoolean.False;
        designTool.ShowDesignerDialog();
    }
    
  • Ribbon Report Designer

    The following images illustrate a ribbon Report Designer toolbar with default bitmap and vector icons.

    SVG Icons
    toolbar-icons-report-designer-ribbon-svg
    Bitmap Icons
    toolbar-icons-report-designer-ribbon-bitmap

    The following code makes the ribbon Report Designer display bitmap icons by disabling the XRDesignMdiController.AllowDefaultSvgImages property.

    using DevExpress.XtraReports.UI;
    // ...
    
    private void button1_Click(object sender, System.EventArgs e) {
        ReportDesignTool designTool = new ReportDesignTool(new XtraReport1());
        designTool.DesignRibbonForm.DesignMdiController.AllowDefaultSvgImages = DevExpress.Utils.DefaultBoolean.False;
        designTool.ShowRibbonDesignerDialog();
    }