Class GridRangeInfoList

Implements a collection of GridRangeInfo objects.

Inheritance

System.Object

System.Collections.CollectionBase

GridRangeInfoList

Implements

System.Collections.IList

System.Collections.ICollection

System.Collections.IEnumerable

System.ICloneable

System.IFormattable

System.Runtime.Serialization.ISerializable

Inherited Members

System.Collections.CollectionBase.Capacity

System.Collections.CollectionBase.Clear()

System.Collections.CollectionBase.Count

System.Collections.CollectionBase.GetEnumerator()

System.Collections.CollectionBase.InnerList

System.Collections.CollectionBase.List

System.Collections.CollectionBase.OnClear()

System.Collections.CollectionBase.OnClearComplete()

System.Collections.CollectionBase.OnInsert(System.Int32, System.Object)

System.Collections.CollectionBase.OnInsertComplete(System.Int32, System.Object)

System.Collections.CollectionBase.OnRemove(System.Int32, System.Object)

System.Collections.CollectionBase.OnRemoveComplete(System.Int32, System.Object)

System.Collections.CollectionBase.OnSet(System.Int32, System.Object, System.Object)

System.Collections.CollectionBase.OnSetComplete(System.Int32, System.Object, System.Object)

System.Collections.CollectionBase.OnValidate(System.Object)

System.Collections.CollectionBase.RemoveAt(System.Int32)

System.Collections.CollectionBase.System.Collections.ICollection.CopyTo(System.Array, System.Int32)

System.Collections.CollectionBase.System.Collections.ICollection.IsSynchronized

System.Collections.CollectionBase.System.Collections.ICollection.SyncRoot

System.Collections.CollectionBase.System.Collections.IList.Add(System.Object)

System.Collections.CollectionBase.System.Collections.IList.Contains(System.Object)

System.Collections.CollectionBase.System.Collections.IList.get_Item(System.Int32)

System.Collections.CollectionBase.System.Collections.IList.IndexOf(System.Object)

System.Collections.CollectionBase.System.Collections.IList.Insert(System.Int32, System.Object)

System.Collections.CollectionBase.System.Collections.IList.IsFixedSize

System.Collections.CollectionBase.System.Collections.IList.IsReadOnly

System.Collections.CollectionBase.System.Collections.IList.Item[System.Int32]

System.Collections.CollectionBase.System.Collections.IList.Remove(System.Object)

System.Collections.CollectionBase.System.Collections.IList.set_Item(System.Int32, System.Object)

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ReferenceEquals(System.Object, System.Object)

Namespace: Syncfusion.Windows.Forms.Grid

Assembly: Syncfusion.Grid.Windows.dll

Syntax

public class GridRangeInfoList : CollectionBase, IList, ICollection, IEnumerable, ICloneable, IFormattable, ISerializable

Constructors

GridRangeInfoList()

Initializes a new empty instance ofGridRangeInfoList class.

Declaration

public GridRangeInfoList()

GridRangeInfoList(SerializationInfo, StreamingContext)

Initializes a new GridRangeInfoList from a serialization stream.

Declaration

protected GridRangeInfoList(SerializationInfo info, StreamingContext context)

Parameters

Type	Name	Description
System.Runtime.Serialization.SerializationInfo	info	An object that holds all the data needed to serialize or de-serialize this instance.
System.Runtime.Serialization.StreamingContext	context	Describes the source and destination of the serialized stream specified by info.

Fields

Empty

An empty and Read-only list.

Declaration

public static readonly GridRangeInfoList Empty

Field Value

Type
GridRangeInfoList

Properties

ActiveRange

Gets the last range in the range list.

Declaration

public GridRangeInfo ActiveRange { get; }

Property Value

Type
GridRangeInfo

Info

Gets the results of ToString method.

Declaration

public string Info { get; }

Property Value

Type
System.String

Item[Int32]

Gets or sets the GridRangeInfo at a specific index.

Declaration

public GridRangeInfo this[int index] { get; set; }

Parameters

Type	Name	Description
System.Int32	index

Property Value

Type
GridRangeInfo

Methods

Add(GridRangeInfo)

Adds GridRangeInfo to the end of the GridRangeInfoList.

Declaration

public int Add(GridRangeInfo value)

Parameters

Type	Name	Description
GridRangeInfo	value	The GridRangeInfo to be added to the list.

Returns

Type	Description
System.Int32	The index of the new element.

AddRange(GridRangeInfo[])

Adds GridRangeInfo elements from an array to the range list.

Declaration

public void AddRange(GridRangeInfo[] value)

Parameters

Type	Name	Description
GridRangeInfo[]	value	An array of GridRangeInfo objects.

