AddTextRun(String,Font) Method

Adds a text run to the current paragraph.

Syntax

Visual Basic

'Declaration
 
Public Overloads Sub AddTextRun( _
   ByVal text As String, _
   ByVal font As Font _
) 

C#

public void AddTextRun( 
   string text,
   Font font
)

Parameters

text

The string value to write.

font

The font that is applied to all characters in the run.

Exceptions

Exception	Description
WordDocumentWriterException	Thrown if no document or paragraph is currently open.
WordDocumentWriterXmlWriterException	Thrown if the XmlWriter used to write content to the stream throws an exception.

Remarks

A new Font instance can be obtained using the CreateFont method. An existing Font instance can also be used; changing properties on that instance does not affect previously added text runs because the information is written to the stream immediately.

Before the AddTextRun method can be called, the developer must begin a paragraph via the StartParagraph method, or an exception is thrown.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2