public event EventHandler<PaintBackgroundEventArgs> PaintBackground

Public Event PaintBackground As EventHandler(Of PaintBackgroundEventArgs)

public:
 event EventHandler<PaintBackgroundEventArgs^>^ PaintBackground {
	void add (EventHandler<PaintBackgroundEventArgs^>^ value);
	void remove (EventHandler<PaintBackgroundEventArgs^>^ value);
}

member PaintBackground : IEvent<EventHandler<PaintBackgroundEventArgs>,
    PaintBackgroundEventArgs>

Value

.Net Grid provides broad functionality of displaying various grid elements, such as cells, rows, headers and columns.

There two ways for grid customization:

• Setting specific appearance of the element via Appearance property. For instance, Grid.Appearance, Header.Appearance, Column.Appearance, Row.Appearance, Cell.Appearance. All information about colors, fonts etc. is stored in memory. Therefore setting of this property is more suitable for Grid, Header, Column. A programmer should not use this property on Rows and Cells, as it will consume lot of memory.
• Setting specific parameters in the very moment of painting. For most efficient memory usage, this information is stored in memory for only a short period of time. To implement this feature, a programmer should subscribe to a specific event such as Grid.PaintCell, Grid.PaintRow, Grid.PaintHeader etc.

Generally paint arguments contain the following information:

• Full and clipped sizes of the painted element
• Graphics object
• Colors and parameters used for elemebt painting (they can be altered)
• Methods for painting every single part of an element (for a Cell there are methods for painting background, text, selection, focus etc.)
• Painting filter PaintPart, which allows to skip a certain part of an element (partial painting)
• PaintAll() method that paints all elements defined in the PaintPart filter
• Handled property that forbids a grid to perform default painting

Note that the whole painting process is accumulated in paint arguments object and consists of the following: a grid creates PaintXXXEventArgs object, sets default parameters, fires Grid.PaintXXX event, and if Handled property is set to false, invokes PaintAll() method. This mechanism is used to paint all elements of the .Net Grid cells, rows, columns, headers, hierarchy tree etc.

We have intentionally described the process of painting in details to show broad and rich abilities of grid customization. In other words, you may customize any parameters, some painted elements (cell, column) and even use Graphics object to manipulate the grid. Even better, this approach enables you to define a painting sequence. For example, you may perform some default actions and then finish drawing with the Graphics object, or do it vice versa!

The following example shows how to draw text over Grid

Copy

public void InitializeGrid(Grid grid) { //Add an event handler grid.PaintBackground += delegate(object sender, PaintBackgroundEventArgs e) { //Do default painting e.PaintAll(); e.Handled = true; //Draw a string in middle of row using (Font font = new Font("Arial", 20, FontStyle.Bold | FontStyle.Italic)) using (StringFormat sf = new StringFormat()) { sf.LineAlignment = StringAlignment.Center; sf.Alignment = StringAlignment.Center; e.Graphics.DrawString("Dapfor .Net Grid", font, SystemBrushes.GrayText, grid.ClientRectangle, sf); } }; }