Style Property (EmptyRowSettings)

Specifies if and how to extend the empty rows all the way to the left so they are aligned with the left edge of the scroll region (grid). The default is ExtendFirstCell.

Syntax

Visual Basic

'Declaration
 
Public Property Style As EmptyRowStyle

C#

public EmptyRowStyle Style {get; set;}

Remarks

Style specifies if and how to extend the empty rows all the way to the left so they are aligned with the left edge of the scroll region (grid). The default is ExtendFirstCell.

Example

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

Visual Basic

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#

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;
		}

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2