GroupBox

GroupBox class

在电子表格中封装表示组框的对象。

public class GroupBox : Shape

特性

姓名描述
ActiveXControl { get; }获取 ActiveX 控件。
ActualLowerRightRow { get; }获取实际的底行。
AlternativeText { get; set; }返回或设置的描述性（替代）文本字符串Shape对象.
AnchorType { get; set; }获取和设置形状锚占位符。
AutoShapeType { get; set; }获取和设置自动形状类型。
Bottom { get; set; }表示形状与其下底角行垂直偏移的宽度，以像素为单位。
ControlData { get; }获取控件的数据。
CreateId { get; set; }获取并设置此形状的创建 ID。
Fill { get; }返回一个FillFormat包含指定形状的填充格式属性的对象。
Font { get; set; }表示形状的字体。
FormatPicture { get; }获取和设置图片格式的选项
Geometry { get; }获取几何图形
Glow { get; }代表一个为图表元素或形状指定发光效果的对象。
Group { get; }获取包含此形状的组形状。
HasLine { get; set; }获取并设置形状的线条边框是否可见。
Height { get; set; }表示形状的高度，以像素为单位。
HeightCM { get; set; }表示形状的高度，单位为厘米。
HeightInch { get; set; }表示形状的高度，以英寸为单位。
HeightInShape { get; set; }表示 shape 与父 shape 上边框的垂直偏移量，单位为父 shape 高度的 1/4000..
HeightPt { get; set; }表示形状的高度，以点为单位。
HeightScale { get; set; }获取和设置高度比例，单位是原始图片高度的百分比。 如果形状不是图片，HeightScale属性只返回100；
HtmlText { get; set; }获取和设置该文本框中包含数据和一些格式的html字符串。
Hyperlink { get; }获取形状的超链接。
Id { get; }获取此形状的标识符。
InputRange { get; set; }获取或设置用于填充指定组合框的工作表范围。
IsEquation { get; }表示形状是否只包含方程。
IsFilled { get; set; }表示填充格式是否可见。
IsFlippedHorizontally { get; set; }获取并设置形状是否水平翻转。
IsFlippedVertically { get; set; }获取并设置形状是否垂直翻转。
IsGroup { get; }表示形状是否为组。
IsHidden { get; set; }表示对象是否可见。
IsInGroup { get; }表示形状是否被分组。
IsLockAspectRatio { get; set; }True 表示不允许更改纵横比。
IsLocked { get; set; }如果对象被锁定，则为 True，如果在工作表受保护时可以修改对象，则为 False。
IsPrintable { get; set; }如果对象是可打印的，则为真
IsRichText { get; }文本是否为富文本。
IsSmartArt { get; }表示形状是否为智能艺术。
IsTextWrapped { get; set; }获取和设置包含文本的形状的文本换行类型。
IsWordArt { get; }表示这个形状是否是艺术字。
Left { get; set; }表示形状与其左列的水平偏移量，以像素为单位。
LeftCM { get; set; }表示形状与其左列的水平偏移量，单位为厘米。
LeftInch { get; set; }表示形状与其左列的水平偏移量，单位为英寸。
LeftInShape { get; set; }表示 shape 与父 shape 左边框的水平偏移量， 以父 shape 宽度的 1/4000 为单位。
LeftToCorner { get; set; }获取和设置形状从工作表左边框的水平偏移量。
Line { get; }获取线条样式
LinkedCell { get; set; }获取或设置链接到控件值的工作表范围。
LowerDeltaX { get; set; }获取或设置形状与其右下角列的水平偏移量。
LowerDeltaY { get; set; }获取或设置形状与其右下角行的垂直偏移量。
LowerRightColumn { get; set; }表示右下角列索引。
LowerRightRow { get; set; }代表右下角行索引。
MacroName { get; set; }获取和设置宏的名称。
MsoDrawingType { get; }获取 mso 绘图类型。
Name { get; set; }获取和设置形状的名称。
Paths { get; }获取自定义几何形状的路径。
Placement { get; set; }表示绘图对象附加到其下方单元格的方式。 该属性控制对象在工作表上的放置。
Reflection { get; }代表一个指定图表元素或形状的反射效果的对象。
RelativeToOriginalPictureSize { get; set; }表示形状是否相对于原始图片大小。
Right { get; set; }表示形状从其右下角列水平偏移的宽度，以像素为单位。
RotationAngle { get; set; }获取和设置形状的旋转。
Shadow { get; set; }表示groupbox是否有阴影。
ShadowEffect { get; }代表一个为图表元素或形状指定阴影效果的对象。
SoftEdges { get; set; }获取和设置应用于边缘的模糊半径，以点为单位。
Spid { get; }指定应用程序可以用来识别特定形状的可选字符串。
Spt { get; }指定一个可选数字，应用程序可以使用该数字将特定形状与定义的形状类型相关联。
Text { get; set; }表示此 TextBox 对象中的字符串。
TextBody { get; }获取和设置形状文本的设置。
TextDirection { get; set; }获取/设置此对象的文本流方向。
TextEffect { get; }返回一个 TextEffectFormat 对象，该对象包含指定形状的文本效果格式属性。 适用于代表艺术字的 Shape 对象。
TextHorizontalAlignment { get; set; }获取和设置形状的文本水平对齐类型。
TextHorizontalOverflow { get; set; }获取和设置包含文本的形状的文本水平溢出类型。
TextOptions { get; set; }表示形状的文本选项。
TextOrientationType { get; set; }获取和设置形状的文本方向类型。
TextShapeType { get; set; }获取和设置预设的文字形状类型。
TextVerticalAlignment { get; set; }获取和设置形状的文本垂直对齐类型。
TextVerticalOverflow { get; set; }获取并设置包含文本的形状的文本垂直溢出类型。
ThreeDFormat { get; }获取并设置形状的 3d 格式。
Title { get; set; }指定当前形状对象的标题（标题）。
Top { get; set; }表示形状与其顶行的垂直偏移量，以像素为单位。
TopCM { get; set; }表示形状与其顶行的垂直偏移量，单位为厘米。
TopInch { get; set; }表示形状与其顶行的垂直偏移量，以英寸为单位。
TopInShape { get; set; }表示 shape 与父 shape 上边框的垂直偏移量， 以父 shape 高度的 1/4000 为单位。
TopToCorner { get; set; }获取和设置形状相对于工作表上边框的垂直偏移量，以像素为单位。
Type { get; }获取自动形状类型。
UpperDeltaX { get; set; }获取或设置形状与其左上角列的水平偏移量。
UpperDeltaY { get; set; }获取或设置形状与其左上角行的垂直偏移量。
UpperLeftColumn { get; set; }表示左上角列索引。
UpperLeftRow { get; set; }表示左上角行索引。
Width { get; set; }表示形状的宽度，以像素为单位。
WidthCM { get; set; }表示形状的宽度，单位为厘米。
WidthInch { get; set; }表示形状的宽度，单位为英寸。
WidthInShape { get; set; }表示形状的宽度，单位为父形状的1/4000。
WidthPt { get; set; }表示形状的宽度，以点为单位。
WidthScale { get; set; }获取和设置宽度比例，单位是原始图片宽度的百分比。 如果形状不是图片，WidthScale属性只返回100；
Worksheet { get; }获取Worksheet包含此形状的对象。
X { get; set; }获取和设置形状相对工作表左边框的水平偏移量，以像素为单位。
Y { get; set; }获取和设置形状相对工作表上边框的垂直偏移量，以像素为单位。
ZOrderPosition { get; set; }返回形状在 z 顺序中的位置。