AnyRangeContains(GridRangeInfo)

Determines if a range in the range list contains the specified range.

Declaration

public bool AnyRangeContains(GridRangeInfo range)

Parameters

Type	Name	Description
GridRangeInfo	range	The range to be searched for.

Returns

Type	Description
System.Boolean	True if any range contains the specified range.

AnyRangeIntersects(GridRangeInfo)

Determines if a range in the range list intersects with the specified range.

Declaration

public bool AnyRangeIntersects(GridRangeInfo range)

Parameters

Type	Name	Description
GridRangeInfo	range	The range to be searched for.

Returns

Type	Description
System.Boolean	True if any range contains the specified range.

Clone()

Makes an exact copy of the current object.

Declaration

public GridRangeInfoList Clone()

Returns

Type	Description
GridRangeInfoList	A GridRangeInfoList with duplicated GridRangeInfo objects.

Contains(GridRangeInfo)

Determines if the range list contains a range object that equals the specified range.

Declaration

public bool Contains(GridRangeInfo value)

Parameters

Type	Name	Description
GridRangeInfo	value	The range to be searched for.

Returns

Type	Description
System.Boolean	True if range was found; False if not found.

CopyTo(GridRangeInfo[], Int32)

Copies all range objects into an array of GridRangeInfo starting at specified index.

Declaration

public void CopyTo(GridRangeInfo[] array, int index)

Parameters

Type	Name	Description
GridRangeInfo[]	array	The array of GridRangeInfo where the values should be copied to.
System.Int32	index	The starting index in the destination array.

CopyTo(GridRangeInfoList, Int32)

Copies all range objects into a GridRangeInfoList starting at specified index.

Declaration

public void CopyTo(GridRangeInfoList rl, int index)

Parameters

Type	Name	Description
GridRangeInfoList	rl	The GridRangeInfoList where the values should be copied to.
System.Int32	index	The starting index in the destination list.

CopyTo(Array, Int32)

Copies all range objects into an array of GridRangeInfo starting at specified index.

Declaration

public void CopyTo(Array array, int index)

Parameters

Type	Name	Description
System.Array	array	The array of GridRangeInfo where the values should be copied to.
System.Int32	index	The starting index in the destination array.

ExpandRanges(Int32, Int32, Int32, Int32)

Creates a range list and convert column and row ranges into cell ranges with the specified bounds.

Declaration

public GridRangeInfoList ExpandRanges(int nFirstRow, int nFirstCol, int nRowCount, int nColCount)

Parameters

Type	Name	Description
System.Int32	nFirstRow	Row index for the first non-label cell in grid area.
System.Int32	nFirstCol	Column index for the first non-label cell in grid area.
System.Int32	nRowCount	Last row in the grid.
System.Int32	nColCount	Last column in the grid

Returns

Type	Description
GridRangeInfoList	The GridRangeInfoList with new GridRangeInfo objects that this method creates.

Remarks

Column ranges will be converted to cell ranges using nFirstRow and nRowCount. Row ranges will be converted to cell ranges using nFirstCol and nColCount. Column ranges will be converted to cell ranges using all input parameters.

FilterRangeType(GridRangeInfoType)

Returns a range list with ranges that match a specified GridRangeInfoType.

Declaration

public GridRangeInfoList FilterRangeType(GridRangeInfoType filter)

Parameters

Type	Name	Description
GridRangeInfoType	filter	The GridRangeInfoType to search for.

Returns

Type	Description
GridRangeInfoList	A GridRangeInfoList with ranges that match the above criteria.

GetColRanges(GridRangeInfoType)

Creates a range list with column ranges that match a specified criteria.

Declaration

public GridRangeInfoList GetColRanges(GridRangeInfoType filter)

Parameters

Type	Name	Description
GridRangeInfoType	filter	The filter criteria.

Returns

Type	Description
GridRangeInfoList	The range list with column ranges.

Remarks

Use

rangeList.GetColRanges(GridRangeInfoType.Cells|GridRangeInfoType.Cols);

if you want to get column ranges for both ranges that are cells or column ranges.

Use

rangeList.GetColRanges(GridRangeInfoType.Cols);

if you only want to get column ranges and not cell ranges.

Neighboring ranges will be combined if they intersect or have the same border (e.g. C4:C5 and C6:C7 will be combined into C4:C7).

GetObjectData(SerializationInfo, StreamingContext)

Implements the ISerializable interface and returns the data needed to serialize the GridRangeInfoList.

Declaration

public virtual void GetObjectData(SerializationInfo info, StreamingContext context)

Parameters

