Represents a discrete section of formatted or unformatted text.
To create an object using scripting, see CreateFromXAML.
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.
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.
The following XAML example shows how to define several differently-formatted text strings within a TextBlock by using Run objects.
<!-- Display formatted text as Run objects within a TextBlock. --> <Canvas xmlns="http://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
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