How to: Add Text to a Shape
- 2 minutes to read
This topic describes how to add text to a shape.
#Create a Text Box
Call the ShapeCollection.AddTextBox method to create a text box.
The code sample below shows how to insert, rotate and color a text box:
Shape textBox = worksheet.Shapes.AddTextBox(50, 120, 500, 100, "Spreadsheet");
textBox.Fill.SetSolidFill(Color.PowderBlue);
textBox.Rotation = 30;
Tip
You can change the text box’s geometry type by setting the Shape
#Add Text to an Existing Shape
The table below lists API members used to add and format shape text:
Member | Description |
---|---|
Shape. |
Returns shape text options. |
Shape |
Returns a Shape |
Shape |
Defines shape text. |
Shape |
Allows you to link shape text to a cell. |
Shape |
Adds a new text range before the current range. |
Shape |
Adds a new text range after the current range. |
Shape |
Allows you to change font attributes for a shape text range. |
Shape |
Allows you to specify paragraph options for a shape text range. |
Shape |
Specifies the vertical alignment for shape text. |
Shape |
Specifies the horizontal alignment for shape text. |
The code sample below creates and formats shape text to look as it does on the image below.
ShapeText shapeText = shape.ShapeText;
// Create a text range.
ShapeTextRange range = shapeText.Characters();
// Specify the shape's text.
range.Text = "Shape ";
// Set font properties.
range.Font.Bold = true;
range.Font.Color = Color.YellowGreen;
// Add a new text range after the existing text
// and specify its font attributes.
ShapeTextRange range2 = range.AddAfter("Text");
range2.Font.Italic = true;
range2.Font.Name = "Arial";
range2.Font.Color = Color.BurlyWood;
// Define the text's vertical and horizontal alignment.
shapeText.VerticalAnchor = ShapeTextVerticalAnchorType.Center;
shapeText.HorizontalAnchor = ShapeTextHorizontalAnchorType.Center;