Run Class
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Represents a discrete section of formatted or unformatted text.
System::Object
System.Windows::DependencyObject
System.Windows.Documents::TextElement
System.Windows.Documents::Inline
System.Windows.Documents::Run
System.Windows::DependencyObject
System.Windows.Documents::TextElement
System.Windows.Documents::Inline
System.Windows.Documents::Run
Assembly: System.Windows (in System.Windows.dll)
XMLNS for XAML: Not mapped to an xmlns.
The Run type exposes the following members.
| Name | Description | |
|---|---|---|
 | CharacterSpacing | Gets or sets the distance between characters of text in the control measured in 1000ths of the font size. (Inherited from TextElement.) |
| ContentEnd | Gets a TextPointer that represents the end of the content in the element. (Inherited from TextElement.) |
| ContentStart | Gets a TextPointer that represents the start of content in the element. (Inherited from TextElement.) |
| Dispatcher | Gets the Dispatcher this object is associated with. (Inherited from DependencyObject.) |
| ElementEnd | Gets a TextPointer that represents the position just after the end of the element. (Inherited from TextElement.) |
| ElementStart | Gets a TextPointer that represents the position just before the start of the element. (Inherited from TextElement.) |
| FlowDirection | Gets or sets the direction that text and other user interface elements flow within the Run element that controls their layout. |
| FontFamily | Gets or sets the preferred top-level font family for the content of the element. (Inherited from TextElement.) |
| FontSize | Gets or sets the font size for the content of the element. (Inherited from TextElement.) |
| FontStretch | Gets or sets the glyph width of the font in a family to select. (Inherited from TextElement.) |
| FontStyle | Gets or sets the font style for the content in this element. (Inherited from TextElement.) |
| FontWeight | Gets or sets the top-level font weight to select from the font family for the content in this element. (Inherited from TextElement.) |
| Foreground | Gets or sets the Brush to apply to the content in this element. (Inherited from TextElement.) |
| Language | Gets or sets the language of the content within an TextElement element. (Inherited from TextElement.) |
| Name | Gets or sets a unique identification for the object. Name can only be set from initial parsing of XAML. (Inherited from TextElement.) |
| Text | Gets or sets the text contents of the Run. |
| TextDecorations | Gets or sets a value that specifies the text decorations that are applied to the content in an Inline element. (Inherited from Inline.) |
| Name | Description | |
|---|---|---|
 | CheckAccess | Determines whether the calling thread has access to this object. (Inherited from DependencyObject.) |
| ClearValue | Clears the local value of a dependency property. (Inherited from DependencyObject.) |
| Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
 | Finalize | Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.) |
| FindName | Gets an object in the Windows Phone object model by referencing the object's x:Name or Name attribute value. (Inherited from TextElement.) |
| GetAnimationBaseValue | Returns any base value established for a Windows Phone dependency property, which would apply in cases where an animation is not active. (Inherited from DependencyObject.) |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| GetValue | Returns the current effective value of a dependency property from a DependencyObject. (Inherited from DependencyObject.) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| OnCreateAutomationPeer | Returns a class-specific AutomationPeer implementation for use by the Windows Phone automation infrastructure. (Inherited from TextElement.) |
| ReadLocalValue | Returns the local value of a dependency property, if a local value is set. (Inherited from DependencyObject.) |
| SetValue | Sets the local value of a dependency property on a DependencyObject. (Inherited from DependencyObject.) |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
The Run and LineBreak objects are the basic content units of a text block. To format the text in a text block, you can apply formatting to various Run objects. The Inlines property of a TextBlock object is an InlineCollection that holds the text block contents.
A Run is also used in the Paragraph and RichTextBox content model.
Any text in the inner text of a XAML TextBlock object element is implicitly converted to a Run object and stored in the TextBlock::Inlines property collection.
You can name a Run (or any other TextElement) by using the Name property or x:Name in XAML. Naming a Run enables you to make changes programmatically. For example, you can change the text dynamically or reorder a text element collection.
Show: