IXRLineBreak (Compact 2013)

3/28/2014

This class represents an inline element that causes a new line to begin when it is displayed in a text container.

Syntax

class IXRLineBreak : public IXRInline

Inheritance Hierarchy

IXRDependencyObject

    IXRTextElement

        IXRTextElement

            IXRLineBreak

Methods

IXRLineBreak provides no new methods. All its methods are inherited from IXRTextElement.

Thread Safety

Members of this class are thread-safe if you previously called IXRApplication::CreateHostFromXaml and supplied it with an XRWindowCreateParams structure that has AllowsMultipleThreadAccess set to true.

Remarks

IXRLineBreak is comparable to the <br /> tag in HTML. In Microsoft Silverlight 3 XAML, the typical usage is the similar self-closing form <LineBreak />.

IXRLineBreak inherits many text formatting methods from IXRTextElement. However, most of these methods are ignored when displaying text. For example, setting the FontSize of an IXRLineBreak does not affect the vertical space between the surrounding lines of text. Instead, the FontSize set on the previous and following text runs determines the line spacing.

You can store an IXRLineBreak object in an IXRInlineCollection object.

When you create a class instance, use an IXRLineBreakPtr smart pointer instead of a raw interface pointer. For more information, see XRPtr<Interface>.

You can also define a line break in Microsoft Silverlight 3 XAML. For information about the differences between XAML in XAML for Windows Embedded and Silverlight 3, see Differences Between Microsoft Silverlight 3 and XAML for Windows Embedded. For more information about how to define this element in the source XAML for your application, see the LineBreak Class on MSDN.

.NET Framework Equivalent

System.Windows.Documents.LineBreak

Requirements

Header

XamlRuntime.h

sysgen

SYSGEN_XAML_RUNTIME

See Also

Reference

Classes for UI Element Management