Infragistics(R) NetAdvantage(R) Windows Forms
EmptyRowSettings Property
See Also  Example E-mail your feedback on this topic.
Infragistics.Win.UltraWinGrid Namespace > UltraGridLayout Class : EmptyRowSettings Property

This object contains the settings for empty rows.

Syntax

Visual Basic (Declaration) 
Public ReadOnly Property EmptyRowSettings As EmptyRowSettings
C# 
public EmptyRowSettings EmptyRowSettings {get;}

Example

The following code enables the empty rows feature and shows some of the properties related to the feature.

Visual BasicCopy Code
Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid


    Private Sub UltraGrid1_InitializeLayout(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.InitializeLayoutEventArgs) Handles UltraGrid1.InitializeLayout
        ' To enable empty row settings set the ShowEmptyRows property to true.
        e.Layout.EmptyRowSettings.ShowEmptyRows = True

        ' Style property controls how the empty rows look. It controls aspects like
        ' whether the row selectors of empty rows are displayed, whether the empty
        ' rows are extended left to occupy pre row area space and if so how they are
        ' extended etc...
        e.Layout.EmptyRowSettings.Style = EmptyRowStyle.PrefixWithEmptyCell

        ' CellAppearance property of EmptyRowSettings controls the appearance of 
        ' cells of empty rows.
        e.Layout.EmptyRowSettings.CellAppearance.BackColor = Color.LightYellow

        ' RowAppearance property of EmptyRowSettings controls the appearance of 
        ' empty rows.
        e.Layout.EmptyRowSettings.RowAppearance.BackColor = Color.LightYellow

        ' RowSelectorAppearance property of EmptyRowSettings controls the appearance 
        ' of row selectors of empty rows, if the row selectors of empty rows are visible.
        e.Layout.EmptyRowSettings.RowSelectorAppearance.BackColor = Color.Gray

        ' EmptyAreaAppearance property of EmptyRowSettings controls the appearance
        ' of the empty rows area. Empty rows area contains all the empty rows.
        e.Layout.EmptyRowSettings.EmptyAreaAppearance.BackColor = SystemColors.Window

    End Sub
C#Copy Code
using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;


		private void UltraGrid1_InitializeLayout(object sender, Infragistics.Win.UltraWinGrid.InitializeLayoutEventArgs e)
		{
			// To enable empty row settings set the ShowEmptyRows property to true.
			e.Layout.EmptyRowSettings.ShowEmptyRows = true;

			// Style property controls how the empty rows look. It controls aspects like
			// whether the row selectors of empty rows are displayed, whether the empty
			// rows are extended left to occupy pre row area space and if so how they are
			// extended etc...
			e.Layout.EmptyRowSettings.Style = EmptyRowStyle.PrefixWithEmptyCell;

			// CellAppearance property of EmptyRowSettings controls the appearance of 
			// cells of empty rows.
			e.Layout.EmptyRowSettings.CellAppearance.BackColor = Color.LightYellow;

			// RowAppearance property of EmptyRowSettings controls the appearance of 
			// empty rows.
			e.Layout.EmptyRowSettings.RowAppearance.BackColor = Color.LightYellow;

			// RowSelectorAppearance property of EmptyRowSettings controls the appearance 
			// of row selectors of empty rows, if the row selectors of empty rows are visible.
			e.Layout.EmptyRowSettings.RowSelectorAppearance.BackColor = Color.Gray;

			// EmptyAreaAppearance property of EmptyRowSettings controls the appearance
			// of the empty rows area. Empty rows area contains all the empty rows.
			e.Layout.EmptyRowSettings.EmptyAreaAppearance.BackColor = SystemColors.Window;
		}

Remarks

EmptyRowSettings object contains the settings for empty rows.

See Also