Type	Name	Description
System.Runtime.Serialization.SerializationInfo	info	A SerializationInfo object containing the information required to serialize the object.
System.Runtime.Serialization.StreamingContext	context	A StreamingContext object containing the source and destination of the serialized stream.

GetOuterRange(GridRangeInfo)

Returns a GridRangeInfo that spans over all ranges that intersect with a specified range.

Declaration

public GridRangeInfo GetOuterRange(GridRangeInfo range)

Parameters

Type	Name	Description
GridRangeInfo	range	The range to be searched for.

Returns

Type	Description
GridRangeInfo	A GridRangeInfo that contains the original range and the outer bounds of all ranges that intersect with range.

GetRangesContained(GridRangeInfo)

Searches for ranges in the GridRangeInfoList that are contained in a specified range.

Declaration

public GridRangeInfoList GetRangesContained(GridRangeInfo range)

Parameters

Type	Name	Description
GridRangeInfo	range	The range to be searched for.

Returns

Type	Description
GridRangeInfoList	The GridRangeInfoList with ranges that match the criteria.

GetRangesContaining(GridRangeInfo)

Searches for ranges in the GridRangeInfoList that contain a specified range.

Declaration

public GridRangeInfoList GetRangesContaining(GridRangeInfo range)

Parameters

Type	Name	Description
GridRangeInfo	range	The range to be searched for.

Returns

Type	Description
GridRangeInfoList	The GridRangeInfoList with ranges that match the criteria.

GetRangesIntersecting(GridRangeInfo)

Searches for ranges in the GridRangeInfoList that intersect with a specified range.

Declaration

public GridRangeInfoList GetRangesIntersecting(GridRangeInfo range)

Parameters

Type	Name	Description
GridRangeInfo	range	The range to be searched for.

Returns

Type	Description
GridRangeInfoList	The GridRangeInfoList with ranges that match the criteria.

GetRowRanges(GridRangeInfoType)

Creates a range list with row ranges that match a specified criteria.

Declaration

public GridRangeInfoList GetRowRanges(GridRangeInfoType filter)

Parameters

Type	Name	Description
GridRangeInfoType	filter	The filter criteria.

Returns

Type	Description
GridRangeInfoList	The range list with row ranges.

Remarks

Use

rangeList.GetRowRanges(GridRangeInfoType.Cells|GridRangeInfoType.Rows);

if you want to get row ranges for both ranges that are cells or row ranges.

Use

rangeList.GetRowRanges(GridRangeInfoType.Rows);

if you only want to get row ranges and not cell ranges.

Neighboring ranges will be combined if they intersect or have the same border (e.g. R4:R5 and R6:R7 will be combined into R4:R7).

IndexOf(GridRangeInfo)

Returns the position of a specific range in the list that equals a specified range.

Declaration

public int IndexOf(GridRangeInfo value)

Parameters

Type	Name	Description
GridRangeInfo	value	The range to be searched for.

Returns

Type	Description
System.Int32	The position of the range; - 1 if not found.

Insert(Int32, GridRangeInfo)

Inserts a GridRangeInfo at a specified position.

Declaration

public void Insert(int index, GridRangeInfo value)

Parameters

Type	Name	Description
System.Int32	index	The index where the value should be inserted.
GridRangeInfo	value	The value to be inserted.

InsertCols(Int32, Int32)

Updates the range list when columns have been inserted in the grid.

Declaration

public void InsertCols(int col, int count)

Parameters

Type	Name	Description
System.Int32	col	The column index where columns have been inserted.
System.Int32	count	The number of columns that were inserted.

InsertRows(Int32, Int32)

Updates the range list when rows have been inserted in the grid.

Declaration

public void InsertRows(int row, int count)

Parameters

Type	Name	Description
System.Int32	row	The row index where rows have been inserted.
System.Int32	count	The number of rows that were inserted.

MoveCols(Int32, Int32, Int32, Int32)

Updates the range list when columns were moved in the grid.

Declaration

public void MoveCols(int nFromCol, int nToCol, int nDestCol, int maxcol)

Parameters

Type	Name	Description
System.Int32	nFromCol	The first column index.
System.Int32	nToCol	The last column index.
System.Int32	nDestCol	The destination column index.
System.Int32	maxcol	The new column count in the grid.

MoveRows(Int32, Int32, Int32, Int32)

Updates the range list when rows were moved in the grid.

Declaration

public void MoveRows(int nFromRow, int nToRow, int nDestRow, int maxrow)

Parameters

Type	Name	Description
System.Int32	nFromRow	The first row index.
System.Int32	nToRow	The last row index.
System.Int32	nDestRow	The destination row index.
System.Int32	maxrow	The new row count in the grid.