方法

姓名描述
AddHyperlink(string)向形状添加超链接。
AlignTopRightCorner(int, int)将图片移动到右上角。
CalculateTextSize()重新计算文本区域
Characters(int, int)返回一个 Characters 对象，该对象表示文本中的一系列字符。
FormatCharacters(int, int, Font, StyleFlag)使用字体设置格式化一些字符。
GetCharacters()返回所有字符对象 ，它表示文本中的字符范围 .
GetConnectionPoints()获取连接点
GetInputRange(bool, bool)获取用于填充控件的范围。
GetLinkedCell(bool, bool)获取链接到控件值的范围。
GetLockedProperty(ShapeLockType)获取锁定属性的值。
virtual GetResultOfSmartArt()将智能艺术转换为分组形状。
virtual IsSameSetting(object)返回形状是否相同。
MoveToRange(int, int, int, int)将形状移动到指定范围。
RemoveActiveXControl()移除activeX控件。
RemoveHyperlink()删除形状的超链接。
SetInputRange(string, bool, bool)设置用于填充控件的范围。
SetLinkedCell(string, bool, bool)设置链接到控件值的范围。
SetLockedProperty(ShapeLockType, bool)设置锁定属性。
ToFrontOrBack(int)将形状放在前面或将形状放在后面。
ToImage(ImageOrPrintOptions)返回形状 . 的位图对象
ToImage(Stream, ImageOrPrintOptions)将形状保存到流中。
ToImage(Stream, ImageType)创建形状图像并将其保存到指定格式的流中。
ToImage(string, ImageOrPrintOptions)将形状保存到文件中。
UpdateSelectedValue()通过链接单元格的值更新选定的值。

