Back to Devexpress

ButtonEdit.ButtonPressed Event

windowsforms-devexpress-dot-xtraeditors-dot-buttonedit-359b7da8.md

latest3.8 KB
Original Source

ButtonEdit.ButtonPressed Event

Occurs when pressing an editor button.

Namespace : DevExpress.XtraEditors

Assembly : DevExpress.XtraEditors.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

csharp
[DXCategory("Events")]
public event ButtonPressedEventHandler ButtonPressed
vb
<DXCategory("Events")>
Public Event ButtonPressed As ButtonPressedEventHandler

Event Data

The ButtonPressed event's data class is ButtonPressedEventArgs. The following properties provide information specific to this event:

PropertyDescription
ButtonGets the button being pressed/clicked.

Remarks

Write a ButtonPressed event handler to perform actions in response to pressing an editor button.

The editor’s ButtonPressed event is equivalent to the RepositoryItemButtonEdit.ButtonPressed event available via the ButtonEdit.Properties object, i.e. adding/removing an event handler for the current event actually affects the RepositoryItemButtonEdit.ButtonPressed event.

Refer to the RepositoryItemButtonEdit.ButtonPressed topic for more information.

Example

The following code shows a ButtonEdit.ButtonPressed event handler for a button edit control.
When the end-user presses the first button (button with index 0), the handler activates a custom dialog of class Form2. The form’s constructor requires an edit value which will be edited in the dialog. After the form is successfully closed, the modified value is retrieved via the EditingValue property and assigned back to the editor’s edit value.

csharp
using DevExpress.XtraEditors.Controls;

private void buttonEdit1_ButtonPressed(object sender, ButtonPressedEventArgs e) {
    ButtonEdit editor = (ButtonEdit)sender;
    int buttonIndex = editor.Properties.Buttons.IndexOf(e.Button);
    if (buttonIndex == 0) {
      using(var form = new Form2(editor.EditValue)) {
          if(form.ShowDialog(this) == DialogResult.OK)
              editor.EditValue = form.EditingValue;
      }
    }
}
vb
Private Sub ButtonEdit1_ButtonPressed(ByVal sender As Object, _
 ByVal e As DevExpress.XtraEditors.Controls.ButtonPressedEventArgs) _
 Handles ButtonEdit1.ButtonPressed
    Dim Editor As ButtonEdit = CType(sender, ButtonEdit)
    Dim buttonIndex As Integer = Editor.Properties.Buttons.IndexOf(e.Button)
    If buttonIndex = 0 Then
        Using form = New Form2(editor.EditValue)
            If form.ShowDialog(Me) = DialogResult.OK Then
                editor.EditValue = form.EditingValue
            End If
        End Using
    End If
End Sub

See Also

ButtonPressed

ButtonClick

ButtonEdit Class

ButtonEdit Members

DevExpress.XtraEditors Namespace