Parse(String)

Creates a range list from a string with comma separated range descriptions.

Declaration

public static GridRangeInfoList Parse(string parseText)

Parameters

Type	Name	Description
System.String	parseText	The text to be parsed.

Returns

Type	Description
GridRangeInfoList	The GridRangeInfoList with range objects described in the string.

Remarks

The method parses a string that was previously created with ToString().

Remove(GridRangeInfo)

Removes a specific range from the range list.

Declaration

public void Remove(GridRangeInfo value)

Parameters

Type	Name	Description
GridRangeInfo	value	The range to be removed.

RemoveCols(Int32, Int32, Int32)

Updates the range list when columns were removed from the grid.

Declaration

public void RemoveCols(int from, int last, int maxcol)

Parameters

Type	Name	Description
System.Int32	from	The first column index.
System.Int32	last	The last column index.
System.Int32	maxcol	The new column count in the grid.

RemoveEmptyRanges()

Removes any empty ranges from the GridRangeInfoList.

Declaration

public void RemoveEmptyRanges()

RemoveRows(Int32, Int32, Int32)

Updates the range list when rows were removed from the grid.

Declaration

public void RemoveRows(int from, int last, int maxrow)

Parameters

Type	Name	Description
System.Int32	from	The first row index.
System.Int32	last	The last row index.
System.Int32	maxrow	The new row count in the grid.

ToString()

Converts the ranges of this GridRangeInfo to a comma separated human-readable string.

Declaration

public override string ToString()

Returns

Type	Description
System.String	A string that contains the column and row index of the top-left and bottom-right position of this GridRangeInfo.

Overrides

System.Object.ToString()

Remarks

The generate string will be in the format R#C#, R#, C#, T.

An example for a range of cells is "R1C1:R10C20" or "R5C5".

An example for a range of rows is "R1:R10" or "R6".

An example for a range of columns is "C1:C10" or "C7".

An example for a table range is "T".

Each range object will be comma separated. For example: "R3:R5,R8:R10,R14:R15".

ToString(IFormatProvider)

Converts the ranges of this GridRangeInfo to a comma separated human-readable string.

Declaration

public string ToString(IFormatProvider provider)

Parameters

Type	Name	Description
System.IFormatProvider	provider	The System.IFormatProvider to use to format the value. Is ignored.

Returns

Type	Description
System.String	A string that contains the column and row index of the top-left and bottom-right position of this GridRangeInfo.

ToString(String)

Converts the ranges of this GridRangeInfo to a comma separated human-readable string.

Declaration

public string ToString(string format)

Parameters

Type	Name	Description
System.String	format	The string Ignored.

Returns

Type	Description
System.String	A string that contains the column and row index of the top-left and bottom-right position of this GridRangeInfo.

ToString(String, IFormatProvider)

Converts the ranges of this GridRangeInfo to a comma separated human-readable string.

Declaration

public string ToString(string format, IFormatProvider formatProvider)

Parameters

Type	Name	Description
System.String	format	The string Ignored.
System.IFormatProvider	formatProvider	The System.IFormatProvider to use to format the value. Is ignored.

Returns

Type	Description
System.String	A string that contains the column and row index of the top-left and bottom-right position of this GridRangeInfo.

Explicit Interface Implementations

ICloneable.Clone()

Creates a new object that is a copy of the current instance.

Declaration

object ICloneable.Clone()

Returns

Type	Description
System.Object	A new object that is a copy of this instance.

Implements

System.Collections.IList

System.Collections.ICollection

System.Collections.IEnumerable

System.ICloneable

System.IFormattable

System.Runtime.Serialization.ISerializable

Extension Methods

EnumerableExtensions.GetElementType(IEnumerable)

EnumerableExtensions.GetItemPropertyInfo(IEnumerable)

FunctionalExtensions.ForEach<T>(IEnumerable, Action<T>)

FunctionalExtensions.ToList<T>(IEnumerable)

FunctionalExtensions.MoveTo(IList, Int32, Int32)

QueryableExtensions.OfQueryable(IEnumerable)

QueryableExtensions.OfQueryable(IEnumerable, Type)

QueryableExtensions.GroupByMany<TElement>(IEnumerable, Type, List<Func<TElement, Object>>)

QueryableExtensions.GroupByMany(IEnumerable, Type, Func<String, Expression>, String[])

QueryableExtensions.GroupByMany(IEnumerable, Type, List<SortDescriptor>, Dictionary<String, IComparer<Object>>, Func<String, Expression>, String[])

QueryableExtensions.GroupByMany(IEnumerable, Type, List<SortDescriptor>, Func<String, Expression>, String[])