## ChartShape class Representa la forma del gráfico. Las propiedades y los métodos del objeto ChartObject controlan la apariencia y el tamaño del gráfico incrustado en la hoja de trabajo. ```csharp public class ChartShape : Shape ``` ## Propiedades | Nombre | Descripción | | --- | --- | | [ActiveXControl](../../aspose.cells.drawing/shape/activexcontrol) { get; } | Obtiene el control ActiveX. | | [ActualLowerRightRow](../../aspose.cells.drawing/shape/actuallowerrightrow) { get; } | Obtenga la fila inferior real. | | [AlternativeText](../../aspose.cells.drawing/shape/alternativetext) { get; set; } | Devuelve o establece la cadena de texto descriptivo (alternativo) del[`Shape`](../shape) objeto. | | [AnchorType](../../aspose.cells.drawing/shape/anchortype) { get; set; } | Obtiene y establece el marcador de posición del ancla de forma. | | [AutoShapeType](../../aspose.cells.drawing/shape/autoshapetype) { get; set; } | Obtiene y establece el tipo de forma automática. | | [Bottom](../../aspose.cells.drawing/shape/bottom) { get; set; } | Representa el ancho del desplazamiento vertical de la forma desde la fila de la esquina inferior inferior, en unidades de píxeles. | | [Chart](../../aspose.cells.drawing/chartshape/chart) { get; } | Devuelve un objeto Chart que representa el gráfico contenido en el objeto. | | [ControlData](../../aspose.cells.drawing/shape/controldata) { get; } | Obtiene los datos de control. | | [CreateId](../../aspose.cells.drawing/shape/createid) { get; set; } | Obtiene y establece crear id para esta forma. | | [Fill](../../aspose.cells.drawing/shape/fill) { get; } | Devuelve unFillFormat objeto que contiene propiedades de formato de relleno para la forma especificada. | | [Font](../../aspose.cells.drawing/shape/font) { get; set; } | Representa la fuente de forma. | | [FormatPicture](../../aspose.cells.drawing/shape/formatpicture) { get; } | Obtiene y establece las opciones del formato de imagen. | | [Geometry](../../aspose.cells.drawing/shape/geometry) { get; } | Obtiene la geometría | | [Glow](../../aspose.cells.drawing/shape/glow) { get; } | Representa un objeto que especifica el efecto de brillo para el elemento del gráfico o la forma. | | [Group](../../aspose.cells.drawing/shape/group) { get; } | Obtiene la figura del grupo que contiene esta figura. | | [HasLine](../../aspose.cells.drawing/shape/hasline) { get; set; } | Obtiene y establece que el borde de la línea de la forma sea visible. | | [Height](../../aspose.cells.drawing/shape/height) { get; set; } | Representa la altura de la forma, en unidades de píxel. | | [HeightCM](../../aspose.cells.drawing/shape/heightcm) { get; set; } | Representa la altura de la forma, en unidades de centímetros. | | [HeightInch](../../aspose.cells.drawing/shape/heightinch) { get; set; } | Representa la altura de la forma, en unidades de pulgadas. | | [HeightInShape](../../aspose.cells.drawing/shape/heightinshape) { get; set; } | Representa el desplazamiento vertical de la forma desde el borde superior de la forma principal, en unidades de 1/4000 de altura de la forma principal.. | | [HeightPt](../../aspose.cells.drawing/shape/heightpt) { get; set; } | Representa la altura de la forma, en unidades de puntos. | | [HeightScale](../../aspose.cells.drawing/shape/heightscale) { get; set; } | Obtiene y establece la escala de altura, en unidades de porcentaje de la altura de la imagen original. Si la forma no es una imagen, la propiedad HeightScale solo devuelve 100; | | [HtmlText](../../aspose.cells.drawing/shape/htmltext) { get; set; } | Obtiene y establece la cadena html que contiene datos y algunos formatos en este cuadro de texto. | | [Hyperlink](../../aspose.cells.drawing/shape/hyperlink) { get; } | Obtiene el hipervínculo de la forma. | | [Id](../../aspose.cells.drawing/shape/id) { get; } | Obtiene el identificador de esta forma. | | [InputRange](../../aspose.cells.drawing/shape/inputrange) { get; set; } | Obtiene o establece el rango de la hoja de cálculo utilizado para llenar el cuadro combinado especificado. | | [IsEquation](../../aspose.cells.drawing/shape/isequation) { get; } | Indica si la forma solo contiene una ecuación. | | [IsFilled](../../aspose.cells.drawing/shape/isfilled) { get; set; } | Indica si el formato de relleno es visible. | | [IsFlippedHorizontally](../../aspose.cells.drawing/shape/isflippedhorizontally) { get; set; } | Obtiene y establece si la forma se voltea horizontalmente . | | [IsFlippedVertically](../../aspose.cells.drawing/shape/isflippedvertically) { get; set; } | Obtiene y establece si la forma se voltea verticalmente . | | [IsGroup](../../aspose.cells.drawing/shape/isgroup) { get; } | Indica si la forma es un grupo. | | [IsHidden](../../aspose.cells.drawing/shape/ishidden) { get; set; } | Indica si el objeto es visible. | | [IsInGroup](../../aspose.cells.drawing/shape/isingroup) { get; } | Indica si la forma está agrupada. | | [IsLockAspectRatio](../../aspose.cells.drawing/shape/islockaspectratio) { get; set; } | Verdadero significa que no permite cambios en la relación de aspecto. | | [IsLocked](../../aspose.cells.drawing/shape/islocked) { get; set; } | True si el objeto está bloqueado, False si el objeto se puede modificar cuando la hoja está protegida. | | [IsPrintable](../../aspose.cells.drawing/shape/isprintable) { get; set; } | Verdadero si el objeto es imprimible | | [IsRichText](../../aspose.cells.drawing/shape/isrichtext) { get; } | Si el texto es texto enriquecido o no. | | [IsSmartArt](../../aspose.cells.drawing/shape/issmartart) { get; } | Indica si la forma es arte inteligente. | | [IsTextWrapped](../../aspose.cells.drawing/shape/istextwrapped) { get; set; } | Obtiene y establece el tipo de ajuste de texto de la forma que contiene texto. | | [IsWordArt](../../aspose.cells.drawing/shape/iswordart) { get; } | Indica si esta forma es un word art. | | [Left](../../aspose.cells.drawing/shape/left) { get; set; } | Representa el desplazamiento horizontal de la forma desde su columna izquierda, en unidades de píxeles. | | [LeftCM](../../aspose.cells.drawing/shape/leftcm) { get; set; } | Representa el desplazamiento horizontal de la forma desde su columna izquierda, en unidades de centímetros. | | [LeftInch](../../aspose.cells.drawing/shape/leftinch) { get; set; } | Representa el desplazamiento horizontal de la forma desde su columna izquierda, en unidades de pulgadas. | | [LeftInShape](../../aspose.cells.drawing/shape/leftinshape) { get; set; } | Representa el desplazamiento horizontal de la forma desde el borde izquierdo de la forma principal, en unidades de 1/4000 del ancho de la forma principal. | | [LeftToCorner](../../aspose.cells.drawing/shape/lefttocorner) { get; set; } | Obtiene y establece el desplazamiento horizontal de la forma desde el borde izquierdo de la hoja de trabajo. | | [Line](../../aspose.cells.drawing/shape/line) { get; } | Obtiene el estilo de línea | | [LinkedCell](../../aspose.cells.drawing/shape/linkedcell) { get; set; } | Obtiene o establece el rango de la hoja de cálculo vinculado al valor del control. | | [LowerDeltaX](../../aspose.cells.drawing/shape/lowerdeltax) { get; set; } | Obtiene o establece el desplazamiento horizontal de la forma desde la columna de la esquina inferior derecha. | | [LowerDeltaY](../../aspose.cells.drawing/shape/lowerdeltay) { get; set; } | Obtiene o establece el desplazamiento vertical de la forma desde la fila de la esquina inferior derecha. | | [LowerRightColumn](../../aspose.cells.drawing/shape/lowerrightcolumn) { get; set; } | Representa el índice de la columna de la esquina inferior derecha. | | [LowerRightRow](../../aspose.cells.drawing/shape/lowerrightrow) { get; set; } | Representa el índice de la fila de la esquina inferior derecha. | | [MacroName](../../aspose.cells.drawing/shape/macroname) { get; set; } | Obtiene y establece el nombre de la macro. | | [MsoDrawingType](../../aspose.cells.drawing/shape/msodrawingtype) { get; } | Obtiene el tipo de dibujo mso. | | [Name](../../aspose.cells.drawing/shape/name) { get; set; } | Obtiene y establece el nombre de la forma. | | [Paths](../../aspose.cells.drawing/shape/paths) { get; } | Obtiene las rutas de una forma geométrica personalizada. | | [Placement](../../aspose.cells.drawing/shape/placement) { get; set; } | Representa la forma en que el objeto de dibujo se adjunta a las celdas debajo de él. La propiedad controla la ubicación de un objeto en una hoja de trabajo. | | [Reflection](../../aspose.cells.drawing/shape/reflection) { get; } | Representa unobjeto que especifica el efecto de reflexión para el elemento del gráfico o la forma. | | [RelativeToOriginalPictureSize](../../aspose.cells.drawing/shape/relativetooriginalpicturesize) { get; set; } | Indica si la forma es relativa al tamaño de la imagen original. | | [Right](../../aspose.cells.drawing/shape/right) { get; set; } | Representa el ancho del desplazamiento horizontal de la forma desde la columna de la esquina inferior derecha, en unidades de píxeles. | | [RotationAngle](../../aspose.cells.drawing/shape/rotationangle) { get; set; } | Obtiene y establece la rotación de la forma. | | [ShadowEffect](../../aspose.cells.drawing/shape/shadoweffect) { get; } | Representa un objeto que especifica el efecto de sombra para el elemento del gráfico o la forma. | | [SoftEdges](../../aspose.cells.drawing/shape/softedges) { get; set; } | Obtiene y establece el radio de desenfoque que se aplicará a los bordes, en unidades de puntos. | | [Spid](../../aspose.cells.drawing/shape/spid) { get; } | Especifica una cadena opcional que una aplicación puede usar para identificar la forma particular. | | [Spt](../../aspose.cells.drawing/shape/spt) { get; } | Especifica un número opcional que una aplicación puede usar para asociar la forma particular con un tipo de forma definido. | | [Text](../../aspose.cells.drawing/shape/text) { get; set; } | Representa la cadena en este objeto TextBox. | | [TextBody](../../aspose.cells.drawing/shape/textbody) { get; } | Obtiene y establece la configuración del texto de la forma. | | [TextDirection](../../aspose.cells.drawing/shape/textdirection) { get; set; } | Obtiene/Establece la dirección del flujo de texto para este objeto. | | [TextEffect](../../aspose.cells.drawing/shape/texteffect) { get; } | Devuelve un objeto TextEffectFormat que contiene propiedades de formato de efecto de texto para la forma especificada. Se aplica a los objetos Shape que representan WordArt. | | [TextHorizontalAlignment](../../aspose.cells.drawing/shape/texthorizontalalignment) { get; set; } | Obtiene y establece el tipo de alineación horizontal del texto de la forma. | | [TextHorizontalOverflow](../../aspose.cells.drawing/shape/texthorizontaloverflow) { get; set; } | Obtiene y establece el tipo de desbordamiento horizontal de texto de la forma que contiene texto. | | [TextOptions](../../aspose.cells.drawing/shape/textoptions) { get; set; } | Representa las opciones de texto de la forma. | | [TextOrientationType](../../aspose.cells.drawing/shape/textorientationtype) { get; set; } | Obtiene y establece el tipo de orientación del texto de la forma. | | [TextShapeType](../../aspose.cells.drawing/shape/textshapetype) { get; set; } | Obtiene y establece el tipo de forma de texto preestablecido. | | [TextVerticalAlignment](../../aspose.cells.drawing/shape/textverticalalignment) { get; set; } | Obtiene y establece el tipo de alineación vertical del texto de la forma. | | [TextVerticalOverflow](../../aspose.cells.drawing/shape/textverticaloverflow) { get; set; } | Obtiene y establece el tipo de desbordamiento vertical de texto de la forma que contiene texto. | | [ThreeDFormat](../../aspose.cells.drawing/shape/threedformat) { get; } | Obtiene y establece el formato 3D de la forma. | | [Title](../../aspose.cells.drawing/shape/title) { get; set; } | Especifica el título (título) del objeto de forma actual. | | [Top](../../aspose.cells.drawing/shape/top) { get; set; } | Representa el desplazamiento vertical de la forma desde su fila superior, en unidades de píxeles. | | [TopCM](../../aspose.cells.drawing/shape/topcm) { get; set; } | Representa el desplazamiento vertical de la forma desde su fila superior, en unidades de centímetros. | | [TopInch](../../aspose.cells.drawing/shape/topinch) { get; set; } | Representa el desplazamiento vertical de la forma desde su fila superior, en unidades de pulgadas. | | [TopInShape](../../aspose.cells.drawing/shape/topinshape) { get; set; } | Representa el desplazamiento vertical de la forma desde el borde superior de la forma principal, en unidades de 1/4000 de altura de la forma principal. | | [TopToCorner](../../aspose.cells.drawing/shape/toptocorner) { get; set; } | Obtiene y establece el desplazamiento vertical de la forma desde el borde superior de la hoja de cálculo, en unidades de píxeles. | | [Type](../../aspose.cells.drawing/shape/type) { get; } | Obtiene el tipo de forma automática. | | [UpperDeltaX](../../aspose.cells.drawing/shape/upperdeltax) { get; set; } | Obtiene o establece el desplazamiento horizontal de la forma desde la columna de la esquina superior izquierda. | | [UpperDeltaY](../../aspose.cells.drawing/shape/upperdeltay) { get; set; } | Obtiene o establece el desplazamiento vertical de la forma desde la fila de la esquina superior izquierda. | | [UpperLeftColumn](../../aspose.cells.drawing/shape/upperleftcolumn) { get; set; } | Representa el índice de la columna de la esquina superior izquierda. | | [UpperLeftRow](../../aspose.cells.drawing/shape/upperleftrow) { get; set; } | Representa el índice de la fila de la esquina superior izquierda. | | [Width](../../aspose.cells.drawing/shape/width) { get; set; } | Representa el ancho de la forma, en unidades de píxeles. | | [WidthCM](../../aspose.cells.drawing/shape/widthcm) { get; set; } | Representa el ancho de la forma, en unidades de centímetros. | | [WidthInch](../../aspose.cells.drawing/shape/widthinch) { get; set; } | Representa el ancho de la forma, en unidades de pulgada. | | [WidthInShape](../../aspose.cells.drawing/shape/widthinshape) { get; set; } | Representa el ancho de la forma, en unidades de 1/4000 de la forma principal. | | [WidthPt](../../aspose.cells.drawing/shape/widthpt) { get; set; } | Representa el ancho de la forma, en unidad de punto. | | [WidthScale](../../aspose.cells.drawing/shape/widthscale) { get; set; } | Obtiene y establece la escala de ancho, en unidades de porcentaje del ancho de la imagen original. Si la forma no es una imagen, la propiedad WidthScale solo devuelve 100; | | [Worksheet](../../aspose.cells.drawing/shape/worksheet) { get; } | Obtiene el[`Worksheet`](../shape/worksheet) objeto que contiene esta forma. | | [X](../../aspose.cells.drawing/shape/x) { get; set; } | Obtiene y establece el desplazamiento horizontal de la forma desde el borde izquierdo de la hoja de cálculo, en unidades de píxeles. | | [Y](../../aspose.cells.drawing/shape/y) { get; set; } | Obtiene y establece el desplazamiento vertical de la forma desde el borde superior de la hoja de cálculo, en unidades de píxeles. | | [ZOrderPosition](../../aspose.cells.drawing/shape/zorderposition) { get; set; } | Devuelve la posición de una forma en el orden z. | ## Métodos | Nombre | Descripción | | --- | --- | | [AddHyperlink](../../aspose.cells.drawing/shape/addhyperlink)(string) | Agrega un hipervínculo a la forma. | | [AlignTopRightCorner](../../aspose.cells.drawing/shape/aligntoprightcorner)(int, int) | Mueve la imagen a la esquina superior derecha. | | [CalculateTextSize](../../aspose.cells.drawing/shape/calculatetextsize)() | Recalcular el área de texto | | [Characters](../../aspose.cells.drawing/shape/characters)(int, int) | Devuelve un objeto Characters que representa un rango de caracteres dentro del texto. | | [FormatCharacters](../../aspose.cells.drawing/shape/formatcharacters)(int, int, Font, StyleFlag) | Formatea algunos caracteres con la configuración de fuente. | | [GetCharacters](../../aspose.cells.drawing/shape/getcharacters)() | Devuelve todos los objetos Characters que representan un rango de caracteres dentro del texto . | | [GetConnectionPoints](../../aspose.cells.drawing/shape/getconnectionpoints)() | Obtener los puntos de conexión | | [GetInputRange](../../aspose.cells.drawing/shape/getinputrange)(bool, bool) | Obtiene el rango usado para llenar el control. | | [GetLinkedCell](../../aspose.cells.drawing/shape/getlinkedcell)(bool, bool) | Obtiene el rango vinculado al valor del control. | | [GetLockedProperty](../../aspose.cells.drawing/shape/getlockedproperty)(ShapeLockType) | Obtiene el valor de la propiedad bloqueada. | | virtual [GetResultOfSmartArt](../../aspose.cells.drawing/shape/getresultofsmartart)() | Conversión de arte inteligente en formas agrupadas. | | virtual [IsSameSetting](../../aspose.cells.drawing/shape/issamesetting)(object) | Devuelve si la forma es la misma. | | [MoveToRange](../../aspose.cells.drawing/shape/movetorange)(int, int, int, int) | Mueve la forma a un rango especificado. | | [RemoveActiveXControl](../../aspose.cells.drawing/shape/removeactivexcontrol)() | Quitar control activeX. | | [RemoveHyperlink](../../aspose.cells.drawing/shape/removehyperlink)() | Eliminar el hipervínculo de la forma. | | [SetInputRange](../../aspose.cells.drawing/shape/setinputrange)(string, bool, bool) | Establece el rango utilizado para llenar el control. | | [SetLinkedCell](../../aspose.cells.drawing/shape/setlinkedcell)(string, bool, bool) | Establece el rango vinculado al valor del control. | | [SetLockedProperty](../../aspose.cells.drawing/shape/setlockedproperty)(ShapeLockType, bool) | Establecer la propiedad bloqueada. | | [ToFrontOrBack](../../aspose.cells.drawing/shape/tofrontorback)(int) | Trae la forma al frente o la envía hacia atrás. | | [ToImage](../../aspose.cells.drawing/shape/toimage)(ImageOrPrintOptions) | Devuelve el objeto de mapa de bits de la forma . | | [ToImage](../../aspose.cells.drawing/shape/toimage)(Stream, ImageOrPrintOptions) | Guarda la forma en un flujo. | | [ToImage](../../aspose.cells.drawing/shape/toimage)(Stream, ImageType) | Crea la imagen de forma y la guarda en una secuencia en el formato especificado. | | [ToImage](../../aspose.cells.drawing/shape/toimage)(string, ImageOrPrintOptions) | Guarda la forma en un archivo. | | [UpdateSelectedValue](../../aspose.cells.drawing/shape/updateselectedvalue)() | Actualiza el valor seleccionado por el valor de la celda vinculada. | ### Ejemplos ```csharp [C#] // Instanciando un objeto Workbook Workbook workbook = new Workbook(); //Obteniendo la referencia de la primera hoja de cálculo Worksheet worksheet = workbook.Worksheets[0]; // Agregar un valor de muestra a la celda "A1" worksheet.Cells["A1"].PutValue(50); // Agregar un valor de muestra a la celda "A2" worksheet.Cells["A2"].PutValue(100); // Agregar un valor de muestra a la celda "A3" worksheet.Cells["A3"].PutValue(150); // Agregar un valor de muestra a la celda "B1" worksheet.Cells["B1"].PutValue(60); // Agregar un valor de muestra a la celda "B2" worksheet.Cells["B2"].PutValue(32); // Agregar un valor de muestra a la celda "B3" worksheet.Cells["B3"].PutValue(50); //Añadiendo un gráfico a la hoja de trabajo int chartIndex = worksheet.Charts.Add(ChartType.PieExploded, 5, 0, 25, 10); //Accediendo a la instancia del gráfico recién agregado Chart chart = worksheet.Charts[chartIndex]; // Agregar NSeries (fuente de datos del gráfico) al gráfico que va desde la celda "A1" hasta la celda "B3" chart.NSeries.Add("A1:B3", true); //Mostrar etiquetas de datos chart.NSeries[0].DataLabels.ShowValue = true; //Obtener la forma del gráfico ChartShape chartShape = chart.ChartObject; // Establecer columna inferior derecha chartShape.LowerRightColumn = 10; // Establecer LowerDeltaX chartShape.LowerDeltaX = 1024; //Guardando el archivo de Excel workbook.Save("book1.xls"); [VB.NET] 'Crear una instancia de un objeto Workbook Dim workbook As Workbook = New Workbook() 'Obtención de la referencia de la primera hoja de cálculo Dim worksheet As Worksheet = workbook.Worksheets(0) 'Adding a sample value to "A1" cell worksheet.Cells("A1").PutValue(50) 'Adding a sample value to "A2" cell worksheet.Cells("A2").PutValue(100) 'Adding a sample value to "A3" cell worksheet.Cells("A3").PutValue(150) 'Adding a sample value to "B1" cell worksheet.Cells("B1").PutValue(60) 'Adding a sample value to "B2" cell worksheet.Cells("B2").PutValue(32) 'Adding a sample value to "B3" cell worksheet.Cells("B3").PutValue(50) 'Adición de un gráfico a la hoja de cálculo Dim chartIndex As Integer = worksheet.Charts.Add(ChartType.PieExploded, 5, 0, 25, 10) 'Acceso a la instancia del gráfico recién agregado Dim chart As Chart = worksheet.Charts(chartIndex) 'Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B3" chart.NSeries.Add("A1:B3", True) 'Mostrar etiquetas de datos chart.NSeries(0).DataLabels.ShowValue = True 'Obtener forma de gráfico Dim chartShape As ChartShape = chart.ChartObject 'Establecer columna inferior derecha chartShape.LowerRightColumn = 10 'Establecer LowerDeltaX chartShape.LowerDeltaX = 1024 'Guardar el archivo de Excel workbook.Save("book1.xls") ``` ### Ver también * class [Shape](../shape) * espacio de nombres [Aspose.Cells.Drawing](../../aspose.cells.drawing) * asamblea [Aspose.Cells](../../)