[]
        
(Showing Draft Content)

C1.Win.C1Input.C1DropDownControl

C1DropDownControl Class

Represents a base drop-down control supporting up/down buttons.

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

Constructors

Name Description
C1DropDownControl()

Initializes a new instance of the C1DropDownControl class.

Properties

Name Description
AutoOpen

Gets or sets a value indicating whether to open the combo box when the control receives the focus.

ButtonCursor

The cursor that is displayed when the mouse is over a button.

ButtonImages

Gets or sets the images for buttons

ButtonWidth

Specifies the button width instead of using the default width.

ContentHeight
Cursor

Gets or sets the cursor that is displayed when the mouse pointer is over the control.

CustomAreaPlace

This property is for internal use only.

CustomAreaWidth

This property is for internal use only.

DefaultDropDownForm

This method is for internal use only.

DefaultDropDownFormClassName

Specifies form class that is used by default as the dropdown for the control.

DefaultSize

This method is for internal use only.

DefaultThemeRootPath

Default path

DropDownForm

Returns dropdown form instance associated with the control.

DropDownFormAlign

Alignment of the dropdown form relative to the control.

DropDownFormClassName

Specifies the class name of a Form serving as the dropdown window.

DropDownFormCreationTime

Determines the time when drop down form is created.

DropDownStyle

Gets or sets the style of the combo box.

DroppedDown

Run-time read-only property indicating if the dropdown is currently open.

GapHeight

Distance in pixels between the control edge and the dropdown.

Image

Gets or sets the button image.

ImageIndex

Gets or sets the index of the button image in the ImageList.

ImageKey

Gets or sets the key of the button image in the ImageList.

ImageList

Gets or sets the ImageList to get the images to display in the drop down items.

ImagePadding

Gets or sets the image padding.

ImagePlace

Has valid value only if ShowValueImage returns true.

ImageTransparentColor

Gets or sets the color to treat as transparent in a image.

InterceptArrowKeys

Determines if the up/down buttons intercept and handle Up and Down arrow keys.

MinSizeInternal

This method is for internal use only.

MouseClickPassThrough

Gets or sets whether the mouse click event is consumed or passed through after closing the dropdown.

ReadOnly
ShowCustomButton

Determines if the modal button is visible.

ShowDropDownButton

Determines if the dropdown button is visible.

ShowImage

Determines if image should be shown.

ShowModalButton

Determines if the modal button is visible.

ShowUpDownButtons

Determines if the up/down buttons are visible.

UpDownButtonAlignment

Gets or sets the alignment of the spin button.

VisibleButtons

Gets or sets a value specifying which buttons are visible. The default is (UpDown Or DropDown).

Methods

Name Description
CalcSizeInternal()

This method is for internal use only.

CloseDropDown()

Closes the dropdown.

CloseDropDown(bool)

Closes the dropdown.

CreateAccessibilityInstance()
Dispose(bool)

Releases the resources used by the C1DropDownControl.

DrawCustomArea(Graphics)

This method is for internal use only.

DrawImage(Graphics, Rectangle)

Draws image in the control.

DrawImage(Graphics, IntPtr, Rectangle)

Draws image in the control.

GetImageSize()

Returns image size.

OnBeforeDropDownOpen(CancelEventArgs)
OnButtonCursorChanged(EventArgs)

This method is for internal use only.

OnClick(EventArgs)
OnCreateDropDownFrom(DropDownForm)

Called when a drop down form is created.

OnCursorChanged(EventArgs)

This method is for internal use only.

OnCustomButtonClick(EventArgs)

This method is for internal use only.

OnDropDownAlignChanged(EventArgs)

This method is for internal use only.

OnDropDownClosed(DropDownClosedEventArgs)

This method is for internal use only.

OnDropDownFormAlignChanged(EventArgs)

This method is for internal use only.

OnDropDownOpened(EventArgs)

This method is for internal use only.

OnDropDownOpening(EventArgs)

This method is for internal use only.

OnDropDownStyleChanged()
OnEnabledChanged(EventArgs)

This method is for internal use only.

OnGotFocus(EventArgs)

This method is for internal use only.

OnInvalidated(InvalidateEventArgs)
OnLostFocus(EventArgs)

This method is for internal use only.

OnModalButtonClick(EventArgs)

This method is for internal use only.

OnMouseLeave(EventArgs)

This method is for internal use only.

OnMouseMove(MouseEventArgs)

This method is for internal use only.

OnMouseWheel(MouseEventArgs)

This method is for internal use only.

OnReadOnlyChanged(EventArgs)

This method is for internal use only.

OnTextChanged(EventArgs)

This method is for internal use only.

OnUpDownButtonClick(UpDownButtonClickEventArgs)

This method is for internal use only.

OnValueChanged(EventArgs)

This method is for internal use only.

OpenDropDown()

Shows the dropdown.

PreProcessMessage(ref Message)

This method is for internal use only.

ProcessKeyDown(KeyEventArgs)

This method is for internal use only.

ProcessKeyPress(KeyPressEventArgs)

This method is for internal use only.

ProcessKeyUp(KeyEventArgs)

This method is for internal use only.

ResetButtonCursor()

This method is for internal use only.

ResetButtonImages()

This method is for internal use only.

ResetDropDownFormClassName()

This method is for internal use only.

SetProposedValue(object)

This method works exactly as setting the Value property, except that it does not change the internal variable storing the value before editing, so the user can press Esc and restore the previous value. This method works only in edit or DropDownList mode. If the control is not in edit or DropDownList mode, this methods does nothing.

ShouldDrawPlaceholder()

Indicates whether the placeholder should be drawn.

ShouldHandleEscape()

This method is for internal use only.

ShouldSerializeButtonCursor()

This method is for internal use only.

ShouldSerializeButtonImages()

This method is for internal use only.

ShouldSerializeDropDownFormClassName()

This method is for internal use only.

SpinDown()

Performs the spin down action.

SpinUp()

Performs the spin up action.

WndProc(ref Message)

This method is for internal use only.

Events

Name Description
BeforeDropDownOpen

Occurs just before the dropdown is opened.

ButtonCursorChanged

Event fired when the value of ButtonCursor property is changed.

CustomButtonClick

Occurs when the Custom button is clicked.

DropDownAlignChanged

Occurs when the value of the DropDownAlign property has changed.

DropDownClosed

Occurs when the dropdown has been closed.

DropDownFormAlignChanged

Occurs when the value of the DropDownFormAlign property has changed.

DropDownOpened

Occurs after the dropdown is opened.

DropDownOpening

Occurs just before the dropdown is opened.

ModalButtonClick

Occurs when the Modal button is clicked.

UpDownButtonClick

Occurs when UpDown buttons are clicked.