Input Controls

Input controls are used to input data to write to a server.

Input Controls Property Usage

The following table shows the properties used by each control:
PropertyData Text Box
AcceptsReturnX
AcceptsTabX
AllowDropX
AutoWordSelectionX
BackgroundX
BorderBrushX
BorderThicknessX
CaretBrushX
CharacterCasingX
ClipToBoundsX
ColumnX
ColumnSpanX
EffectX
FlowDirectionX
FocusableX
FocusVisualStyleX
FontFamilyX
FontSizeX
FontStretchX
FontStyleX
FontWeightX
ForceCursorX
ForegroundX
HeightX
HorizontalAlignmentX
HorizontalContentAlignmentX
HorizontalScrollBarVisibilityX
IsEnabledX
IsHitTestVisibleX
IsManipulationEnabledX
IsReadOnlyX
IsReadOnlyCaretVisibleX
IsSharedSizeScopeX
IsTabStopX
IsUndoEnabledX
LocalizationX
MarginX
MaxHeightX
MaxLengthX
MaxLinesX
MaxWidthX
MinHeightX
MinLinesX
MinWidthX
NameX
OpacityX
OpacityMaskX
OverridesDefaultStyleX
PaddingX
RenderTransformOriginX
RowX
RowSpanX
SelectionBrushX
SelectionOpacityX
SnapsToDevicePixelsX
StyleX
TabIndexX
TagX
TemplateX
TextX
TextAlignmentX
TextWrappingX
ToolTipX
UidX
UseLayoutRoundingX
VerticalAlignmentX
VerticalContentAlignmentX
VerticalScrollBarVisibilityX
VisibilityX
WidthX

Input Controls Property Descriptions

The following table shows the properties descriptions used by all control:
PropertyDescription
AcceptsReturnSelect this check box to indicate that pressing Enter in a multiline Text Box control creates a new line of text in the control or activates the default button.
AcceptsTabSelect this check box to indicate that pressing the Tab key in a multiline text box control types a tab character in the control instead of moving the focus to the next control in the tab order.
AllowDropSelect this check box to indicate that the control can accept data that is dragged onto it.
AutoWordSelectionSelect this check box to indicate that when you select part of a word by dragging across it with the mouse, the rest of the word is selected.
BackgroundExpand this field to select the background color of the selected control.
BorderBrushExpand this field to select the border color of the selected control.
BorderThicknessSpecifies the border thickness of a control, in pixels.
CaretBrushExpand this field to select the brush to use to render the vertical bar that indicates the insertion point.
CharacterCasingSpecifies how characters are cased when they are manually entered into the text box. Selections are:
  • Normal
  • Lower
  • Upper
ClipToBoundsSelect this check box to clip the content of this control (or content coming from the child elements of this control) to fit into the size of the containing control.
ColumnSpecifies the column within the grid where the control is located.
ColumnSpanSpecifies the total number of columns that child content spans within a grid.
EffectClick the arrow to expand the property, select the effect you want to apply to the control, and then configure the specific values for the effect. Valid values to select are:
  • Blur
    • Kernel Type
    • Radius
  • Drop Shadow
    • Color
    • Direction
    • Opactiy
    • Shadow Depth
FlowDirectionSpecifies the direction that text and other user interface (UI) elements flow within any parent control. Selections are:
  • Left to Right
  • Right to Left
FocusableSelect this check box to indicate that the control can receive focus.
FocusVisualStyleSpecifies a property that enables customization of appearance, effects, or other style characteristics that apply to this control when it has focus.
FontFamilySpecifies the font family for the control.
FontSizeSpecifies the font size for the control.
FontStretchSpecifies the degree to which a font is condensed or expanded on the screen.
FontStyleSpecifies the font style for the control.
FontWeightSpecifies the weight or thickness of the specified font.
ForceCursorSelect this check box to indicate that the user interface (UI) renders the cursor as declared by the Cursor property.
ForegroundExpand this field to select the foreground color.
HeightSpecifies the height of the control, in pixels.
HorizontalAlignmentSpecifies the horizontal alignment characteristics applied to this control. Selections are:
  • Left
  • Center
  • Right
  • Stretch
HorizontalContentAlignmentSpecifies the horizontal alignment of the control's content. Selections are:
  • Left
  • Center
  • Right
  • Stretch
HorizontalScrollBarVisibilitySpecifies whether a horizontal scroll bar is shown. Selections are:
  • Auto - the scroll bar appears only if the content exceeds the width of the control
  • Disabled - the scroll bar never appears
  • Hidden - the scroll bar is hidden from view
  • Visible - the scroll bar is visible at all times
