Common Controls

Workflow provides a series of common controls to use in forms and user display authoring.

Common Controls Property Usage

The following table shows the properties used by each control:


Property	Button	Calendar	Check Box	Expander	Hyperlink	Image	Label	Masked Text Box	Password Box	Progress Bar	Radio Button Item [add]	Repeat Button	Rich Text Box	Scroll Bar	Slider	Text Block	Text Box	Toggle Button	Validating Text Box
AcceptsReturn													X				X		X
AcceptsTab													X				X		X
AllowDrop	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
AutoToolTipPlacement															X
AutoToolTipPrecision															X
AutoWordSelection													X				X		X
Background	X	X	X	X	X		X	X	X	X	X	X	X	X	X	X	X	X	X
BaselineOffset																X
BorderBrush	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X		X	X	X
BorderThickness	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X		X	X	X
CacheMode		X			X	X
CalendarButtonStyle		X
CalendarDayButtonStyle		X
CalendarItemStyle		X
CaretBrush									X				X				X		X
CharacterCasing																	X		X
ClickMode	X		X		X						X	X						X
Clip		X			X	X
ClipToBounds	X		X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X
Column	X	X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
ColumnSpan	X	X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Command					X
CommandParameter	X		X		X						X	X						X
CommandTarget	X		X								X	X						X
Content	X		X		X		X				X	X						X
ContentStringFormat	X	X	X				X				X	X						X
ContentTemplate					X
Cursor		X			X	X
DataContext		X			X	X
Delay												X			X
DisplayDate		X
DisplayDateEnd		X
DisplayDateStart		X
DisplayMode		X
Effect	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
FirstDayOfWeek		X
FlowDirection	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Focusable	X		X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X
FocusVisualStyle	X		X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X
FontFamily	X	X	X		X		X	X	X	X	X	X	X	X	X	X	X	X	X
FontSize	X	X	X		X		X	X	X	X	X	X	X	X	X	X	X	X	X
FontStretch	X	X	X		X		X	X	X	X	X	X	X	X	X	X	X	X	X
FontStyle	X	X	X		X		X	X	X	X	X	X	X	X	X	X	X	X	X
FontWeight	X	X	X		X		X	X	X	X	X	X	X	X	X	X	X	X	X
ForceCursor	X		X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X
Foreground	X	X	X		X		X	X	X	X	X	X	X	X	X	X	X	X	X
Height	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
HorizontalAlignment	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
HorizontalContentAlignment	X	X	X		X			X	X	X	X	X	X	X	X		X	X	X
HorizontalScrollBarVisibility													X				X		X
Interval												X			X
ImageStretch						X
IsCancel	X		X
IsChecked			X								X							X
IsDefault	X		X
IsDirectionReversed															X
IsDocumentEnabled													X
IsEnabled	X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
IsHitTestVisible	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
IsHyphenationEnabled																X	X	X
IsIndeterminate										X
IsManipulationEnabled	X		X	X		X	X	X	X	X	X	X	X	X	X	X	X		X
IsMoveToPointEnabled															X
IsReadOnly													X				X		X
IsReadOnlyCaretVisible													X				X		X
IsSelectionRangeEnabled															X
IsSharedSizeScope	X		X			X	X	X	X	X	X	X	X	X	X	X	X	X	X
IsSnapToTickEnabled															X
IsTabStop	X	X	X		X			X	X	X	X	X	X	X	X		X	X	X
IsThreeState											X							X
IsTodayHighlighted		X
IsUndoEnabled																	X		X
Language		X			X	X
LargeChange										X				X	X
LineHeight																X
LineStackingStrategy																X
Localization	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Margin	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
MaxHeight	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
MaxLength																	X		X
MaxLines																	X		X
MaxWidth	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
MinHeight	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
MinLines																	X		X
MinWidth	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Name	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
NavigateUri					X
Opacity	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
OpacityMask	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Orientation			X							X				X	X
OverridesDefaultStyle	X		X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X
Padding	X	X	X		X	X		X	X	X	X	X	X	X	X	X	X	X	X
PasswordChar									X
Projection		X				X
RenderTransformOrigin	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Row	X	X	X		X			X	X	X	X	X	X	X	X	X	X	X	X
RowSpan	X	X	X		X			X	X	X	X	X	X	X	X	X	X	X	X
SelectedDate		X
SelectionBrush									X				X				X		X
SelectionEnd															X
SelectionMode		X
SelectionOpacity									X				X				X		X
SelectionStart															X
ShowGridLines				X
SmallChange										X				X	X
SnapsToDevicePixels	X		X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X
Source						X	X
Stretch						X	X
StretchDirection						X	X
Style	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
TabIndex	X	X	X		X	X		X	X	X	X	X	X	X	X		X	X	X
TabNavigation		X			X
Tag	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
TargetName					X
Template	X	X	X		X			X	X	X	X	X	X	X	X		X	X	X
Text																X	X		X
TextAlignment																X	X		X
TextTrimming																X
TextWrapping																X	X		X
TickFrequency															X
TickPlacement															X
ToolTip	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Uid	X		X	X		X	X	X	X	X	X	X	X	X	X	X	X	X	X
UndoLimit													X				X		X
UseLayoutRounding	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X		X
Value										X					X
VerticalAlignment	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
VerticalContentAlignment	X	X	X	X	X			X	X	X	X	X	X	X	X		X	X	X
VerticalScrollBarVisibility													X				X		X
ViewportSize														X
Visibility	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X
Width	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X	X