例子


[C#]

//实例化一个新的工作簿。
Workbook excelbook = new Workbook();
 
//向第一个工作表添加一个组框。
Aspose.Cells.GroupBox box = excelbook.Worksheets[0].Shapes.AddGroupBox(1, 0, 1, 0, 300, 250);
 
//设置分组框的标题。
box.Text = "Age Groups";
box.Placement = PlacementType.FreeFloating;
 
//使它成为二维盒子。
box.Shadow = false;
 
//添加一个单选按钮。
Aspose.Cells.RadioButton radio1 = excelbook.Worksheets[0].Shapes.AddRadioButton(3, 0, 2, 0, 30, 110);
 
//设置它的文本字符串。
radio1.Text = "20-29";
 
//将A1单元格设置为单选按钮的链接单元格。
radio1.LinkedCell = "A1";
 
//将单选按钮设为 3-D。
radio1.Shadow = true;
 
//设置单选按钮的前景色。
radio1.FillFormat.ForeColor = Color.LightGreen;
 
//设置单选按钮的线条样式。
radio1.LineFormat.Style = MsoLineStyle.ThickThin;
 
//设置单选按钮的权重。
radio1.LineFormat.Weight = 4;
 
//设置单选按钮的线条颜色。
radio1.LineFormat.ForeColor = Color.Blue;
 
//设置单选按钮的虚线样式。
radio1.LineFormat.DashStyle = MsoLineDashStyle.Solid;
 
//使行格式可见。
radio1.LineFormat.IsVisible = true;
 
//使填充格式可见。
radio1.FillFormat.IsVisible = true;
 
//添加另一个单选按钮。
Aspose.Cells.RadioButton radio2 = excelbook.Worksheets[0].Shapes.AddRadioButton(6, 0, 2, 0, 30, 110);
 
//设置它的文本字符串。
radio2.Text = "30-39";
 
//将A1单元格设置为单选按钮的链接单元格。
radio2.LinkedCell = "A1";
 
//将单选按钮设为 3-D。
radio2.Shadow = true;
 
//设置单选按钮的前景色。
radio2.FillFormat.ForeColor = Color.LightGreen;
 
//设置单选按钮的线条样式。
radio2.LineFormat.Style = MsoLineStyle.ThickThin;
 
//设置单选按钮的权重。
radio2.LineFormat.Weight = 4;
 
//设置单选按钮的线条颜色。
radio2.LineFormat.ForeColor = Color.Blue;
 
//设置单选按钮的虚线样式。
radio2.LineFormat.DashStyle = MsoLineDashStyle.Solid;
 
//使行格式可见。
radio2.LineFormat.IsVisible = true;
 
//使填充格式可见。
radio2.FillFormat.IsVisible = true;
 
//添加另一个单选按钮。
Aspose.Cells.RadioButton radio3 = excelbook.Worksheets[0].Shapes.AddRadioButton(9, 0, 2, 0, 30, 110);
 
//设置它的文本字符串。
radio3.Text = "40-49";
 
//将A1单元格设置为单选按钮的链接单元格。
radio3.LinkedCell = "A1";
 
//将单选按钮设为 3-D。
radio3.Shadow = true;
 
//设置单选按钮的前景色。
radio3.FillFormat.ForeColor = Color.LightGreen;
 
//设置单选按钮的线条样式。
radio3.LineFormat.Style = MsoLineStyle.ThickThin;
 
//设置单选按钮的权重。
radio3.LineFormat.Weight = 4;
 
//设置单选按钮的线条颜色。
radio3.LineFormat.ForeColor = Color.Blue;
 
//设置单选按钮的虚线样式。
radio3.LineFormat.DashStyle = MsoLineDashStyle.Solid;
 
//使行格式可见。
radio3.LineFormat.IsVisible = true;
 
//使填充格式可见。
radio3.FillFormat.IsVisible = true;
 
//获取形状。
Aspose.Cells.Shape[] shapeobjects = new Aspose.Cells.Shape[] { box, radio1, radio2, radio3 };
 
//对形状进行分组。
Aspose.Cells.GroupShape group = excelbook.Worksheets[0].Shapes.Group(shapeobjects);
 
//保存excel文件。
excelbook.Save("groupshapes.xls");

[VB.NET]

'实例化一个新的工作簿。
Dim excelbook As Workbook = New Workbook()
 
'将组框添加到第一个工作表。
Dim box As Aspose.Cells.GroupBox = excelbook.Worksheets(0).Shapes.AddGroupBox(1, 0, 1, 0, 300, 250)
 
'设置组框的标题。
box.Text = "Age Groups"
box.Placement = PlacementType.FreeFloating
 
'使其成为二维盒子。
box.Shadow = False
 
'添加一个单选按钮。
Dim radio1 As Aspose.Cells.RadioButton = excelbook.Worksheets(0).Shapes.AddRadioButton(3, 0, 2, 0, 30, 110)
 
'设置其文本字符串。
radio1.Text = "20-29"
 
'将 A1 单元格设置为单选按钮的链接单元格。
radio1.LinkedCell = "A1"
 
'将单选按钮设为 3-D。
radio1.Shadow = True
 
'设置单选按钮的前景色。
radio1.FillFormat.ForeColor = Color.LightGreen
 
'设置单选按钮的线条样式。
radio1.LineFormat.Style = MsoLineStyle.ThickThin
 
'设置单选按钮的权重。
radio1.LineFormat.Weight = 4
 
'设置单选按钮的线条颜色。
radio1.LineFormat.ForeColor = Color.Blue
 
'设置单选按钮的破折号样式。
radio1.LineFormat.DashStyle = MsoLineDashStyle.Solid
 
'使行格式可见。
radio1.LineFormat.IsVisible = True
 
'使填充格式可见。
radio1.FillFormat.IsVisible = True
 
'添加另一个单选按钮。
Dim radio2 As Aspose.Cells.RadioButton = excelbook.Worksheets(0).Shapes.AddRadioButton(6, 0, 2, 0, 30, 110)
 
'设置其文本字符串。
radio2.Text = "30-39"
 
'将 A1 单元格设置为单选按钮的链接单元格。
radio2.LinkedCell = "A1"
 
'将单选按钮设为 3-D。
radio2.Shadow = True
 
'设置单选按钮的前景色。
radio2.FillFormat.ForeColor = Color.LightGreen
 
'设置单选按钮的线条样式。
radio2.LineFormat.Style = MsoLineStyle.ThickThin
 
'设置单选按钮的权重。
radio2.LineFormat.Weight = 4
 
'设置单选按钮的线条颜色。
radio2.LineFormat.ForeColor = Color.Blue
 
'设置单选按钮的破折号样式。
radio2.LineFormat.DashStyle = MsoLineDashStyle.Solid
 
'使行格式可见。
radio2.LineFormat.IsVisible = True
 
'使填充格式可见。
radio2.FillFormat.IsVisible = True
 
'添加另一个单选按钮。
Dim radio3 As Aspose.Cells.RadioButton = excelbook.Worksheets(0).Shapes.AddRadioButton(9, 0, 2, 0, 30, 110)
 
'设置其文本字符串。
radio3.Text = "40-49"
 
'将 A1 单元格设置为单选按钮的链接单元格。
radio3.LinkedCell = "A1"
 
'将单选按钮设为 3-D。
radio3.Shadow = True
 
'设置单选按钮的前景色。
radio3.FillFormat.ForeColor = Color.LightGreen
 
'设置单选按钮的线条样式。
radio3.LineFormat.Style = MsoLineStyle.ThickThin
 
'设置单选按钮的权重。
radio3.LineFormat.Weight = 4
 
'设置单选按钮的线条颜色。
radio3.LineFormat.ForeColor = Color.Blue
 
'设置单选按钮的破折号样式。
radio3.LineFormat.DashStyle = MsoLineDashStyle.Solid
 
'使行格式可见。
radio3.LineFormat.IsVisible = True
 
'使填充格式可见。
radio3.FillFormat.IsVisible = True
 
'获取形状。
Dim shapeobjects() As Aspose.Cells.Shape = New Aspose.Cells.Shape() {box, radio1, radio2, radio3}
 
'对形状进行分组。
Dim group As Aspose.Cells.GroupShape = excelbook.Worksheets(0).Shapes.Group(shapeobjects)
 
'保存excel文件。
excelbook.Save("groupshapes.xls")

也可以看看

GradientStyleType GroupFill