IconView Property

Description

Displays or hides Icon View, a view similar to the Icon View in Windows Explorer.

Property Type

Read-write property

Syntax (Visual Basic)

Public Property IconView() As Boolean

Remarks

The grid's Icon View is similar to the icon view in Windows Explorer. The CreateIconViewColumn is used to create a separate icon column that is distinct from the other columns in the grid. This icon column will remain hidden until the IconView property is set to display the icon column. All normal columns are hidden when the icon column is displayed; you need to use the IconView property to display either the icon column or the normal columns; you can't display both at the same time.

You can display text under each icon in the icon column. To do this, you would use the IconViewSetup method to choose from which normal column text will be displayed. The IconViewSetup method is also used to specify which icon from the image manager should be displayed for all items in the icon column. This will use the specified icon for each item in the icon column. You can override the default icon using the BeforeDrawRow event.

Another great feature of using the BeforeDrawRow event is that you can access all records associated with the current icon view item. This proves very useful when in BeforeDrawRow as you can read the record information to update the text/icon for the icon column item or use that information to perform other actions.

The CreateIconViewColumn method is automatically called internally when calling the IconViewSetup method. You only need to call CreateIconViewColumn if you choose not to use the IconViewSetup method.

Example

wndGridControl.ShowGroupBox = False  
wndGridControl.GroupsOrder.DeleteAll  

wndGridControl.CreateIconViewColumn  
wndGridControl.IconViewSetup 3, COLUMN_IMPORTANCE_ICON  
wndGridControl.IconView = True

Private Sub wndGridControl_BeforeDrawRow(ByVal Row As XtremeGridControl.IGridRow, ByVal Item As XtremeGridControl.IGridRecordItem, ByVal Metrics As XtremeGridControl.IGridRecordItemMetrics)  
    If wndGridControl.IconView Then  
        If Not Row.GroupRow Then  
            Metrics.ItemIcon = Row.Record(1).Icon  
        End If  
    End If
End Sub