ShapeCollection.InsertTextBox(DocumentPosition, RectangleF) Method
Inserts a text box at the specified position in the document.
Namespace: DevExpress.XtraRichEdit.API.Native
Assembly: DevExpress.RichEdit.v24.2.Core.dll
NuGet Package: DevExpress.RichEdit.Core
#Declaration
Shape InsertTextBox(
DocumentPosition pos,
RectangleF bounds
)
#Parameters
Name | Type | Description |
---|---|---|
pos | Document |
The position of the text box’s anchor. |
bounds | Rectangle |
An object that specifies the text box’s size and location (relative to the top and left edges of the page). The Document. |
#Returns
Type | Description |
---|---|
Shape | The text box embedded in the document. |
#Remarks
Use the Shape.ShapeFormat.TextBox.Document property to access and modify text box content.
The example below creates a text box and places it on the page as follows:
the absolute horizontal position is 1.5 inches to the right of the page;
the absolute vertical position is one inch below the page.
Document document = wordProcessor.Document;
document.Unit = DevExpress.Office.DocumentUnit.Inch;
// Create a text box.
Shape myTextBox = document.Shapes.InsertTextBox(document.Range.Start, new RectangleF(1.5f, 1f, 1.5f, 0.5f));
// Specify the text box background color.
myTextBox.Fill.Color = System.Drawing.Color.WhiteSmoke;
// Draw a border around the text box.
myTextBox.Line.Color = System.Drawing.Color.Black;
myTextBox.Line.Thickness = 1;
// Modify text box content.
SubDocument textBoxDocument = myTextBox.ShapeFormat.TextBox.Document;
textBoxDocument.AppendText("Text box");
CharacterProperties cp = textBoxDocument.BeginUpdateCharacters(textBoxDocument.Range.Start, 4);
cp.ForeColor = System.Drawing.Color.Orange;
cp.FontSize = 24;
textBoxDocument.EndUpdateCharacters(cp);