Share via


Run Object

Represents a discrete section of formatted or unformatted text.

XAML
<Run .../>
Scripting
To create an object using scripting, see CreateFromXAML.

Properties

FontFamily, FontSize, FontStretch, FontStyle, FontWeight, Foreground, Name, Text, TextDecorations

Methods

Equals, FindName, GetHost, GetValue, SetValue

Remarks

Run is one of the few Silverlight objects that supports inner text as a XAML element. The inner text is parsed and becomes the value of the Text property in the Silverlight object model.

The inner text of a TextBlock in XAML is also processed as a Run with a Text value.

Multiple Run objects can be declared within an Inlines collection. By applying specific property formatting to various Run objects, and introducing LineBreak objects, you can introduce basic text formatting to text blocks.

Examples

The following XAML example shows how to define several differently-formatted text strings within a TextBlock by using Run objects.

XAML
<!-- Display formatted text as Run objects within a TextBlock. -->
<Canvas
  xmlns="https://schemas.microsoft.com/client/2007">
<TextBlock
  FontFamily="Arial" Width="400" Text="Sample text formatting runs">
  <LineBreak/>
  <Run Foreground="Maroon" FontFamily="Courier New" FontSize="24">Courier New 24</Run>
  <LineBreak/>
  <Run Foreground="Teal" FontFamily="Times New Roman" FontSize="18" FontStyle="Italic">Times New Roman Italic 18</Run>
  <LineBreak/>
  <Run Foreground="SteelBlue" FontFamily="Verdana" FontSize="14" FontWeight="Bold">Verdana Bold 14</Run>
</TextBlock>
</Canvas>

The following illustration shows the rendered formatted text from the previous XAML content example.

Rendered formatted text

Rendered formatted text

Notice that the LineBreak object forces the text in each Run to display on a separate line. Without the LineBreak object, the text in each Run would flow together as one line, and eventually be truncated after exceeding the TextBlock's Width value. The following illustration shows how the formatted text would render without using LineBreak objects.

Rendered formatted text without line breaks

Rendered formatted text without line breaks

See Also

Text and Fonts Overview
LineBreak
TextBlock