Formas en gráficos
Adición de control de etiquetas al gráfico
Las etiquetas proporcionan un medio para dar información a los usuarios sobre el contenido de una hoja de cálculo. Aspose.Cells le permite agregar y manipular etiquetas incluso en gráficos.
ÉlAspose.Cells.Drawing.ShapeCollection clase proporciona un método llamadoAddLabelInChart, utilizado para agregar un control de etiqueta a un gráfico. A continuación se muestra una lista de los parámetros utilizados para el método:
- parte superior – el desplazamiento vertical de la etiqueta desde la esquina superior izquierda en unidades de 1/4000 del área del gráfico.
- izquierda – el desplazamiento vertical de la etiqueta desde la esquina superior izquierda en unidades de 1/4000 del área del gráfico.
- altura – la altura de la etiqueta, en unidades de 1/4000 del área del gráfico.
- ancho – el ancho de la etiqueta, en unidades de 1/4000 del área del gráfico.
El método vuelveAspose.Cells.Drawing.Labelobjeto. ÉlEtiqueta class representa una etiqueta en el gráfico. Tiene algunos miembros importantes:
- Texto(propiedad): especifica la cadena de título de una etiqueta.
- Llenar (propiedad): especifica los atributos de color de relleno.
El siguiente ejemplo muestra cómo agregar una etiqueta al gráfico. El ejemplo utiliza un archivo de diseñador (exp_piechart.xls) que tiene un gráfico en él. Usamos este archivo para insertar una etiqueta en el gráfico. A continuación se muestra el código original para agregar una etiqueta al gráfico. El siguiente resultado se genera al ejecutar el código.
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
| // The path to the documents directory. | |
| string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
| // Open the existing file. | |
| Workbook workbook = new Workbook(dataDir + "chart.xls"); | |
| // Get the designer chart in the second sheet. | |
| Worksheet sheet = workbook.Worksheets[1]; | |
| Aspose.Cells.Charts.Chart chart = sheet.Charts[0]; | |
| // Add a new label to the chart. | |
| Aspose.Cells.Drawing.Label label = chart.Shapes.AddLabelInChart(100, 100, 350, 900); | |
| // Set the caption of the label. | |
| label.Text = "A Label In Chart"; | |
| // Set the Placement Type, the way the | |
| // Label is attached to the cells. | |
| label.Placement = Aspose.Cells.Drawing.PlacementType.FreeFloating; | |
| // Save the excel file. | |
| workbook.Save(dataDir + "chart.out.xls"); |
Adición de control de cuadro de texto al gráfico
Una forma de resaltar información importante en un informe es utilizar un cuadro de texto. Por ejemplo, ingrese texto para resaltar el nombre de la empresa o para indicar la región geográfica con las ventas más altas. ÉlAspose.Cells.Drawing.ShapeCollection clase proporciona un método llamadoAddTextBoxInChartque se utiliza para agregar un control de cuadro de texto a un gráfico. A continuación se muestra la lista de parámetros utilizados para el método:
- parte superior – el desplazamiento vertical del cuadro de texto desde la esquina superior izquierda en unidades de 1/4000 del área del gráfico.
- izquierda – el desplazamiento vertical del cuadro de texto desde la esquina superior izquierda en unidades de 1/4000 del área del gráfico.
- altura– la altura del cuadro de texto, en unidades de 1/4000 del área del gráfico.
- ancho – el ancho del cuadro de texto, en unidades de 1/4000 del área del gráfico.
El método vuelveAspose.Cells.Drawing.TextBox objeto. ÉlCaja de textoclass representa un cuadro de texto en el gráfico.
El siguiente ejemplo muestra cómo agregar un cuadro de texto a un gráfico. El ejemplo utiliza el archivo del diseñador anterior (exp_piechart.xls) que tiene un gráfico en él. Usamos este archivo para insertar un cuadro de texto en el gráfico para mostrar el título del gráfico. A continuación se muestra el código original para agregar un cuadro de texto al gráfico.
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
| // The path to the documents directory. | |
| string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
| // Open the existing file. | |
| Workbook workbook = new Workbook(dataDir + "chart.xls"); | |
| // Get the designer chart in the second sheet. | |
| Worksheet sheet = workbook.Worksheets[1]; | |
| Aspose.Cells.Charts.Chart chart = sheet.Charts[0]; | |
| // Add a new textbox to the chart. | |
| Aspose.Cells.Drawing.TextBox textbox0 = chart.Shapes.AddTextBoxInChart(100, 1100, 350, 2550); | |
| // Fill the text. | |
| textbox0.Text = "Sales By Region"; | |
| // Get the textbox text frame. | |
| // Aspose.Cells.Drawing.MsoTextFrame textframe0 = textbox0.TextFrame; | |
| // Set the textbox to adjust it according to its contents. | |
| // textframe0.AutoSize = true; | |
| // Set the font color. | |
| textbox0.Font.Color = Color.Maroon; | |
| // Set the font to bold. | |
| textbox0.Font.IsBold = true; | |
| // Set the font size. | |
| textbox0.Font.Size = 14; | |
| // Set font attribute to italic. | |
| textbox0.Font.IsItalic = true; | |
| // Get the filformat of the textbox. | |
| Aspose.Cells.Drawing.FillFormat fillformat = textbox0.Fill; | |
| // Get the lineformat type of the textbox. | |
| Aspose.Cells.Drawing.LineFormat lineformat = textbox0.Line; | |
| // Set the line weight. | |
| lineformat.Weight = 2; | |
| // Set the dash style to solid. | |
| lineformat.DashStyle = Aspose.Cells.Drawing.MsoLineDashStyle.Solid; | |
| // Save the excel file. | |
| workbook.Save(dataDir + "chart.out.xls"); |
Agregar imagen al gráfico
Aspose.Cells le permite insertar imágenes en un gráfico. Por ejemplo, agregue una imagen para enfatizar o dar más significado a un gráfico o su contenido, o inserte un archivo de imagen de marca.
ÉlAspose.Cells.Drawing.ShapeCollection clase proporciona un método llamadoAgregarImagenEnGráfico, que se utiliza para agregar un objeto de imagen al gráfico. A continuación se muestra la lista de parámetros utilizados para el método:
- parte superior– el desplazamiento vertical de la imagen desde la esquina superior izquierda en unidades de 1/4000 del área del gráfico.
- izquierda– el desplazamiento vertical de la imagen desde la esquina superior izquierda en unidades de 1/4000 del área del gráfico.
- arroyo – un objeto de flujo que contiene los datos de la imagen.
- anchoEscala – la escala del ancho de la imagen, un valor porcentual.
- alturaEscala – la escala de altura de la imagen, un valor porcentual.
El método devuelve unAspose.Cells.Drawing.Picture objeto. ÉlFotografíaclass representa un objeto de imagen en el gráfico.
El siguiente ejemplo muestra cómo agregar una imagen al gráfico. El ejemplo utiliza el archivo del diseñador anterior (exp_piechart.xls) que tiene un gráfico en él. Usamos este archivo para insertar una imagen en el gráfico. A continuación se muestra el código original para agregar una imagen al gráfico.
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
| // The path to the documents directory. | |
| string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
| // Open the existing file. | |
| Workbook workbook = new Workbook(dataDir + "chart.xls"); | |
| // Get an image file to the stream. | |
| FileStream stream = new FileStream(dataDir + "logo.jpg", FileMode.Open, FileAccess.Read); | |
| // Get the designer chart in the second sheet. | |
| Worksheet sheet = workbook.Worksheets[0]; | |
| Aspose.Cells.Charts.Chart chart = sheet.Charts[0]; | |
| // Add a new picture to the chart. | |
| Aspose.Cells.Drawing.Picture pic0 = chart.Shapes.AddPictureInChart(50, 50, stream, 40, 40); | |
| // Get the lineformat type of the picture. | |
| Aspose.Cells.Drawing.LineFormat lineformat = pic0.Line; | |
| // Set the dash style. | |
| lineformat.DashStyle = Aspose.Cells.Drawing.MsoLineDashStyle.Solid; | |
| // Set the line weight. | |
| lineformat.Weight = 4; | |
| // Save the excel file. | |
| workbook.Save(dataDir + "chart.out.xls"); |
Agregar casilla de verificación en el gráfico
Aspose.Cells le permite insertar casillas de verificación en una hoja de gráfico utilizandoMsoDrawingType enumeración. El siguiente ejemplo muestra cómo agregar una casilla de verificación a una hoja de gráfico.
La siguiente imagen muestra la hoja de gráfico con la casilla de verificación en el archivo de salida.
Élarchivo de salidagenerado por el siguiente fragmento de código se adjunta para su referencia.
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
| // Instantiating a Workbook object | |
| Workbook workbook = new Workbook(); | |
| // Adding a chart to the worksheet | |
| int index = workbook.Worksheets.Add(SheetType.Chart); | |
| Worksheet sheet = workbook.Worksheets[index]; | |
| sheet.Charts.AddFloatingChart(ChartType.Column, 0, 0, 1024, 960); | |
| sheet.Charts[0].NSeries.Add("{1,2,3}", false); | |
| // Add checkbox to the chart. | |
| sheet.Charts[0].Shapes.AddShapeInChart(MsoDrawingType.CheckBox, PlacementType.Move, 400, 400, 1000, 600); | |
| sheet.Charts[0].Shapes[0].Text = "CheckBox 1"; | |
| // Save the excel file. | |
| workbook.Save(outputDir + "InsertCheckboxInChartSheet_out.xlsx"); |