# GrapeCity.Documents.Word.Run

## Content

<div class="doc-site-dotnet-api-container">



  <h1 id="GrapeCity_Documents_Word_Run" data-uid="GrapeCity.Documents.Word.Run" class="text-break">Run Class
</h1>
  <div class="markdown level0 summary"><p>Represents a contiguous fragment of a body content with uniform formatting.</p>
<p>
Use <a class="xref" href="GrapeCity.Documents.Word.ContentObject.GetRange.html#GrapeCity_Documents_Word_ContentObject_GetRange">GetRange()</a> to access the range of objects inside a run.
</p>
</div>
  <div class="markdown level0 conceptual"></div>
  <div class="inheritance">
    <h5>Inheritance</h5>
    <div class="level0"><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.object">object</a></div>
    <div class="level1"><a class="xref" href="GrapeCity.Documents.Word.ContentObject.html">ContentObject</a></div>
    <div class="level2"><a class="xref" href="GrapeCity.Documents.Word.FormattedContentObject.html">FormattedContentObject</a></div>
    <div class="level3"><span class="xref">Run</span></div>
  </div>
  <div class="implements">
    <h5>Implements</h5>
    <div><a class="xref" href="GrapeCity.Documents.Word.IBrowsable-1.html">IBrowsable</a>&lt;<a class="xref" href="GrapeCity.Documents.Word.Run.html">Run</a>&gt;</div>
  </div>
  <h6><strong>Namespace</strong>: <a class="xref" href="GrapeCity.Documents.Word.html">GrapeCity.Documents.Word</a></h6>
  <h6><strong>Assembly</strong>: DS.Documents.Word.dll</h6>
  <h5 id="GrapeCity_Documents_Word_Run_syntax">Syntax</h5>
  <div class="codewrapper">
    <pre><code class="lang-csharp hljs">public class Run : FormattedContentObject, IBrowsable&lt;Run&gt;</code></pre>
  </div>
  <div class="codewrapper">
    <pre><code class="lang-vbnet hljs">Public Class Run
    Inherits FormattedContentObject
    Implements IBrowsable(Of Run)</code></pre>
  </div>
  <h5 id="GrapeCity_Documents_Word_Run_remarks"><strong>Remarks</strong></h5>
  <div class="markdown level0 remarks"><p>A run most commonly contains a single <a class="xref" href="GrapeCity.Documents.Word.Text.html">Text</a> object,
but it can also contain no or more than one texts and/or other objects.</p>
</div>
  <h5 id="GrapeCity_Documents_Word_Run_examples"><strong>Examples</strong></h5>
  <p>To get a string representing all text in a run:</p>
