## Label class

封装表示电子表格中标签的对象。

```csharp
public class Label : Shape
```

## 特性

| 姓名 | 描述 |
| --- | --- |
| [ActiveXControl](../../aspose.cells.drawing/shape/activexcontrol) { get; } | 获取 ActiveX 控件。 |
| [ActualLowerRightRow](../../aspose.cells.drawing/shape/actuallowerrightrow) { get; } | 获取实际的底行。 |
| [AlternativeText](../../aspose.cells.drawing/shape/alternativetext) { get; set; } | 返回或设置的描述性（替代）文本字符串[`Shape`](../shape)对象. |
| [AnchorType](../../aspose.cells.drawing/shape/anchortype) { get; set; } | 获取和设置形状锚占位符。 |
| [AutoShapeType](../../aspose.cells.drawing/shape/autoshapetype) { get; set; } | 获取和设置自动形状类型。 |
| [Bottom](../../aspose.cells.drawing/shape/bottom) { get; set; } | 表示形状与其下底角行垂直偏移的宽度，以像素为单位。 |
| [ControlData](../../aspose.cells.drawing/shape/controldata) { get; } | 获取控件的数据。 |
| [CreateId](../../aspose.cells.drawing/shape/createid) { get; set; } | 获取并设置此形状的创建 ID。 |
| [Fill](../../aspose.cells.drawing/shape/fill) { get; } | 返回一个FillFormat包含指定形状的填充格式属性的对象。 |
| [Font](../../aspose.cells.drawing/shape/font) { get; set; } | 表示形状的字体。 |
| [FormatPicture](../../aspose.cells.drawing/shape/formatpicture) { get; } | 获取和设置图片格式的选项 |
| [Geometry](../../aspose.cells.drawing/shape/geometry) { get; } | 获取几何图形 |
| [Glow](../../aspose.cells.drawing/shape/glow) { get; } | 代表一个为图表元素或形状指定发光效果的对象。 |
| [Group](../../aspose.cells.drawing/shape/group) { get; } | 获取包含此形状的组形状。 |
| [HasLine](../../aspose.cells.drawing/shape/hasline) { get; set; } | 获取并设置形状的线条边框是否可见。 |
| [Height](../../aspose.cells.drawing/shape/height) { get; set; } | 表示形状的高度，以像素为单位。 |
| [HeightCM](../../aspose.cells.drawing/shape/heightcm) { get; set; } | 表示形状的高度，单位为厘米。 |
| [HeightInch](../../aspose.cells.drawing/shape/heightinch) { get; set; } | 表示形状的高度，以英寸为单位。 |
| [HeightInShape](../../aspose.cells.drawing/shape/heightinshape) { get; set; } | 表示 shape 与父 shape 上边框的垂直偏移量，单位为父 shape 高度的 1/4000.. |
| [HeightPt](../../aspose.cells.drawing/shape/heightpt) { get; set; } | 表示形状的高度，以点为单位。 |
| [HeightScale](../../aspose.cells.drawing/shape/heightscale) { get; set; } | 获取和设置高度比例，单位是原始图片高度的百分比。 如果形状不是图片，HeightScale属性只返回100； |
| [HtmlText](../../aspose.cells.drawing/shape/htmltext) { get; set; } | 获取和设置该文本框中包含数据和一些格式的html字符串。 |
| [Hyperlink](../../aspose.cells.drawing/shape/hyperlink) { get; } | 获取形状的超链接。 |
| [Id](../../aspose.cells.drawing/shape/id) { get; } | 获取此形状的标识符。 |
| [InputRange](../../aspose.cells.drawing/shape/inputrange) { get; set; } | 获取或设置用于填充指定组合框的工作表范围。 |
| [IsEquation](../../aspose.cells.drawing/shape/isequation) { get; } | 表示形状是否只包含方程。 |
| [IsFilled](../../aspose.cells.drawing/shape/isfilled) { get; set; } | 表示填充格式是否可见。 |
| [IsFlippedHorizontally](../../aspose.cells.drawing/shape/isflippedhorizontally) { get; set; } | 获取并设置形状是否水平翻转。 |
| [IsFlippedVertically](../../aspose.cells.drawing/shape/isflippedvertically) { get; set; } | 获取并设置形状是否垂直翻转。 |
| [IsGroup](../../aspose.cells.drawing/shape/isgroup) { get; } | 表示形状是否为组。 |
| [IsHidden](../../aspose.cells.drawing/shape/ishidden) { get; set; } | 表示对象是否可见。 |
| [IsInGroup](../../aspose.cells.drawing/shape/isingroup) { get; } | 表示形状是否被分组。 |
| [IsLockAspectRatio](../../aspose.cells.drawing/shape/islockaspectratio) { get; set; } | True 表示不允许更改纵横比。 |
| [IsLocked](../../aspose.cells.drawing/shape/islocked) { get; set; } | 如果对象被锁定，则为 True，如果在工作表受保护时可以修改对象，则为 False。 |
| [IsPrintable](../../aspose.cells.drawing/shape/isprintable) { get; set; } | 如果对象是可打印的，则为真 |
| [IsRichText](../../aspose.cells.drawing/shape/isrichtext) { get; } | 文本是否为富文本。 |
| [IsSmartArt](../../aspose.cells.drawing/shape/issmartart) { get; } | 表示形状是否为智能艺术。 |
| [IsTextWrapped](../../aspose.cells.drawing/shape/istextwrapped) { get; set; } | 获取和设置包含文本的形状的文本换行类型。 |
| [IsWordArt](../../aspose.cells.drawing/shape/iswordart) { get; } | 表示这个形状是否是艺术字。 |
| [Left](../../aspose.cells.drawing/shape/left) { get; set; } | 表示形状与其左列的水平偏移量，以像素为单位。 |
| [LeftCM](../../aspose.cells.drawing/shape/leftcm) { get; set; } | 表示形状与其左列的水平偏移量，单位为厘米。 |
| [LeftInch](../../aspose.cells.drawing/shape/leftinch) { get; set; } | 表示形状与其左列的水平偏移量，单位为英寸。 |
| [LeftInShape](../../aspose.cells.drawing/shape/leftinshape) { get; set; } | 表示 shape 与父 shape 左边框的水平偏移量， 以父 shape 宽度的 1/4000 为单位。 |
| [LeftToCorner](../../aspose.cells.drawing/shape/lefttocorner) { get; set; } | 获取和设置形状从工作表左边框的水平偏移量。 |
| [Line](../../aspose.cells.drawing/shape/line) { get; } | 获取线条样式 |
| [LinkedCell](../../aspose.cells.drawing/shape/linkedcell) { get; set; } | 获取或设置链接到控件值的工作表范围。 |
| [LowerDeltaX](../../aspose.cells.drawing/shape/lowerdeltax) { get; set; } | 获取或设置形状与其右下角列的水平偏移量。 |
| [LowerDeltaY](../../aspose.cells.drawing/shape/lowerdeltay) { get; set; } | 获取或设置形状与其右下角行的垂直偏移量。 |
| [LowerRightColumn](../../aspose.cells.drawing/shape/lowerrightcolumn) { get; set; } | 表示右下角列索引。 |
| [LowerRightRow](../../aspose.cells.drawing/shape/lowerrightrow) { get; set; } | 代表右下角行索引。 |
| [MacroName](../../aspose.cells.drawing/shape/macroname) { get; set; } | 获取和设置宏的名称。 |
| [MsoDrawingType](../../aspose.cells.drawing/shape/msodrawingtype) { get; } | 获取 mso 绘图类型。 |
| [Name](../../aspose.cells.drawing/shape/name) { get; set; } | 获取和设置形状的名称。 |
| [Paths](../../aspose.cells.drawing/shape/paths) { get; } | 获取自定义几何形状的路径。 |
| [Placement](../../aspose.cells.drawing/shape/placement) { get; set; } | 表示绘图对象附加到其下方单元格的方式。 该属性控制对象在工作表上的放置。 |
| [Reflection](../../aspose.cells.drawing/shape/reflection) { get; } | 代表一个指定图表元素或形状的反射效果的对象。 |
| [RelativeToOriginalPictureSize](../../aspose.cells.drawing/shape/relativetooriginalpicturesize) { get; set; } | 表示形状是否相对于原始图片大小。 |
| [Right](../../aspose.cells.drawing/shape/right) { get; set; } | 表示形状从其右下角列水平偏移的宽度，以像素为单位。 |
| [RotationAngle](../../aspose.cells.drawing/shape/rotationangle) { get; set; } | 获取和设置形状的旋转。 |
| [ShadowEffect](../../aspose.cells.drawing/shape/shadoweffect) { get; } | 代表一个为图表元素或形状指定阴影效果的对象。 |
| [SoftEdges](../../aspose.cells.drawing/shape/softedges) { get; set; } | 获取和设置应用于边缘的模糊半径，以点为单位。 |
| [Spid](../../aspose.cells.drawing/shape/spid) { get; } | 指定应用程序可以用来识别特定形状的可选字符串。 |
| [Spt](../../aspose.cells.drawing/shape/spt) { get; } | 指定一个可选数字，应用程序可以使用该数字将特定形状与定义的形状类型相关联。 |
| [Text](../../aspose.cells.drawing/shape/text) { get; set; } | 表示此 TextBox 对象中的字符串。 |
| [TextBody](../../aspose.cells.drawing/shape/textbody) { get; } | 获取和设置形状文本的设置。 |
| [TextDirection](../../aspose.cells.drawing/shape/textdirection) { get; set; } | 获取/设置此对象的文本流方向。 |
| [TextEffect](../../aspose.cells.drawing/shape/texteffect) { get; } | 返回一个 TextEffectFormat 对象，该对象包含指定形状的文本效果格式属性。 适用于代表艺术字的 Shape 对象。 |
| [TextHorizontalAlignment](../../aspose.cells.drawing/shape/texthorizontalalignment) { get; set; } | 获取和设置形状的文本水平对齐类型。 |
| [TextHorizontalOverflow](../../aspose.cells.drawing/shape/texthorizontaloverflow) { get; set; } | 获取和设置包含文本的形状的文本水平溢出类型。 |
| [TextOptions](../../aspose.cells.drawing/shape/textoptions) { get; set; } | 表示形状的文本选项。 |
| [TextOrientationType](../../aspose.cells.drawing/shape/textorientationtype) { get; set; } | 获取和设置形状的文本方向类型。 |
| [TextShapeType](../../aspose.cells.drawing/shape/textshapetype) { get; set; } | 获取和设置预设的文字形状类型。 |
| [TextVerticalAlignment](../../aspose.cells.drawing/shape/textverticalalignment) { get; set; } | 获取和设置形状的文本垂直对齐类型。 |
| [TextVerticalOverflow](../../aspose.cells.drawing/shape/textverticaloverflow) { get; set; } | 获取并设置包含文本的形状的文本垂直溢出类型。 |
| [ThreeDFormat](../../aspose.cells.drawing/shape/threedformat) { get; } | 获取并设置形状的 3d 格式。 |
| [Title](../../aspose.cells.drawing/shape/title) { get; set; } | 指定当前形状对象的标题（标题）。 |
| [Top](../../aspose.cells.drawing/shape/top) { get; set; } | 表示形状与其顶行的垂直偏移量，以像素为单位。 |
| [TopCM](../../aspose.cells.drawing/shape/topcm) { get; set; } | 表示形状与其顶行的垂直偏移量，单位为厘米。 |
| [TopInch](../../aspose.cells.drawing/shape/topinch) { get; set; } | 表示形状与其顶行的垂直偏移量，以英寸为单位。 |
| [TopInShape](../../aspose.cells.drawing/shape/topinshape) { get; set; } | 表示 shape 与父 shape 上边框的垂直偏移量， 以父 shape 高度的 1/4000 为单位。 |
| [TopToCorner](../../aspose.cells.drawing/shape/toptocorner) { get; set; } | 获取和设置形状相对于工作表上边框的垂直偏移量，以像素为单位。 |
| [Type](../../aspose.cells.drawing/shape/type) { get; } | 获取自动形状类型。 |
| [UpperDeltaX](../../aspose.cells.drawing/shape/upperdeltax) { get; set; } | 获取或设置形状与其左上角列的水平偏移量。 |
| [UpperDeltaY](../../aspose.cells.drawing/shape/upperdeltay) { get; set; } | 获取或设置形状与其左上角行的垂直偏移量。 |
| [UpperLeftColumn](../../aspose.cells.drawing/shape/upperleftcolumn) { get; set; } | 表示左上角列索引。 |
| [UpperLeftRow](../../aspose.cells.drawing/shape/upperleftrow) { get; set; } | 表示左上角行索引。 |
| [Width](../../aspose.cells.drawing/shape/width) { get; set; } | 表示形状的宽度，以像素为单位。 |
| [WidthCM](../../aspose.cells.drawing/shape/widthcm) { get; set; } | 表示形状的宽度，单位为厘米。 |
| [WidthInch](../../aspose.cells.drawing/shape/widthinch) { get; set; } | 表示形状的宽度，单位为英寸。 |
| [WidthInShape](../../aspose.cells.drawing/shape/widthinshape) { get; set; } | 表示形状的宽度，单位为父形状的1/4000。 |
| [WidthPt](../../aspose.cells.drawing/shape/widthpt) { get; set; } | 表示形状的宽度，以点为单位。 |
| [WidthScale](../../aspose.cells.drawing/shape/widthscale) { get; set; } | 获取和设置宽度比例，单位是原始图片宽度的百分比。 如果形状不是图片，WidthScale属性只返回100； |
| [Worksheet](../../aspose.cells.drawing/shape/worksheet) { get; } | 获取[`Worksheet`](../shape/worksheet)包含此形状的对象。 |
| [X](../../aspose.cells.drawing/shape/x) { get; set; } | 获取和设置形状相对工作表左边框的水平偏移量，以像素为单位。 |
| [Y](../../aspose.cells.drawing/shape/y) { get; set; } | 获取和设置形状相对工作表上边框的垂直偏移量，以像素为单位。 |
| [ZOrderPosition](../../aspose.cells.drawing/shape/zorderposition) { get; set; } | 返回形状在 z 顺序中的位置。 |

