Het hier geïllustreerde voorbeeld laat zien hoe je een header kunt toevoegen die zich over de kolomheaders van een grid heen legt. Het principe van deze header is dat elk element een eigenschap ColumnSpan bevat waarmee het zich over meerdere kolommen kan uitstrekken. De code moet worden uitgevoerd wanneer het grid zijn kolommen al heeft. Het is op elk moment mogelijk om deze overlappende header te bouwen of te vernieuwen via de methode:
Zodra dit type header aan een grid is gekoppeld, is het voor de gebruiker niet langer mogelijk om de volgorde van kolommen te wijzigen (grid.AllowUserToOrderColumns = false). Scrollen blijft daarentegen wel mogelijk.
De onderstaande code produceert de geïllustreerde visuele weergave.
MercatorUi.GridPro.TopHeaders topHeaders = new MercatorUi.GridPro.TopHeaders(grid)
{
Items = new MercatorUi.GridPro.TopHeader[]
{
new MercatorUi.GridPro.TopHeader { ColumnStart = 0 },
new MercatorUi.GridPro.TopHeader { ColumnStart = 1, ColumnSpan = 2, Text = "Document" },
new MercatorUi.GridPro.TopHeader { ColumnStart = 3, ColumnSpan = 2 },
new MercatorUi.GridPro.TopHeader { ColumnStart = 5, ColumnSpan = 3, Text = "Totaal" },
new MercatorUi.GridPro.TopHeader { ColumnStart = 8 }
}
};
topHeaders.Build();
Merk op dat wanneer de eigenschap Text niet is gedefinieerd, de TopHeader eenvoudigweg een "masker" is. Dit maakt het mogelijk de TopHeaders te benadrukken met een tekst.
De kolommen worden genummerd vanaf nul.