Viewer Controls

The Designer provides the following group of custom viewer controls.

Viewer Controls Property Usage

The following table shows the properties used by each control:
PropertyScroll Viewer
AllowDropX
BackgroundX
BorderBrushX
BorderThicknessX
CanContentScrollX
ClipToBoundsX
ColumnX
ColumnSpanX
ContentX
ContentStringFormatX
EffectX
FlowDirectionX
FocusableX
FocusVisualStyleX
FontFamilyX
FontSizeX
FontStretchX
FontStyleX
FontWeightX
ForceCursorX
ForegroundX
HeightX
HorizontalAlignmentX
HorizontalContentAlignmentX
HorizontalScrollBarVisiblityX
IsDeferredScrollingEnabledX
IsEnabledX
IsHitTestVisibleX
IsManipulationEnabledX
IsSharedSizeScopeX
IsTabStopX
LocalizationX
MarginX
MaxHeightX
MaxWidthX
MinHeightX
MinWidthX
NameX
OpacityX
OpacityMaskX
OverridesDefaultStyleX
PaddingX
PanningDeclerationX
PanningModeX
PanningRatioX
RenderTransformOriginX
RowX
RowSpanX
SnapsToDevicePixelsX
StrokeThicknessX
StyleX
TabIndexX
TagX
TemplateX
ToolTipX
UidX
UseLayoutRoundingX
VerticalAlignmentX
VerticalContentAlignmentX
VerticalScrollBarVisibilityX
VisibilityX
WidthX

Viewer Controls Property Descriptions

The following table shows the properties descriptions used by all control:
PropertyDescription
AllowDropSelect this check box to indicate that the control can accept data that is dragged onto it.
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.
CanContentScrollSelect this check box to indicate that elements that support the Scroll Viewer control are allowed to scroll.
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.
ContentSpecifies the content displayed on the control.
ContentStringFormatSpecifies a composite string that determines how to format the Content property if it is displayed as a string.
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 ba 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
IsDeferredScrollingEnabledSelect this check box to indicate that the content is stationary when you drag the thumb of a scroll bar.
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.
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.
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.
MaxWidthSpecifies the maximum width of a control.
MinHeightSpecifies the minimum height of a control.
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.
PnningDecelerationSpecifies the rate at which the control slows.
PanningModeSpecifies the way the control reacts to touch manipulation. Valid selections are:
  • None
  • Horizontal Only
  • Vertical Only
  • Both
  • Horizontal First
  • Vertical First
PanningRatioSpecifies the ratio of scrolling offset to translate manipulation offset.
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.
SnapsToDevicePixelsSelect this check box to indicate that rendering for this control uses device-specific pixel settings.
StrokeThicknessSpecifies the width of the control's outline.
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.
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.