Créer des boutons de commande personnalisés

Aspose.Cells.GridWeb contient des boutons spéciaux commeNous faire parvenir, Sauver etannuler. Tous ces boutons effectuent des tâches spécifiques pour Aspose.Cells.GridWeb. Il est également possible d’ajouter des boutons personnalisés qui effectuent des tâches personnalisées. Cette rubrique explique comment utiliser cette fonctionnalité.

Création de boutons de commande personnalisés

Pour créer un bouton de commande personnalisé dans Aspose.Cells.GridWeb :

1. Ajoutez le contrôle Aspose.Cells.GridWeb au formulaire Web.
2. Accéder à une feuille de calcul.
3. Créez une instance de la classe CustomCommandButton.
4. Définissez la commande du bouton sur une certaine valeur. Cette valeur est utilisée dans le gestionnaire d’événements du bouton.
5. Définissez le texte du bouton.
6. Définissez l’URL de l’image du bouton.
7. Enfin, ajoutez l’objet CustomCommandButton à la collection CustomCommandButtons du contrôle GridWeb.

Des boutons de commande personnalisés peuvent également être ajoutés en mode WYSIWYG à l’aide de la boîte de dialogue Propriétés de Visual Studio.

La sortie de l’extrait de code est illustrée ci-dessous :

Un bouton de commande personnalisé ajouté au contrôle GridWeb

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Instantiating a CustomCommandButton object
CustomCommandButton button = new CustomCommandButton();

// Setting the command, text and image URL for button. Image should be relative to website root folder
button.Command = "MyButton";
button.Text = "MyButton";
button.ImageUrl = "../Image/aspose.ico";
    
// Adding button to CustomCommandButtons collection of GridWeb
GridWeb1.CustomCommandButtons.Add(button);

Gestion des événements du bouton de commande personnalisé

L’aspect le plus important des boutons de commande personnalisés est l’action qu’ils effectuent lorsqu’ils sont cliqués. Pour définir l’action, créez un gestionnaire d’événements pour l’événement CustomCommand du contrôle GridWeb.

L’événement CustomCommand est toujours déclenché lorsqu’un bouton de commande personnalisé est cliqué. Ainsi, le gestionnaire d’événements doit identifier le bouton de commande personnalisé spécifique auquel il s’applique par le jeu de commandes lors de l’ajout du bouton au contrôle GridWeb. Enfin, ajoutez un code personnalisé qui est exécuté lorsque le bouton est cliqué.

Dans l’exemple de code ci-dessous, un message texte est ajouté à la cellule A1 lorsque le bouton est cliqué.

Texte ajouté à la cellule A1 lorsque le bouton de commande personnalisé est cliqué

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Creating Event Handler for CustomCommand event
protected void GridWeb1_CustomCommand(object sender, string command)
{
    // Identifying a specific button by checking its command
    if (command.Equals("MyButton"))
    {
        // Accessing the cells collection of the worksheet that is currently active
        GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

        // Putting value to "A1" cell
        sheet.Cells["A1"].PutValue("My Custom Command Button is Clicked.");

        // Set first column width to make the text visible
        sheet.Cells.SetColumnWidth(0, 30);
    }
}