BindingNavigator Class (System - Windows
BindingNavigator Class (System - Windows
Forms)
BindingNavigator Class
.NET Framework (current version)
Represents the navigation and manipulation user interface (UI) for controls on a form that are bound to data.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Inheritance Hierarchy
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ScrollableControl
System.Windows.Forms.ToolStrip
System.Windows.Forms.BindingNavigator
Syntax
C#
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
public class BindingNavigator : ToolStrip, ISupportInitialize
Constructors
Name Description
BindingNavigator(B Initializes a new instance of the BindingNavigator class with the specified
indingSource) BindingSource as the data source.
BindingNavigator(I Initializes a new instance of the BindingNavigator class and adds this new
Container) instance to the specified container.
Properties
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 1/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
Name Description
AccessibleDef Gets or sets the default action description of the control for use by accessibility
aultActionDes client applications.(Inherited from Control.)
cription
AccessibleDe Gets or sets the description of the control used by accessibility client applications.
scription (Inherited from Control.)
AccessibleNa Gets or sets the name of the control used by accessibility client applications.
me (Inherited from Control.)
AccessibleRol Gets or sets the accessible role of the control (Inherited from Control.)
e
AddNewItem Gets or sets the ToolStripItem that represents the Add New button.
AllowDrop Gets or sets a value indicating whether drag-and-drop and item reordering are
handled through events that you implement.(Inherited from ToolStrip.)
AllowItemReo Gets or sets a value indicating whether drag-and-drop and item reordering are
rder handled privately by the ToolStrip class.(Inherited from ToolStrip.)
Anchor Gets or sets the edges of the container to which a ToolStrip is bound and
determines how a ToolStrip is resized with its parent.(Inherited from ToolStrip.)
AutoScroll This API supports the product infrastructure and is not intended to be used directly
from your code. This property is not relevant for this class.(Inherited from
ToolStrip.)
AutoScrollMa This API supports the product infrastructure and is not intended to be used directly
rgin from your code. This property is not relevant for this class.(Inherited from
ToolStrip.)
AutoScrollMi This API supports the product infrastructure and is not intended to be used directly
nSize from your code. This property is not relevant for this class.(Inherited from
ToolStrip.)
AutoScrollPos This API supports the product infrastructure and is not intended to be used directly
ition from your code. This property is not relevant for this class.(Inherited from
ToolStrip.)
AutoSize Gets or sets a value indicating whether the control is automatically resized to
display its entire contents.(Inherited from ToolStrip.)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 2/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
BackColor This API supports the product infrastructure and is not intended to be used directly
from your code. Gets or sets the background color for the ToolStrip.(Inherited from
ToolStrip.)
BackgroundI Gets or sets the background image displayed in the control.(Inherited from
mage Control.)
BackgroundI Gets or sets the background image layout as defined in the ImageLayout
mageLayout enumeration.(Inherited from Control.)
BindingConte Gets or sets the binding context for the ToolStrip.(Inherited from ToolStrip.)
xt
Bottom Gets the distance, in pixels, between the bottom edge of the control and the top
edge of its container's client area.(Inherited from Control.)
Bounds Gets or sets the size and location of the control including its nonclient elements, in
pixels, relative to the parent control.(Inherited from Control.)
CanEnableIm Gets a value indicating whether the ImeMode property can be set to an active value,
e to enable IME support.(Inherited from Control.)
CanFocus Gets a value indicating whether the control can receive focus.(Inherited from
Control.)
CanOverflow Gets or sets a value indicating whether items in the ToolStrip can be sent to an
overflow menu.(Inherited from ToolStrip.)
CanSelect Gets a value indicating whether the control can be selected.(Inherited from Control.)
Capture Gets or sets a value indicating whether the control has captured the mouse.
(Inherited from Control.)
CausesValida Gets or sets a value indicating whether the ToolStrip causes validation to be
tion performed on any controls that require validation when it receives focus.(Inherited
from ToolStrip.)
ClientRectang Gets the rectangle that represents the client area of the control.(Inherited from
le Control.)
ClientSize Gets or sets the height and width of the client area of the control.(Inherited from
Control.)
CompanyNa Gets the name of the company or creator of the application containing the control.
me (Inherited from Control.)
Container Gets the IContainer that contains the Component.(Inherited from Component.)
ContainsFocu Gets a value indicating whether the control, or one of its child controls, currently has
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 3/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
ContextMenu Gets or sets the shortcut menu associated with the control.(Inherited from Control.)
ContextMenu Gets or sets the ContextMenuStrip associated with this control.(Inherited from
Strip Control.)
Controls This API supports the product infrastructure and is not intended to be used directly
from your code. This property is not relevant for this class.(Inherited from
ToolStrip.)
CountItem Gets or sets the ToolStripItem that displays the total number of items in the
associated BindingSource.
CountItemFor Gets or sets a string used to format the information displayed in the CountItem
mat control.
Created Gets a value indicating whether the control has been created.(Inherited from
Control.)
CreateParam Gets the required creation parameters when the control handle is created.(Inherited
s from ScrollableControl.)
Cursor Gets or sets the cursor that is displayed when the mouse pointer is over the
ToolStrip.(Inherited from ToolStrip.)
DataBindings Gets the data bindings for the control.(Inherited from Control.)
DefaultCursor Gets or sets the default cursor for the control.(Inherited from Control.)
DefaultDock Gets the docking location of the ToolStrip, indicating which borders are docked to
the container.(Inherited from ToolStrip.)
DefaultGripM Gets the default spacing, in pixels, between the sizing grip and the edges of the
argin ToolStrip.(Inherited from ToolStrip.)
DefaultImeM Gets the default Input Method Editor (IME) mode supported by the control.
ode (Inherited from Control.)
DefaultMargi Gets the spacing, in pixels, between the ToolStrip and the ToolStripContainer.
n (Inherited from ToolStrip.)
DefaultMaxim Gets the length and height, in pixels, that is specified as the default maximum size
umSize of a control.(Inherited from Control.)
DefaultMinim Gets the length and height, in pixels, that is specified as the default minimum size of
umSize a control.(Inherited from Control.)
DefaultPaddi Gets the internal spacing, in pixels, of the contents of a ToolStrip.(Inherited from
ng ToolStrip.)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 4/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
DefaultShowIt Gets a value indicating whether ToolTips are shown for the ToolStrip by default.
emToolTips (Inherited from ToolStrip.)
DeleteItem Gets or sets the ToolStripItem that is associated with the Delete functionality.
DesignMode Gets a value that indicates whether the Component is currently in design mode.
(Inherited from Component.)
DeviceDpi Gets the DPI value for the display device where the control is currently being
displayed.(Inherited from Control.)
DisplayedIte Gets the subset of items that are currently displayed on the ToolStrip, including
ms items that are automatically added into the ToolStrip.(Inherited from ToolStrip.)
DisplayRecta This API supports the product infrastructure and is not intended to be used directly
ngle from your code. Retrieves the current display rectangle.(Inherited from ToolStrip.)
Disposing Gets a value indicating whether the base Control class is in the process of
disposing.(Inherited from Control.)
Dock Gets or sets which ToolStrip borders are docked to its parent control and
determines how a ToolStrip is resized with its parent.(Inherited from ToolStrip.)
DockPadding Gets the dock padding settings for all edges of the control.(Inherited from
ScrollableControl.)
DoubleBuffer Gets or sets a value indicating whether this control should redraw its surface using
ed a secondary buffer to reduce or prevent flicker.(Inherited from Control.)
Enabled Gets or sets a value indicating whether the control can respond to user interaction.
(Inherited from Control.)
Events Gets the list of event handlers that are attached to this Component.(Inherited from
Component.)
Focused Gets a value indicating whether the control has input focus.(Inherited from Control.)
Font Gets or sets the font used to display text in the control.(Inherited from ToolStrip.)
FontHeight Gets or sets the height of the font of the control.(Inherited from Control.)
ForeColor Gets or sets the foreground color of the ToolStrip.(Inherited from ToolStrip.)
GripDisplaySt Gets the orientation of the ToolStrip move handle.(Inherited from ToolStrip.)
yle
GripMargin Gets or sets the space around the ToolStrip move handle.(Inherited from ToolStrip.)
GripRectangl Gets the boundaries of the ToolStrip move handle.(Inherited from ToolStrip.)
e
GripStyle Gets or sets whether the ToolStrip move handle is visible or hidden.(Inherited from
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 5/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
ToolStrip.)
Handle Gets the window handle that the control is bound to.(Inherited from Control.)
HasChildren This API supports the product infrastructure and is not intended to be used directly
from your code. This property is not relevant for this class.(Inherited from
ToolStrip.)
HorizontalScr This API supports the product infrastructure and is not intended to be used directly
oll from your code. This property is not relevant for this class.(Inherited from
ToolStrip.)
HScroll Gets or sets a value indicating whether the horizontal scroll bar is visible.(Inherited
from ScrollableControl.)
ImageList Gets or sets the image list that contains the image displayed on a ToolStrip item.
(Inherited from ToolStrip.)
ImageScaling Gets or sets the size, in pixels, of an image used on a ToolStrip.(Inherited from
Size ToolStrip.)
ImeMode Gets or sets the Input Method Editor (IME) mode of the control.(Inherited from
Control.)
InvokeRequir Gets a value indicating whether the caller must call an invoke method when making
ed method calls to the control because the caller is on a different thread than the one
the control was created on.(Inherited from Control.)
IsAccessible Gets or sets a value indicating whether the control is visible to accessibility
applications.(Inherited from Control.)
IsCurrentlyDr Gets a value indicating whether the user is currently moving the ToolStrip from one
agging ToolStripContainer to another. (Inherited from ToolStrip.)
IsDisposed Gets a value indicating whether the control has been disposed of.(Inherited from
Control.)
IsHandleCrea Gets a value indicating whether the control has a handle associated with it.(Inherited
ted from Control.)
IsMirrored Gets a value indicating whether the control is mirrored.(Inherited from Control.)
Items Gets all the items that belong to a ToolStrip.(Inherited from ToolStrip.)
LayoutEngine Passes a reference to the cached LayoutEngine returned by the layout engine
interface.(Inherited from ToolStrip.)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 6/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
LayoutStyle Gets or sets a value indicating how the ToolStrip lays out the items collection.
(Inherited from ToolStrip.)
Left Gets 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.)
Location Gets or sets the coordinates of the upper-left corner of the control relative to the
upper-left corner of its container.(Inherited from Control.)
MaximumSize Gets or sets the size that is the upper limit that GetPreferredSize can specify.
(Inherited from Control.)
MaxItemSize Gets the maximum height and width, in pixels, of the ToolStrip.(Inherited from
ToolStrip.)
MinimumSize Gets or sets the size that is the lower limit that GetPreferredSize can specify.
(Inherited from Control.)
MoveFirstIte Gets or sets the ToolStripItem that is associated with the Move First functionality.
m
MoveLastIte Gets or sets the ToolStripItem that is associated with the Move Last functionality.
m
MoveNextIte Gets or sets the ToolStripItem that is associated with the Move Next functionality.
m
MovePreviou Gets or sets the ToolStripItem that is associated with the Move Previous
sItem functionality.
OverflowButt Gets the ToolStripItem that is the overflow button for a ToolStrip with overflow
on enabled.(Inherited from ToolStrip.)
Parent Gets or sets the parent container of the control.(Inherited from Control.)
PositionItem Gets or sets the ToolStripItem that displays the current position within the
BindingSource.
PreferredSize Gets the size of a rectangular area into which the control can fit.(Inherited from
Control.)
ProductName Gets the product name of the assembly containing the control.(Inherited from
Control.)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 7/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
ProductVersi Gets the version of the assembly containing the control.(Inherited from Control.)
on
RecreatingHa Gets a value indicating whether the control is currently re-creating its handle.
ndle (Inherited from Control.)
Region Gets or sets the window region associated with the control.(Inherited from Control.)
Renderer Gets or sets a ToolStripRenderer used to customize the look and feel of a
ToolStrip.(Inherited from ToolStrip.)
RenderMode Gets or sets a value that indicates which visual styles will be applied to the
ToolStrip.(Inherited from ToolStrip.)
ResizeRedra Gets or sets a value indicating whether the control redraws itself when resized.
w (Inherited from Control.)
Right Gets the distance, in pixels, between the right edge of the control and the left edge
of its container's client area.(Inherited from Control.)
RightToLeft Gets or sets a value indicating whether control's elements are aligned to support
locales using right-to-left fonts.(Inherited from Control.)
ScaleChildren Gets a value that determines the scaling of child controls. (Inherited from Control.)
ShowFocusCu Gets a value indicating whether the control should display focus rectangles.
es (Inherited from Control.)
ShowItemToo Gets or sets a value indicating whether ToolTips are to be displayed on ToolStrip
lTips items. (Inherited from ToolStrip.)
ShowKeyboar Gets a value indicating whether the user interface is in the appropriate state to
dCues show or hide keyboard accelerators.(Inherited from Control.)
Size Gets or sets the height and width of the control.(Inherited from Control.)
Stretch Gets or sets a value indicating whether the ToolStrip stretches from end to end in
the ToolStripContainer.(Inherited from ToolStrip.)
TabIndex Gets or sets the tab order of the control within its container.(Inherited from
Control.)
TabStop Gets or sets a value indicating whether the user can give the focus to an item in the
ToolStrip using the TAB key.(Inherited from ToolStrip.)
Tag Gets or sets the object that contains data about the control.(Inherited from Control.)
Text Gets or sets the text associated with this control.(Inherited from Control.)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 8/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
TextDirection Gets or sets the direction in which to draw text on a ToolStrip.(Inherited from
ToolStrip.)
Top Gets 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.)
TopLevelCont Gets the parent control that is not parented by another Windows Forms control.
rol Typically, this is the outermost Form that the control is contained in.(Inherited from
Control.)
UseWaitCurs Gets or sets a value indicating whether to use the wait cursor for the current control
or and all child controls.(Inherited from Control.)
VerticalScroll This API supports the product infrastructure and is not intended to be used directly
from your code. This property is not relevant for this class.(Inherited from
ToolStrip.)
Visible Gets or sets a value indicating whether the control and all its child controls are
displayed.(Inherited from Control.)
VScroll Gets or sets a value indicating whether the vertical scroll bar is visible.(Inherited
from ScrollableControl.)
WindowTarg This API supports the product infrastructure and is not intended to be used directly
et from your code. This property is not relevant for this class.(Inherited from Control.)
Methods
Name Description
AccessibilityNoti Notifies the accessibility client applications of the specified AccessibleEvents for
fyClients(Accessi the specified child control.(Inherited from Control.)
bleEvents,
Int32)
AccessibilityNoti Notifies the accessibility client applications of the specified AccessibleEvents for
fyClients(Accessi the specified child control .(Inherited from Control.)
bleEvents,
Int32, Int32)
AddStandardIte Adds the standard set of navigation items to the BindingNavigator control.
ms()
AdjustFormScrol Adjusts the scroll bars on the container based on the current control positions
lbars(Boolean) and the control currently selected. (Inherited from ScrollableControl.)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 9/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
BeginInvoke(Del Executes the specified delegate asynchronously on the thread that the control's
egate) underlying handle was created on.(Inherited from Control.)
BeginInvoke(Del Executes the specified delegate asynchronously with the specified arguments, on
egate, Object[]) the thread that the control's underlying handle was created on.(Inherited from
Control.)
BringToFront() Brings the control to the front of the z-order.(Inherited from Control.)
Contains(Contro Retrieves a value indicating whether the specified control is a child of the control.
l) (Inherited from Control.)
CreateAccessibil Creates a new accessibility object for the ToolStrip item.(Inherited from
ityInstance() ToolStrip.)
CreateControl() Forces the creation of the visible control, including the creation of the handle and
any visible child controls.(Inherited from Control.)
CreateControlsI Creates a new instance of the control collection for the control.(Inherited from
nstance() ToolStrip.)
CreateDefaultIte Creates a default ToolStripItem with the specified text, image, and event handler
m(String, on a new ToolStrip instance.(Inherited from ToolStrip.)
Image,
EventHandler)
CreateLayoutSet Specifies the visual arrangement for the ToolStrip.(Inherited from ToolStrip.)
tings(ToolStripL
ayoutStyle)
CreateObjRef(Ty Creates an object that contains all the relevant information required to generate
pe) a proxy used to communicate with a remote object.(Inherited from
MarshalByRefObject.)
DefWndProc(M Sends the specified message to the default window procedure.(Inherited from
essage) Control.)
DestroyHandle() Destroys the handle associated with the control.(Inherited from Control.)
Dispose(Boolea Releases the unmanaged resources used by the BindingNavigator and optionally
n) releases the managed resources. (Overrides ToolStrip.Dispose(Boolean).)
Rectangle)
EndInit() Enables updates to the ToolStripItem controls of the BindingNavigator after the
component's initialization has concluded.
EndInvoke(IAsyn Retrieves the return value of the asynchronous operation represented by the
cResult) IAsyncResult passed.(Inherited from Control.)
Equals(Object) Determines whether the specified object is equal to the current object.(Inherited
from Object.)
Finalize() Releases unmanaged resources and performs other cleanup operations before
the Component is reclaimed by garbage collection.(Inherited from Component.)
FindForm() Retrieves the form that the control is on.(Inherited from Control.)
GetAutoSizeMo Retrieves a value indicating how a control will behave when its AutoSize property
de() is enabled.(Inherited from Control.)
GetChildAtPoint( This API supports the product infrastructure and is not intended to be used
Point) directly from your code. This method is not relevant for this class.(Inherited from
ToolStrip.)
GetChildAtPoint( This API supports the product infrastructure and is not intended to be used
Point, directly from your code. This method is not relevant for this class.(Inherited from
GetChildAtPoint ToolStrip.)
Skip)
GetContainerCo Returns the next ContainerControl up the control's chain of parent controls.
ntrol() (Inherited from Control.)
GetItemAt(Int32, Returns the item located at the specified x- and y-coordinates of the ToolStrip
Int32) client area.(Inherited from ToolStrip.)
GetItemAt(Point) Returns the item located at the specified point in the client area of the ToolStrip.
(Inherited from ToolStrip.)
GetLifetimeServi Retrieves the current lifetime service object that controls the lifetime policy for
ce() this instance.(Inherited from MarshalByRefObject.)
GetNextControl( Retrieves the next control forward or back in the tab order of child controls.
Control, (Inherited from Control.)
Boolean)
GetNextItem(To Retrieves the next ToolStripItem from the specified reference point and moving in
olStripItem, the specified direction.(Inherited from ToolStrip.)
ArrowDirection)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 11/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
GetPreferredSiz Retrieves the size of a rectangular area into which a control can be fitted.
e(Size) (Inherited from Control.)
GetScaledBound Retrieves the bounds within which the control is scaled.(Inherited from Control.)
s(Rectangle,
SizeF,
BoundsSpecifie
d)
GetScrollState(In Determines whether the specified flag has been set.(Inherited from
t32) ScrollableControl.)
GetService(Type Returns an object that represents a service provided by the Component or by its
) Container.(Inherited from Component.)
GetStyle(Control Retrieves the value of the specified control style bit for the control.(Inherited from
Styles) Control.)
InitializeLifetime Obtains a lifetime service object to control the lifetime policy for this instance.
Service() (Inherited from MarshalByRefObject.)
InitLayout() Called after the control has been added to another container.(Inherited from
Control.)
Invalidate() Invalidates the entire surface of the control and causes the control to be redrawn.
(Inherited from Control.)
Invalidate(Boole Invalidates a specific region of the control and causes a paint message to be
an) sent to the control. Optionally, invalidates the child controls assigned to the
control.(Inherited from Control.)
Invalidate(Recta Invalidates the specified region of the control (adds it to the control's update
ngle) 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(Recta Invalidates the specified region of the control (adds it to the control's update
ngle, Boolean) 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(Regio Invalidates the specified region of the control (adds it to the control's update
n) 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(Regio Invalidates the specified region of the control (adds it to the control's update
n, Boolean) 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.)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 12/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
Invoke(Delegate 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
, Object[]) window handle, with the specified list of arguments.(Inherited from Control.)
InvokeGotFocus( Raises the GotFocus event for the specified control.(Inherited from Control.)
Control,
EventArgs)
InvokeLostFocus Raises the LostFocus event for the specified control.(Inherited from Control.)
(Control,
EventArgs)
InvokeOnClick(C Raises the Click event for the specified control.(Inherited from Control.)
ontrol,
EventArgs)
InvokePaint(Con Raises the Paint event for the specified control.(Inherited from Control.)
trol,
PaintEventArgs)
InvokePaintBack Raises the PaintBackground event for the specified control.(Inherited from
ground(Control, Control.)
PaintEventArgs)
IsInputChar(Cha Determines whether a character is an input character that the item recognizes.
r) (Inherited from ToolStrip.)
IsInputKey(Keys) Determines whether the specified key is a regular input key or a special key that
requires preprocessing.(Inherited from ToolStrip.)
LogicalToDevice Converts a Logical DPI value to it's equivalent DeviceUnit DPI value.(Inherited from
Units(Int32) Control.)
NotifyInvalidate( This API supports the product infrastructure and is not intended to be used
Rectangle) directly from your code. Raises the Invalidated event with a specified region of
the control to invalidate.(Inherited from Control.)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 14/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
AfterParent(Eve
ntArgs)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 15/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
validateEventAr
gs)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 16/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
OnPaintBackgro Raises the Paint event for the ToolStrip background.(Inherited from ToolStrip.)
und(PaintEventA
rgs)
OnParentBackC Raises the BackColorChanged event when the BackColor property value of the
olorChanged(Ev control's container changes.(Inherited from Control.)
entArgs)
OnParentBindin Raises the BindingContextChanged event when the BindingContext property value
gContextChang of the control's container changes.(Inherited from Control.)
ed(EventArgs)
OnParentEnable Raises the EnabledChanged event when the Enabled property value of the
dChanged(Event control's container changes.(Inherited from Control.)
Args)
OnParentFontCh Raises the FontChanged event when the Font property value of the control's
anged(EventArg container changes.(Inherited from Control.)
s)
OnParentForeC Raises the ForeColorChanged event when the ForeColor property value of the
olorChanged(Ev control's container changes.(Inherited from Control.)
entArgs)
OnParentRightT Raises the RightToLeftChanged event when the RightToLeft property value of the
oLeftChanged(E control's container changes.(Inherited from Control.)
ventArgs)
OnParentVisible Raises the VisibleChanged event when the Visible property value of the control's
Changed(EventA container changes.(Inherited from Control.)
rgs)
(EventArgs)
PerformLayout() Forces the control to apply layout logic to all its child controls.(Inherited from
Control.)
PerformLayout( Forces the control to apply layout logic to all its child controls.(Inherited from
Control, String) Control.)
PointToClient(Po Computes the location of the specified screen point into client coordinates.
int) (Inherited from Control.)
PointToScreen(P Computes the location of the specified client point into screen coordinates.
oint) (Inherited from Control.)
PreProcessCont Preprocesses keyboard or input messages within the message loop before they
rolMessage(Me are dispatched.(Inherited from Control.)
ssage)
PreProcessMess Preprocesses keyboard or input messages within the message loop before they
age(Message) are dispatched.(Inherited from Control.)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 19/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
ProcessKeyEven Processes a key message and generates the appropriate control events.
tArgs(Message) (Inherited from Control.)
RaiseDragEvent( This API supports the product infrastructure and is not intended to be used
Object, directly from your code. Raises the appropriate drag event.(Inherited from
DragEventArgs) Control.)
RaiseKeyEvent( This API supports the product infrastructure and is not intended to be used
Object, directly from your code. Raises the appropriate key event.(Inherited from
KeyEventArgs) Control.)
RaiseMouseEve This API supports the product infrastructure and is not intended to be used
nt(Object, directly from your code. Raises the appropriate mouse event.(Inherited from
MouseEventArg Control.)
s)
RaisePaintEvent( This API supports the product infrastructure and is not intended to be used
Object, directly from your code. Raises the appropriate paint event.(Inherited from
PaintEventArgs) Control.)
RecreateHandle Forces the re-creation of the handle for the control.(Inherited from Control.)
()
RectangleToClie Computes the size and location of the specified screen rectangle in client
nt(Rectangle) coordinates.(Inherited from Control.)
RectangleToScr Computes the size and location of the specified client rectangle in screen
een(Rectangle) coordinates.(Inherited from Control.)
Refresh() Forces the control to invalidate its client area and immediately redraw itself and
any child controls.(Inherited from Control.)
RefreshItemsCo Refreshes the state of the standard items to reflect the current state of the data.
re()
RescaleConstant Provides constants for rescaling the control when a DPI change occurs.(Inherited
sForDpi(Int32, from Control.)
Int32)
ResetBackColor( Resets the BackColor property to its default value.(Inherited from Control.)
)
ResetBindings() Causes a control bound to the BindingSource to reread all the items in the list
and refresh their displayed values.(Inherited from Control.)
ResetCursor() Resets the Cursor property to its default value.(Inherited from Control.)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 20/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
ResetFont() Resets the Font property to its default value.(Inherited from Control.)
ResetForeColor( Resets the ForeColor property to its default value.(Inherited from Control.)
)
ResetImeMode( Resets the ImeMode property to its default value.(Inherited from Control.)
)
ResetMinimumS This API supports the product infrastructure and is not intended to be used
ize() directly from your code. This method is not relevant for this class.(Inherited from
ToolStrip.)
ResetMouseEve This API supports the product infrastructure and is not intended to be used
ntArgs() directly from your code. Resets the control to handle the MouseLeave event.
(Inherited from Control.)
ResetRightToLef Resets the RightToLeft property to its default value.(Inherited from Control.)
t()
ResetText() Resets the Text property to its default value.(Inherited from Control.)
ResumeLayout(B Resumes usual layout logic, optionally forcing an immediate layout of pending
oolean) layout requests.(Inherited from Control.)
Scale(Single) Obsolete. Scales the control and any child controls.(Inherited from Control.)
Scale(Single, Obsolete. Scales the entire control and any child controls.(Inherited from
Single) Control.)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 21/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
Scale(SizeF) Scales the control and all child controls by the specified scaling factor.(Inherited
from Control.)
ScaleBitmapLogi Scales a logical bitmap value to it's equivalent device unit value when a DPI
calToDevice(Bit change occurs.(Inherited from Control.)
map)
ScaleCore(Singl This method is not relevant for this class.(Inherited from ScrollableControl.)
e, Single)
ScrollControlInt Scrolls the specified child control into view on an auto-scroll enabled control.
oView(Control) (Inherited from ScrollableControl.)
ScrollToControl( Calculates the scroll offset to the specified child control. (Inherited from
Control) ScrollableControl.)
Select(Boolean, Activates a child control. Optionally specifies the direction in the tab order to
Boolean) select the control from.(Inherited from ToolStrip.)
SendToBack() Sends the control to the back of the z-order.(Inherited from Control.)
SetAutoScrollM This method is not relevant for this class.(Inherited from ToolStrip.)
argin(Int32,
Int32)
SetAutoSizeMo Sets a value indicating how a control will behave when its AutoSize property is
de(AutoSizeMo enabled.(Inherited from Control.)
de)
SetBounds(Int32 Sets the bounds of the control to the specified location and size.(Inherited from
, Int32, Int32, Control.)
Int32)
SetBounds(Int32 Sets the specified bounds of the control to the specified location and size.
, Int32, Int32, (Inherited from Control.)
Int32,
BoundsSpecifie
d)
SetBoundsCore( Performs the work of setting the specified bounds of this control.(Inherited from
Int32, Int32, ToolStrip.)
Int32, Int32,
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 22/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
BoundsSpecifie
d)
SetClientSizeCor Sets the size of the client area of the control.(Inherited from Control.)
e(Int32, Int32)
SetDisplayedIte Resets the collection of displayed and overflow items after a layout is done.
ms() (Inherited from ToolStrip.)
SetStyle(Control Sets a specified ControlStyles flag to either true or false.(Inherited from Control.)
Styles, Boolean)
SetVisibleCore(B Retrieves a value that sets the ToolStripItem to the specified visibility state.
oolean) (Inherited from ToolStrip.)
SizeFromClientSi Determines the size of the entire control from the height and width of its client
ze(Size) area.(Inherited from Control.)
SuspendLayout( Temporarily suspends the layout logic for the control.(Inherited from Control.)
)
ToString() Returns a string that represents the ToolStrip control.(Inherited from ToolStrip.)
Update() Causes the control to redraw the invalidated regions within its client area.
(Inherited from Control.)
UpdateBounds() Updates the bounds of the control with the current size and location.(Inherited
from Control.)
UpdateBounds(I Updates the bounds of the control with the specified size and location.(Inherited
nt32, Int32, from Control.)
Int32, Int32)
UpdateBounds(I Updates the bounds of the control with the specified size, location, and client
nt32, Int32, size.(Inherited from Control.)
Int32, Int32,
Int32, Int32)
UpdateStyles() Forces the assigned styles to be reapplied to the control.(Inherited from Control.)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 23/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
Validate() Causes form validation to occur and returns whether validation was successful.
Events
Name Description
AutoSizeChang Occurs when the AutoSize property has changed.(Inherited from ToolStrip.)
ed
BackColorChan Occurs when the value of the BackColor property changes.(Inherited from Control.)
ged
BackgroundIm Occurs when the value of the BackgroundImage property changes.(Inherited from
ageChanged Control.)
BeginDrag Occurs when the user begins to drag the ToolStrip control.(Inherited from
ToolStrip.)
BindingContext Occurs when the value of the BindingContext property changes.(Inherited from
Changed Control.)
ChangeUICues Occurs when the focus or keyboard user interface (UI) cues change.(Inherited from
Control.)
ClientSizeChan Occurs when the value of the ClientSize property changes. (Inherited from Control.)
ged
ContextMenuC Occurs when the value of the ContextMenu property changes.(Inherited from
hanged Control.)
ContextMenuSt Occurs when the value of the ContextMenuStrip property changes. (Inherited from
ripChanged Control.)
ControlAdded This API supports the product infrastructure and is not intended to be used
directly from your code. This event is not relevant for this class.(Inherited from
ToolStrip.)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 24/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
ControlRemov This API supports the product infrastructure and is not intended to be used
ed directly from your code. This event is not relevant for this class.(Inherited from
ToolStrip.)
CursorChange Occurs when the value of the Cursor property changes.(Inherited from ToolStrip.)
d
Disposed Occurs when the component is disposed by a call to the Dispose method.
(Inherited from Component.)
DockChanged Occurs when the value of the Dock property changes.(Inherited from Control.)
DpiChangedAft Occurs when the DPI setting for a control is changed programmatically after the
erParent DPI of it's parent control or form has changed.(Inherited from Control.)
DpiChangedBe Occurs when the DPI setting for a control is changed programmatically before a
foreParent DPI change event for it's parent control or form has occurred.(Inherited from
Control.)
DragEnter Occurs when an object is dragged into the control's bounds.(Inherited from
Control.)
DragLeave Occurs when an object is dragged out of the control's bounds.(Inherited from
Control.)
DragOver Occurs when an object is dragged over the control's bounds.(Inherited from
Control.)
EnabledChang Occurs when the Enabled property value has changed.(Inherited from Control.)
ed
EndDrag Occurs when the user stops dragging the ToolStrip control.(Inherited from
ToolStrip.)
FontChanged Occurs when the Font property value changes.(Inherited from Control.)
ForeColorChan Occurs when the value of the ForeColor property changes.(Inherited from
ged ToolStrip.)
HandleCreated Occurs when a handle is created for the control.(Inherited from Control.)
HandleDestroy Occurs when the control's handle is in the process of being destroyed.(Inherited
ed from Control.)
HelpRequeste Occurs when the user requests help for a control.(Inherited from Control.)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 25/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
ImeModeChan Occurs when the ImeMode property has changed.(Inherited from Control.)
ged
KeyDown Occurs when a key is pressed while the control has focus.(Inherited from Control.)
KeyPress Occurs when a character. space or backspace key is pressed while the control has
focus.(Inherited from Control.)
KeyUp Occurs when a key is released while the control has focus.(Inherited from Control.)
Layout Occurs when a control should reposition its child controls.(Inherited from Control.)
LayoutComplet Occurs when the layout of the ToolStrip is complete.(Inherited from ToolStrip.)
ed
LayoutStyleCha Occurs when the value of the LayoutStyle property changes.(Inherited from
nged ToolStrip.)
Leave Occurs when the input focus leaves the control.(Inherited from Control.)
LocationChang Occurs when the Location property value has changed.(Inherited from Control.)
ed
MouseCapture Occurs when the control loses mouse capture.(Inherited from Control.)
Changed
MouseClick Occurs when the control is clicked by the mouse.(Inherited from Control.)
MouseDouble Occurs when the control is double clicked by the mouse.(Inherited from Control.)
Click
MouseDown Occurs when the mouse pointer is over the control and a mouse button is
pressed.(Inherited from Control.)
MouseEnter Occurs when the mouse pointer enters the control.(Inherited from Control.)
MouseHover Occurs when the mouse pointer rests on the control.(Inherited from Control.)
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 26/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
MouseLeave Occurs when the mouse pointer leaves the control.(Inherited from Control.)
MouseMove Occurs when the mouse pointer is moved over the control.(Inherited from
Control.)
MouseUp Occurs when the mouse pointer is over the control and a mouse button is
released.(Inherited from Control.)
MouseWheel Occurs when the mouse wheel moves while the control has focus.(Inherited from
Control.)
PaintGrip Occurs when the ToolStrip move handle is painted.(Inherited from ToolStrip.)
ParentChange Occurs when the Parent property value changes.(Inherited from Control.)
d
PreviewKeyDo Occurs before the KeyDown event when a key is pressed while focus is on this
wn control.(Inherited from Control.)
QueryContinue Occurs during a drag-and-drop operation and enables the drag source to
Drag determine whether the drag-and-drop operation should be canceled.(Inherited
from Control.)
RefreshItems Occurs when the state of the navigational user interface (UI) needs to be refreshed
to reflect the current state of the underlying data.
RegionChange Occurs when the value of the Region property changes.(Inherited from Control.)
d
RendererChan Occurs when the value of the Renderer property changes.(Inherited from
ged ToolStrip.)
RightToLeftCha Occurs when the RightToLeft property value changes.(Inherited from Control.)
nged
Scroll Occurs when the user or code scrolls through the client area.(Inherited from
ScrollableControl.)
SizeChanged Occurs when the Size property value changes.(Inherited from Control.)
hanged
TabIndexChan Occurs when the TabIndex property value changes.(Inherited from Control.)
ged
TabStopChang Occurs when the TabStop property value changes.(Inherited from Control.)
ed
TextChanged Occurs when the Text property value changes.(Inherited from Control.)
VisibleChange Occurs when the Visible property value changes.(Inherited from Control.)
d
Name Description
IDropTarget.OnDra This API supports the product infrastructure and is not intended to be used
gDrop(DragEventAr directly from your code. Raises the DragDrop event.(Inherited from Control.)
gs)
IDropTarget.OnDra This API supports the product infrastructure and is not intended to be used
gEnter(DragEventAr directly from your code. Raises the DragEnter event.(Inherited from Control.)
gs)
IDropTarget.OnDra This API supports the product infrastructure and is not intended to be used
gLeave(EventArgs) directly from your code. Raises the DragLeave event.(Inherited from Control.)
IDropTarget.OnDra This API supports the product infrastructure and is not intended to be used
gOver(DragEventAr directly from your code. Raises the DragOver event.(Inherited from Control.)
gs)
Remarks
The BindingNavigator control represents a standardized way to navigate and manipulate data on a form. In most cases,
a BindingNavigator is paired with a BindingSource control to move through data records on a form and interact with
them. In these cases, the BindingSource property is set to the associated System.Windows.Forms.BindingSource
component that acts as a data source.
By default, the BindingNavigator control's user interface (UI) is composed of a series of ToolStrip buttons, text boxes,
and static text elements for most common data-related actions, such as adding data, deleting data, and navigating
through data. Each of these controls can be retrieved or set through an associated member of the BindingNavigator
control. Likewise, there is also a one-to-one correspondence to members within the BindingSource class that
programmatically perform the same functionality, as shown in the following table.
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 28/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
Adding a BindingNavigator control to a form and binding it to a data source, such as a BindingSource, will automatically
establish the relationships in this table.
You can use one of the following techniques to customize this toolbar:
Create the BindingNavigator with the BindingNavigator(Boolean) constructor, which accepts a Boolean
addStandardItems parameter, and set this parameter to false. Then add the desired ToolStripItem objects to the
Items collection.
If a great deal of customization is desired, or the custom design will be reused, derive a class from
BindingNavigator and override the AddStandardItems method to define additional or alternate standard items.
Examples
The following code example demonstrates how to use a BindingNavigator control to move through a data set. The set
is contained in a DataView, which is bound to a TextBox control with a BindingSource component.
C#
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Data.SqlClient;
using System.Windows.Forms;
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 29/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
// This is the BindingSource that provides data for
// the Textbox control.
BindingSource customersBindingSource = new BindingSource();
public Form1()
{
// Set up the BindingSource component.
this.customersBindingNavigator.BindingSource = this.customersBindingSource;
this.customersBindingNavigator.Dock = DockStyle.Top;
this.Controls.Add(this.customersBindingNavigator);
SqlDataAdapter dataAdapter1 =
new SqlDataAdapter(new SqlCommand("Select * From Customers",connection));
DataSet ds = new DataSet("Northwind Customers");
ds.Tables.Add("Customers");
dataAdapter1.Fill(ds.Tables["Customers"]);
[STAThread]
public static void Main()
{
Application.EnableVisualStyles();
Application.Run(new Form1());
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 30/31
06/07/2017 BindingNavigator Class (System.Windows.Forms)
}
}
Version Information
.NET Framework
Available since 2.0
Thread Safety
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not
guaranteed to be thread safe.
See Also
BindingSource
System.Windows.Forms Namespace
BindingNavigator Control (Windows Forms)
Return to top
© 2017 Microsoft
https://msdn.microsoft.com/en-us/library/system.windows.forms.bindingnavigator(d=printer,v=vs.110).aspx 31/31