IXRTextBox (Windows Embedded CE 6.0)

Article
01/05/2012

1/6/2010

This class represents a control that can be used to display single-format, multiline text.

Syntax

class IXRTextBox : public IXRControl

Methods

Method	Description
IXRTextBox::AddSelectionChangedEventHandler	Attaches a delegate to the SelectionChanged event for this text box. When the SelectionChanged event is raised by this text box, this delegate will be invoked.
IXRTextBox::AddTextChangedEventHandler	Attaches a delegate to the TextChanged event for this text box. When the TextChanged event is raised by this text box, this delegate is invoked.
IXRTextBox::GetAcceptsReturn	Retrieves a value that determines whether this text box allows for and displays the new-line character or return character. These characters are used to divide text into multiple lines.
IXRTextBox::GetHorizontalScrollBarVisibility	Retrieves the visibility of the horizontal scroll bar.
IXRTextBox::GetIsReadOnly	Retrieves a value that determines whether the user can change the text in this text box.
IXRTextBox::GetMaxLength	Retrieves the value that determines the maximum number of characters allowed for user input.
IXRTextBox::GetSelectedText	Retrieves the content of the current selection in this text box.
IXRTextBox::GetSelectionBackground	Retrieves the Brush that fills the background of the selected text in this text box.
IXRTextBox::GetSelectionForeground	Retrieves the Brush used for the selected text in this text box.
IXRTextBox::GetSelectionStart	Retrieves the starting position of the text selected in this text box.
IXRTextBox::GetSelectionLength	Retrieves the number of characters in the current selection in this text box.
IXRTextBox::GetText	Retrieves the text contents of this text box.
IXRTextBox::GetTextAlignment	Retrieves a value that indicates the horizontal alignment of text inside this text box.
IXRTextBox::GetTextWrapping	Retrieves how line breaking occurs if a line of text extends beyond the available width of this text box.
IXRTextBox::GetVerticalScrollBarVisibility	Retrieves the visibility of the vertical scroll bar.
IXRTextBox::RemoveSelectionChangedEventHandler	Removes a delegate from the SelectionChanged event for this text-box control.
IXRTextBox::RemoveTextChangedEventHandler	Removes a delegate from the TextChanged event for this text-box control.
IXRTextBox::Select	Selects a range of text in this text box.
IXRTextBox::SelectAll	Selects all the contents of this text box.
IXRTextBox::SetAcceptsReturn	Sets a value that determines whether this text box allows for and displays the new-line character or return character. These characters are used to divide text into multiple lines.
IXRTextBox::SetHorizontalScrollBarVisibility	Sets the visibility of the horizontal scroll bar.
IXRTextBox::SetIsReadOnly	Retrieves a value that determines whether the user can change the text in this text box.
IXRTextBox::SetMaxLength	Sets the value that determines the maximum number of characters allowed for user input.
IXRTextBox::SetSelectedText	Sets the content of the current selection in this text box.
IXRTextBox::SetSelectionBackground	Sets the Brush that fills the background of the selected text in this text box.
IXRTextBox::SetSelectionForeground	Sets the Brush used for the selected text in this text box.
IXRTextBox::SetSelectionLength	Sets the number of characters in the current selection in this text box.
IXRTextBox::SetSelectionStart	Sets the starting position of the text selected in this text box.
IXRTextBox::SetText	Sets the text contents of this text box.
IXRTextBox::SetTextAlignment	Sets a value that indicates the horizontal alignment of text inside this text box.
IXRTextBox::SetTextWrapping	Sets how line breaking occurs if a line of text extends beyond the available width of this text box.
IXRTextBox::SetVerticalScrollBarVisibility	Sets the visibility of the vertical scroll bar.

Remarks

You can enable multiline text in a text-box control by using IXRTextBox::SetAcceptsReturn.

You might want to use a text box to display text. However, you might not want users to be able to edit its text. To prevent users from editing its text, you can call IXRTextBox::SetIsReadOnly. If you pass in true to this method, edit commands will not be supported, and the KeyUp and KeyDown events are specified as handled. If you must have formatted text that cannot be edited by the user, use the IXRTextBlock class instead. If you must have an editable text box that accepts passwords or other input, use the IXRPasswordBox class instead.

You can modify the border of a text box by using the inherited methods IXRControl::SetBorderThickness and IXRControl::SetBorderBrush.

You can also define a text-box control in Microsoft Silverlight 2 XAML. For information about the differences between XAML in Silverlight for Windows Embedded and Silverlight 2, see Differences Between Silverlight for the Web and Silverlight for Windows Embedded. For more information about how to define this element in the source XAML for your application, see this Microsoft Web site.