Share via

XRScrollBarVisibility (Compact 2013)

  • Article

3/28/2014

This enumeration contains values that specify the visibility of a scroll bar that is inside a scroll viewer or text box.

Syntax

enum XRScrollBarVisibility
{
        XRScrollBarVisibility_Disabled = 0,
        XRScrollBarVisibility_Auto,
        XRScrollBarVisibility_Hidden,
        XRScrollBarVisibility_Visible,
};

Members

  • XRScrollBarVisibility_Disabled
    An IXRScrollBar control does not appear, even when the viewport cannot display all of the content. The dimension of the content is set to the corresponding dimension of the parent IXRScrollViewer control. For a horizontal IXRScrollBar control, the width of the content is set to the viewport-width of the IXRScrollViewer control. For a vertical IXRScrollBar control, the height of the content is set to the viewport height of the IXRScrollViewer control.
  • XRScrollBarVisibility_Auto
    An IXRScrollBar control appears, and the dimension of the IXRScrollViewer is applied to the content when the viewport cannot display all of the content. For a horizontal IXRScrollBar control, the width of the content is set to the viewport width of the IXRScrollViewer control. For a vertical IXRScrollBar control, the height of the content is set to the viewport height of the IXRScrollViewer control.
  • XRScrollBarVisibility_Hidden
    An IXRScrollBar control does not appear, even when the viewport cannot display all of the content. The dimension of the IXRScrollViewer control is not applied to the content.
  • XRScrollBarVisibility_Visible
    An IXRScrollBar control always appears. The dimension of the IXRScrollViewer control is applied to the content. For a horizontal IXRScrollBar control, the width of the content is set to the viewport width of the IXRScrollViewer control. For a vertical IXRScrollBar control, the height of the content is set to the viewport height of the IXRScrollViewer control.

Remarks

You can use this enumeration to set the horizontal scroll bar visibility and vertical scroll bar visibility characteristics for a scroll viewer or text box.

The member values of this enumeration specify IXRScrollBar visibility in a given direction. These member values also specify whether the corresponding IXRScrollViewer dimension is applied to its enclosed content.

After you call IXRFrameworkElement::SetWidth or IXRFrameworkElement::SetHeight on the IXRScrollViewer control, these values help determine the viewport size for the content.

.NET Framework Equivalent

System.Windows.Controls.ScrollBarVisibility

Requirements

Header

XamlRuntime.h

sysgen

SYSGEN_XAML_RUNTIME

See Also

Reference

XAML for Windows Embedded Enumerations
IXRScrollViewer::GetHorizontalScrollBarVisibility
IXRScrollViewer::SetHorizontalScrollBarVisibility
IXRScrollViewer::GetVerticalScrollBarVisibility
IXRScrollViewer::SetVerticalScrollBarVisibility
IXRTextBox::GetHorizontalScrollBarVisibility
IXRTextBox::SetHorizontalScrollBarVisibility
IXRTextBox::GetVerticalScrollBarVisibility
IXRTextBox::SetVerticalScrollBarVisibility