Common Controls Property Descriptions

The following table shows the properties descriptions used by all control:

Property	Description
AcceptsReturn	Select 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.
AcceptsTab	Select 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.
AllowDrop	Select this check box to indicate that the control can accept data that is dragged onto it.
AutoToolTipPlacement	Specifies whether a tooltip that contains the current value of the slider displays when the thumb is pressed and also specifies the placement of the tooltip. Selections are: None Top Left Bottom Right
AutoToolTipPrecision	Specifies the number of digits to the right side of the decimal point to display in a tooltip for the value of the slider.
AutoWordSelection	Select 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.
ArrowBackground	Expand this field to select the background color for an arrow button control.
ArrowBorderBrush	Expand this field to select the border color of the selected arrow control.
ArrowDesign	Specifies the appearance of the arrow. Available selections are: Pointer Barbed Triangle
ArrowDirection	Specifies the direction of the arrow. Available selections are: Up Down Right Left
ArrowPadding	Specifies the horizontal and vertical alignment of the arrow within the button.
Background	Expand this field to select the background color of the selected control.
BaselineOffset	Specifies the amount of space, by which each line of text is offset from the baseline.
BorderBrush	Expand this field to select the border color of the selected control.
BorderThickness	Specifies the border thickness of a control, in pixels.
CacheMode	Specifies a value that indicates that rendered content should be cached when possible.
CalendarButtonStyle	Specifies the style of the calendar's buttons.
CalendarDayButtonStyle	Specifies the style of the calendar's day buttons.
CalendarItemStyle	Specifies the style of the calendar's items.
CaretBrush	Expand this field to select the brush to use to render the vertical bar that indicates the insertion point.
CharacterCasing	Specifies how characters are cased when they are manually entered into the text box. Selections are: Normal Lower Upper
ClickMode	Specifies when the Click event occurs. Selections are: Hover Press Release
Clip	Specifies the geometric shape used to define the outline of the image. Selections are: Hover Press Release
ClipToBounds	Select 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.
Column	Specifies the column within the grid where the control is located.
ColumnSpan	Specifies the total number of columns that child content spans within a grid.
Command	Specifies the command to invoke when this control is pressed or clicked.
CommandParameter	Specifies the parameter to pass to the Command property.
CommandTarget	Specifies the element on which to raise the specified command.
Content	Specifies the content displayed on the control.
ContentStringFormat	Specifies a composite string that determines how to format the Content property if it is displayed as a string.
ContentTemplate	Specifies the data template used to display the content of the Content property.
Cursor	Specifies the cursor image to display when the mouse pointer hovers over an object.
DataContext	Specifies the data context for a control when it participates in data binding.
Delay	Specifies the amount of time, in milliseconds, that the control waits while being pressed before a command executes.
DisplayDate	Specifies the date to display.
DisplayDateEnd	Specifies the last date in the date range that is available in the calendar.
DisplayDateStart	Specifies the first date that is available in the calendar.
DisplayMode	Specifies whether the calendar displays a month, year, or decade.
Effect	Click 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
FirstDayOfWeek	Specifies the day that is considered the beginning of the week. Selections are: Sunday Modnay Tuesday Wednesday Thursday Friday Saturday
FlowDirection	Specifies the direction that text and other user interface (UI) elements flow within any parent control. Selections are: Left to Right Right to Left
Focusable	Select this check box to indicate that the control can receive focus.
FocusVisualStyle	Specifies a property that enables customization of appearance, effects, or other style characteristics that apply to this control when it has focus.
FontFamily	Specifies the font family for the control.
FontSize	Specifies the font size for the control.
FontStretch	Specifies the degree to which a font is condensed or expanded on the screen.
FontStyle	Specifies the font style for the control.
FontWeight	Specifies the weight or thickness of the specified font.
ForceCursor	Select this check box to indicate that the user interface (UI) renders the cursor as declared by the Cursor property.
Foreground	Expand this field to select the foreground color.
Height	Specifies the height of the control, in pixels.
HorizontalAlignment	Specifies the horizontal alignment characteristics applied to this control. Selections are: Left Center Right Stretch
HorizontalContentAlignment	Specifies the horizontal alignment of the control's content. Selections are: Left Center Right Stretch
HorizontalScrollBarVisibility	Specifies 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
ImageStretch	Specifies how the image should be stretched to fill the destination rectangle. Selections are: Fill None Uniform UniformToFill
Interval	Specifies the amount of time, in milliseconds, between increase or decrease commands when you click a Repeat Button or a Slider.
IsCancel	Select this check box to indicate that a Button or Repeat Button acts as a Cancel button. Press the Esc key to select the actual Cancel button.
IsChecked	Select this check box to indicate that the control is checked.
IsDefault	Select this check box to indicate that a Button or Repeat Button is the default Submit button. Press the Enter key to select the actual Submit button.
IsDirectionReversed	Select this check box to indicate that the direction of increasing value is reversed; that is, from right to left.
IsDocumentEnabled	Select this check box to indicate that you can interact with UIElement and ContentElement objects within the Rich Text Box.
IsEnabled	Select this check box to indicate that this control is enabled in the user interface (UI).
IsHitTestVisible	Select this check box to indicate that the control can possibly be returned as a hit test result from some portion of its rendered content.
IsHyphenationEnabled	Select this check box to indicate that automatic hyphenation of words is enabled.
IsIndeterminate	Select this check box to indicate that no actual values display on the progress bar. Clear this check box to display actual values.
IsManipulationEnabled	Select this check box to indicate that the manipulation events for the control are enabled.
IsMoveToPointEnabled	Select this check box to indicate that the thumb of a slider moves immediately to the location of the mouse click that occurs while the mouse pointer pauses on the Slider track.
IsReadOnly	Select this check box to indicate that the text editing control is read-only to a user interacting with the control.
IsReadOnlyCaretVisible	Specifies 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.
IsSelectionRangeEnabled	Select this check box to indicate that the Slider displays a selection range.
IsSharedSizeScope	Select this check box to indicate that controls are sharing size information.
IsSnapToTickEnabled	Select this check box to indicate that the Slider automatically moves the thumb to the closest tick mark.
IsTabStop	Select this check box to indicate that a control is included in tab navigation.
IsThreeState	Select this check box to indicate that the control supports three states; that is, selected, cleared, indeterminate (the control is selected but dimmed).
IsTodayHighlighted	Select this check box to indicate that the current date is highlighted.
IsUndoEnabled	Select 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.
Language	Specifies the localization language that applies to an object.
LargeChange	Specifies a value to be added to or subtracted from the value of a range base control.
LineHeight	Specifies the height of each line of content.
LineStackingStrategy	Specifies the mechanism by which a line box is determined for each line of text within the Text Block. Selections are: BlockLineHeight MaxHeight
Localization	Click 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.
Margin	Specifies the outer margin of a control.
MaxHeight	Specifies the maximum height of a control.
MaxLength	Specifies 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.
MaxLines	Specifies the maximum number of visible lines.
MaxWidth	Specifies the maximum width of a control.
MinHeight	Specifies the minimum height of a control.
MinLines	Specifies the minimum number of visible lines.
MinWidth	Specifies the minimum width of a control.
Name	Specifies 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.
NavigateUri	Specifies the URI to navigate to when the control is clicked.
Opacity	Specifies the opacity factor applied to the entire control. Valid values are 0 through 1, with up to 15 decimal places.
OpacityMask	Expand 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.
Orientation	Specifies the orientation of a control. Selections are: Portrait Landscape
OverridesDefaultStyle	Select this check box to indicate that this control incorporates style properties from theme styles.
Padding	Specifies the amount of padding to apply to the inside edge of each side of a control.
PasswordChar	Specifies the masking character for the Password Box.
Projection	Specifies the 3-D effect to apply to the current object.
RenderTransformOrigin	Specifies 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.
Row	RowBackground
RowSpan	Specifies the total number of rows that child content spans within a grid.
SelectedDate	Specifies the currently selected date.
SelectionBrush	Expand this field to select the brush to use to highlight the selected text.
SelectionEnd	Specifies the largest value of a specified selection for a slider control. The value of this property cannot be greater than the value of the Maximum property and cannot be less than the value of the Minimum property. The value of this property must also be greater than or equal to the value of the SelectionStart property. If the value of this property is greater than the value of the Maximum property or less than the value of the Minimum property, the value is set to the value of the Maximum or Minimum property respectively.
SelectionMode	Specifies the selection behavior for a List Box or List View control. Selections are: Single Date Single Range Multiple Range None
SelectionStart	Specifies the smallest value of a specified selection for a slider control. The value of this property cannot be less than the value of the Minimum property and cannot be greater than the value of the Maximum property. The value of this property must also be greater than or equal to the value of the SelectionEnd property. If the value of this property is less than the value of the Minimum property or greater than the value of the Maximum property, the value is set to the value of the Minimum or Maximum property respectively.
SelectionOpacity	Specifies the opacity factor applied to the selected text. Valid values are 0 through 1, with up to 15 decimal places. If the value is set to 0, the SelectionBrush is transparent and is not visible. If the value is set to 1.0 or greater, the SelectionBrush is opaque and the selected text is not visible.
ShowGridLines	Select this check box to indicate that grid lines are visible within this grid.
SmallChange	Specifies a value to be added to or subtracted from the value of a range base control.
SnapsToDevicePixels	Select this check box to indicate that rendering for this control uses device-specific pixel settings.
Source	Click the ellipsis button to open the Select an Image dialog box, where you can selec the image to use for the control.
Stretch	Specifies how an Image stretches to fill the destination rectangle. Selections are: Fill None (does not apply to Scale Box) Uniform (does not apply to Scale Box) UniformFill (does not apply to Scale Box)
StretchDirection	Specifies how the image is scaled. Selections are: Vertical Horizontal
Style	Specifies the style used by this control when it is rendered.
TabIndex	Specifies the order in which controls receive focus when the Tab key is pressed.
TabNavigation	Specifies a value that modifies how tabbing and the TabIndex property work for this control.
Tag	Specifies an arbitrary object value that can be used to store custom information about this control.
TargetName	Specifies the name of the target window or frame that the web page should open in, or the name of the object within the Silverlight application to navigate to.
Template	Click the ellipsis button to open the Open dialog box to select a template to use.
Text	Specifies the text contents of a control.
TextAlignment	Specifies the horizontal alignment of text content. Selections are: Left Center Right Justify
TextTrimming	Specifies the text trimming behavior to employ when content overflows the content area. Selections are: None CharacterEllipsis WordEllipsis
TextWrapping	Specifies how the control wraps text. Selections are: NoWrap Wrap WrapWithOverflow
TickFrequency	Specifies the interval between tick marks.
TickPlacement	Specifies the position of tick marks with respect to the track of the Slider. Selections are: None Both TopLeft BottomRight
ToolTip	Specifies the tool-tip that displays for this control in the user interface (UI).
Uid	Specifies the unique identifier (for localization) for this control.
UndoLimit	Specifies the number of actions stored in the undo queue.
UseLayoutRounding	Specifies a value that determines whether rendering for the object and its visual subtree should use rounding behavior that aligns rendering to whole pixels.
Value	Specifies the current magnitude of the range control.
VerticalAlignment	Specifies the vertical alignment characteristics applied to this control. Selections are: Bottom Center Top Stretch
VerticalContentAlignment	Specifies the vertical alignment of the control's content. Selections are: Bottom Center Top Stretch
VerticalScrollBarVisibility	Specifies 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.
ViewportSize	Specifies the amount of the scrollable content that is currently visible. The value of this property is used to calculate the size of the thumb control that is displayed as the sliding value indicator in a scrollbar control. The thumb' control's size represents the amount of a scrollviewer control's content that is visible. For example, if 25 percent of a scrollviewer control's content is visible, the thumb control occupies 25 percent of the track in the scrollbar.
Visiblility	Specifies the visibility of this control. Selections are: Collapsed Hidden Visible
Width	Specifies the width of the control, in pixels.