<pre><code class="lang-csharp">string text = run.GetRange().Text;</code></pre>

  <h3 id="properties">Properties
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_Font" data-uid="GrapeCity.Documents.Word.Run.Font">
          <a class="xref" href="GrapeCity.Documents.Word.Run.Font.html#GrapeCity_Documents_Word_Run_Font">Font</a>
        </td>
        <td class="markdown level1 summary"><p>Provides access to font formatting of this run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_IsOMathRun" data-uid="GrapeCity.Documents.Word.Run.IsOMathRun">
          <a class="xref" href="GrapeCity.Documents.Word.Run.IsOMathRun.html#GrapeCity_Documents_Word_Run_IsOMathRun">IsOMathRun</a>
        </td>
        <td class="markdown level1 summary"><p>Gets whether the run belongs to an Office Math zone.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_Next" data-uid="GrapeCity.Documents.Word.Run.Next">
          <a class="xref" href="GrapeCity.Documents.Word.Run.Next.html#GrapeCity_Documents_Word_Run_Next">Next</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the next run content.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_OMathFormat" data-uid="GrapeCity.Documents.Word.Run.OMathFormat">
          <a class="xref" href="GrapeCity.Documents.Word.Run.OMathFormat.html#GrapeCity_Documents_Word_Run_OMathFormat">OMathFormat</a>
        </td>
        <td class="markdown level1 summary"><p>Gets Office Math formatting for the run if the <a class="xref" href="GrapeCity.Documents.Word.Run.IsOMathRun.html#GrapeCity_Documents_Word_Run_IsOMathRun">IsOMathRun</a> property is set to <a href="https://learn.microsoft.com/dotnet/csharp/language-reference/builtin-types/bool">true</a>.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_Previous" data-uid="GrapeCity.Documents.Word.Run.Previous">
          <a class="xref" href="GrapeCity.Documents.Word.Run.Previous.html#GrapeCity_Documents_Word_Run_Previous">Previous</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the previous run content.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_RevisionId" data-uid="GrapeCity.Documents.Word.Run.RevisionId">
          <a class="xref" href="GrapeCity.Documents.Word.Run.RevisionId.html#GrapeCity_Documents_Word_Run_RevisionId">RevisionId</a>
        </td>
        <td class="markdown level1 summary"><p>Gets unique identifiers used to track the run editing session.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_Style" data-uid="GrapeCity.Documents.Word.Run.Style">
          <a class="xref" href="GrapeCity.Documents.Word.Run.Style.html#GrapeCity_Documents_Word_Run_Style">Style</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets character or linked paragraph style which shall be used to format the contents of this run.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="methods">Methods
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddBreak" data-uid="GrapeCity.Documents.Word.Run.AddBreak">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddBreak.html#GrapeCity_Documents_Word_Run_AddBreak">AddBreak()</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a <a class="xref" href="GrapeCity.Documents.Word.Break.html">Break</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddBreak_GrapeCity_Documents_Word_BreakType_" data-uid="GrapeCity.Documents.Word.Run.AddBreak(GrapeCity.Documents.Word.BreakType)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddBreak.html#GrapeCity_Documents_Word_Run_AddBreak_GrapeCity_Documents_Word_BreakType_">AddBreak(BreakType)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a <a class="xref" href="GrapeCity.Documents.Word.Break.html">Break</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddBreak_GrapeCity_Documents_Word_BreakType_GrapeCity_Documents_Word_BreakClear_" data-uid="GrapeCity.Documents.Word.Run.AddBreak(GrapeCity.Documents.Word.BreakType,GrapeCity.Documents.Word.BreakClear)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddBreak.html#GrapeCity_Documents_Word_Run_AddBreak_GrapeCity_Documents_Word_BreakType_GrapeCity_Documents_Word_BreakClear_">AddBreak(BreakType, BreakClear)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a <a class="xref" href="GrapeCity.Documents.Word.Break.html">Break</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddCanvasShape" data-uid="GrapeCity.Documents.Word.Run.AddCanvasShape">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddCanvasShape.html#GrapeCity_Documents_Word_Run_AddCanvasShape">AddCanvasShape()</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a <a class="xref" href="GrapeCity.Documents.Word.CanvasShape.html">CanvasShape</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddCanvasShape_System_Single_System_Single_" data-uid="GrapeCity.Documents.Word.Run.AddCanvasShape(System.Single,System.Single)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddCanvasShape.html#GrapeCity_Documents_Word_Run_AddCanvasShape_System_Single_System_Single_">AddCanvasShape(float, float)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a <a class="xref" href="GrapeCity.Documents.Word.CanvasShape.html">CanvasShape</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddGroupShape" data-uid="GrapeCity.Documents.Word.Run.AddGroupShape">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddGroupShape.html#GrapeCity_Documents_Word_Run_AddGroupShape">AddGroupShape()</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a <a class="xref" href="GrapeCity.Documents.Word.GroupShape.html">GroupShape</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddGroupShape_System_Single_System_Single_" data-uid="GrapeCity.Documents.Word.Run.AddGroupShape(System.Single,System.Single)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddGroupShape.html#GrapeCity_Documents_Word_Run_AddGroupShape_System_Single_System_Single_">AddGroupShape(float, float)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a <a class="xref" href="GrapeCity.Documents.Word.GroupShape.html">GroupShape</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddInkShape_System_Xml_XmlDocument_" data-uid="GrapeCity.Documents.Word.Run.AddInkShape(System.Xml.XmlDocument)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddInkShape.html#GrapeCity_Documents_Word_Run_AddInkShape_System_Xml_XmlDocument_">AddInkShape(XmlDocument)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds an <a class="xref" href="GrapeCity.Documents.Word.InkShape.html">InkShape</a>&gt; to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddInkShape_System_Xml_XmlDocument_System_Single_System_Single_" data-uid="GrapeCity.Documents.Word.Run.AddInkShape(System.Xml.XmlDocument,System.Single,System.Single)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddInkShape.html#GrapeCity_Documents_Word_Run_AddInkShape_System_Xml_XmlDocument_System_Single_System_Single_">AddInkShape(XmlDocument, float, float)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds an <a class="xref" href="GrapeCity.Documents.Word.InkShape.html">InkShape</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddLastRenderedPageBreak" data-uid="GrapeCity.Documents.Word.Run.AddLastRenderedPageBreak">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddLastRenderedPageBreak.html#GrapeCity_Documents_Word_Run_AddLastRenderedPageBreak">AddLastRenderedPageBreak()</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a <a class="xref" href="GrapeCity.Documents.Word.LastRenderedPageBreak.html">LastRenderedPageBreak</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddPicture" data-uid="GrapeCity.Documents.Word.Run.AddPicture">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddPicture.html#GrapeCity_Documents_Word_Run_AddPicture">AddPicture()</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a new <a class="xref" href="GrapeCity.Documents.Word.Picture.html">Picture</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddPicture_GrapeCity_Documents_Drawing_Image_" data-uid="GrapeCity.Documents.Word.Run.AddPicture(GrapeCity.Documents.Drawing.Image)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddPicture.html#GrapeCity_Documents_Word_Run_AddPicture_GrapeCity_Documents_Drawing_Image_">AddPicture(Image)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a new <a class="xref" href="GrapeCity.Documents.Word.Picture.html">Picture</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddPicture_System_Byte___System_String_" data-uid="GrapeCity.Documents.Word.Run.AddPicture(System.Byte[],System.String)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddPicture.html#GrapeCity_Documents_Word_Run_AddPicture_System_Byte___System_String_">AddPicture(byte[], string)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a new <a class="xref" href="GrapeCity.Documents.Word.Picture.html">Picture</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddPicture_System_Byte___System_String_System_Single_System_Single_" data-uid="GrapeCity.Documents.Word.Run.AddPicture(System.Byte[],System.String,System.Single,System.Single)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddPicture.html#GrapeCity_Documents_Word_Run_AddPicture_System_Byte___System_String_System_Single_System_Single_">AddPicture(byte[], string, float, float)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a new <a class="xref" href="GrapeCity.Documents.Word.Picture.html">Picture</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddShape" data-uid="GrapeCity.Documents.Word.Run.AddShape">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddShape.html#GrapeCity_Documents_Word_Run_AddShape">AddShape()</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a new <a class="xref" href="GrapeCity.Documents.Word.GeometryType.html#GrapeCity_Documents_Word_GeometryType_Rectangle">Rectangle</a> <a class="xref" href="GrapeCity.Documents.Word.Shape.html">Shape</a> (100 x 100 points) to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddShape_System_Single_System_Single_GrapeCity_Documents_Word_GeometryType_" data-uid="GrapeCity.Documents.Word.Run.AddShape(System.Single,System.Single,GrapeCity.Documents.Word.GeometryType)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddShape.html#GrapeCity_Documents_Word_Run_AddShape_System_Single_System_Single_GrapeCity_Documents_Word_GeometryType_">AddShape(float, float, GeometryType)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a new <a class="xref" href="GrapeCity.Documents.Word.Shape.html">Shape</a> with a specified size and text to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddShape_System_Single_System_Single_System_String_" data-uid="GrapeCity.Documents.Word.Run.AddShape(System.Single,System.Single,System.String)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddShape.html#GrapeCity_Documents_Word_Run_AddShape_System_Single_System_Single_System_String_">AddShape(float, float, string)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a new <a class="xref" href="GrapeCity.Documents.Word.GeometryType.html#GrapeCity_Documents_Word_GeometryType_Rectangle">Rectangle</a> <a class="xref" href="GrapeCity.Documents.Word.Shape.html">Shape</a> with a specified size and text to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddShape_System_Single_System_Single_System_String_GrapeCity_Documents_Word_GeometryType_" data-uid="GrapeCity.Documents.Word.Run.AddShape(System.Single,System.Single,System.String,GrapeCity.Documents.Word.GeometryType)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddShape.html#GrapeCity_Documents_Word_Run_AddShape_System_Single_System_Single_System_String_GrapeCity_Documents_Word_GeometryType_">AddShape(float, float, string, GeometryType)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a new <a class="xref" href="GrapeCity.Documents.Word.Shape.html">Shape</a> with a specified size, text and geometry to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddSymbol_System_Char_System_String_" data-uid="GrapeCity.Documents.Word.Run.AddSymbol(System.Char,System.String)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddSymbol.html#GrapeCity_Documents_Word_Run_AddSymbol_System_Char_System_String_">AddSymbol(char, string)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a <a class="xref" href="GrapeCity.Documents.Word.Symbol.html">Symbol</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddTab" data-uid="GrapeCity.Documents.Word.Run.AddTab">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddTab.html#GrapeCity_Documents_Word_Run_AddTab">AddTab()</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a <a class="xref" href="GrapeCity.Documents.Word.Tab.html">Tab</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddTab_GrapeCity_Documents_Word_TabAlignment_" data-uid="GrapeCity.Documents.Word.Run.AddTab(GrapeCity.Documents.Word.TabAlignment)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddTab.html#GrapeCity_Documents_Word_Run_AddTab_GrapeCity_Documents_Word_TabAlignment_">AddTab(TabAlignment)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a <a class="xref" href="GrapeCity.Documents.Word.Tab.html">Tab</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddTab_GrapeCity_Documents_Word_TabAlignment_GrapeCity_Documents_Word_TabLeader_" data-uid="GrapeCity.Documents.Word.Run.AddTab(GrapeCity.Documents.Word.TabAlignment,GrapeCity.Documents.Word.TabLeader)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddTab.html#GrapeCity_Documents_Word_Run_AddTab_GrapeCity_Documents_Word_TabAlignment_GrapeCity_Documents_Word_TabLeader_">AddTab(TabAlignment, TabLeader)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a <a class="xref" href="GrapeCity.Documents.Word.Tab.html">Tab</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddTab_GrapeCity_Documents_Word_TabAlignment_GrapeCity_Documents_Word_TabLeader_GrapeCity_Documents_Word_TabRelativeTo_" data-uid="GrapeCity.Documents.Word.Run.AddTab(GrapeCity.Documents.Word.TabAlignment,GrapeCity.Documents.Word.TabLeader,GrapeCity.Documents.Word.TabRelativeTo)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddTab.html#GrapeCity_Documents_Word_Run_AddTab_GrapeCity_Documents_Word_TabAlignment_GrapeCity_Documents_Word_TabLeader_GrapeCity_Documents_Word_TabRelativeTo_">AddTab(TabAlignment, TabLeader, TabRelativeTo)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a <a class="xref" href="GrapeCity.Documents.Word.Tab.html">Tab</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_AddText_System_String_" data-uid="GrapeCity.Documents.Word.Run.AddText(System.String)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.AddText.html#GrapeCity_Documents_Word_Run_AddText_System_String_">AddText(string)</a>
        </td>
        <td class="markdown level1 summary"><p>Adds a <a class="xref" href="GrapeCity.Documents.Word.Text.html">Text</a> to the end of the run.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Word_Run_Split_GrapeCity_Documents_Word_ContentObject_GrapeCity_Documents_Word_InsertLocation_" data-uid="GrapeCity.Documents.Word.Run.Split(GrapeCity.Documents.Word.ContentObject,GrapeCity.Documents.Word.InsertLocation)">
          <a class="xref" href="GrapeCity.Documents.Word.Run.Split.html#GrapeCity_Documents_Word_Run_Split_GrapeCity_Documents_Word_ContentObject_GrapeCity_Documents_Word_InsertLocation_">Split(ContentObject, InsertLocation)</a>
        </td>
        <td class="markdown level1 summary"><p>Splits the run at a specified location relative to a specified child content.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="seealso">See Also</h3>
  <div class="seealso">
      <div><a class="xref" href="GrapeCity.Documents.Word.Text.html">Text</a></div>
  </div>

</div>
