GroupBox

GroupBox class

Encapsula el objeto que representa un cuadro de grupo en una hoja de cálculo.

public class GroupBox : Shape

Propiedades

NombreDescripción
ActiveXControl { get; }Obtiene el control ActiveX.
ActualLowerRightRow { get; }Obtenga la fila inferior real.
AlternativeText { get; set; }Devuelve o establece la cadena de texto descriptivo (alternativo) delShape objeto.
AnchorType { get; set; }Obtiene y establece el marcador de posición del ancla de forma.
AutoShapeType { get; set; }Obtiene y establece el tipo de forma automática.
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.
ControlData { get; }Obtiene los datos de control.
CreateId { get; set; }Obtiene y establece crear id para esta forma.
Fill { get; }Devuelve unFillFormat objeto que contiene propiedades de formato de relleno para la forma especificada.
Font { get; set; }Representa la fuente de forma.
FormatPicture { get; }Obtiene y establece las opciones del formato de imagen.
Geometry { get; }Obtiene la geometría
Glow { get; }Representa un objeto que especifica el efecto de brillo para el elemento del gráfico o la forma.
Group { get; }Obtiene la figura del grupo que contiene esta figura.
HasLine { get; set; }Obtiene y establece que el borde de la línea de la forma sea visible.
Height { get; set; }Representa la altura de la forma, en unidades de píxel.
HeightCM { get; set; }Representa la altura de la forma, en unidades de centímetros.
HeightInch { get; set; }Representa la altura de la forma, en unidades de pulgadas.
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 { get; set; }Representa la altura de la forma, en unidades de puntos.
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 { get; set; }Obtiene y establece la cadena html que contiene datos y algunos formatos en este cuadro de texto.
Hyperlink { get; }Obtiene el hipervínculo de la forma.
Id { get; }Obtiene el identificador de esta forma.
InputRange { get; set; }Obtiene o establece el rango de la hoja de cálculo utilizado para llenar el cuadro combinado especificado.
IsEquation { get; }Indica si la forma solo contiene una ecuación.
IsFilled { get; set; }Indica si el formato de relleno es visible.
IsFlippedHorizontally { get; set; }Obtiene y establece si la forma se voltea horizontalmente .
IsFlippedVertically { get; set; }Obtiene y establece si la forma se voltea verticalmente .
IsGroup { get; }Indica si la forma es un grupo.
IsHidden { get; set; }Indica si el objeto es visible.
IsInGroup { get; }Indica si la forma está agrupada.
IsLockAspectRatio { get; set; }Verdadero significa que no permite cambios en la relación de aspecto.
IsLocked { get; set; }True si el objeto está bloqueado, False si el objeto se puede modificar cuando la hoja está protegida.
IsPrintable { get; set; }Verdadero si el objeto es imprimible
IsRichText { get; }Si el texto es texto enriquecido o no.
IsSmartArt { get; }Indica si la forma es arte inteligente.
IsTextWrapped { get; set; }Obtiene y establece el tipo de ajuste de texto de la forma que contiene texto.
IsWordArt { get; }Indica si esta forma es un word art.
Left { get; set; }Representa el desplazamiento horizontal de la forma desde su columna izquierda, en unidades de píxeles.
LeftCM { get; set; }Representa el desplazamiento horizontal de la forma desde su columna izquierda, en unidades de centímetros.
LeftInch { get; set; }Representa el desplazamiento horizontal de la forma desde su columna izquierda, en unidades de pulgadas.
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 { get; set; }Obtiene y establece el desplazamiento horizontal de la forma desde el borde izquierdo de la hoja de trabajo.
Line { get; }Obtiene el estilo de línea
LinkedCell { get; set; }Obtiene o establece el rango de la hoja de cálculo vinculado al valor del control.
LowerDeltaX { get; set; }Obtiene o establece el desplazamiento horizontal de la forma desde la columna de la esquina inferior derecha.
LowerDeltaY { get; set; }Obtiene o establece el desplazamiento vertical de la forma desde la fila de la esquina inferior derecha.
LowerRightColumn { get; set; }Representa el índice de la columna de la esquina inferior derecha.
LowerRightRow { get; set; }Representa el índice de la fila de la esquina inferior derecha.
MacroName { get; set; }Obtiene y establece el nombre de la macro.
MsoDrawingType { get; }Obtiene el tipo de dibujo mso.
Name { get; set; }Obtiene y establece el nombre de la forma.
Paths { get; }Obtiene las rutas de una forma geométrica personalizada.
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 { get; }Representa unobjeto que especifica el efecto de reflexión para el elemento del gráfico o la forma.
RelativeToOriginalPictureSize { get; set; }Indica si la forma es relativa al tamaño de la imagen original.
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 { get; set; }Obtiene y establece la rotación de la forma.
Shadow { get; set; }Indica si el groupbox tiene shadow.
ShadowEffect { get; }Representa un objeto que especifica el efecto de sombra para el elemento del gráfico o la forma.
SoftEdges { get; set; }Obtiene y establece el radio de desenfoque que se aplicará a los bordes, en unidades de puntos.
Spid { get; }Especifica una cadena opcional que una aplicación puede usar para identificar la forma particular.
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 { get; set; }Representa la cadena en este objeto TextBox.
TextBody { get; }Obtiene y establece la configuración del texto de la forma.
TextDirection { get; set; }Obtiene/Establece la dirección del flujo de texto para este objeto.
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 { get; set; }Obtiene y establece el tipo de alineación horizontal del texto de la forma.
TextHorizontalOverflow { get; set; }Obtiene y establece el tipo de desbordamiento horizontal de texto de la forma que contiene texto.
TextOptions { get; set; }Representa las opciones de texto de la forma.
TextOrientationType { get; set; }Obtiene y establece el tipo de orientación del texto de la forma.
TextShapeType { get; set; }Obtiene y establece el tipo de forma de texto preestablecido.
TextVerticalAlignment { get; set; }Obtiene y establece el tipo de alineación vertical del texto de la forma.
TextVerticalOverflow { get; set; }Obtiene y establece el tipo de desbordamiento vertical de texto de la forma que contiene texto.
ThreeDFormat { get; }Obtiene y establece el formato 3D de la forma.
Title { get; set; }Especifica el título (título) del objeto de forma actual.
Top { get; set; }Representa el desplazamiento vertical de la forma desde su fila superior, en unidades de píxeles.
TopCM { get; set; }Representa el desplazamiento vertical de la forma desde su fila superior, en unidades de centímetros.
TopInch { get; set; }Representa el desplazamiento vertical de la forma desde su fila superior, en unidades de pulgadas.
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 { 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 { get; }Obtiene el tipo de forma automática.
UpperDeltaX { get; set; }Obtiene o establece el desplazamiento horizontal de la forma desde la columna de la esquina superior izquierda.
UpperDeltaY { get; set; }Obtiene o establece el desplazamiento vertical de la forma desde la fila de la esquina superior izquierda.
UpperLeftColumn { get; set; }Representa el índice de la columna de la esquina superior izquierda.
UpperLeftRow { get; set; }Representa el índice de la fila de la esquina superior izquierda.
Width { get; set; }Representa el ancho de la forma, en unidades de píxeles.
WidthCM { get; set; }Representa el ancho de la forma, en unidades de centímetros.
WidthInch { get; set; }Representa el ancho de la forma, en unidades de pulgada.
WidthInShape { get; set; }Representa el ancho de la forma, en unidades de 1/4000 de la forma principal.
WidthPt { get; set; }Representa el ancho de la forma, en unidad de punto.
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 { get; }Obtiene elWorksheet objeto que contiene esta forma.
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 { 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 { get; set; }Devuelve la posición de una forma en el orden z.

Métodos

NombreDescripción
AddHyperlink(string)Agrega un hipervínculo a la forma.
AlignTopRightCorner(int, int)Mueve la imagen a la esquina superior derecha.
CalculateTextSize()Recalcular el área de texto
Characters(int, int)Devuelve un objeto Characters que representa un rango de caracteres dentro del texto.
FormatCharacters(int, int, Font, StyleFlag)Formatea algunos caracteres con la configuración de fuente.
GetCharacters()Devuelve todos los objetos Characters que representan un rango de caracteres dentro del texto .
GetConnectionPoints()Obtener los puntos de conexión
GetInputRange(bool, bool)Obtiene el rango usado para llenar el control.
GetLinkedCell(bool, bool)Obtiene el rango vinculado al valor del control.
GetLockedProperty(ShapeLockType)Obtiene el valor de la propiedad bloqueada.
virtual GetResultOfSmartArt()Conversión de arte inteligente en formas agrupadas.
virtual IsSameSetting(object)Devuelve si la forma es la misma.
MoveToRange(int, int, int, int)Mueve la forma a un rango especificado.
RemoveActiveXControl()Quitar control activeX.
RemoveHyperlink()Eliminar el hipervínculo de la forma.
SetInputRange(string, bool, bool)Establece el rango utilizado para llenar el control.
SetLinkedCell(string, bool, bool)Establece el rango vinculado al valor del control.
SetLockedProperty(ShapeLockType, bool)Establecer la propiedad bloqueada.
ToFrontOrBack(int)Trae la forma al frente o la envía hacia atrás.
ToImage(ImageOrPrintOptions)Devuelve el objeto de mapa de bits de la forma .
ToImage(Stream, ImageOrPrintOptions)Guarda la forma en un flujo.
ToImage(Stream, ImageType)Crea la imagen de forma y la guarda en una secuencia en el formato especificado.
ToImage(string, ImageOrPrintOptions)Guarda la forma en un archivo.
UpdateSelectedValue()Actualiza el valor seleccionado por el valor de la celda vinculada.

Ejemplos


[C#]

//Crear una instancia de un nuevo libro de trabajo.
Workbook excelbook = new Workbook();
 
//Agregue un cuadro de grupo a la primera hoja de trabajo.
Aspose.Cells.GroupBox box = excelbook.Worksheets[0].Shapes.AddGroupBox(1, 0, 1, 0, 300, 250);
 
//Establecer el título del cuadro de grupo.
box.Text = "Age Groups";
box.Placement = PlacementType.FreeFloating;
 
//Hacerlo cuadro 2-D.
box.Shadow = false;
 
//Añadir un botón de radio.
Aspose.Cells.RadioButton radio1 = excelbook.Worksheets[0].Shapes.AddRadioButton(3, 0, 2, 0, 30, 110);
 
//Establecer su cadena de texto.
radio1.Text = "20-29";
 
//Establece la celda A1 como una celda vinculada para el botón de opción.
radio1.LinkedCell = "A1";
 
//Hacer el botón de radio en 3-D.
radio1.Shadow = true;
 
//Establecer el color de primer plano del botón de opción.
radio1.FillFormat.ForeColor = Color.LightGreen;
 
//Establecer el estilo de línea del botón de opción.
radio1.LineFormat.Style = MsoLineStyle.ThickThin;
 
//Establecer el peso del botón de radio.
radio1.LineFormat.Weight = 4;
 
//Establecer el color de línea del botón de radio.
radio1.LineFormat.ForeColor = Color.Blue;
 
//Establecer el estilo de guión del botón de opción.
radio1.LineFormat.DashStyle = MsoLineDashStyle.Solid;
 
//Hacer visible el formato de línea.
radio1.LineFormat.IsVisible = true;
 
//Hacer visible el formato de relleno.
radio1.FillFormat.IsVisible = true;
 
//Agregue otro botón de radio.
Aspose.Cells.RadioButton radio2 = excelbook.Worksheets[0].Shapes.AddRadioButton(6, 0, 2, 0, 30, 110);
 
//Establecer su cadena de texto.
radio2.Text = "30-39";
 
//Establece la celda A1 como una celda vinculada para el botón de opción.
radio2.LinkedCell = "A1";
 
//Hacer el botón de radio en 3-D.
radio2.Shadow = true;
 
//Establecer el color de primer plano del botón de opción.
radio2.FillFormat.ForeColor = Color.LightGreen;
 
//Establecer el estilo de línea del botón de opción.
radio2.LineFormat.Style = MsoLineStyle.ThickThin;
 
//Establecer el peso del botón de radio.
radio2.LineFormat.Weight = 4;
 
//Establecer el color de línea del botón de radio.
radio2.LineFormat.ForeColor = Color.Blue;
 
//Establecer el estilo de guión del botón de opción.
radio2.LineFormat.DashStyle = MsoLineDashStyle.Solid;
 
//Hacer visible el formato de línea.
radio2.LineFormat.IsVisible = true;
 
//Hacer visible el formato de relleno.
radio2.FillFormat.IsVisible = true;
 
//Agregue otro botón de radio.
Aspose.Cells.RadioButton radio3 = excelbook.Worksheets[0].Shapes.AddRadioButton(9, 0, 2, 0, 30, 110);
 
//Establecer su cadena de texto.
radio3.Text = "40-49";
 
//Establece la celda A1 como una celda vinculada para el botón de opción.
radio3.LinkedCell = "A1";
 
//Hacer el botón de radio en 3-D.
radio3.Shadow = true;
 
//Establecer el color de primer plano del botón de opción.
radio3.FillFormat.ForeColor = Color.LightGreen;
 
//Establecer el estilo de línea del botón de opción.
radio3.LineFormat.Style = MsoLineStyle.ThickThin;
 
//Establecer el peso del botón de radio.
radio3.LineFormat.Weight = 4;
 
//Establecer el color de línea del botón de radio.
radio3.LineFormat.ForeColor = Color.Blue;
 
//Establecer el estilo de guión del botón de opción.
radio3.LineFormat.DashStyle = MsoLineDashStyle.Solid;
 
//Hacer visible el formato de línea.
radio3.LineFormat.IsVisible = true;
 
//Hacer visible el formato de relleno.
radio3.FillFormat.IsVisible = true;
 
//Obtener las formas.
Aspose.Cells.Shape[] shapeobjects = new Aspose.Cells.Shape[] { box, radio1, radio2, radio3 };
 
//Agrupa las formas.
Aspose.Cells.GroupShape group = excelbook.Worksheets[0].Shapes.Group(shapeobjects);
 
//Guardar el archivo de Excel.
excelbook.Save("groupshapes.xls");

[VB.NET]

'Cree una instancia de un nuevo libro de trabajo.
Dim excelbook As Workbook = New Workbook()
 
'Agregue un cuadro de grupo a la primera hoja de trabajo.
Dim box As Aspose.Cells.GroupBox = excelbook.Worksheets(0).Shapes.AddGroupBox(1, 0, 1, 0, 300, 250)
 
'Establezca el título del cuadro de grupo.
box.Text = "Age Groups"
box.Placement = PlacementType.FreeFloating
 
'Conviértelo en una caja bidimensional.
box.Shadow = False
 
'Agregue un botón de opción.
Dim radio1 As Aspose.Cells.RadioButton = excelbook.Worksheets(0).Shapes.AddRadioButton(3, 0, 2, 0, 30, 110)
 
'Establecer su cadena de texto.
radio1.Text = "20-29"
 
'Configure la celda A1 como una celda vinculada para el botón de opción.
radio1.LinkedCell = "A1"
 
'Haz el botón de radio en 3-D.
radio1.Shadow = True
 
'Establezca el color de primer plano del botón de opción.
radio1.FillFormat.ForeColor = Color.LightGreen
 
'Establezca el estilo de línea del botón de opción.
radio1.LineFormat.Style = MsoLineStyle.ThickThin
 
'Establezca el peso del botón de opción.
radio1.LineFormat.Weight = 4
 
'Establezca el color de línea del botón de radio.
radio1.LineFormat.ForeColor = Color.Blue
 
'Establezca el estilo de guión del botón de opción.
radio1.LineFormat.DashStyle = MsoLineDashStyle.Solid
 
'Haz que el formato de línea sea visible.
radio1.LineFormat.IsVisible = True
 
'Haz que el formato de relleno sea visible.
radio1.FillFormat.IsVisible = True
 
'Agregue otro botón de opción.
Dim radio2 As Aspose.Cells.RadioButton = excelbook.Worksheets(0).Shapes.AddRadioButton(6, 0, 2, 0, 30, 110)
 
'Establecer su cadena de texto.
radio2.Text = "30-39"
 
'Configure la celda A1 como una celda vinculada para el botón de opción.
radio2.LinkedCell = "A1"
 
'Haz el botón de radio en 3-D.
radio2.Shadow = True
 
'Establezca el color de primer plano del botón de opción.
radio2.FillFormat.ForeColor = Color.LightGreen
 
'Establezca el estilo de línea del botón de opción.
radio2.LineFormat.Style = MsoLineStyle.ThickThin
 
'Establezca el peso del botón de opción.
radio2.LineFormat.Weight = 4
 
'Establezca el color de línea del botón de radio.
radio2.LineFormat.ForeColor = Color.Blue
 
'Establezca el estilo de guión del botón de opción.
radio2.LineFormat.DashStyle = MsoLineDashStyle.Solid
 
'Haz que el formato de línea sea visible.
radio2.LineFormat.IsVisible = True
 
'Haz que el formato de relleno sea visible.
radio2.FillFormat.IsVisible = True
 
'Agregue otro botón de opción.
Dim radio3 As Aspose.Cells.RadioButton = excelbook.Worksheets(0).Shapes.AddRadioButton(9, 0, 2, 0, 30, 110)
 
'Establecer su cadena de texto.
radio3.Text = "40-49"
 
'Configure la celda A1 como una celda vinculada para el botón de opción.
radio3.LinkedCell = "A1"
 
'Haz el botón de radio en 3-D.
radio3.Shadow = True
 
'Establezca el color de primer plano del botón de opción.
radio3.FillFormat.ForeColor = Color.LightGreen
 
'Establezca el estilo de línea del botón de opción.
radio3.LineFormat.Style = MsoLineStyle.ThickThin
 
'Establezca el peso del botón de opción.
radio3.LineFormat.Weight = 4
 
'Establezca el color de línea del botón de radio.
radio3.LineFormat.ForeColor = Color.Blue
 
'Establezca el estilo de guión del botón de opción.
radio3.LineFormat.DashStyle = MsoLineDashStyle.Solid
 
'Haz que el formato de línea sea visible.
radio3.LineFormat.IsVisible = True
 
'Haz que el formato de relleno sea visible.
radio3.FillFormat.IsVisible = True
 
'Consigue las formas.
Dim shapeobjects() As Aspose.Cells.Shape = New Aspose.Cells.Shape() {box, radio1, radio2, radio3}
 
'Agrupa las formas.
Dim group As Aspose.Cells.GroupShape = excelbook.Worksheets(0).Shapes.Group(shapeobjects)
 
'Guarde el archivo de Excel.
excelbook.Save("groupshapes.xls")

Ver también

GradientStyleType GroupFill