Custom Controls

The Designer provides the following group of custom controls.

Custom Controls Property Usage

The following table shows the properties used by each control:
PropertyUniversal BrowserUser Validation
AllowDropXX
AuthenticatedX
BackgroundXX
BorderBrushXX
BorderThicknessXX
ClipToBoundsXX
ColumnXX
ColumnSpanXX
DataFilterX
EffectXX
FlowDirectionXX
FocusableXX
FocusVisualStyleXX
FontFamilyXX
FontSizeXX
FontStretchXX
FontStyleXX
FontWeightXX
ForceCursorXX
ForegroundXX
HeightXX
HorizontalAlignmentXX
HorizontalContentAlignmentXX
InstructionTextX
IsEnabledXX
IsHitTestVisibleXX
IsManipulationEnabledXX
IsSharedSizeScopeXX
IsTabStopXX
ItemTextX
LocalizationXX
MarginXX
MaxHeightXX
MaxWidthXX
MinHeightXX
MinWidthXX
ModelsAndEntryPointFilterX
MultipleSelectAllowedX
NameXX
OpacityXX
OpacityMaskXX
OverridesDefaultStyleXX
PaddingXX
RenderTransformOriginXX
RowXX
RowSpanXX
SnapsToDevicePixelsXX
StrokeThicknessX
StyleXX
TabIndexXX
TagXX
TemplateXX
ToolTipXX
UidXX
UseLayoutRoundingXX
VerticalAlignmentXX
VerticalContentAlignmentXX
VisibilityXX
WidthXX

Custom 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.
AuthenticatedThis check box is selected when a user's authentication attempt succeeds.
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.
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.
DataFilterClick the ellipsis button to open the Browser Data Filter dialog box where you can filter the data to display in the Universal Browser control. The settings you configure in this dialog box are ignored if the ShowModels property check box is selected.
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.
GlareBrushExpand this field to specify the glare effect for the control.
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
ImageStretchSpecifies how the image should be stretched to fill the destination rectangle. Selections are:
  • Fill
  • None
  • Uniform
  • UniformToFill
InstructionTextSpecifies the item description displayed initially when nothing is selected. The default text is "Please select an appropriate item."
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.
ItemTextSpecifies the item name displayed initially when nothing is selected. The default text is "Not Set."
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.
ModelsAndEntryPointFilterClick the ellipsis button to open the Browser Models and Entry Point Filter dialog box where you can specify a list of the models and entry points to be included in, or excluded from, the Universal Browser when it appears. By default, all models and entry points are displayed. In order for the selected models and entry points to display, the ShowModels property check box must be selected.
Note: When you exclude entry points, you must also exclude the "All" entry point, if it exists. Including the "All" entry point takes precedence over individual exclusions.
MultipleSelectAllowedSelect this check box to allow multiple resources to be selected in the Universal Browser.
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.
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
VisiblilitySpecifies the visibility of this control. Selections are:
  • Collapsed
  • Hidden
  • Visible
WidthSpecifies the width of the control, in pixels.