SimpleButton.Command Property

Gets or sets the command that is executed when a user taps the button. This is a bindable property.

Namespace: DevExpress.Maui.Controls

Assembly: DevExpress.Maui.Controls.dll

NuGet Package: DevExpress.Maui.Controls

Declaration

public ICommand Command { get; set; }

Property Value

Type	Description
ICommand	A command that exposes the ICommand interface.

Remarks

Use the Command property to set the action that occurs when a user taps the button. The CommandParameter property allows you to pass data to the Command.

You can also use the Clicked event to define the action on button tap.

Example

This example shows how to create a custom command with a parameter and execute it when a user taps the button.

1. In a view model, create a command that implements the ICommand interface:

   C#

   using System.ComponentModel;
   using System.Windows.Input;
   
   namespace TestICommand.ViewModels {
       public class ValidationCommand : ICommand {
           public event EventHandler CanExecuteChanged;
   
           MainViewModel viewModel;
           public ValidationCommand(MainViewModel viewModel) {
               this.viewModel = viewModel;
           }
   
           public bool CanExecute(object Login) {
               if (string.IsNullOrEmpty((string)Login) || Login == null) {
                   viewModel.ValidationResultText = "Login cannot be empty";
                   viewModel.TextHasError = true;
                   return false;
               }
               viewModel.ValidationResultText = "";
               viewModel.TextHasError = false;
               return true;            
           }
   
           public void Execute(object Login) {
               viewModel.ValidationResultText = $"Login {Login} is correct";
           }
       }
   
       public class MainViewModel : INotifyPropertyChanged {
           public MainViewModel() {
               buttonCommand = new ValidationCommand(this);
           }
   
           ICommand buttonCommand = null;
           public ICommand ButtonCommand {
               get { return buttonCommand; }
               set { 
                   if (buttonCommand != value) {
                       buttonCommand = value;
                       OnPropertyChanged("ButtonCommand");
                   }
               }
           }
   
           public event PropertyChangedEventHandler PropertyChanged;
           protected void OnPropertyChanged(string name) {
               PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(name));
           }
   
           bool textHasError = false;
           public bool TextHasError {
               get { return textHasError; }
               set { 
                   if (textHasError != value) {
                       textHasError = value;
                       OnPropertyChanged("TextHasError");
                   }
               }
           }
   
           string validationResultText = "";
           public string ValidationResultText {
               get { return validationResultText; }
               set { 
                   validationResultText = value;
                   OnPropertyChanged("ValidationResultText");
               }
           }
       }
   }
   

2. Bind the specified command to the Command property and define the CommandParameter value:

   XAML

   <ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
           xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
           xmlns:local="clr-namespace:TestICommand"
           xmlns:vm="clr-namespace:TestICommand.ViewModels"
           xmlns:dxco="clr-namespace:DevExpress.Maui.Controls;assembly=DevExpress.Maui.Controls"
           x:Class="TestICommand.MainPage">
       <ContentPage.BindingContext>
           <vm:MainViewModel/>
       </ContentPage.BindingContext>
       <StackLayout>
           <dxe:TextEdit x:Name="TextEditor" 
                         HasError="{Binding TextHasError}"/>
   
           <dxco:SimpleButton x:Name="MyButton" 
                             Text="Check"
                             Command="{Binding ButtonCommand}"
                             CommandParameter="{Binding Source={x:Reference TextEditor}, Path=Text}"/>
   
           <Label Text="{Binding ValidationResultText}"
                  HorizontalOptions="Center"/>    
       </StackLayout>
   </ContentPage>