Erstellen Sie benutzerdefinierte Befehlsschaltflächen

Aspose.Cells.GridWeb enthält spezielle Schaltflächen wieeinreichen, Speichern undRückgängig machen. Alle diese Schaltflächen führen bestimmte Aufgaben für Aspose.Cells.GridWeb aus. Es ist auch möglich, benutzerdefinierte Schaltflächen hinzuzufügen, die benutzerdefinierte Aufgaben ausführen. In diesem Thema wird die Verwendung dieser Funktion erläutert.

Erstellen von benutzerdefinierten Befehlsschaltflächen

So erstellen Sie eine benutzerdefinierte Befehlsschaltfläche in Aspose.Cells.GridWeb:

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 CustomCommandButton-Klasse.
4. Setzen Sie den Befehl der Schaltfläche auf einen Wert. Dieser Wert wird im Ereignishandler der Schaltfläche verwendet.
5. Legen Sie den Text der Schaltfläche fest.
6. Legen Sie die Bild-URL der Schaltfläche fest.
7. Fügen Sie schließlich das CustomCommandButton-Objekt der CustomCommandButtons-Auflistung des GridWeb-Steuerelements hinzu.

Benutzerdefinierte Befehlsschaltflächen können auch im WYSIWYG-Modus mithilfe des Eigenschaftendialogfelds von Visual Studio hinzugefügt werden.

Die Ausgabe des Code-Snippets ist unten dargestellt:

Eine benutzerdefinierte Befehlsschaltfläche, die dem GridWeb-Steuerelement hinzugefügt wurde

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

Ereignisbehandlung der benutzerdefinierten Befehlsschaltfläche

Der wichtigste Aspekt benutzerdefinierter Befehlsschaltflächen ist die Aktion, die sie ausführen, wenn sie angeklickt wird. Erstellen Sie zum Festlegen der Aktion 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. Daher muss der Ereignishandler die spezifische benutzerdefinierte Befehlsschaltfläche identifizieren, auf die er durch den Befehlssatz angewendet wird, wenn die Schaltfläche dem GridWeb-Steuerelement hinzugefügt wird. Fügen Sie schließlich benutzerdefinierten Code hinzu, der ausgeführt wird, wenn auf die Schaltfläche geklickt wird.

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

Text, der der A1-Zelle hinzugefügt wird, wenn auf eine benutzerdefinierte Befehlsschaltflä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);
    }
}