[]
        
(Showing Draft Content)

C1.Win.C1Input.C1DbNavigator

C1DbNavigator Class

Represents a data bound control supporting convenient navigation over data source rows and common data actions such as updating the data source and refreshing data.

Namespace: C1.Win.C1Input
Assembly: C1.Win.C1Input.4.8.dll
Syntax
[ToolboxBitmap(typeof(C1DbNavigator), "C1DbNavigator.png")]
public class C1DbNavigator : UserControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, IContainerControl, ISupportInitialize

Constructors

Name Description
C1DbNavigator()

Initializes a new instance of the C1DbNavigator class.

Properties

Name Description
AutoSize

Specifies if navigator buttons have color bitmaps.

BackColor

This member overrides Control.BackColor.

BorderStyle

Navigator border style.

ButtonCursor

The cursor that is displayed when the mouse is over the navigator buttons.

ButtonSize

The size of navigator buttons.

ButtonStyle

Navigator button style.

ButtonTextAlign

Controls how the text is positioned relative to the image in navigator buttons.

ButtonTexts

Gets or sets the texts displayed on the buttons.

ButtonToolTips

The string collection defining navigator button tooltips.

CausesFormValidation

Whether the control in focus should be validated before a button click is handled by the navigator.

ColorButtons

Specifies if navigator buttons have color bitmaps.

ColorWhenHover

If True, navigator buttons show color bitmaps when the mouse hovers over them.

ConfirmDelete

Whether a confirmation dialog is shown before deleting a record.

CurrencyManager

Gets or sets the CurrencyManager object navigated by the control.

DataMember

"For multi-table data sources, specifies a specific table to which the control is bound.

DataSource

The data source object to which the control is bound.

EnabledButtons

Flags enumeration specifying which buttons are enabled.

ErrorProvider

Gets or sets an ErrorProvider object used to indicate error state of the current data row.

ForeColor

This member overrides Control.ForeColor.

HorizontalIndent

Horizontal margin between the border and the buttons.

ImageList

Gets or sets the ImageList to use when displaying button images without highlighting.

ImageListHighlight

Gets or sets the ImageList to use when displaying button images in highlighted state.

MoveDelayFirst

Time delay in milliseconds after pressing Next/Previous button before automatic scrolling begins.

MoveDelayNext

Time delay in milliseconds between row moves in automatic scrolling.

PageSize

Number of rows to skip when the user presses PageUp/Down.

Position

Gets or sets the current row position in the table (from 0 to RowCount - 1).

PositionVisible

Specifies whether the editable row position field and row captions are visible in the navigator.

RowCount

Returns the number of rows in the table.

ShowToolTips

Indicates whether tooltips are shown for the buttons.

TabStop

This member overrides Control.TabStop.

Text

Gets or sets value of the Position textbox.

UIStrings

Gets the collection of user interface strings.

VerticalAlign

Vertical alignment of navigator buttons.

VerticalIndent

Vertical margin between the border and the buttons.

VisibleButtons

Flags enumeration specifying which buttons are visible.

VisualStyle

Gets or sets the visual style of the control.

Methods

Name Description
BeginInit()

This method is for internal use only.

ClickButton(NavigatorButtonEnum)

Performs the action associated with a navigator button.

Dispose(bool)

Releases the resources used by the C1DbNavigator.

EndInit()

This method is for internal use only.

GetPreferredSize(Size)

Retrieves the size of a rectangular area into which a control can be fitted.

OnAdding(NavigatorAddingEventArgs)

This method is for internal use only.

OnBackColorChanged(EventArgs)

This method is for internal use only.

OnBeforeAction(NavigatorBeforeActionEventArgs)

This method is for internal use only.

OnButtonClick(NavigatorButtonClickEventArgs)

This method is for internal use only.

OnButtonCursorChanged(EventArgs)

This method is for internal use only.

OnDeleting(NavigatorDeletingEventArgs)

This method is for internal use only.

OnEditing(NavigatorEditingEventArgs)

This method is for internal use only.

OnEnabledChanged(EventArgs)

This method is for internal use only.

OnError(NavigatorErrorEventArgs)

This method is for internal use only.

OnForeColorChanged(EventArgs)

This method is for internal use only.

OnItemChanged(ItemChangedEventArgs)

This method is for internal use only.

OnLayout(LayoutEventArgs)
OnPositionChanged(EventArgs)

This method is for internal use only.

OnRefreshData(EventArgs)

This method is for internal use only.

OnRightToLeftChanged(EventArgs)

Raises C1.Win.C1Input.C1DbNavigator.RightToLeftChanged event.

OnTextChanged(EventArgs)

Raises the TextChanged event.

OnUpdateData(EventArgs)

This method is for internal use only.

OnVisualStyleChanged(EventArgs)

Invokes the VisualStyleChanged event.

ProcessDialogKey(Keys)
ResetBackColor()
ResetButtonCursor()

This method is for internal use only.

ResetButtonSize()

This method is for internal use only.

ResetButtonTexts()

This method is for internal use only.

ResetButtonToolTips()

This method is for internal use only.

ResetUIStrings()

This method is for internal use only.

ResetVisualStyle()

Resets VisualStyle to the default value.

ResetVisualStyleBaseStyle()

This method is for internal use only.

SetDataBinding(object, string)

Sets the DataSource and DataMember properties at run time.

ShouldSerializeButtonCursor()

This method is for internal use only.

ShouldSerializeButtonSize()

This method is for internal use only.

ShouldSerializeButtonTexts()

This method is for internal use only.

ShouldSerializeButtonToolTips()

This method is for internal use only.

ShouldSerializeUIStrings()

This method is for internal use only.

ShouldSerializeVisualStyle()

Tests whether VisualStyle should be serialized.

ShouldSerializeVisualStyleBaseStyle()

This method is for internal use only.

WndProc(ref Message)

This method is for internal use only.

Events

Name Description
Adding

Occurs when Add button is pressed.

BeforeAction

Occurs when a button is clicked, before the action is executed.

ButtonClick

Occurs when a navigator button has been pressed, after the button action is performed.

ButtonCursorChanged

Event fired when the value of ButtonCursor property is changed.

Deleting

Occurs when Delete button is pressed.

Editing

Occurs when Edit button is pressed.

Error

Occurs when an exceptions is thrown performing an action on button click.

ItemChanged

Occurs when the current row has been modified, some of its fields changed.

PositionChanged

Occurs when the Position has changed.

RefreshData

Occurs when Refresh button is pressed.

TextChanged

Occurs when the Text property value changes.

UpdateData

Occurs when Update button is pressed.

VisualStyleChanged

Occurs when the VisualStyle property has changed.