Создание пользовательских кнопок команд

Aspose.Cells.GridWeb содержит специальные кнопки, такие как Submit, Save и Undo. Все эти кнопки выполняют определенные задачи для Aspose.Cells.GridWeb. Также можно добавить пользовательские кнопки, выполняющие пользовательские задачи. Эта тема объясняет, как использовать эту функцию.

Создание пользовательских кнопок команд

Для создания пользовательской кнопки команд в Aspose.Cells.GridWeb:

1. Добавьте элемент управления Aspose.Cells.GridWeb на веб-форму.
2. Получите доступ к листу.
3. Создайте экземпляр класса CustomCommandButton.
4. Установите команду кнопки на некоторое значение. Это значение используется в обработчике событий кнопки.
5. Установите текст кнопки.
6. Установите URL-адрес изображения кнопки.
7. Наконец, добавьте объект CustomCommandButton в коллекцию CustomCommandButtons элемента управления GridWeb.

Пользовательские кнопки команд также могут быть добавлены в режиме WYSIWYG с помощью диалогового окна свойств Visual Studio.

Результат работы фрагмента кода показан ниже:

Пользовательская командная кнопка добавлена к элементу 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);

Обработка событий пользовательской командной кнопки

Самым важным аспектом пользовательских командных кнопок является действие, которое выполняется при их нажатии. Чтобы установить действие, создайте обработчик событий для события CustomCommand элемента управления GridWeb.

Событие CustomCommand всегда срабатывает, когда пользовательская командная кнопка нажата. Поэтому обработчику событий необходимо определить конкретную пользовательскую командную кнопку, к которой она применяется с помощью заданной команды при добавлении кнопки к элементу управления GridWeb. Наконец, добавьте пользовательский код, который выполняется при нажатии кнопки.

В приведенном ниже примере кода к ячейке A1 добавлено текстовое сообщение при нажатии кнопки.

Текст добавлен в ячейку A1 при нажатии пользовательской командной кнопки

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