Erstellen benutzerdefinierter Befehlsschaltflächen

Aspose.Cells.GridWeb enthält spezielle Schaltflächen wie Senden, Speichern und Rückgängig machen. All diese Schaltflächen führen spezifische Aufgaben für Aspose.Cells.GridWeb aus. Es ist auch möglich, benutzerdefinierte Schaltflächen hinzuzufügen, die benutzerdefinierte Aufgaben ausführen. In diesem Artikel wird erläutert, wie diese Funktion verwendet wird.

Erstellen von benutzerdefinierten Befehlsschaltflächen

Um eine benutzerdefinierte Befehlsschaltfläche in Aspose.Cells.GridWeb zu erstellen:

1. Fügen Sie dem Webformular das Aspose.Cells.GridWeb-Steuerelement hinzu.
2. Greifen Sie auf ein Arbeitsblatt zu.
3. Erstellen Sie eine Instanz der Klasse CustomCommandButton.
4. Legen Sie den Befehl der Schaltfläche auf einen bestimmten Wert fest. Dieser Wert wird im Ereignishandler der Schaltfläche verwendet.
5. Legen Sie den Text der Schaltfläche fest.
6. Legen Sie die URL des Schaltflächenbilds fest.
7. Fügen Sie schließlich das Objekt CustomCommandButton zur CustomCommandButtons-Sammlung des GridWeb-Steuerelements hinzu.

Benutzerdefinierte Befehlsschaltflächen können auch im WYSIWYG-Modus über das Eigenschaftenfenster von Visual Studio hinzugefügt werden.

Die Ausgabe des Code-Snippets wird unten angezeigt:

Eine benutzerdefinierte Befehlsschaltfläche wurde zum GridWeb-Steuerelement hinzugefügt

// 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);

Eventbehandlung der benutzerdefinierten Befehlsschaltfläche

Der wichtigste Aspekt von benutzerdefinierten Befehlsschaltflächen ist die Aktion, die sie ausführen, wenn darauf geklickt wird. Um die Aktion einzustellen, erstellen Sie einen Ereignishandler für das CustomCommand-Ereignis des GridWeb-Steuerelements.

Das CustomCommand-Ereignis wird immer ausgelöst, wenn auf eine benutzerdefinierte Befehlsschaltfläche geklickt wird. Der Ereignishandler muss also die spezifische benutzerdefinierte Befehlsschaltfläche identifizieren, auf die er sich bezieht, indem der Befehl beim Hinzufügen der Schaltfläche zum GridWeb-Steuerelement festgelegt wird. Fügen Sie schließlich benutzerdefinierten Code hinzu, der ausgeführt wird, wenn auf die Schaltfläche geklickt wird.

Im nachfolgenden Codebeispiel wird eine Textnachricht der Zelle A1 hinzugefügt, wenn die Schaltfläche geklickt wird.

Text zur Zelle A1 hinzugefügt, wenn benutzerdefinierte Schaltfläche geklickt wird

// 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);
    }
}