DataList Class

This control allows you to specify a user control template to display and edit information from a data source similar in nature to the DataList web server control, the sub-form control or continuous forms detail section in a Microsoft Access form, or the DataRepeater control from Visual Basic 6.

Definition

Namespace: EWSoftware.ListControls
Assembly: EWSoftware.ListControls (in EWSoftware.ListControls.dll) Version: 2023.4.9.0
public class DataList : UserControl
Inheritance
Object    MarshalByRefObject    Component    Control    ScrollableControl    ContainerControl    UserControl    DataList

Constructors

DataList Constructor

Properties

AccessibilityObjectGets the AccessibleObject assigned to the control.
(Inherited from Control)
AccessibleDefaultActionDescriptionGets or sets the default action description of the control for use by accessibility client applications.
(Inherited from Control)
AccessibleDescriptionGets or sets the description of the control used by accessibility client applications.
(Inherited from Control)
AccessibleNameGets or sets the name of the control used by accessibility client applications.
(Inherited from Control)
AccessibleRoleGets or sets the accessible role of the control.
(Inherited from Control)
ActiveControlGets or sets the active control on the container control.
(Inherited from ContainerControl)
AddDeleteButtonsVisible This property is used to set or get whether or not the add and delete buttons are displayed
AddRowShortcut This is used to set or get the shortcut key to use for jumping to the "new row" template
AllowAdditions This is used to determine whether or not additions are allowed to be made to the data source
AllowDeletes This is used to determine whether or not deletes are allowed to be made to the data source
AllowDropGets or sets a value indicating whether the control can accept data that the user drags onto it.
(Inherited from Control)
AllowEdits This is used to determine whether or not edits are allowed to be made to the data source
AnchorGets or sets the edges of the container to which a control is bound and determines how a control is resized with its parent.
(Inherited from Control)
AutoScaleDimensionsGets or sets the dimensions that the control was designed to.
(Inherited from ContainerControl)
AutoScaleFactorGets the scaling factor between the current and design-time automatic scaling dimensions.
(Inherited from ContainerControl)
AutoScaleModeGets or sets the automatic scaling mode of the control.
(Inherited from ContainerControl)
AutoScrollMarginGets or sets the size of the auto-scroll margin.
(Inherited from ScrollableControl)
AutoScrollMinSizeGets or sets the minimum size of the auto-scroll.
(Inherited from ScrollableControl)
AutoScrollOffsetGets or sets where this control is scrolled to in ScrollControlIntoView(Control).
(Inherited from Control)
AutoScrollPositionGets or sets the location of the auto-scroll position.
(Inherited from ScrollableControl)
AutoSizeThis property is not relevant for this class.
(Inherited from UserControl)
AutoSizeModeGets or sets how the control will resize itself.
(Inherited from UserControl)
AutoValidateGets or sets how the control performs validation when the user changes focus to another control.
(Inherited from UserControl)
BackColorGets or sets the background color for the control.
(Inherited from Control)
BackgroundImageLayoutGets or sets the background image layout as defined in the ImageLayout enumeration.
(Inherited from Control)
BindingContextGets or sets the BindingContext for the control.
(Inherited from ContainerControl)
BorderStyle This property is used to set or get the border style.
BottomGets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area.
(Inherited from Control)
BoundsGets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control.
(Inherited from Control)
CanEnableImeGets a value indicating whether the ImeMode property can be set to an active value, to enable IME support.
(Inherited from ContainerControl)
CanFocusGets a value indicating whether the control can receive focus.
(Inherited from Control)
CanRaiseEventsDetermines if events can be raised on the control.
(Inherited from Control)
CanSelectGets a value indicating whether the control can be selected.
(Inherited from Control)
CaptionBackColor This property is used to set or get the caption background color
CaptionFont This property is used to set or get the caption font
CaptionForeColor This property is used to set or get the caption foreground color
CaptionText This property is used to set or get the caption text
CaptionVisible This property is used to set or get whether or not the caption is displayed
CaptureGets or sets a value indicating whether the control has captured the mouse.
(Inherited from Control)
CausesValidationGets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus.
(Inherited from Control)
ClientRectangleGets the rectangle that represents the client area of the control.
(Inherited from Control)
ClientSizeGets or sets the height and width of the client area of the control.
(Inherited from Control)
CompanyNameGets the name of the company or creator of the application containing the control.
(Inherited from Control)
ContainerGets the IContainer that contains the Component.
(Inherited from Component)
ContainsFocusGets a value indicating whether the control, or one of its child controls, currently has the input focus.
(Inherited from Control)
ContextMenuStripGets or sets the ContextMenuStrip associated with this control.
(Inherited from Control)
ControlsGets the collection of controls contained within the control.
(Inherited from Control)
CreatedGets a value indicating whether the control has been created.
(Inherited from Control)
CreateParamsGets the required creation parameters when the control handle is created.
(Inherited from UserControl)
CurrentAutoScaleDimensionsGets the current run-time dimensions of the screen.
(Inherited from ContainerControl)
CurrentItem This is used to get a reference to the current item's row template
CurrentRow This read-only property is used to get the zero-based row number of the currently selected row item
CursorGets or sets the cursor that is displayed when the mouse pointer is over the control.
(Inherited from Control)
DataBindingsGets the data bindings for the control.
(Inherited from Control)
DataContextGets or sets the data context for the purpose of data binding. This is an ambient property.
(Inherited from Control)
DataMember This indicates the sub-list (if any) of the DataSource to show in the data list
DataSource This gets or sets the data source for the data list
DefaultCursorGets or sets the default cursor for the control.
(Inherited from Control)
DefaultImeModeGets the default Input Method Editor (IME) mode supported by the control.
(Inherited from Control)
DefaultMarginGets the space, in pixels, that is specified by default between controls.
(Inherited from Control)
DefaultMaximumSizeGets the length and height, in pixels, that is specified as the default maximum size of a control.
(Inherited from Control)
DefaultMinimumSizeGets the length and height, in pixels, that is specified as the default minimum size of a control.
(Inherited from Control)
DefaultPaddingGets the internal spacing, in pixels, of the contents of a control.
(Inherited from Control)
DefaultSizeGets the default size of the control.
(Inherited from UserControl)
DeleteRowShortcut This is used to set or get the shortcut key to use for deleting a row
DesignModeGets a value that indicates whether the Component is currently in design mode.
(Inherited from Component)
DeviceDpiGets the DPI value for the display device where the control is currently being displayed.
(Inherited from Control)
DisplayRectangleGets the rectangle that represents the virtual display area of the control.
(Inherited from ScrollableControl)
DisposingGets a value indicating whether the base Control class is in the process of disposing.
(Inherited from Control)
DockGets or sets which control borders are docked to its parent control and determines how a control is resized with its parent.
(Inherited from Control)
DockPaddingGets the dock padding settings for all edges of the control.
(Inherited from ScrollableControl)
DoubleBufferedGets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker.
(Inherited from Control)
EnabledGets or sets a value indicating whether the control can respond to user interaction.
(Inherited from Control)
EventsGets the list of event handlers that are attached to this Component.
(Inherited from Component)
FocusedGets a value indicating whether the control has input focus.
(Inherited from Control)
FontGets or sets the font of the text displayed by the control.
(Inherited from Control)
FontHeightGets or sets the height of the font of the control.
(Inherited from Control)
FooterControl This is used to get a reference to the current footer template control if one has been specified
FooterTemplate The template control type to use for the footer
ForeColorGets or sets the foreground color of the control.
(Inherited from Control)
HandleGets the window handle that the control is bound to.
(Inherited from Control)
HasChanges This read-only property can be used to see if the data source has been modified
HasChildrenGets a value indicating whether the control contains one or more child controls.
(Inherited from Control)
HeaderControl This is used to get a reference to the current header template control if one has been specified
HeaderTemplate The template control type to use for the header
HeightGets or sets the height of the control.
(Inherited from Control)
HorizontalScrollGets the characteristics associated with the horizontal scroll bar.
(Inherited from ScrollableControl)
HScrollGets or sets a value indicating whether the horizontal scroll bar is visible.
(Inherited from ScrollableControl)
ImeModeGets or sets the Input Method Editor (IME) mode of the control.
(Inherited from Control)
ImeModeBaseGets or sets the IME mode of a control.
(Inherited from Control)
InvokeRequiredGets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on.
(Inherited from Control)
IsAccessibleGets or sets a value indicating whether the control is visible to accessibility applications.
(Inherited from Control)
IsAncestorSiteInDesignModeIndicates if one of the Ancestors of this control is sited and that site in DesignMode. This property is read-only.
(Inherited from Control)
IsBinding This read-only property can be used to see if the data list is in the process of binding to its data source.
IsDisposedGets a value indicating whether the control has been disposed of.
(Inherited from Control)
IsHandleCreatedGets a value indicating whether the control has a handle associated with it.
(Inherited from Control)
IsMirroredGets a value indicating whether the control is mirrored.
(Inherited from Control)
IsUndoing This read-only property can be used to see if changes are being undone
IsValid This property can be used to query the current row template to see if it is valid
ItemString This can be used to get the value of the specified column in the currently selected item
ItemInt32, String This can be used to get the value of the specified column in the specified row of the data list's data source.
LayoutEngineGets a cached instance of the control's layout engine.
(Inherited from Control)
LeftGets or sets the distance, in pixels, between the left edge of the control and the left edge of its container's client area.
(Inherited from Control)
ListManager This returns the CurrencyManager that the data list is currently using to get data from the DataSource/DataMember pair.
LocationGets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container.
(Inherited from Control)
MarginGets or sets the space between controls.
(Inherited from Control)
MaximumSizeGets or sets the size that is the upper limit that GetPreferredSize(Size) can specify.
(Inherited from Control)
MinimumSizeGets or sets the size that is the lower limit that GetPreferredSize(Size) can specify.
(Inherited from Control)
NameGets or sets the name of the control.
(Inherited from Control)
NavigationControlsVisible This property is used to set or get whether or not the navigation controls are displayed
PaddingGets or sets padding within the control.
(Inherited from Control)
ParentGets or sets the parent container of the control.
(Inherited from Control)
ParentFormGets the form that the container control is assigned to.
(Inherited from ContainerControl)
PreferredSizeGets the size of a rectangular area into which the control can fit.
(Inherited from Control)
ProductNameGets the product name of the assembly containing the control.
(Inherited from Control)
ProductVersionGets the version of the assembly containing the control.
(Inherited from Control)
RecreatingHandleGets a value indicating whether the control is currently re-creating its handle.
(Inherited from Control)
RegionGets or sets the window region associated with the control.
(Inherited from Control)
RenderRightToLeftThis property is now obsolete.
(Inherited from Control)
Obsolete.
RepeatInterval This property is used to set or get the repeat delay in milliseconds for the Next and Previous buttons when they are clicked and held down to navigate through the data source.
RepeatWait This property is used to set or get the initial wait in milliseconds before the Next and Previous buttons auto-repeat when clicked and held to navigate through the data source.
ResizeRedrawGets or sets a value indicating whether the control redraws itself when resized.
(Inherited from Control)
RightGets the distance, in pixels, between the right edge of the control and the left edge of its container's client area.
(Inherited from Control)
RightToLeftGets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts.
(Inherited from Control)
RowCount This read-only property can be used to get the current row count from the data source
RowHeaderBackColor This property is used to set or get the row header's background color
RowHeaderForeColor This property is used to set or get the row header's foreground color
RowHeadersFlat This property is used to set or get whether to draw the row headers using a flat style
RowHeadersVisible This property is used to set or get whether or not row headers are displayed in front of each row
RowHeaderWidth This property is used to set or get the width of the row headers when the RowHeadersVisible property is true.
RowHeight This read-only property can be used to get the row height including the separator.
RowNumberNavShortcut This is used to set or get the shortcut key to use for jumping to the row number navigation text box
RowTemplate The template control type to use for rows in the data source
ScaleChildrenGets a value that determines the scaling of child controls.
(Inherited from Control)
SelectionBackColor This property is used to set or get the background color for selected row headers
SelectionEnd This property is used to set or get the zero-based ending row number of the currently selected range of rows.
SelectionForeColor This property is used to set or get the foreground color for selected row headers
SelectionStart This property is used to set or get the zero-based starting row number of the currently selected range of rows.
SeparatorColor This property is used to set or get the color of the separators when the SeparatorsVisible property is true.
SeparatorHeight This property is used to set or get the height of the separators when the SeparatorsVisible property is true.
SeparatorsVisible This property is used to set or get whether or not separators are displayed between rows
SharedDataSources This can be used to store data sources that are shared amongst all instances of the row, header, and footer templates.
ShowFocusCuesGets a value indicating whether the control should display focus rectangles.
(Inherited from Control)
ShowKeyboardCuesGets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators.
(Inherited from Control)
SiteGets or sets the site of the control.
(Inherited from Control)
SizeGets or sets the height and width of the control.
(Inherited from Control)
SwitchSectionShortcut This is used to set or get the shortcut key to use for jumping between the header, detail, and footer sections of the control.
TabIndexGets or sets the tab order of the control within its container.
(Inherited from Control)
TabStopGets or sets a value indicating whether the user can give the focus to this control using the TAB key.
(Inherited from Control)
TagGets or sets the object that contains data about the control.
(Inherited from Control)
TextGets or sets the text associated with this control.
(Inherited from UserControl)
TopGets or sets the distance, in pixels, between the top edge of the control and the top edge of its container's client area.
(Inherited from Control)
TopLevelControlGets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in.
(Inherited from Control)
UseWaitCursorGets or sets a value indicating whether to use the wait cursor for the current control and all child controls.
(Inherited from Control)
VerticalScrollGets the characteristics associated with the vertical scroll bar.
(Inherited from ScrollableControl)
VisibleGets or sets a value indicating whether the control and all its child controls are displayed.
(Inherited from Control)
VScrollGets or sets a value indicating whether the vertical scroll bar is visible.
(Inherited from ScrollableControl)
WidthGets or sets the width of the control.
(Inherited from Control)
WindowTargetThis property is not relevant for this class.
(Inherited from Control)