ImageStretchSpecifies how the image should be stretched to fill the destination rectangle. Selections are:
  • Fill
  • None
  • Uniform
  • UniformToFill
IsEnabledSelect this check box to indicate that this control is enabled in the user interface (UI).
IsHitTestVisibleSelect this check box to indicate that the control can possibly be returned as a hit test result from some portion of its rendered content.
IsManipulationEnabledSelect this check box to indicate that the manipulation events for the control are enabled.
IsReadOnlySelect this check box to indicate that the text editing control is read-only to a user interacting with the control.
IsReadOnlyCaretVisibleSpecifies whether a read-only text box displays a caret. If the IsReadOnly check box is selected, you can still select and copy text. If the IsReadOnlyCaretVisible check box is also selected, a caret appears in the text box when the text box has keyboard focus. When the IsReadOnly check box is cleared, selecting the IsReadOnlyCaretVisible check box has no effect.
IsSharedSizeScopeSelect this check box to indicate that controls are sharing size information.
IsTabStopSelect this check box to indicate that a control is included in tab navigation.
IsUndoEnabledSelect this check box to indicate that undo support is enabled for the text-editing control. Clearing this check box clears the undo stack. Therefore, if you disable undo and then re-enable it, undo commands still do not work because the undo stack was emptied when you cleared the check box.
LocalizationClick the ellipsis button to open the Localization Configuration dialog box where you can configure the property to localize, the language to use for localization, and the text to localize.
MarginSpecifies the outer margin of a control.
MaxHeightSpecifies the maximum height of a control.
MaxLengthSpecifies the maximum length of text that can be entered in the control. When this property is set to 0, the maximum length of the text that can be entered in the control is limited only by available memory.
MaxLinesSpecifies the maximum number of visible lines.
MaxWidthSpecifies the maximum width of a control.
MinHeightSpecifies the minimum height of a control.
MinLinesSpecifies the minimum number of visible lines.
MinWidthSpecifies the minimum width of a control.
NameSpecifies the identifying name of the control. The name provides a reference so that code behind, such as event handler code, can refer to a markup element during processing by a XAML processor.
OpacitySpecifies the opacity factor applied to the entire control. Valid values are 0 through 1, with up to 15 decimal places.
OpacityMaskExpand this field to select a color for the opacity mask, which is applied to any alpha-channel masking for the rendered content of this control.
OverridesDefaultStyleSelect this check box to indicate that this control incorporates style properties from theme styles.
PaddingSpecifies the amount of padding to apply to the inside edge of each side of a control.
RenderTransformOriginSpecifies the center point of any possible render transform, relative to the bounds of the element.
  • X is the horizontal origin factor, given as a value between 0 and 1.
  • Y is the vertical origin factor, given as a value between 0 and 1.
RowRowBackground
RowSpanSpecifies the total number of rows that child content spans within a grid.
SelectionBrushExpand this field to select the brush to use to highlight the selected text.
SnapsToDevicePixelsSelect this check box to indicate that rendering for this control uses device-specific pixel settings.
StyleSpecifies the style used by this control when it is rendered.
TabIndexSpecifies the order in which controls receive focus when the Tab key is pressed.
TagSpecifies an arbitrary object value that can be used to store custom information about this control.
TemplateClick the ellipsis button to open the Open dialog box to select a template to use.
TextSpecifies the text contents of a control.
TextAlignmentSpecifies the horizontal alignment of text content. Selections are:
  • Left
  • Center
  • Right
  • Justify
TextWrappingSpecifies how the control wraps text. Selections are:
  • NoWrap
  • Wrap
  • WrapWithOverflow
ToolTipSpecifies the tool-tip that displays for this control in the user interface (UI).
UidSpecifies the unique identifier (for localization) for this control.
UseLayoutRoundingSpecifies a value that determines whether rendering for the object and its visual subtree should use rounding behavior that aligns rendering to whole pixels.
VerticalAlignmentSpecifies the vertical alignment characteristics applied to this control. Selections are:
  • Bottom
  • Center
  • Top
  • Stretch
VerticalContentAlignmentSpecifies the vertical alignment of the control's content. Selections are:
  • Bottom
  • Center
  • Top
  • Stretch
VerticalScrollBarVisibilitySpecifies whether a vertical scroll bar is shown. Scroll bar selections are:
  • Auto - appears only if the content exceeds the width of the control.
  • Disabled - never appears.
  • Hidden - hidden from view.
  • Visible - visible at all times.
VisiblilitySpecifies the visibility of this control. Selections are:
  • Collapsed
  • Hidden
  • Visible
WidthSpecifies the width of the control, in pixels.