The WinGridCellProxy™ control is exactly what its name suggests – a proxy of a WinGrid™ cell. However, just because it is a proxy, doesn’t mean that it is a copy of a specific cell. The proxy can contain the same data as other cells in WinGrid because it uses the same editor as those cells in WinGrid. In order to have a proxy cell show the same data as a WinGrid cell, you need to provide a data source and data member.
With WinGridCellProxy, providing a data source is very simple. The WinGridCellProxy control can only be used inside a WinGridRowEditTemplate™. Therefore, once you add the proxy to the template’s Controls collection, you are essentially setting its data source. Each WinGridRowEditTemplate is associated with a single Band in WinGrid, setting a Band’s RowEditTemplate property to an instance of an UltraGridRowEditTemplate object will set the template’s data source to that band.
Providing a data member for WinGridCellProxy involves setting the ColumnKey property to a Column’s key from the associated band. Once set to a specific column, WinGridCellProxy will perform whichever role the underlying editor of that column performs, whether it be WinMaskedEdit, WinCombo, WinOptionSet, etc.
The following example code demonstrates how to create an instance of WinGridCellProxy, add it to WinGridRowEditTemplate’s Controls collection, and set the data member through the ColumnKey property.
In Visual Basic:
'Instantiate an UltraGridCellProxy object. Dim ultraGridCellProxy1 As Infragistics.Win.UltraWinGrid.UltraGridCellProxy = _ New Infragistics.Win.UltraWinGrid.UltraGridCellProxy() 'Add the proxy to the template's Controls collection. Me.UltraGridRowEditTemplate1.Controls.Add(ultraGridCellProxy1) 'Provide a data member to the proxy by setting the ColumnKey 'Property to a Column's Key in your data source. ultraGridCellProxy1.ColumnKey = "CompanyName"
In C#:
//Instantiate an UltraGridCellProxy object. Infragistics.Win.UltraWinGrid.UltraGridCellProxy ultraGridCellProxy1 = new Infragistics.Win.UltraWinGrid.UltraGridCellProxy(); //Add the proxy to the template's Controls collection. this.ultraGridRowEditTemplate1.Controls.Add(ultraGridCellProxy1); //Provide a data member to the proxy by setting the ColumnKey //Property to a Column's Key in your data source. ultraGridCellProxy1.ColumnKey = "CompanyName";