Methods

AccessibilityNotifyClients(AccessibleEvents, Int32)Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control.
(Inherited from Control)
AccessibilityNotifyClients(AccessibleEvents, Int32, Int32)Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control .
(Inherited from Control)
AdjustFormScrollbarsAdjusts the scroll bars on the container based on the current control positions and the control currently selected.
(Inherited from ContainerControl)
BeginInvoke(Action)Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on.
(Inherited from Control)
BeginInvoke(Delegate)Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on.
(Inherited from Control)
BeginInvoke(Delegate, Object)Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on.
(Inherited from Control)
BringToFrontBrings the control to the front of the z-order.
(Inherited from Control)
CancelChanges This is used to manually cancel pending changes to the current row in the data source
CommitChanges This is used to manually commit pending changes to the current row in the data source
ContainsRetrieves a value indicating whether the specified control is a child of the control.
(Inherited from Control)
CreateAccessibilityInstanceCreates a new accessibility object for the control.
(Inherited from Control)
CreateControlForces the creation of the visible control, including the creation of the handle and any visible child controls.
(Inherited from Control)
CreateControlsInstanceCreates a new instance of the control collection for the control.
(Inherited from Control)
CreateGraphicsCreates the Graphics for the control.
(Inherited from Control)
CreateHandleCreates a handle for the control.
(Inherited from Control)
DefWndProcSends the specified message to the default window procedure.
(Inherited from Control)
DeleteRow This can be used as an alternative to the Delete button to delete a row from the list
DestroyHandleDestroys the handle associated with the control.
(Inherited from Control)
DisposeReleases all resources used by the Component.
(Inherited from Component)
Dispose(Boolean) Clean up any resources being used
(Overrides ContainerControlDispose(Boolean))
DoDragDrop(Object, DragDropEffects)Begins a drag-and-drop operation.
(Inherited from Control)
DoDragDrop(Object, DragDropEffects, Bitmap, Point, Boolean)Begins a drag operation.
(Inherited from Control)
DrawToBitmapSupports rendering to the specified bitmap.
(Inherited from Control)
EndInvokeRetrieves the return value of the asynchronous operation represented by the IAsyncResult passed.
(Inherited from Control)
EnsureVisible This is used to ensure that the specified row is visible in the data list
EqualsDetermines whether the specified object is equal to the current object.
(Inherited from Object)
FinalizeReleases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection.
(Inherited from Component)
Find Find an item value in the specified member of the data source
FindFormRetrieves the form that the control is on.
(Inherited from Control)
FindString(String, String) Finds the first item whose given member starts with the given string. The search is not case-sensitive.
FindString(String, String, Int32) Finds the first item after the given index whose given data member starts with the given string. The search is not case-sensitive.
FindString(String, String, Int32, Boolean, Boolean) Finds the first item after the given index whose given data member matches the given string. Partial matches and case-sensitivity are optional.
FindStringExact(String, String) Finds the first item whose given member matches the specified string. The search is not case-sensitive.
FindStringExact(String, String, Int32) Finds the first item after the given index whose given data member matches the given string. The search is not case-sensitive.
FocusSets input focus to the control.
(Inherited from Control)
GetAccessibilityObjectByIdRetrieves the specified AccessibleObject.
(Inherited from Control)
GetAutoSizeModeRetrieves a value indicating how a control will behave when its AutoSize property is enabled.
(Inherited from Control)
GetChildAtPoint(Point)Retrieves the child control that is located at the specified coordinates.
(Inherited from Control)
GetChildAtPoint(Point, GetChildAtPointSkip)Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type.
(Inherited from Control)
GetContainerControlReturns the next ContainerControl up the control's chain of parent controls.
(Inherited from Control)
GetHashCodeServes as the default hash function.
(Inherited from Object)
GetLifetimeServiceRetrieves the current lifetime service object that controls the lifetime policy for this instance.
(Inherited from MarshalByRefObject)
Obsolete.
GetNextControlRetrieves the next control forward or back in the tab order of child controls.
(Inherited from Control)
GetPreferredSizeRetrieves the size of a rectangular area into which a control can be fitted.
(Inherited from Control)
GetScaledBoundsRetrieves the bounds within which the control is scaled.
(Inherited from Control)
GetScrollStateDetermines whether the specified flag has been set.
(Inherited from ScrollableControl)
GetServiceReturns an object that represents a service provided by the Component or by its Container.
(Inherited from Component)
GetStyleRetrieves the value of the specified control style bit for the control.
(Inherited from Control)
GetTopLevelDetermines if the control is a top-level control.
(Inherited from Control)
GetTypeGets the Type of the current instance.
(Inherited from Object)
HideConceals the control from the user.
(Inherited from Control)
HitTest Test a point within the data list control to see within which part it falls
InitializeLifetimeServiceObtains a lifetime service object to control the lifetime policy for this instance.
(Inherited from MarshalByRefObject)
Obsolete.
InitLayoutCalled after the control has been added to another container.
(Inherited from Control)
InvalidateInvalidates the entire surface of the control and causes the control to be redrawn.
(Inherited from Control)
Invalidate(Boolean)Invalidates a specific region of the control and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.
(Inherited from Control)
Invalidate(Rectangle)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control.
(Inherited from Control)
Invalidate(Region)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control.
(Inherited from Control)
Invalidate(Rectangle, Boolean)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.
(Inherited from Control)
Invalidate(Region, Boolean)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.
(Inherited from Control)
Invoke(Action)Executes the specified delegate on the thread that owns the control's underlying window handle.
(Inherited from Control)
Invoke(Delegate)Executes the specified delegate on the thread that owns the control's underlying window handle.
(Inherited from Control)
Invoke(Delegate, Object)Executes the specified delegate, on the thread that owns the control's underlying window handle, with the specified list of arguments.
(Inherited from Control)
InvokeT(FuncT)Executes the specified delegate on the thread that owns the control's underlying window handle.
(Inherited from Control)
InvokeGotFocusRaises the GotFocus event for the specified control.
(Inherited from Control)
InvokeLostFocusRaises the LostFocus event for the specified control.
(Inherited from Control)
InvokeOnClickRaises the Click event for the specified control.
(Inherited from Control)
InvokePaintRaises the Paint event for the specified control.
(Inherited from Control)
InvokePaintBackgroundRaises the PaintBackground event for the specified control.
(Inherited from Control)
IsInputCharDetermines if a character is an input character that the control recognizes.
(Inherited from Control)
IsInputKeyDetermines whether the specified key is a regular input key or a special key that requires preprocessing.
(Inherited from Control)
LogicalToDeviceUnits(Int32)Converts a Logical DPI value to its equivalent DeviceUnit DPI value.
(Inherited from Control)
LogicalToDeviceUnits(Size)Transforms a size from logical to device units by scaling it for the current DPI and rounding down to the nearest integer value for width and height.
(Inherited from Control)
MemberwiseCloneCreates a shallow copy of the current Object.
(Inherited from Object)
MemberwiseClone(Boolean)Creates a shallow copy of the current MarshalByRefObject object.
(Inherited from MarshalByRefObject)
MoveTo(Int32) This method is used to move the focus to the specified row in the data source
MoveTo(RowPosition) This method is used to move the focus to the specified fixed row position in the data source
NotifyInvalidateRaises the Invalidated event with a specified region of the control to invalidate.
(Inherited from Control)
OnAddDeleteButtonsVisibleChanged This raises the AddDeleteButtonsVisibleChanged event
OnAddedRow This raises the AddedRow event
OnAddingRow This raises the AddingRow event
OnAutoSizeChangedRaises the AutoSizeChanged event.
(Inherited from Control)
OnAutoValidateChangedRaises the AutoValidateChanged event.
(Inherited from ContainerControl)
OnBackColorChangedRaises the BackColorChanged event.
(Inherited from Control)
OnBackgroundImageChangedRaises the BackgroundImageChanged event.
(Inherited from Control)
OnBackgroundImageLayoutChangedRaises the BackgroundImageLayoutChanged event.
(Inherited from Control)
OnBeginDrag This raises the BeginDrag event
OnBindingContextChanged This is overridden to refresh the data source when the binding context changes
(Overrides ControlOnBindingContextChanged(EventArgs))
OnCanceledEdits This raises the CanceledEdits event
OnCancelingEdits This raises the CancelingEdits event
OnCausesValidationChangedRaises the CausesValidationChanged event.
(Inherited from Control)
OnChangePolicyModified This raises the ChangePolicyModified event for the control and calls the TemplateControl.ChangePolicyModified method in all initialized rows in the control including any header and footer templates.
OnChangeUICuesRaises the ChangeUICues event.
(Inherited from Control)
OnClickRaises the Click event.
(Inherited from Control)
OnClientSizeChangedRaises the ClientSizeChanged event.
(Inherited from Control)
OnContextMenuStripChangedRaises the ContextMenuStripChanged event.
(Inherited from Control)
OnControlAddedRaises the ControlAdded event.
(Inherited from Control)
OnControlRemovedRaises the ControlRemoved event.
(Inherited from Control)
OnCreateControlRaises the CreateControl event.
(Inherited from UserControl)
OnCurrent This raises the Current event
OnCursorChangedRaises the CursorChanged event.
(Inherited from Control)
OnDataContextChanged
(Inherited from Control)
OnDataSourceChanged This raises the DataSourceChanged event
OnDeletedRow This raises the DeletedRow event
OnDeletingRow This raises the DeletingRow event
OnDockChangedRaises the DockChanged event.
(Inherited from Control)
OnDoubleClickRaises the DoubleClick event.
(Inherited from Control)
OnDpiChangedAfterParentRaises the DpiChangedAfterParent event.
(Inherited from Control)
OnDpiChangedBeforeParentRaises the DpiChangedBeforeParent event.
(Inherited from Control)
OnDragDropRaises the DragDrop event.
(Inherited from Control)
OnDragEnterRaises the DragEnter event.
(Inherited from Control)
OnDragLeaveRaises the DragLeave event.
(Inherited from Control)
OnDragOver This is overridden to scroll the data list as needed during drag and drop operations
(Overrides ControlOnDragOver(DragEventArgs))
OnEnabledChangedRaises the EnabledChanged event.
(Inherited from Control)
OnEnterRaises the Enter event.
(Inherited from Control)
OnFontChangedRaises the FontChanged event.
(Inherited from ContainerControl)
OnFooterDataBound This raises the FooterDataBound event
OnForeColorChangedRaises the ForeColorChanged event.
(Inherited from Control)
OnGiveFeedbackRaises the GiveFeedback event.
(Inherited from Control)
OnGotFocusRaises the GotFocus event.
(Inherited from Control)
OnHandleCreatedRaises the HandleCreated event.
(Inherited from Control)
OnHandleDestroyedRaises the HandleDestroyed event.
(Inherited from Control)
OnHeaderDataBound This raises the HeaderDataBound event
OnHelpRequestedRaises the HelpRequested event.
(Inherited from Control)
OnImeModeChangedRaises the ImeModeChanged event.
(Inherited from Control)
OnInvalidatedRaises the Invalidated event.
(Inherited from Control)
OnItemDataBound This raises the ItemDataBound event
OnKeyDownRaises the KeyDown event.
(Inherited from Control)
OnKeyPressRaises the KeyPress event.
(Inherited from Control)
OnKeyUpRaises the KeyUp event.
(Inherited from Control)
OnLayout This is used to reposition the controls when the control attributes change
(Overrides ContainerControlOnLayout(LayoutEventArgs))
OnLeaveRaises the Leave event.
(Inherited from Control)
OnLoadRaises the Load event.
(Inherited from UserControl)
OnLocationChangedRaises the LocationChanged event.
(Inherited from Control)
OnLostFocusRaises the LostFocus event.
(Inherited from Control)
OnMarginChangedRaises the MarginChanged event.
(Inherited from Control)
OnMouseCaptureChangedRaises the MouseCaptureChanged event.
(Inherited from Control)
OnMouseClickRaises the MouseClick event.
(Inherited from Control)
OnMouseDoubleClickRaises the MouseDoubleClick event.
(Inherited from Control)
OnMouseDown This is overridden to handle selecting rows by clicking and/or dragging the mouse on the row headers
(Overrides UserControlOnMouseDown(MouseEventArgs))
OnMouseEnterRaises the MouseEnter event.
(Inherited from Control)
OnMouseHoverRaises the MouseHover event.
(Inherited from Control)
OnMouseLeaveRaises the MouseLeave event.
(Inherited from Control)
OnMouseMove This is overridden to handle selecting rows by dragging the mouse on the row headers
(Overrides ControlOnMouseMove(MouseEventArgs))
OnMouseUp This is overridden to handle selecting rows by clicking and/or dragging the mouse on the row headers
(Overrides ControlOnMouseUp(MouseEventArgs))
OnMouseWheelRaises the MouseWheel event.
(Inherited from ScrollableControl)
OnMove
(Inherited from ContainerControl)
OnNavigationControlsVisibleChanged This raises the NavigationControlsVisibleChanged event
OnNoRows This raises the NoRows event
OnNotifyMessageNotifies the control of Windows messages.
(Inherited from Control)
OnPaddingChangedRaises the PaddingChanged event.
(Inherited from ScrollableControl)
OnPaint This is overridden to draw row headers, a separator between the row panel and the header and footer/navigation button section, and to bind the rows as they scroll into view.
(Overrides ControlOnPaint(PaintEventArgs))
OnPaintBackground This is overridden to ignore the row header area to help prevent flickering
(Overrides ScrollableControlOnPaintBackground(PaintEventArgs))
OnParentBackColorChangedRaises the BackColorChanged event when the BackColor property value of the control's container changes.
(Inherited from Control)
OnParentBackgroundImageChangedRaises the BackgroundImageChanged event when the BackgroundImage property value of the control's container changes.
(Inherited from Control)
OnParentBindingContextChangedRaises the BindingContextChanged event when the BindingContext property value of the control's container changes.
(Inherited from Control)
OnParentChangedRaises the ParentChanged event.
(Inherited from ContainerControl)
OnParentCursorChangedRaises the CursorChanged event.
(Inherited from Control)
OnParentDataContextChanged
(Inherited from Control)
OnParentEnabledChangedRaises the EnabledChanged event when the Enabled property value of the control's container changes.
(Inherited from Control)
OnParentFontChangedRaises the FontChanged event when the Font property value of the control's container changes.
(Inherited from Control)
OnParentForeColorChangedRaises the ForeColorChanged event when the ForeColor property value of the control's container changes.
(Inherited from Control)
OnParentRightToLeftChangedRaises the RightToLeftChanged event when the RightToLeft property value of the control's container changes.
(Inherited from Control)
OnParentVisibleChangedRaises the VisibleChanged event when the Visible property value of the control's container changes.
(Inherited from Control)
OnPreviewKeyDownRaises the PreviewKeyDown event.
(Inherited from Control)
OnPrintRaises the Paint event.
(Inherited from Control)
OnQueryContinueDragRaises the QueryContinueDrag event.
(Inherited from Control)
OnRegionChangedRaises the RegionChanged event.
(Inherited from Control)
OnRepeatIntervalChanged This raises the RepeatIntervalChanged event
OnRepeatWaitChanged This raises the RepeatWaitChanged event
OnResizeRaises the Resize event.
(Inherited from UserControl)
OnRightToLeftChangedRaises the RightToLeftChanged event.
(Inherited from ScrollableControl)
OnRowHeaderBackColorChanged This raises the RowHeaderBackColorChanged event
OnRowHeaderForeColorChanged This raises the RowHeaderForeColorChanged event
OnRowHeadersFlatChanged This raises the RowHeadersFlatChanged event
OnRowHeadersVisibleChanged This raises the RowHeadersVisibleChanged event
OnRowHeaderWidthChanged This raises the RowHeaderWidthChanged event
OnScrollRaises the Scroll event.
(Inherited from ScrollableControl)
OnSelectionBackColorChanged This raises the SelectionBackColorChanged event
OnSelectionForeColorChanged This raises the SelectionForeColorChanged event
OnSeparatorColorChanged This raises the SeparatorColorChanged event
OnSeparatorHeightChanged This raises the SeparatorHeightChanged event
OnSeparatorsVisibleChanged This raises the SeparatorsVisibleChanged event
OnSizeChanged This is overridden to initialize and bind any newly visible rows after the size changes
(Overrides ControlOnSizeChanged(EventArgs))
OnStyleChangedRaises the StyleChanged event.
(Inherited from Control)
OnSystemColorsChangedRaises the SystemColorsChanged event.
(Inherited from Control)
OnTabIndexChangedRaises the TabIndexChanged event.
(Inherited from Control)
OnTabStopChangedRaises the TabStopChanged event.
(Inherited from Control)
OnTextChangedRaises the TextChanged event.
(Inherited from Control)
OnValidatedRaises the Validated event.
(Inherited from Control)
OnValidating This is overridden to provide validation support
(Overrides ControlOnValidating(CancelEventArgs))
OnVisibleChangedRaises the VisibleChanged event.
(Inherited from ScrollableControl)
PerformAutoScalePerforms scaling of the container control and its children.
(Inherited from ContainerControl)
PerformLayoutForces the control to apply layout logic to all its child controls.
(Inherited from Control)
PerformLayout(Control, String)Forces the control to apply layout logic to all its child controls.
(Inherited from Control)
PointToClientComputes the location of the specified screen point into client coordinates.
(Inherited from Control)
PointToScreenComputes the location of the specified client point into screen coordinates.
(Inherited from Control)
PreProcessControlMessagePreprocesses keyboard or input messages within the message loop before they are dispatched.
(Inherited from Control)
PreProcessMessagePreprocesses keyboard or input messages within the message loop before they are dispatched.
(Inherited from Control)
ProcessCmdKey This is overridden to handle the various extra keys recognized by this control
(Overrides ContainerControlProcessCmdKey(Message, Keys))
ProcessDialogCharProcesses a dialog character.
(Inherited from ContainerControl)
ProcessDialogKeyProcesses a dialog key.
(Inherited from ContainerControl)
ProcessKeyEventArgsProcesses a key message and generates the appropriate control events.
(Inherited from Control)
ProcessKeyMessageProcesses a keyboard message.
(Inherited from Control)
ProcessKeyPreviewPreviews a keyboard message.
(Inherited from Control)
ProcessMnemonic This is overridden so that the current row gets a chance to process the mnemonic first
(Overrides ContainerControlProcessMnemonic(Char))
ProcessTabKeySelects the next available control and makes it the active control.
(Inherited from ContainerControl)
RaiseDragEventRaises the appropriate drag event.
(Inherited from Control)
RaiseKeyEventRaises the appropriate key event.
(Inherited from Control)
RaiseMouseEventRaises the appropriate mouse event.
(Inherited from Control)
RaisePaintEventRaises the appropriate paint event.
(Inherited from Control)
RecreateHandleForces the re-creation of the handle for the control.
(Inherited from Control)
RectangleToClientComputes the size and location of the specified screen rectangle in client coordinates.
(Inherited from Control)
RectangleToScreenComputes the size and location of the specified client rectangle in screen coordinates.
(Inherited from Control)
RefreshForces the control to invalidate its client area and immediately redraw itself and any child controls.
(Inherited from Control)
RescaleConstantsForDpi
(Inherited from ContainerControl)
ResetBackColorResets the BackColor property to its default value.
(Inherited from Control)
ResetBindingsCauses a control bound to the BindingSource to reread all the items in the list and refresh their displayed values.
(Inherited from Control)
ResetCursorResets the Cursor property to its default value.
(Inherited from Control)
ResetFontResets the Font property to its default value.
(Inherited from Control)
ResetForeColorResets the ForeColor property to its default value.
(Inherited from Control)
ResetImeModeResets the ImeMode property to its default value.
(Inherited from Control)
ResetMouseEventArgsResets the control to handle the MouseLeave event.
(Inherited from Control)
ResetRightToLeftResets the RightToLeft property to its default value.
(Inherited from Control)
ResetTextResets the Text property to its default value (Empty).
(Inherited from Control)
ResumeLayoutResumes usual layout logic.
(Inherited from Control)
ResumeLayout(Boolean)Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests.
(Inherited from Control)
RtlTranslateAlignment(ContentAlignment)Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text.
(Inherited from Control)
RtlTranslateAlignment(HorizontalAlignment)Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text.
(Inherited from Control)
RtlTranslateAlignment(LeftRightAlignment)Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text.
(Inherited from Control)
RtlTranslateContentConverts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text.
(Inherited from Control)
RtlTranslateHorizontalConverts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text.
(Inherited from Control)
RtlTranslateLeftRightConverts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text.
(Inherited from Control)
Scale(Single)Scales the control and any child controls.
(Inherited from Control)
Obsolete.
Scale(SizeF)Scales the control and all child controls by the specified scaling factor.
(Inherited from Control)
Scale(Single, Single)Scales the entire control and any child controls.
(Inherited from Control)
Obsolete.
ScaleBitmapLogicalToDeviceScales a logical bitmap value to it's equivalent device unit value when a DPI change occurs.
(Inherited from Control)
ScaleControlScales a control's location, size, padding and margin.
(Inherited from ScrollableControl)
ScaleCoreThis method is not relevant for this class.
(Inherited from ScrollableControl)
ScaleMinMaxSizeScales the size of the container's Min and Max properties with the scale factor provided.
(Inherited from ContainerControl)
ScrollControlIntoViewScrolls the specified child control into view on an auto-scroll enabled control.
(Inherited from ScrollableControl)
ScrollToControlCalculates the scroll offset to the specified child control.
(Inherited from ScrollableControl)
SelectActivates the control.
(Inherited from Control)
Select(Boolean, Boolean) This is overridden to ensure that the current row regains the focus when tabbing into the control
(Overrides ContainerControlSelect(Boolean, Boolean))
Select(Int32, Int32, Int32) This is used to set the selected range of rows
SelectNextControlActivates the next control.
(Inherited from Control)
SendToBackSends the control to the back of the z-order.
(Inherited from Control)
SetAutoScrollMarginSets the size of the auto-scroll margins.
(Inherited from ScrollableControl)
SetAutoSizeModeSets a value indicating how a control will behave when its AutoSize property is enabled.
(Inherited from Control)
SetBounds(Int32, Int32, Int32, Int32)Sets the bounds of the control to the specified location and size.
(Inherited from Control)
SetBounds(Int32, Int32, Int32, Int32, BoundsSpecified)Sets the specified bounds of the control to the specified location and size.
(Inherited from Control)
SetBoundsCorePerforms the work of setting the specified bounds of this control.
(Inherited from Control)
SetClientSizeCoreSets the size of the client area of the control.
(Inherited from Control)
SetDataBinding(Object, String, Type) Calling this method is the equivalent of setting the DataSource, DataMember, and RowTemplate properties individually.
SetDataBinding(Object, String, Type, Type, Type) Calling this method is the equivalent of setting the DataSource, DataMember, RowTemplate, HeaderTemplate, and FooterTemplate properties individually.
SetDisplayRectLocationPositions the display window to the specified value.
(Inherited from ScrollableControl)
SetScrollStateSets the specified scroll state flag.
(Inherited from ScrollableControl)
SetStyleSets a specified ControlStyles flag to either or .
(Inherited from Control)
SetTopLevelSets the control as the top-level control.
(Inherited from Control)
SetVisibleCoreSets the control to the specified visible state.
(Inherited from Control)
ShowDisplays the control to the user.
(Inherited from Control)
SizeFromClientSizeDetermines the size of the entire control from the height and width of its client area.
(Inherited from Control)
SuspendLayoutTemporarily suspends the layout logic for the control.
(Inherited from Control)
ToStringReturns a String containing the name of the Component, if any. This method should not be overridden.
(Inherited from Component)
UpdateCauses the control to redraw the invalidated regions within its client area.
(Inherited from Control)
UpdateBoundsUpdates the bounds of the control with the current size and location.
(Inherited from Control)
UpdateBounds(Int32, Int32, Int32, Int32)Updates the bounds of the control with the specified size and location.
(Inherited from Control)
UpdateBounds(Int32, Int32, Int32, Int32, Int32, Int32)Updates the bounds of the control with the specified size, location, and client size.
(Inherited from Control)
UpdateDefaultButtonWhen overridden by a derived class, updates which button is the default button.
(Inherited from ContainerControl)
UpdateStylesForces the assigned styles to be reapplied to the control.
(Inherited from Control)
UpdateZOrderUpdates the control in its parent's z-order.
(Inherited from Control)
ValidateVerifies the value of the control losing focus by causing the Validating and Validated events to occur, in that order.
(Inherited from ContainerControl)
Validate(Boolean)Verifies the value of the control that is losing focus; conditionally dependent on whether automatic validation is turned on.
(Inherited from ContainerControl)
ValidateChildrenCauses all of the child controls within a control that support validation to validate their data.
(Inherited from UserControl)
ValidateChildren(ValidationConstraints)Causes all of the child controls within a control that support validation to validate their data.
(Inherited from UserControl)
WndProc This is overridden to handle gaining the focus correctly
(Overrides UserControlWndProc(Message))

