Class Run
Represents a single run of text within a text content element.
Implements
Inherited Members
Namespace: IronWord.Models
Assembly: IronWord.dll
Syntax
public class Run : ParentElement, IDocumentElement, IDocumentObject, ICloneable, IDrawContainer, ITextContainer, IDocumentTextElementContainer<TextStyle>Constructors
Run()
Initializes a new instance of the Run class.
Declaration
public Run()Run(ImageContent[])
Initializes a new instance of the Run class with the specified child elements.
Declaration
public Run(params ImageContent[] children)Parameters
| Type | Name | Description |
|---|---|---|
| ImageContent[] | children | The child elements to be added. |
Run(ShapeContent[])
Initializes a new instance of the Run class with the specified child elements.
Declaration
public Run(params ShapeContent[] children)Parameters
| Type | Name | Description |
|---|---|---|
| ShapeContent[] | children | The child elements to be added. |
Run(TextContent[])
Initializes a new instance of the Run class with the specified child elements.
Declaration
public Run(params TextContent[] children)Parameters
| Type | Name | Description |
|---|---|---|
| TextContent[] | children | The child elements to be added. |
Properties
Index
Gets the index of this Run within the parent's list of children.
Declaration
public int Index { get; set; }Property Value
| Type | Description |
|---|---|
| System.Int32 |
Style
Gets or sets the TextStyle applied to this Run.
Declaration
public TextStyle Style { get; set; }Property Value
| Type | Description |
|---|---|
| TextStyle |
Methods
AddImage(AnyBitmap)
Adds an image to this Run.
Declaration
public ImageContent AddImage(AnyBitmap anyBitmap)Parameters
| Type | Name | Description |
|---|---|---|
| IronSoftware.Drawing.AnyBitmap | anyBitmap |
Returns
| Type | Description |
|---|---|
| ImageContent |
AddImage(ImageContent)
Adds an Image element to this Run.
Declaration
public ImageContent AddImage(ImageContent imageContent)Parameters
| Type | Name | Description |
|---|---|---|
| ImageContent | imageContent | The Image element to add. |
Returns
| Type | Description |
|---|---|
| ImageContent |
AddImage(Stream)
Adds an Image element to this Run using a stream containing the image data.
Declaration
public ImageContent AddImage(Stream imageStream)Parameters
| Type | Name | Description |
|---|---|---|
| System.IO.Stream | imageStream | The Stream containing the image data. |
Returns
| Type | Description |
|---|---|
| ImageContent |
AddImage(String)
Adds an Image element to this Run using an image path.
Declaration
public ImageContent AddImage(string imagePath)Parameters
| Type | Name | Description |
|---|---|---|
| System.String | imagePath | The path to the image file. |
Returns
| Type | Description |
|---|---|
| ImageContent |
AddShape(ShapeContent)
Adds an Image element to this Run.
Declaration
public ShapeContent AddShape(ShapeContent shapeContent)Parameters
| Type | Name | Description |
|---|---|---|
| ShapeContent | shapeContent | The Shape element to add. |
Returns
| Type | Description |
|---|---|
| ShapeContent |
AddText(TextContent)
Adds an Text element to this Run.
Declaration
public TextContent AddText(TextContent textContent)Parameters
| Type | Name | Description |
|---|---|---|
| TextContent | textContent | The Text element to add. |
Returns
| Type | Description |
|---|---|
| TextContent |
AddText(String)
Adds an text content to this Run.
Declaration
public TextContent AddText(string text)Parameters
| Type | Name | Description |
|---|---|---|
| System.String | text | The text content to add. |
Returns
| Type | Description |
|---|---|
| TextContent |
ExtractImages()
Extract all images from this container
Declaration
public List<AnyBitmap> ExtractImages()Returns
| Type | Description |
|---|---|
| System.Collections.Generic.List<IronSoftware.Drawing.AnyBitmap> | List of images |
ExtractShapes()
Extract all shapes from this container
Declaration
public List<IReadOnlyCollection<IPathSegment>> ExtractShapes()Returns
| Type | Description |
|---|---|
| System.Collections.Generic.List<System.Collections.Generic.IReadOnlyCollection<IronSoftware.IPathSegment>> | List of path segment collections |
ExtractText()
Extract all text from the container
Declaration
public string ExtractText()Returns
| Type | Description |
|---|---|
| System.String | Extracted text |
FindText(String)
Find the first text element which contains the specified text
Declaration
public TextContent FindText(string find)Parameters
| Type | Name | Description |
|---|---|---|
| System.String | find | Text to find |
Returns
| Type | Description |
|---|---|
| TextContent | Text element containing the specified text |
Remove(TextContent)
Remove the specified text element
Declaration
public bool Remove(TextContent element)Parameters
| Type | Name | Description |
|---|---|---|
| TextContent | element | Text element to remove |
Returns
| Type | Description |
|---|---|
| System.Boolean | True if the element was found and removed, False otherwise |
ReplaceText(String, String)
Replace all instances of the specified text
Declaration
public void ReplaceText(string find, string replace)Parameters
| Type | Name | Description |
|---|---|---|
| System.String | find | Text to replace |
| System.String | replace | Replacement text |