Skip to main content
All docs
V25.1
  • TileCustomDrawEventArgs.ShouldDrawBackground Property

    Gets whether the tile should display a background.

    Namespace: DevExpress.XtraEditors

    Assembly: DevExpress.XtraEditors.v25.1.dll

    NuGet Package: DevExpress.Win.Navigation

    Declaration

    public virtual bool ShouldDrawBackground { get; }

    Property Value

    Type Description
    Boolean

    true if the tile should display a background; otherwise, false.

    Remarks

    When the ShouldDrawBackground property returns true, you can draw your custom background or use the e.DrawBackground method to draw the default background.

    The following code snippet demonstrates the default drawing algorithm:

    void tileView1_CustomDrawTile(object sender, TileViewItemCustomDrawEventArgs e) {
        switch (e.DrawingProcess) {
            case TileViewItemCustomDrawProcess.DrawTile:
                if (e.ShouldDrawBackground)
                    e.DrawBackground();
                if (e.ShouldDrawContent)
                    e.DrawContent();
                if (e.ShouldDrawHoveredOverlay)
                    e.DrawHoveredOverlay();
                if (e.ShouldDrawDisabledOverlay)
                    e.DrawDisabledOverlay();
                if (e.ShouldDrawBorder)
                    e.DrawBorder();
                if (e.ShouldDrawCheckMark)
                    e.DrawCheckMark();
                break;
            case TileViewItemCustomDrawProcess.DrawCheckMark:
                e.DefaultDraw();
                break;
            case TileViewItemCustomDrawProcess.DrawSelection:
                e.DefaultDraw();
                break;
        }
        e.Handled = true;
    }
    
    See Also