Events

AddDeleteButtonsVisibleChanged This event is raised when the AddDeleteButtonsVisible property changes
AddedRow This event is raised after adding an item to the data source
AddingRow This event is raised just prior to adding an item to the data source
AutoSizeChangedOccurs when the AutoSize property changes.
(Inherited from UserControl)
AutoValidateChangedOccurs when the AutoValidate property changes.
(Inherited from UserControl)
BackColorChangedOccurs when the value of the BackColor property changes.
(Inherited from Control)
BackgroundImageChangedOccurs when the value of the BackgroundImage property changes.
(Inherited from Control)
BackgroundImageLayoutChangedOccurs when the BackgroundImageLayout property changes.
(Inherited from Control)
BeginDrag This event is raised when a drag and drop operation is initiated
BindingContextChangedOccurs when the value of the BindingContext property changes.
(Inherited from Control)
CanceledEdits This event is raised after canceling edits via the Escape key
CancelingEdits This event is raised just prior to canceling edits to a row via the Escape key
CausesValidationChangedOccurs when the value of the CausesValidation property changes.
(Inherited from Control)
ChangePolicyModified This event is raised when the change policy for the data source is modified (i.e. changes to indicate whether or not adds, edits, or deletes are allowed).
ChangeUICuesOccurs when the focus or keyboard user interface (UI) cues change.
(Inherited from Control)
ClickOccurs when the control is clicked.
(Inherited from Control)
ClientSizeChangedOccurs when the value of the ClientSize property changes.
(Inherited from Control)
ContextMenuStripChangedOccurs when the value of the ContextMenuStrip property changes.
(Inherited from Control)
ControlAddedOccurs when a new control is added to the ControlControlCollection.
(Inherited from Control)
ControlRemovedOccurs when a control is removed from the ControlControlCollection.
(Inherited from Control)
Current This event is raised when a row is made the current row
CursorChangedOccurs when the value of the Cursor property changes.
(Inherited from Control)
DataContextChangedOccurs when the value of the DataContext property changes.
(Inherited from Control)
DataSourceChanged This event is raised when the DataSource is changed
DeletedRow This event is raised after deleting an item from the data source
DeletingRow This event is raised just prior to deleting an item from the data source
DisposedOccurs when the component is disposed by a call to the Dispose method.
(Inherited from Component)
DockChangedOccurs when the value of the Dock property changes.
(Inherited from Control)
DoubleClickOccurs when the control is double-clicked.
(Inherited from Control)
DpiChangedAfterParentOccurs when the DPI setting for a control is changed programmatically after the DPI of its parent control or form has changed.
(Inherited from Control)
DpiChangedBeforeParentOccurs when the DPI setting for a control is changed programmatically before a DPI change event for its parent control or form has occurred.
(Inherited from Control)
DragDropOccurs when a drag-and-drop operation is completed.
(Inherited from Control)
DragEnterOccurs when an object is dragged into the control's bounds.
(Inherited from Control)
DragLeaveOccurs when an object is dragged out of the control's bounds.
(Inherited from Control)
DragOverOccurs when an object is dragged over the control's bounds.
(Inherited from Control)
EnabledChangedOccurs when the Enabled property value has changed.
(Inherited from Control)
EnterOccurs when the control is entered.
(Inherited from Control)
FontChangedOccurs when the Font property value changes.
(Inherited from Control)
FooterDataBound This event is raised when the footer is data bound
ForeColorChangedOccurs when the ForeColor property value changes.
(Inherited from Control)
GiveFeedbackOccurs during a drag operation.
(Inherited from Control)
GotFocusOccurs when the control receives focus.
(Inherited from Control)
HandleCreatedOccurs when a handle is created for the control.
(Inherited from Control)
HandleDestroyedOccurs when the control's handle is in the process of being destroyed.
(Inherited from Control)
HeaderDataBound This event is raised when the header is data bound
HelpRequestedOccurs when the user requests help for a control.
(Inherited from Control)
ImeModeChangedOccurs when the ImeMode property has changed.
(Inherited from Control)
InvalidatedOccurs when a control's display requires redrawing.
(Inherited from Control)
ItemDataBound This event is raised when a row item is data bound
KeyDownOccurs when a key is pressed while the control has focus.
(Inherited from Control)
KeyPressOccurs when a character. space or backspace key is pressed while the control has focus.
(Inherited from Control)
KeyUpOccurs when a key is released while the control has focus.
(Inherited from Control)
LayoutOccurs when a control should reposition its child controls.
(Inherited from Control)
LeaveOccurs when the input focus leaves the control.
(Inherited from Control)
LoadOccurs before the control becomes visible for the first time.
(Inherited from UserControl)
LocationChangedOccurs when the Location property value has changed.
(Inherited from Control)
LostFocusOccurs when the control loses focus.
(Inherited from Control)
MarginChangedOccurs when the control's margin changes.
(Inherited from Control)
MouseCaptureChangedOccurs when the control loses mouse capture.
(Inherited from Control)
MouseClickOccurs when the control is clicked by the mouse.
(Inherited from Control)
MouseDoubleClickOccurs when the control is double clicked by the mouse.
(Inherited from Control)
MouseDownOccurs when the mouse pointer is over the control and a mouse button is pressed.
(Inherited from Control)
MouseEnterOccurs when the mouse pointer enters the control.
(Inherited from Control)
MouseHoverOccurs when the mouse pointer rests on the control.
(Inherited from Control)
MouseLeaveOccurs when the mouse pointer leaves the control.
(Inherited from Control)
MouseMoveOccurs when the mouse pointer is moved over the control.
(Inherited from Control)
MouseUpOccurs when the mouse pointer is over the control and a mouse button is released.
(Inherited from Control)
MouseWheelOccurs when the mouse wheel moves while the control has focus.
(Inherited from Control)
MoveOccurs when the control is moved.
(Inherited from Control)
NavigationControlsVisibleChanged This event is raised when the NavigationControlsVisible property changes
NoRows This event is raised after refreshing the data source or after deleting a row and there are no more rows in the data source.
PaddingChangedOccurs when the control's padding changes.
(Inherited from Control)
PaintOccurs when the control is redrawn.
(Inherited from Control)
ParentChangedOccurs when the Parent property value changes.
(Inherited from Control)
PreviewKeyDownOccurs before the KeyDown event when a key is pressed while focus is on this control.
(Inherited from Control)
QueryAccessibilityHelpOccurs when AccessibleObject is providing help to accessibility applications.
(Inherited from Control)
QueryContinueDragOccurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled.
(Inherited from Control)
RegionChangedOccurs when the value of the Region property changes.
(Inherited from Control)
RepeatIntervalChanged This event is raised when the RepeatInterval changes
RepeatWaitChanged This event is raised when the RepeatWait value changes
ResizeOccurs when the control is resized.
(Inherited from Control)
RightToLeftChangedOccurs when the RightToLeft property value changes.
(Inherited from Control)
RowHeaderBackColorChanged This event is raised when the RowHeaderBackColor changes
RowHeaderForeColorChanged This event is raised when the RowHeaderForeColor changes
RowHeadersFlatChanged This event is raised when the RowHeadersFlat property changes
RowHeadersVisibleChanged This event is raised when the RowHeadersVisible property changes
RowHeaderWidthChanged This event is raised when the RowHeaderWidth changes
ScrollOccurs when the user or code scrolls through the client area.
(Inherited from ScrollableControl)
SelectionBackColorChanged This event is raised when the SelectionBackColor changes
SelectionForeColorChanged This event is raised when the SelectionForeColor changes
SeparatorColorChanged This event is raised when the SeparatorColor changes
SeparatorHeightChanged This event is raised when the SeparatorHeight changes
SeparatorsVisibleChanged This event is raised when the SeparatorsVisible property changes
SizeChangedOccurs when the Size property value changes.
(Inherited from Control)
StyleChangedOccurs when the control style changes.
(Inherited from Control)
SystemColorsChangedOccurs when the system colors change.
(Inherited from Control)
TabIndexChangedOccurs when the TabIndex property value changes.
(Inherited from Control)
TabStopChangedOccurs when the TabStop property value changes.
(Inherited from Control)
TextChangedRaises the TextChanged event.
(Inherited from UserControl)
ValidatedOccurs when the control is finished validating.
(Inherited from Control)
ValidatingOccurs when the control is validating.
(Inherited from Control)
VisibleChangedOccurs when the Visible property value changes.
(Inherited from Control)

See Also