[]
        
(Showing Draft Content)

C1.Win.Input.Base.C1DropDownEditorBase

C1DropDownEditorBase Class

Represents a base drop-down control with text editor.

Namespace: C1.Win.Input.Base
Assembly: C1.Win.Input.8.dll
Syntax
public abstract class C1DropDownEditorBase : C1DropDownControlBase, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, IView, ISupportUia, ISupportInitialize, IDropDownOwner, ISupportUiaContainer, IDropDownEditorBase, IDropDownControlBase, IUiaExpandCollapseProvider

Constructors

Name Description
C1DropDownEditorBase(BaseThemeProvider)

Initializes a new instance of the C1DropDownEditorBase class.

Properties

Name Description
AcceptsEscape

Gets or sets a value indicates if the Escape key that cancels modified value is handled by the control without passing it to the owner form (AcceptsEscape=True), or it is then passed to the form and can close it if the form has CancelButton (AcceptsEscape=False).

AutoCompleteCustomSource

Gets or sets a custom StringCollection to use when the AutoCompleteSource property is set to CustomSource.

AutoCompleteMode

Gets or sets an option that controls how automatic completion works for the control.

AutoCompleteSource

Gets or sets a value specifying the source of complete strings used for automatic completion.

BorderStyle

Gets or sets the border type of the text box control.

CanUndo

Gets a value indicating whether the user can undo the previous operation in a drop down control.

CaseSensitive

Gets or sets a value indicating whether string comparisons are case-sensitive.

CharacterCasing

Gets or sets whether the drop down control modifies the case of characters as they are typed.

CultureInfo

Gets or sets the current CultureInfo object.

CustomFormat

Gets or sets custom format specified used if FormatType property is CustomFormat.

DataMember

Gets or sets the member of the data source object to which the control is bound.

DataSource

Gets or sets the data source object to which the control is bound.

DataType

Gets or sets the type of the Value property.

DisableOnNoData

Gets or sets whether the text box should be disabled when it is bound to an empty data source, i.e. CurrencyManager.Count = 0.

DisplayFormat

Format used to display the value when the control is in display mode.

DropDownStyle

Gets or sets the style of the drop down control.

EditFormat

Format used to display the value when the control is in edit mode (has input focus and is not read-only).

EmptyAsNull

Gets or sets a value indicating whether empty strings are interpreted as null values (DBNull).

ErrorInfo

Gets a settings affecting error handling in the control.

ExitOnLeftRightKey

Gets or sets whether the focus automatically moves to the previous or next control in the tab order when pressing the left or right arrow keys.

FloatingPlaceholderEnabled

Gets or sets the value indicating whether the floating placeholder is enabled.

FormatType

Gets or sets enumeration value determining the formatting method, including standard .NET format specifies, custom and programmatic formatting.

HideSelection

Gets or sets a value indicating whether the selected text in the drop down control remains highlighted when the control loses focus.

InitialSelection

Gets or sets a value determines the selection position when a control receives input focus.

MarkEmpty

Gets or sets a value that indicates need draws a red dotted line if Value is empty or not.

MaxLength

Gets or sets the maximum number of characters the user can type or paste into the drop down control.

MaxLengthUnit

Gets or sets whether the maximum number of characters that fit in the control are handled based on bytes, characters, or text elements.

NullText

Gets or sets string representing a DBNull value.

ParseInfo

Gets a settings affecting parsing, that is, converting the string entered by the user to the data type.

PasswordChar

Gets or sets the character used to mask characters of a password in a single-line drop down control.

Placeholder

Gets or sets the textual place holder, that is displayed by drop down control to prompt the user for information.

PostValidation

Gets a validation rules applied after parsing, that is, after converting the string entered by the user to the DataType (typed validation).

PreValidation

Gets the validation rules applied before parsing, that is, before converting the string entered by the user to the DataType (raw string validation).

ReadOnly

Gets or sets a value indicating whether the text in the edit control can be changed or not.

SelectedText

Gets or sets a value indicating the currently selected text in the control.

SelectionLength

Gets or sets the number of characters selected in the drop down control.

SelectionStart

Gets or sets the starting point of text selected in the drop down control.

ShortcutsEnabled

Gets or sets a value indicating whether the defined shortcuts are enabled.

Text

Gets or sets the text associated with this control.

TextAlign

Gets or sets how text is aligned in a drop down control.

TextLength

Gets the length of text in the control.

TrimEnd

Gets or sets a value indicating whether trailing spaces are removed.

TrimStart

Gets or sets a value indicating whether leading spaces are removed.

UseSystemPasswordChar

Gets or sets a value indicating whether the text in the drop down control should appear as the default password character.

Value

Gets or sets the current DataType representation of the visual information contained in the control.