## 方法

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

### 例子

```csharp
//创建一个新的工作簿。
Workbook workbook = new Workbook();
 
//获取工作簿中的第一个工作表。
Worksheet sheet = workbook.Worksheets[0];
 
//向工作表添加一个新标签。
Aspose.Cells.Drawing.Label label = sheet.Shapes.AddLabel(2, 0, 2, 0, 60, 120);
 
//设置标签的标题。
label.Text = "This is a Label";
 
//设置Placement Type，方式
//标签附加到单元格上。
label.Placement = PlacementType.FreeFloating;
 
//设置标签的填充颜色。
label.Fill.FillType = FillType.Solid;
label.Fill.SolidFill.Color = Color.Yellow;
 
//保存文件。
workbook.Save("tstlabel.xls");

[VB.NET]

创建一个新的工作簿。
Dim workbook As Workbook = New Workbook()
 
'获取工作簿中的第一个工作表。
Dim sheet As Worksheet = workbook.Worksheets(0)
 
'将新标签添加到工作表。
Dim label As Aspose.Cells.Drawing.Label = sheet.Shapes.AddLabel(2, 0, 2, 0, 60, 120)
 
'设置标签的标题。
label.Text = "This is a Label"
 
'设置放置类型，方式
'标签贴在细胞上。
label.Placement = PlacementType.FreeFloating
 
'设置标签的填充颜色。
label.Fill.FillType = FillType.Solid
label.Fill.SolidFill.Color = Color.Yellow
 
'保存文件。
workbook.Save("tstlabel.xls")
```

### 也可以看看

* class [Shape](../shape)
* 命名空间 [Aspose.Cells.Drawing](../../aspose.cells.drawing)
* 部件 [Aspose.Cells](../../)

<!-- DO NOT EDIT: generated by xmldocmd for Aspose.Cells.dll -->