DropDownButton Properties
The button that can be associated with a popup control or a context menu. It is possible to prevent the button from receiving focus on a click.| Name | Description |
|---|---|
| AccessibilityObject | Gets the AccessibleObject assigned to the control. Inherited from Control. |
| AccessibleDefaultActionDescription | Gets or sets the default action description of the control for use by accessibility client applications. Inherited from Control. |
| AccessibleDescription | Gets or sets the description of the control used by accessibility client applications. Inherited from Control. |
| AccessibleName | Gets or sets the name of the control used by accessibility client applications. Inherited from Control. |
| AccessibleRole | Gets or sets the accessible role of the control. Inherited from Control. |
| ActAsDropDown |
Gets or sets whether a click on the button opens the dropdown control. This option is in effect when the DropDownButton.DropDownArrowStyle property is set to DropDownArrowStyle.Hide.
|
| AllowDrop | Gets or sets a value indicating whether the control can accept data that the user drags onto it. Inherited from Control. |
| AllowFocus | Gets or sets whether the button can be focused. Inherited from SimpleButton. |
| AllowGlyphSkinning | Gets or sets whether the current SimpleButton icon should be painted with the button’s fore color. Inherited from SimpleButton. |
| AllowHtmlDraw | Gets or sets whether the current SimpleButton‘s caption can be formatted using HTML-tags. Inherited from SimpleButton. |
| AllowHtmlTextInToolTip | Gets or sets whether HTML formatting is allowed in the control’s regular tooltips. Inherited from BaseControl. |
| Anchor | Gets 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. |
| Appearance | Gets the appearance settings used to paint the control’s contents. Inherited from BaseStyleControl. |
| AppearanceDisabled | Provides access to the appearance settings applied when the current button is disabled. Inherited from BaseButton. |
| AppearanceDropDown | Provides access to the appearance settings used to paint the drop-down button. |
| AppearanceDropDownDisabled | Provides access to the appearance settings applied to the drop-down button when the current control is disabled. |
| AppearanceDropDownHovered | Provides access to the appearance settings applied to the drop-down button when it is hovered over with the mouse pointer. |
| AppearanceDropDownPressed | Provides access to the appearance settings applied to the drop-down button when it is clicked. |
| AppearanceHovered | Provides access to the appearance settings applied when the mouse pointer passes over the current button. Inherited from BaseButton. |
| AppearancePressed | Provides access to the appearance settings applied when the current button is clicked. Inherited from BaseButton. |
| AutoScrollOffset | Gets or sets where this control is scrolled to in ScrollControlIntoView(Control). Inherited from Control. |
| AutoSize | Gets or sets whether the control’s size is automatically calculated based on its contents. Inherited from SimpleButton. |
| AutoSizeInLayoutControl | This member is not supported for the SimpleButton control. Use the SimpleButton.AutoWidthInLayoutControl property instead. Inherited from SimpleButton. |
| AutoWidthInLayoutControl | Gets or sets whether the control’s width is changed to display the control’s content in its entirety. This property is in effect when the control resides within a LayoutControl. Inherited from SimpleButton. |
| BackColor | Gets or sets the button’s background color. Inherited from BaseButton. |
| BackgroundImage | Gets or sets the background image displayed in the control. Inherited from Control. |
| BackgroundImageLayout | Gets or sets the background image layout as defined in the ImageLayout enumeration. Inherited from Control. |
| BindingContext | Gets or sets the BindingContext for the control. Inherited from Control. |
| BorderStyle | This member is not supported. Inherited from BaseButton. |
| 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. |
| ButtonStyle | Gets or sets the style of the button control. Inherited from BaseButton. |
| CanEnableIme protected | Gets a value indicating whether the ImeMode property can be set to an active value, to enable IME support. Inherited from Control. |
| CanFocus | Gets a value indicating whether the control can receive focus. Inherited from Control. |
| CanRaiseEvents protected | Determines if events can be raised on the control. Inherited from Control. |
| 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. |
| CausesValidation | Gets 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. |
| CheckForIllegalCrossThreadCalls static | Gets or sets a value indicating whether to catch calls on the wrong thread that access a control’s Handle property when an application is being debugged. Inherited from Control. |
| ClientRectangle | Gets the rectangle that represents the client area of the control. Inherited from Control. |
| ClientSize | Gets or sets the height and width of the client area of the control. Inherited from Control. |
| Command |
Gets or sets the ICommand whose Execute(Object) method will be called when the Click event is invoked.
Inherited from BaseButton. |
| CommandParameter |
Gets or sets the parameter that is passed to the command specified by the Command property.
Inherited from BaseButton. |
| CompanyName | Gets the name of the company or creator of the application containing the control. Inherited from Control. |
| Container | Gets the IContainer that contains the Component. Inherited from Component. |
| ContainsFocus | Gets a value indicating whether the control, or one of its child controls, currently has the input focus. Inherited from Control. |
| ContextMenu | This member is not supported by the DropDownButton class. |
| ContextMenuStrip | Gets or sets the ContextMenuStrip associated with this control. Inherited from Control. |
| Controls | Gets the collection of controls contained within the control. Inherited from Control. |
| Created | Gets a value indicating whether the control has been created. Inherited from Control. |
| Cursor | Gets or sets the cursor that is displayed when the mouse pointer is over the ControlBase control. Inherited from ControlBase. |
| DataBindings | Gets the data bindings for the control. Inherited from Control. |
| DefaultBackColor static | Gets the default background color of the control. Inherited from Control. |
| DefaultCursor protected | Gets or sets the default cursor for the control. Inherited from Control. |
| DefaultFont static | Gets the default font of the control. Inherited from Control. |
| DefaultForeColor static | Gets the default foreground color of the control. Inherited from Control. |
| DefaultImeMode protected | Gets the default Input Method Editor (IME) mode supported by the control. Inherited from Control. |
| DefaultMargin protected | Gets the space, in pixels, that is specified by default between controls. Inherited from Control. |
| DefaultMaximumSize protected | Gets the length and height, in pixels, that is specified as the default maximum size of a control. Inherited from Control. |
| DefaultMinimumSize protected | Gets the length and height, in pixels, that is specified as the default minimum size of a control. Inherited from Control. |
| DefaultPadding protected | Gets the internal spacing, in pixels, of the contents of a control. Inherited from Control. |
| DesignMode protected | Gets a value that indicates whether the Component is currently in design mode. Inherited from Component. |
| DialogResult | Gets or sets a value that is returned to the parent form when the button is clicked. Inherited from BaseButton. |
| DisplayRectangle | Gets the rectangle that represents the display area of the control. Inherited from Control. |
| Disposing | Gets a value indicating whether the base Control class is in the process of disposing. Inherited from Control. |
| Dock | Gets or sets which control borders are docked to its parent control and determines how a control is resized with its parent. Inherited from Control. |
| DoubleBuffered protected | Gets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker. Inherited from Control. |
| DropDownArrowStyle | Gets or sets whether and how a dropdown arrow is displayed within the DropDownButton. |
| DropDownButtonPadding | Gets or sets the interior spacing of the separate button displaying the drop-down arrow. This property is in effect if DropDownButton.DropDownArrowStyle is set to SplitButton. |
| DropDownControl | Gets or sets the popup control for the button. |
| Enabled | Gets or sets a value indicating whether the control can respond to user interaction. Inherited from Control. |
| Events protected | 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 the control’s content. Inherited from BaseStyleControl. |
| FontHeight protected | Gets or sets the height of the font of the control. Inherited from Control. |
| ForeColor | Gets or sets the control’s foreground color. Inherited from BaseStyleControl. |
| GlyphAlignment | Obsolete. Gets or sets the alignment of the image displayed within the button. Inherited from SimpleButton. |
| Handle | Gets the window handle that the control is bound to. Inherited from Control. |
| HasChildren | Gets a value indicating whether the control contains one or more child controls. Inherited from Control. |
| Height | Gets or sets the height of the control. Inherited from Control. |
| Image | Gets or sets the button’s image. Inherited from SimpleButton. |
| ImageAlignment | Obsolete. Gets or sets the alignment of the image displayed within the button. Inherited from SimpleButton. |
| ImageIndex | Gets or sets the index of the image displayed on the button. Inherited from SimpleButton. |
| ImageList | Gets or sets the source of images to be displayed within the button. Inherited from SimpleButton. |
| ImageLocation | Specifies the image alignment relative to the button. Inherited from SimpleButton. |
| ImageOptions | Provides access to all properties that allow you to assign and customize an icon for this SimpleButton. Inherited from SimpleButton. |
| ImageToTextAlignment | Gets or sets how the button’s image is aligned relative to the button’s text. Inherited from SimpleButton. |
| ImageToTextIndent | Gets or sets the ditance between the button’s image and text. This property is in effect if the button’s image is aligned relative to the text. Inherited from SimpleButton. |
| ImageUri |
Gets or sets the uniform resource identifier of the image in the DX Image Gallery displayed in the current button. A specific version of the addressed image is automatically chosen based on the app context (the current skin and required image size). Inherited from SimpleButton. |
| ImeMode | Gets or sets the Input Method Editor (IME) mode of the control. Inherited from Control. |
| ImeModeBase protected | Gets or sets the IME mode of a control. Inherited from Control. |
| InvokeRequired | Gets 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. |
| IsAccessible | Gets or sets a value indicating whether the control is visible to accessibility applications. Inherited from Control. |
| IsDesignMode | Gets a value indicating whether the control is currently in design mode. Inherited from BaseControl. |
| IsDisposed | Gets a value indicating whether the control has been disposed of. Inherited from Control. |
| IsHandleCreated | Gets a value indicating whether the control has a handle associated with it. Inherited from Control. |
| IsLoading | Gets whether the control is being initialized. Inherited from BaseControl. |
| IsMirrored | Gets a value indicating whether the control is mirrored. Inherited from Control. |
| IsOpened | Gets whether the associated popup control is currently open. |
| IsRightToLeft | Gets whether the ControlBase‘s visual elements are actually aligned to support locales using right-to-left fonts. Inherited from ControlBase. |
| LayoutEngine | Gets a cached instance of the control’s layout engine. Inherited from Control. |
| 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. |
| LookAndFeel | Provides access to the object containing the control’s look and feel settings. Inherited from BaseControl. |
| Margin | Gets or sets the space between controls. Inherited from Control. |
| MaximumSize | Gets or sets the size that is the upper limit that GetPreferredSize(Size) can specify. Inherited from Control. |
| MenuManager | Gets or sets an object that manages the display of the associated popup control . |
| MinimumSize | Gets or sets the size that is the lower limit that GetPreferredSize(Size) can specify. Inherited from Control. |
| ModifierKeys static | Gets a value indicating which of the modifier keys (SHIFT, CTRL, and ALT) is in a pressed state. Inherited from Control. |
| MouseButtons static | Gets a value indicating which of the mouse buttons is in a pressed state. Inherited from Control. |
| MousePosition static | Gets the position of the mouse cursor in screen coordinates. Inherited from Control. |
| Name | Gets or sets the name of the control. Inherited from Control. |
| Padding | Gets or sets padding within the control. Inherited from Control. |
| PaintStyle | Gets or sets the button’s paint style. Inherited from BaseButton. |
| Parent | Gets or sets the parent container of the control. Inherited from Control. |
| 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. |
| ProductVersion | Gets the version of the assembly containing the control. Inherited from Control. |
| PropagatingImeMode protected static | Gets an object that represents a propagating IME mode. Inherited from Control. |
| RecreatingHandle | Gets a value indicating whether the control is currently re-creating its handle. Inherited from Control. |
| Region | Gets or sets the window region associated with the control. Inherited from Control. |
| RenderRightToLeft protected | This property is now obsolete. Inherited from Control. |
| ResizeRedraw protected | Gets or sets a value indicating whether the control redraws itself when resized. 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 protected | Gets a value that determines the scaling of child controls. Inherited from Control. |
| ScaleFactor | Returns scale multipliers that are currently applied to a control’s original width and height. Inherited from BaseControl. |
| ShowArrowButton | Obsolete. Gets or sets whether the drop-down arrow is displayed as a part of the DropDownButton control. |
| ShowFocusCues protected | Gets a value indicating whether the control should display focus rectangles. Inherited from Control. |
| ShowFocusRectangle | Gets or sets whether the dotted focus rectangle is displayed within the SimpleButton when it has focus. Inherited from SimpleButton. |
| ShowKeyboardCues protected | Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators. Inherited from Control. |
| ShowToolTips | Gets or sets whether a tooltip should be displayed when the mouse pointer is over the control. Inherited from BaseControl. |
| Site | Gets or sets the site of the control. Inherited from Control. |
| Size | Gets or sets the height and width of the control. Inherited from Control. |
| StyleController | Gets or sets the style controller component that provides style settings for this control. Inherited from BaseControl. |
| SuperTip | Gets or sets a SuperToolTip for the current control. Inherited from BaseControl. |
| 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 this control using the TAB key. Inherited from Control. |
| Tag | Gets or sets the object that contains data about the control. Inherited from Control. |
| Text | Gets or sets the text string displayed within the button control. Inherited from SimpleButton. |
| ToolTip | Gets or sets a regular tooltip’s text content. Inherited from BaseControl. |
| ToolTipAnchor | Gets or sets whether the tooltip is anchored relative to the mouse pointer or the button. Inherited from BaseButton. |
| ToolTipController | Gets or sets the tooltip controller component that controls the appearance, position and content of hints displayed for this control. Inherited from BaseControl. |
| ToolTipIconType | Gets or sets the type of the tooltip icon. Inherited from BaseControl. |
| ToolTipTitle | Gets or sets a regular tooltip’s title. Inherited from BaseControl. |
| 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. |
| TopLevelControl | Gets 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. |
| UseWaitCursor | Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls. Inherited from Control. |
| Visible | Gets or sets a value indicating whether the control and all its child controls are displayed. Inherited from Control. |
| Width | Gets or sets the width of the control. Inherited from Control. |
| WindowTarget | This property is not relevant for this class. Inherited from Control. |
See Also