TextBox Class
Definition
Represents a control that can be used to display or edit unformatted text.
public class TextBox
Constructors
| Name | Description |
|---|---|
| TextBox | No summary available. |
TextBox Constructor
public TextBox()
Methods
| Name | Description |
|---|---|
| Clear | Clears the text in the TextBox |
| ClearSelection | Clears the current selection, maintaining the Avalonia.Controls.TextBox.CaretIndex |
| Copy | Copies the current text onto the clipboard |
| Cut | Cuts the current text onto the clipboard |
| GetLineCount | Get the number of lines in the TextBox. |
| Paste | Pastes the current clipboard text content into the TextBox |
| Redo | Reapplies the first item on the redo stack |
| ScrollToLine | Scroll the Avalonia.Controls.TextBox to the specified line index. |
| SelectAll | Select all text in the TextBox |
| Undo | Undoes the first action in the undo stack |
| ApplyTemplate | Creates the visual children of the control, if necessary Inherited from TemplatedControl. |
| GetIsTemplateFocusTarget | Gets the value of the IsTemplateFocusTargetProperty attached property on a control. Inherited from TemplatedControl. |
| SetIsTemplateFocusTarget | Sets the value of the IsTemplateFocusTargetProperty attached property on a control. Inherited from TemplatedControl. |
| Focus | Focuses the control. Inherited from InputElement. |
| GetIsHoldWithMouseEnabled | Inherited from InputElement. |
| GetIsHoldingEnabled | Inherited from InputElement. |
| SetIsHoldWithMouseEnabled | Inherited from InputElement. |
| SetIsHoldingEnabled | Inherited from InputElement. |
| AddHandler (2 overloads) | Adds a handler for the specified routed event. Inherited from Interactive. |
| RaiseEvent | Raises a routed event. Inherited from Interactive. |
| RemoveHandler (2 overloads) | Removes a handler for the specified routed event. Inherited from Interactive. |
| Arrange | Arranges the control and its children. Inherited from Layoutable. |
| InvalidateArrange | Invalidates the arrangement of the control and queues a new layout pass. Inherited from Layoutable. |
| InvalidateMeasure | Invalidates the measurement of the control and queues a new layout pass. Inherited from Layoutable. |
| Measure | Carries out a measure of the control. Inherited from Layoutable. |
| UpdateLayout | Executes a layout pass. Inherited from Layoutable. |
| GetFlowDirection | Gets the value of the attached Avalonia.Visual.FlowDirectionProperty on a control. Inherited from Visual. |
| InvalidateVisual | Invalidates the visual and queues a repaint. Inherited from Visual. |
| Render | Renders the visual to a Avalonia.Media.DrawingContext. Inherited from Visual. |
| SetFlowDirection | Sets the value of the attached Avalonia.Visual.FlowDirectionProperty on a control. Inherited from Visual. |
| ApplyStyling | Applies styling to the control if the control is initialized and styling is not already applied. Inherited from StyledElement. |
| BeginInit | Inherited from StyledElement. |
| EndInit | Inherited from StyledElement. |
| TryGetResource | Inherited from StyledElement. |
| Bind (8 overloads) | Binds a Avalonia.AvaloniaProperty to an Avalonia.Data.BindingBase. Inherited from AvaloniaObject. |
| CheckAccess | Returns a value indicating whether the current thread is the UI thread. Inherited from AvaloniaObject. |
| ClearValue (4 overloads) | Clears a Avalonia.AvaloniaProperty's local value. Inherited from AvaloniaObject. |
| CoerceValue | Coerces the specified Avalonia.AvaloniaProperty. Inherited from AvaloniaObject. |
| Equals | Compares two objects using reference equality. Inherited from AvaloniaObject. |
| GetBaseValue | Inherited from AvaloniaObject. |
| GetHashCode | Gets the hash code for the object. Inherited from AvaloniaObject. |
| GetValue (3 overloads) | Gets a Avalonia.AvaloniaProperty value. Inherited from AvaloniaObject. |
| IsAnimating | Checks whether a Avalonia.AvaloniaProperty is animating. Inherited from AvaloniaObject. |
| IsSet | Checks whether a Avalonia.AvaloniaProperty is set on this object. Inherited from AvaloniaObject. |
| SetCurrentValue (2 overloads) | Sets the value of a dependency property without changing its value source. Inherited from AvaloniaObject. |
| SetValue (3 overloads) | Sets a Avalonia.AvaloniaProperty value. Inherited from AvaloniaObject. |
| VerifyAccess | Checks that the current thread is the UI thread and throws if not. Inherited from AvaloniaObject. |
Clear Method
Clears the text in the TextBox
public void Clear()
ClearSelection Method
Clears the current selection, maintaining the Avalonia.Controls.TextBox.CaretIndex
public void ClearSelection()
Copy Method
Copies the current text onto the clipboard
public void Copy()
Cut Method
Cuts the current text onto the clipboard
public void Cut()
GetLineCount Method
Get the number of lines in the TextBox.
public int GetLineCount()
Returns
int
Value
number of lines in the TextBox, or -1 if no layout information is available
Remarks
If Wrap == true, changing the width of the TextBox may change this value. The value returned is the number of lines in the entire TextBox, regardless of how many are currently in view.
Paste Method
Pastes the current clipboard text content into the TextBox
public void Paste()
Redo Method
Reapplies the first item on the redo stack
public void Redo()
ScrollToLine Method
Scroll the Avalonia.Controls.TextBox to the specified line index.
public void ScrollToLine(int lineIndex)
Parameters
lineIndex int
The line index to scroll to.
Exceptions
- `lineIndex` is less than zero. -or - `lineIndex` is larger than or equal to the line count.
SelectAll Method
Select all text in the TextBox
public void SelectAll()
Undo Method
Undoes the first action in the undo stack
public void Undo()
Properties
| Name | Description |
|---|---|
| AcceptsReturn | Gets or sets a value that determines whether the TextBox allows and displays newline or return characters |
| AcceptsTab | Gets or sets a value that determines whether the TextBox allows and displays tabs |
| CanCopy | Property for determining if the Copy command can be executed. |
| CanCut | Property for determining if the Cut command can be executed. |
| CanPaste | Property for determining if the Paste command can be executed. |
| CanRedo | Gets a value that indicates whether the redo stack has an action that can be redone |
| CanUndo | Gets a value that indicates whether the undo stack has an action that can be undone |
| CaretBlinkInterval | Gets or sets the caret blink rate |
| CaretBrush | Gets or sets a brush that is used for the text caret |
| CaretIndex | Gets or sets the index of the text caret |
| ClearSelectionOnLostFocus | Gets or sets a value that determines whether the TextBox clears its selection after it loses focus. |
| CopyGesture | Gets a platform-specific Avalonia.Input.KeyGesture for the Copy action |
| CutGesture | Gets a platform-specific Avalonia.Input.KeyGesture for the Cut action |
| HorizontalContentAlignment | Gets or sets the horizontal alignment of the content within the control. |
| InnerLeftContent | Gets or sets custom content that is positioned on the left side of the text layout box |
| InnerRightContent | Gets or sets custom content that is positioned on the right side of the text layout box |
| IsInactiveSelectionHighlightEnabled | Gets or sets a value that determines whether the TextBox shows a selection highlight when it is not focused. |
| IsReadOnly | Gets or sets a value whether this TextBox is read-only |
| IsUndoEnabled | Property for determining whether undo/redo is enabled |
| LineHeight | Gets or sets the line height. |
| MaxLength | Gets or sets the maximum number of characters that the Avalonia.Controls.TextBox can accept. This constraint only applies for manually entered (user-inputted) text. |
| MaxLines | Gets or sets the maximum number of visible lines to size to. |
| MinLines | Gets or sets the minimum number of visible lines to size to. |
| NewLine | Gets or sets which characters are inserted when Enter is pressed. Default: Environment.NewLine |
| PasswordChar | Gets or sets the char that should be used for password masking |
| PasteGesture | Gets a platform-specific Avalonia.Input.KeyGesture for the Paste action |
| PlaceholderForeground | Gets or sets the brush used for the foreground color of the placeholder text. |
| PlaceholderText | Gets or sets the placeholder or descriptive text that is displayed even if the Avalonia.Controls.TextBox.Text property is not yet set. |
| RevealPassword | Gets or sets whether text masked by Avalonia.Controls.TextBox.PasswordChar should be revealed |
| SelectedText | Gets or sets the text selected in the TextBox |
| SelectionBrush | Gets or sets a brush that is used to highlight selected text |
| SelectionEnd | Gets or sets the end position of the text selected in the TextBox |
| SelectionForegroundBrush | Gets or sets a brush that is used for the foreground of selected text |
| SelectionStart | Gets or sets the starting position of the text selected in the TextBox |
| Text | Gets or sets the Text content of the TextBox |
| TextAlignment | Gets or sets the Avalonia.Media.TextAlignment of the TextBox |
| TextWrapping | Gets or sets the Avalonia.Media.TextWrapping of the TextBox |
| UndoLimit | Gets or sets the maximum number of items that can reside in the Undo stack |
| UseFloatingPlaceholder | Gets or sets a value indicating whether the Avalonia.Controls.TextBox.PlaceholderText will still be shown above the Avalonia.Controls.TextBox.Text even after a text value is set. |
| UseFloatingWatermark | Gets or sets a value indicating whether the Avalonia.Controls.TextBox.PlaceholderText will still be shown above the Avalonia.Controls.TextBox.Text even after a text value is set. |
| VerticalContentAlignment | Gets or sets the vertical alignment of the content within the control. |
| Watermark | Gets or sets the placeholder or descriptive text that is displayed even if the Avalonia.Controls.TextBox.Text property is not yet set. |
| WatermarkForeground | Gets or sets the brush used for the foreground color of the placeholder text. |
| Background | Gets or sets the brush used to draw the control's background. Inherited from TemplatedControl. |
| BackgroundSizing | Gets or sets how the control's background is drawn relative to the control's border. Inherited from TemplatedControl. |
| BorderBrush | Gets or sets the brush used to draw the control's border. Inherited from TemplatedControl. |
| BorderThickness | Gets or sets the thickness of the control's border. Inherited from TemplatedControl. |
| CornerRadius | Gets or sets the radius of the border rounded corners. Inherited from TemplatedControl. |
| FontFamily | Gets or sets the font family used to draw the control's text. Inherited from TemplatedControl. |
| FontFeatures | Gets or sets the font features turned on/off. Inherited from TemplatedControl. |
| FontSize | Gets or sets the size of the control's text in points. Inherited from TemplatedControl. |
| FontStretch | Gets or sets the font stretch used to draw the control's text. Inherited from TemplatedControl. |
| FontStyle | Gets or sets the font style used to draw the control's text. Inherited from TemplatedControl. |
| FontWeight | Gets or sets the font weight used to draw the control's text. Inherited from TemplatedControl. |
| Foreground | Gets or sets the brush used to draw the control's text and other foreground elements. Inherited from TemplatedControl. |
| LetterSpacing | Gets or sets the letter spacing for the control's text content. Inherited from TemplatedControl. |
| Padding | Gets or sets the padding placed between the border of the control and its content. Inherited from TemplatedControl. |
| Template | Gets or sets the template that defines the control's appearance. Inherited from TemplatedControl. |
| ContextFlyout | Gets or sets a context flyout to the control Inherited from Control. |
| ContextMenu | Gets or sets a context menu to the control. Inherited from Control. |
| DataTemplates | Gets or sets the data templates for the control. Inherited from Control. |
| FocusAdorner | Gets or sets the control's focus adorner. Inherited from Control. |
| IsLoaded | Gets a value indicating whether the control is fully constructed in the visual tree and both layout and render are complete. Inherited from Control. |
| Tag | Gets or sets a user-defined object attached to the control. Inherited from Control. |
| Cursor | Gets or sets associated mouse cursor. Inherited from InputElement. |
| Focusable | Gets or sets a value indicating whether the control can receive focus. Inherited from InputElement. |
| GestureRecognizers | Inherited from InputElement. |
| IsEffectivelyEnabled | Gets a value indicating whether this control and all its parents are enabled. Inherited from InputElement. |
| IsEnabled | Gets or sets a value indicating whether the control is enabled for user interaction. Inherited from InputElement. |
| IsFocused | Gets a value indicating whether the control is focused. Inherited from InputElement. |
| IsHitTestVisible | Gets or sets a value indicating whether the control is considered for hit testing. Inherited from InputElement. |
| IsKeyboardFocusWithin | Gets a value indicating whether keyboard focus is anywhere within the element or its visual tree child elements. Inherited from InputElement. |
| IsPointerOver | Gets a value indicating whether the pointer is currently over the control. Inherited from InputElement. |
| IsTabStop | Gets or sets a value that indicates whether the control is included in tab navigation. Inherited from InputElement. |
| KeyBindings | Inherited from InputElement. |
| TabIndex | Gets or sets a value that determines the order in which elements receive focus when the user navigates through controls by pressing the Tab key. Inherited from InputElement. |
| DesiredSize | Gets the size that this element computed during the measure pass of the layout process. Inherited from Layoutable. |
| Height | Gets or sets the height of the element. Inherited from Layoutable. |
| HorizontalAlignment | Gets or sets the element's preferred horizontal alignment in its parent. Inherited from Layoutable. |
| IsArrangeValid | Gets a value indicating whether the control's layouts arrange is valid. Inherited from Layoutable. |
| IsMeasureValid | Gets a value indicating whether the control's layout measure is valid. Inherited from Layoutable. |
| Margin | Gets or sets the margin around the element. Inherited from Layoutable. |
| MaxHeight | Gets or sets the maximum height of the element. Inherited from Layoutable. |
| MaxWidth | Gets or sets the maximum width of the element. Inherited from Layoutable. |
| MinHeight | Gets or sets the minimum height of the element. Inherited from Layoutable. |
| MinWidth | Gets or sets the minimum width of the element. Inherited from Layoutable. |
| UseLayoutRounding | Gets or sets a value that determines whether the element should be snapped to pixel boundaries at layout time. Inherited from Layoutable. |
| VerticalAlignment | Gets or sets the element's preferred vertical alignment in its parent. Inherited from Layoutable. |
| Width | Gets or sets the width of the element. Inherited from Layoutable. |
| Bounds | Gets the bounds of the control relative to its parent. Inherited from Visual. |
| CacheMode | Gets or sets the cache mode of the visual. Inherited from Visual. |
| Clip | Gets or sets the geometry clip for this visual. Inherited from Visual. |
| ClipToBounds | Gets or sets a value indicating whether the control should be clipped to its bounds. Inherited from Visual. |
| Effect | Gets or sets the effect of the control. Inherited from Visual. |
| FlowDirection | Gets or sets the text flow direction. Inherited from Visual. |
| HasMirrorTransform | Gets or sets a value indicating whether to apply mirror transform on this control. Inherited from Visual. |
| IsEffectivelyVisible | Gets a value indicating whether this control and all its parents are visible. Inherited from Visual. |
| IsVisible | Gets or sets a value indicating whether this control is visible. Inherited from Visual. |
| Opacity | Gets or sets the opacity of the control. Inherited from Visual. |
| OpacityMask | Gets or sets the opacity mask of the control. Inherited from Visual. |
| RenderTransform | Gets or sets the render transform of the control. Inherited from Visual. |
| RenderTransformOrigin | Gets or sets the transform origin of the control. Inherited from Visual. |
| ZIndex | Gets or sets the Z index of the control. Inherited from Visual. |
| ActualThemeVariant | Gets the UI theme that is currently used by the element, which might be different than the RequestedThemeVariantProperty. Inherited from StyledElement. |
| Classes | Gets or sets the styled element's classes. Inherited from StyledElement. |
| DataContext | Gets or sets the control's data context. Inherited from StyledElement. |
| IsInitialized | Gets a value that indicates whether the element has finished initialization. Inherited from StyledElement. |
| Name | Gets or sets the name of the styled element. Inherited from StyledElement. |
| Parent | Gets the styled element's logical parent. Inherited from StyledElement. |
| Resources | Gets or sets the styled element's resource dictionary. Inherited from StyledElement. |
| StyleKey | Gets the type by which the element is styled. Inherited from StyledElement. |
| Styles | Gets the styles for the styled element. Inherited from StyledElement. |
| TemplatedParent | Gets the styled element whose lookless template this styled element is part of. Inherited from StyledElement. |
| Theme | Gets or sets the theme to be applied to the element. Inherited from StyledElement. |
| Transitions | Gets or sets the property transitions for the control. Inherited from Animatable. |
| Dispatcher | Returns the Avalonia.AvaloniaObject.Dispatcher that this Avalonia.AvaloniaObject is associated with. Inherited from AvaloniaObject. |
| Item | Inherited from AvaloniaObject. |