Class GridColumnSpanDescriptorCollection
A collection of GridColumnSpanDescriptor with information about columns that can spread multiple grid rows or columns.
An instance of this collection is returned by the ColumnSpans property of a GridColumnSetDescriptor.
Inheritance
Implements
Inherited Members
Namespace: Syncfusion.Windows.Forms.Grid.Grouping
Assembly: Syncfusion.Grid.Grouping.Windows.dll
Syntax
public class GridColumnSpanDescriptorCollection : IDisposable, IList, ICollection, IEnumerable, IInsideCollectionEditorProperty, ICloneable, ICustomTypeDescriptor
Constructors
GridColumnSpanDescriptorCollection()
Initializes a new instances of the GridColumnSpanDescriptorCollection class.
Declaration
public GridColumnSpanDescriptorCollection()
Fields
Empty
A Read-only and empty collection.
Declaration
public static readonly GridColumnSpanDescriptorCollection Empty
Field Value
| Type |
|---|
| GridColumnSpanDescriptorCollection |
Properties
ColumnSet
Gets the GridColumnSetDescriptor this collection belongs to.
Declaration
public GridColumnSetDescriptor ColumnSet { get; }
Property Value
| Type |
|---|
| GridColumnSetDescriptor |
Count
Gets the number of elements contained in the collection. The property also ensures that the collection is in sync with the underlying table if changes have been made to the table or the TableDescriptor.
Declaration
public int Count { get; }
Property Value
| Type |
|---|
| System.Int32 |
InsideCollectionEditor
Gets or sets a value indicating whether the collection is manipulated inside a collection editor or not.
Declaration
public bool InsideCollectionEditor { get; set; }
Property Value
| Type |
|---|
| System.Boolean |
IsFixedSize
Gets a value indicating whether the collection has fixed size or not.
Declaration
public bool IsFixedSize { get; }
Property Value
| Type |
|---|
| System.Boolean |
IsReadOnly
Gets a value indicating whether the collection is Read-only or not.
Declaration
public bool IsReadOnly { get; }
Property Value
| Type |
|---|
| System.Boolean |
IsSynchronized
Gets a value indicating whether the collection is synchronized or not. Returns False.
Declaration
public bool IsSynchronized { get; }
Property Value
| Type |
|---|
| System.Boolean |
Item[Int32]
Gets or sets the element at the zero-based index.
Declaration
public GridColumnSpanDescriptor this[int index] { get; set; }
Parameters
| Type | Name | Description |
|---|---|---|
| System.Int32 | index |
Property Value
| Type |
|---|
| GridColumnSpanDescriptor |
Item[String]
Gets or sets the element with the specified name.
Declaration
public GridColumnSpanDescriptor this[string name] { get; set; }
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | name |
Property Value
| Type |
|---|
| GridColumnSpanDescriptor |
TableDescriptor
Gets the GridTableDescriptor this collection belongs to.
Declaration
public GridTableDescriptor TableDescriptor { get; }
Property Value
| Type |
|---|
| GridTableDescriptor |
Version
Gets the version number of this collection. The version is increased each time the collection or an element within the collection is modified.
Declaration
public int Version { get; }
Property Value
| Type |
|---|
| System.Int32 |
Methods
Add(GridColumnSpanDescriptor)
Adds an object to the end of the collection.
Declaration
public int Add(GridColumnSpanDescriptor value)
Parameters
| Type | Name | Description |
|---|---|---|
| GridColumnSpanDescriptor | value | The element to be added to the end of the collection. The value must not be a NULL reference (Nothing in Visual Basic). |
Returns
| Type | Description |
|---|---|
| System.Int32 | The zero-based collection index at which the value has been added. |
Add(String)
Adds an object to the end of the collection.
Declaration
public int Add(string name)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | name | The column descriptor name of the element to be added to the end of the collection. The value must not be a NULL reference (Nothing in Visual Basic). |
Returns
| Type | Description |
|---|---|
| System.Int32 | The zero-based collection index at which the value has been added. |
AddRange(GridColumnSpanDescriptor[])
Adds multiple elements at the end of the collection.
Declaration
public void AddRange(GridColumnSpanDescriptor[] columnSpanDescriptors)
Parameters
| Type | Name | Description |
|---|---|---|
| GridColumnSpanDescriptor[] | columnSpanDescriptors | The array with elements that should be added to the end of the collection. The array and its elements cannot be NULL references (Nothing in Visual Basic). |
Clear()
Removes all elements from the collection.
Declaration
public void Clear()
Clone()
Creates a copy of the collection and all its elements.
Declaration
public GridColumnSpanDescriptorCollection Clone()
Returns
| Type | Description |
|---|---|
| GridColumnSpanDescriptorCollection | A copy of the collection and all its elements. |
Contains(GridColumnSpanDescriptor)
Determines a value indicating whether the element belongs to this collection or not.
Declaration
public bool Contains(GridColumnSpanDescriptor value)
Parameters
| Type | Name | Description |
|---|---|---|
| GridColumnSpanDescriptor | value | The Object to locate in the collection. The value can be a NULL reference (Nothing in Visual Basic). |
Returns
| Type | Description |
|---|---|
| System.Boolean | True if item is found in the collection; otherwise, False. |
Contains(String)
Searches for the element with the specified name.
Declaration
public bool Contains(string name)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | name | The name of the element to locate in the collection. |
Returns
| Type | Description |
|---|---|
| System.Boolean | True if item is found in the collection; otherwise, False. |
CopyTo(GridColumnSpanDescriptor[], Int32)
Copies the entire collection to a compatible one-dimensional array, starting at the specified index of the target array.
Declaration
public void CopyTo(GridColumnSpanDescriptor[] array, int index)
Parameters
| Type | Name | Description |
|---|---|---|
| GridColumnSpanDescriptor[] | array | The one-dimensional array that is the destination of the elements copied from the ArrayList. The array must have zero-based indexing. |
| System.Int32 | index | The zero-based index in an array at which copying begins. |
Dispose()
Disposes of the object and collection items.
Declaration
public void Dispose()
Equals(Object)
Overrides and determines a value indicating whether the specified System.Object is equal to the current System.Object or not.
Declaration
public override bool Equals(object obj)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Object | obj | The System.Object to compare with the current System.Object. |
Returns
| Type | Description |
|---|---|
| System.Boolean | true if the specified System.Object is equal to the current System.Object; otherwise, false. |
Overrides
GetEnumerator()
Gets an enumerator for the entire collection.
Declaration
public GridColumnSpanDescriptorCollectionEnumerator GetEnumerator()
Returns
| Type | Description |
|---|---|
| GridColumnSpanDescriptorCollectionEnumerator | An Enumerator for the entire collection. |
Remarks
Enumerators only allow reading of the data in the collection. Enumerators cannot be used to modify the underlying collection.
GetHashCode()
Gets a hash function for a particular type.
Declaration
public override int GetHashCode()
Returns
| Type | Description |
|---|---|
| System.Int32 | A hash code for the current object. |
Overrides
IndexOf(GridColumnSpanDescriptor)
Gets the zero-based index of the occurrence of the element in the collection.
Declaration
public int IndexOf(GridColumnSpanDescriptor value)
Parameters
| Type | Name | Description |
|---|---|---|
| GridColumnSpanDescriptor | value | The element to locate in the collection. The value can be a NULL reference (Nothing in Visual Basic). |
Returns
| Type | Description |
|---|---|
| System.Int32 | The zero-based index of the occurrence of the element within the entire collection, if found; otherwise, -1. |
IndexOf(String)
Searches for the element with the specified name.
Declaration
public int IndexOf(string name)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | name | The name of the element to locate in the collection. |
Returns
| Type | Description |
|---|---|
| System.Int32 | The zero-based index of the occurrence of the element with matching name within the entire collection, if found; otherwise, -1. |
InitializeFrom(GridColumnSpanDescriptorCollection)
Copies settings from another collection and raises Changing and Changed events if differences to the other collection are detected.
Declaration
public void InitializeFrom(GridColumnSpanDescriptorCollection other)
Parameters
| Type | Name | Description |
|---|---|---|
| GridColumnSpanDescriptorCollection | other | The source collection. |
Insert(Int32, GridColumnSpanDescriptor)
Inserts a descriptor element into the collection at the specified index.
Declaration
public void Insert(int index, GridColumnSpanDescriptor value)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Int32 | index | The zero-based index at which the element should be inserted. |
| GridColumnSpanDescriptor | value | The element to insert. The value must not be a NULL reference (Nothing in Visual Basic). |
OnChanged(ListPropertyChangedEventArgs)
Triggered when the Changed event is done.
Declaration
protected virtual void OnChanged(ListPropertyChangedEventArgs e)
Parameters
| Type | Name | Description |
|---|---|---|
| ListPropertyChangedEventArgs | e | A ListPropertyChangedEventArgs contains the event data. |
OnChanging(ListPropertyChangedEventArgs)
Triggered when the Changed event is done.
Declaration
protected virtual void OnChanging(ListPropertyChangedEventArgs e)
Parameters
| Type | Name | Description |
|---|---|---|
| ListPropertyChangedEventArgs | e | A ListPropertyChangedEventArgs contains the event data. |
Remove(GridColumnSpanDescriptor)
Removes the specified descriptor element from the collection.
Declaration
public void Remove(GridColumnSpanDescriptor value)
Parameters
| Type | Name | Description |
|---|---|---|
| GridColumnSpanDescriptor | value | The element to remove from the collection. If the value is NULL or the element is not contained in the collection, the method will do nothing. |
Remove(String)
Removes the specified descriptor element from the collection.
Declaration
public void Remove(string name)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | name | The column descriptor name of the element to remove from the collection. If the name is not found in the collection, the method will do nothing. |
RemoveAt(Int32)
Removes the element at the specified index of the collection.
Declaration
public void RemoveAt(int index)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Int32 | index | The zero-based index of the element to remove. |
ToString()
Overrides and gets the string representation of the current object.
Declaration
public override string ToString()
Returns
| Type | Description |
|---|---|
| System.String | A string that represents the current object. |
Overrides
Events
Changed
Occurs after a property in a nested element or the collection is changed.
Declaration
public event ListPropertyChangedEventHandler Changed
Event Type
| Type |
|---|
| ListPropertyChangedEventHandler |
Changing
Occurs before a property in a nested element or the collection is changed.
Declaration
public event ListPropertyChangedEventHandler Changing
Event Type
| Type |
|---|
| ListPropertyChangedEventHandler |
Explicit Interface Implementations
IInsideCollectionEditorProperty.InitializeFrom(Object)
Initializes the form
Declaration
void IInsideCollectionEditorProperty.InitializeFrom(object other)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Object | other | The object to be initialized. |
ICollection.CopyTo(Array, Int32)
Declaration
void ICollection.CopyTo(Array array, int index)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Array | array | |
| System.Int32 | index |
ICollection.SyncRoot
Declaration
object ICollection.SyncRoot { get; }
Returns
| Type |
|---|
| System.Object |
IEnumerable.GetEnumerator()
Declaration
IEnumerator IEnumerable.GetEnumerator()
Returns
| Type |
|---|
| System.Collections.IEnumerator |
IList.Add(Object)
Declaration
int IList.Add(object value)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Object | value |
Returns
| Type |
|---|
| System.Int32 |
IList.Contains(Object)
Declaration
bool IList.Contains(object value)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Object | value |
Returns
| Type |
|---|
| System.Boolean |
IList.get_Item(Int32)
Declaration
object IList.get_Item(int index)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Int32 | index |
Returns
| Type |
|---|
| System.Object |
IList.IndexOf(Object)
Declaration
int IList.IndexOf(object value)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Object | value |
Returns
| Type |
|---|
| System.Int32 |
IList.Insert(Int32, Object)
Declaration
void IList.Insert(int index, object value)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Int32 | index | |
| System.Object | value |
IList.Item[Int32]
Declaration
object IList.this[] { get; set; }
Parameters
| Type | Name | Description |
|---|---|---|
| System.Int32 | index |
Returns
| Type |
|---|
| System.Object |
IList.Remove(Object)
Declaration
void IList.Remove(object value)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Object | value |
IList.set_Item(Int32, Object)
Declaration
void IList.set_Item(int index, object value)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Int32 | index | |
| System.Object | value |
ICloneable.Clone()
Declaration
object ICloneable.Clone()
Returns
| Type |
|---|
| System.Object |