Crear botones de comando personalizados

Aspose.Cells.GridWeb contiene botones especiales como Enviar, Guardar y Deshacer. Todos estos botones realizan tareas específicas para Aspose.Cells.GridWeb. También es posible agregar botones personalizados que realizan tareas personalizadas. Este tema explica cómo utilizar esta característica.

Creación de botones de comando personalizados

Para crear un botón de comando personalizado en Aspose.Cells.GridWeb:

1. Agregar el control Aspose.Cells.GridWeb al formulario web.
2. Acceder a una hoja de cálculo.
3. Crear una instancia de la clase CustomCommandButton.
4. Establecer el comando del botón en algún valor. Este valor se utiliza en el controlador de eventos del botón.
5. Establecer el texto del botón.
6. Establecer la URL de la imagen del botón.
7. Finalmente, agregar el objeto CustomCommandButton a la colección CustomCommandButtons del control GridWeb.

También es posible agregar botones de comando personalizados en modo WYSIWYG utilizando el cuadro de diálogo de Propiedades de Visual Studio.

La salida del fragmento de código se muestra a continuación:

Un botón de comando personalizado agregado al control 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);

Manejo de eventos del botón de comando personalizado

El aspecto más importante de los botones de comando personalizados es la acción que realizan al hacer clic. Para configurar la acción, cree un controlador de eventos para el evento CustomCommand del control GridWeb.

El evento CustomCommand siempre se desencadena cuando se hace clic en un botón de comando personalizado. Por lo tanto, el controlador de eventos debe identificar el botón de comando personalizado específico al que se aplica mediante el comando establecido al agregar el botón al control GridWeb. Finalmente, agregue código personalizado que se ejecuta al hacer clic en el botón.

En el ejemplo de código a continuación, se agrega un mensaje de texto a la celda A1 cuando se hace clic en el botón.

Texto agregado a la celda A1 cuando se hace clic en el botón de comando personalizado

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