VerticalAlign

Gets or sets the vertical alignment of the content in the control.

Methods

Name Description
BeginInit()

Signals the object that initialization is starting.

CheckValidationResult(ErrorReason, ref object, ErrorInfo)

Checks the result of the ParseContent method.

CreateUiaItem(UiaItem)

Creates UI Automation object of this control.

DisposeHostedControl()

Releases the HostedControl and unsubscribe from event handlers.

EndInit()

Signals the object that initialization is complete.

InitilizeView(IDropDownControlViewBase)

Initializes a view of the C1DropDownEditorBase control.

InternalWndProc(ref Message)

The edits window procedure of internal text editor. Inheriting classes can override this to add extra functionality.

OnDataTypeChanged(EventArgs)

Raises the DataTypeChanged event.

OnFormatError(FormatErrorEventArgs)

Raises the FormatError event.

OnFormatting(FormatEventArgs)

Raises the Formatting event.

OnHideSelectionChanged(EventArgs)

Raises the HideSelectionChanged event.

OnParsed(ParseEventArgs)

Raises the Parsed event.

OnParsing(ParseEventArgs)

Raises the Parsing event.

OnPostValidated(PostValidationEventArgs)

Raises the PostValidated event.

OnPostValidating(PostValidationEventArgs)

Raises the PostValidating event.

OnPreValidated(PreValidationEventArgs)

Raises the PreValidated event.

OnPreValidating(PreValidationEventArgs)

Raises the PreValidating event.

OnTabIndexChanged(EventArgs)
OnTextAlignChanged(EventArgs)

Raises the TextAlignChanged event.

OnValidationError(ValidationErrorEventArgs)

Raises the ValidationError event.

OnValueChanged(EventArgs)

Raises the ValueChanged event.

OnVerticalAlignChanged(EventArgs)

Raises the VerticalAlignChanged event.

OnVisibleChanged(EventArgs)
ParseContent(out object, ErrorInfo)

Parses the Text string.

ResetAutoCompleteCustomSource()

Restores the default value of the AutoCompleteCustomSource property.

ResetDisplayFormat()

Restores the default value of the DisplayFormat property.

ResetEditFormat()

Restores the default value of the EditFormat property.

ResetErrorInfo()

Restores the default value of the ErrorInfo property.

ResetInitialSelection()

Restores the default value of the InitialSelection property.

ResetParseInfo()

Restores the default value of the ParseInfo property.

ResetPostValidation()

Restores the default value of the PostValidation property.

ResetPreValidation()

Restores the default value of the PreValidation property.

ResetValue()

Restores the default value of the Value property.

Select(int, int)

Selects a range of text in the drop down control.

SelectAll()

Selects all text in the drop down control.

SetHostedControl(Control)

Sets the HostedControl and subscribe to event handlers.

ShouldSerializeAutoCompleteCustomSource()

Specifies whether to save the value of the AutoCompleteCustomSource property.

ShouldSerializeDisplayFormat()

Specifies whether to save the value of the DisplayFormat property.

ShouldSerializeEditFormat()

Specifies whether to save the value of the EditFormat property.

ShouldSerializeErrorInfo()

Specifies whether to save the value of the ErrorInfo property.

ShouldSerializeInitialSelection()

Specifies whether to save the value of the InitialSelection property.

ShouldSerializeParseInfo()

Specifies whether to save the value of the ParseInfo property.

ShouldSerializePostValidation()

Specifies whether to save the value of the PostValidation property.

ShouldSerializePreValidation()

Specifies whether to save the value of the PreValidation property.

ShouldSerializeValue()

Specifies whether to save the value of the Value property.

UpdateValueWithCurrentText()

Triggers parsing of the Text property and updating the Value.

ValidateText()

Validates current Text property in the same manner as it usually validated after the control loses focus.

Events

Name Description
DataTypeChanged

Occurs when the DataType property changes.

FormatError

Occurs when the control receives data that cannot be formatted according to the current format and edit mask settings.

Formatting

Formatting the value programmatically.

HideSelectionChanged

Occurs when the value of the HideSelection property has changed.

Parsed

Occurs after the input string value has been converted to the DataType.

Parsing

Occurs when the input string is parsed programmatically.

PostValidated

Occurs after the typed value has been validated

PostValidating

Occurs when programmatic typed value validating.

PreValidated

Occurs after the input string value has been validated.

PreValidating

Occurs when programmatic input string validating.

TextAlignChanged

Occurs when the value of the TextAlign property has changed.

ValidationError

Occurs when parsing or validating the input string fails.

ValueChanged

Occurs when the Value property changes.

VerticalAlignChanged

Occurs when the value of the VerticalAlign property changes.