Intersoft ClientUI Documentation
VerticalScrollBarVisibility Property
See Also  Send Feedback
Intersoft.Client.UI.Controls Namespace > UXScrollViewer Class : VerticalScrollBarVisibility Property






Gets or sets a value that indicates whether a vertical ScrollBar should be displayed.

Syntax

Visual Basic (Declaration) 
<CategoryAttribute("Common Properties")>
Public Property VerticalScrollBarVisibility As ScrollBarVisibility
Visual Basic (Usage)Copy Code
Dim instance As UXScrollViewer
Dim value As ScrollBarVisibility
 
instance.VerticalScrollBarVisibility = value
 
value = instance.VerticalScrollBarVisibility
C# 
[CategoryAttribute("Common Properties")]
public ScrollBarVisibility VerticalScrollBarVisibility {get; set;}
Delphi 
public read-write property VerticalScrollBarVisibility: ScrollBarVisibility; 
JScript 
CategoryAttribute("Common Properties")
public function get,set VerticalScrollBarVisibility : ScrollBarVisibility
Managed Extensions for C++ 
[CategoryAttribute("Common Properties")]
public: __property ScrollBarVisibility get_VerticalScrollBarVisibility();
public: __property void set_VerticalScrollBarVisibility( 
   ScrollBarVisibility value
);
C++/CLI 
[CategoryAttribute("Common Properties")]
public:
property ScrollBarVisibility VerticalScrollBarVisibility {
   ScrollBarVisibility get();
   void set (    ScrollBarVisibility value);
}

Remarks

By default, the vertical scrollbar is always displayed regardless of the content size. In this case, the vertical scroll bar is shown disabled if the content fits the size. You can customize this behavior to automatically display the vertical scollbar only when necessary by setting the VerticalScrollBarVisibility to Auto. The same is true for HorizontalScrollBarVisibility as well.

The scroll bar visibility for both vertical and horizontal direction provides the following options:

  • Disabled
    The scroll bar for the particular direction is disabled. In this mode, the scroll bar will never appear eventhough the content exceeds the desired size.
     
  • Auto
    The scroll bar for the particular direction will appear automatically when the content exceeds the desired size.
     
  • Hidden
    The scroll bar for the particular direction is hidden and never appear eventhough the content exceeds the desired size. In this mode, the scroll bar logic is performed which updates the relevant scrolling properties.
     
  • Visible
    The scroll bar for the particular direction will always be visible regardless of the content size.

The following example shows how to show both scroll bars of the UXScrollViewer only when its content exceeds the desired size.

XAML Copy Code
<Intersoft:UXScrollViewer Height="150" Width="250" BorderThickness="1" BorderBrush="#FF7E7E7E"
                          VerticalScrollBarVisibility="Auto" 
                          HorizontalScrollBarVisibility="Auto">

    <Grid Height="200" Background="#FFD0EFFF">
        <TextBlock Text="Put very long content here" VerticalAlignment="Center" HorizontalAlignment="Center"/>
    </Grid>

</Intersoft:UXScrollViewer>

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2012 All Rights Reserved.