EditorButton.Kind Property

Gets or sets the type of image to display within the button.

Namespace: DevExpress.XtraEditors.Controls

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(ButtonPredefines.Ellipsis)]
[DXCategory("Appearance")]
public virtual ButtonPredefines Kind { get; set; }

VB.NET

<DefaultValue(ButtonPredefines.Ellipsis)>
<DXCategory("Appearance")>
Public Overridable Property Kind As ButtonPredefines

Property Value

Type	Default	Description
ButtonPredefines	Ellipsis	A ButtonPredefines enumerator value that specifies the type of image to display within the button.

Available values:

Show 22 items

Name	Description
Glyph	A custom bitmap is drawn on the button’s surface.
Down	A Down-arrow is drawn on the button’s surface.
Up	An Up-arrow is drawn on the button’s surface.
Left	A Left-arrow symbol is drawn on the button’s surface.
Right	A Right-arrow is drawn the button’s surface.
Ellipsis	An Ellipsis symbol is drawn on the button’s surface.
Delete	A Delete symbol is drawn on the button’s surface.
OK	An OK sign is drawn on the button’s surface.
Plus	A Plus sign is drawn on the button’s surface.
Minus	A Minus sign is drawn on the button’s surface.
Redo	A Redo symbol is drawn on the button’s surface.
Undo	An Undo symbol is drawn on the button’s surface.
Combo	A Down-arrow for a combo box is drawn on the button’s surface.
SpinUp	An up-arrow for a spin editor is displayed on the button’s surface.
SpinDown	A down-arrow for a spin editor is displayed on the button’s surface.
SpinLeft	A left-arrow for a spin editor is displayed on the button’s surface.
SpinRight	A right-arrow for a spin editor is displayed on the button’s surface.
Close	A Close symbol is displayed on the button’s surface.
DropDown	A Down-arrow is drawn on the button’s surface. Unlike, the Down button, this kind of button allows text to be displayed next to the down-arrow.
Search	A Search symbol is drawn on the button’s surface.
Clear	A Clear symbol is drawn on the button’s surface.
Separator	A Separator.

Remarks

The Kind property allows you to specify the type of image to display within the button. The ButtonPredefines type enumerates possible image types. Setting the Kind property to Glyph allows you to display a custom image specified by the EditorButton.Image property. If Kind is set to a value other than Glyph, the button displays a predefined image. See the ButtonPredefines topic for sample screenshots.

If the Kind property is set to Glyph, Ellipsis, Delete, OK, Plus, Minus, Redo, Undo or DropDown, it is possible to display the button’s EditorButton.Caption near the image. To allow the display of the button’s caption and image at the same time, set the EditorButton.ImageLocation property to any value except for MiddleCenter. Otherwise, only the image is displayed.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Kind property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-tab-control-display-header-buttons/CS/XtraTabWithButtons/Form1.cs#L40

    XtraTabPageDescendant xtraPage = sender as XtraTabPageDescendant;
    MessageBox.Show(string.Format("PageName {0}, click on button {1} kind {2}", xtraPage.Name, e.Button.Index, e.Button.Kind));
}

winforms-tab-control-custom-header-buttons/CS/XtraTabControl_CustomButtons/Form1.cs#L22

void xtraTabControl1_CustomHeaderButtonClick(object sender, CustomHeaderButtonEventArgs e) {
    if (e.Button.Kind == ButtonPredefines.Plus)
        OnAddImageBtnClick();

winforms-grid-customize-find-panel/CS/MyXtraGrid/MyFindControl.cs#L50

{
    if (e.Button.Kind == ButtonPredefines.Ellipsis)
        using (Form form = new Form())

winforms-layoutcontrol-show-ui-controls-in-tabbed-group-header/CS/Form1.cs#L32

riBE.TextEditStyle = DevExpress.XtraEditors.Controls.TextEditStyles.HideTextEditor;
riBE.Buttons[0].Kind = DevExpress.XtraEditors.Controls.ButtonPredefines.Glyph;
riBE.Buttons[0].Caption = "Test";

winforms-lookup-add-empty-item/CS/Form1.cs#L31

private void repositoryItemLookUpEdit1_ButtonClick(object sender, DevExpress.XtraEditors.Controls.ButtonPressedEventArgs e) {
    if(e.Button.Kind == DevExpress.XtraEditors.Controls.ButtonPredefines.Delete) {
        LookUpEdit editor = (LookUpEdit)sender;

VB.NET

winforms-tab-control-display-header-buttons/VB/XtraTabWithButtons/Form1.vb#L34

    Dim xtraPage As XtraTabPageDescendant = TryCast(sender, XtraTabPageDescendant)
    MessageBox.Show(String.Format("PageName {0}, click on button {1} kind {2}", xtraPage.Name, e.Button.Index, e.Button.Kind))
End Sub

winforms-tab-control-custom-header-buttons/VB/XtraTabControl_CustomButtons/Form1.vb#L25

Private Sub xtraTabControl1_CustomHeaderButtonClick(ByVal sender As Object, ByVal e As CustomHeaderButtonEventArgs)
    If e.Button.Kind = ButtonPredefines.Plus Then OnAddImageBtnClick()
    If e.Button.Kind = ButtonPredefines.Minus Then OnRemoveImageClick()

winforms-grid-customize-find-panel/VB/MyXtraGrid/MyFindControl.vb#L46

Private Sub be_ButtonClick(ByVal sender As Object, ByVal e As ButtonPressedEventArgs)
    If e.Button.Kind = ButtonPredefines.Ellipsis Then
        Using form As Form = New Form()

winforms-layoutcontrol-show-ui-controls-in-tabbed-group-header/VB/Form1.vb#L32

riBE.TextEditStyle = DevExpress.XtraEditors.Controls.TextEditStyles.HideTextEditor
riBE.Buttons(0).Kind = DevExpress.XtraEditors.Controls.ButtonPredefines.Glyph
riBE.Buttons(0).Caption = "Test"

winforms-lookup-add-empty-item/VB/Form1.vb#L28

Private Sub repositoryItemLookUpEdit1_ButtonClick(ByVal sender As Object, ByVal e As DevExpress.XtraEditors.Controls.ButtonPressedEventArgs)
    If e.Button.Kind = DevExpress.XtraEditors.Controls.ButtonPredefines.Delete Then
        Dim editor As LookUpEdit = CType(sender, LookUpEdit)