ScrollBars 枚举
定义
指定 Panel 控件中滚动条的可见性和位置。Specifies the visibility and position of scroll bars in a Panel control.
此枚举有一个 FlagsAttribute 属性,允许按位组合成员值。
public enum class ScrollBars
[System.Flags]
public enum ScrollBars
[<System.Flags>]
type ScrollBars =
Public Enum ScrollBars
- 继承
- 属性
字段
| Auto | 4 | 根据需要,可显示水平滚动条、垂直滚动条或这两种滚动条。Displays, horizontal, vertical, or both scroll bars as necessary. 要不然也可以不显示任何滚动条。Otherwise, no scroll bars are shown. |
| Both | 3 | 同时显示水平滚动条和垂直滚动条。Displays both a horizontal and a vertical scroll bar. |
| Horizontal | 1 | 只显示水平滚动条。Displays only a horizontal scroll bar. |
| None | 0 | 不显示滚动条。Displays no scroll bars. |
| Vertical | 2 | 只显示垂直滚动条。Displays only a vertical scroll bar. |
示例
下面的代码示例演示如何以声明方式将 ScrollBars 属性设置为 Auto 。The following code example demonstrates how to declaratively set the ScrollBars property to Auto. 面板包含一个表,其中的全部内容超出了面板的大小。The panel contains a table, the entire contents of which exceed the size of the panel. 这会导致垂直滚动条和水平滚动条在呈现面板时自动显示。This causes both vertical and horizontal scroll bars to be automatically displayed when the panel is rendered. 然后,用户可以滚动查看表中的所有数据。The user can then scroll to view all the data in the table.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
private void Page_Load(object sender, EventArgs e)
{
// Add more rows and columns to the table than can
// be displayed in the panel area.
// Scroll bars will be required to view all the data.
// Add rows and columns to the table.
for (int rowNum = 0; rowNum < 51; rowNum++)
{
TableRow tempRow = new TableRow();
for (int cellNum = 0; cellNum < 11; cellNum++)
{
TableCell tempCell = new TableCell();
tempCell.Text =
String.Format("({0}, {1})", rowNum, cellNum);
tempRow.Cells.Add(tempCell);
}
Table1.Rows.Add(tempRow);
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
<title>Panel Scrollbars - C# Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>Panel.ScrollBars Property Example</h3>
<asp:Panel ID="Panel1" runat="Server"
Height="300px" Width="400px"
BackColor="Aqua" ScrollBars="Auto">
<asp:Table ID="Table1" runat="Server"></asp:Table>
</asp:Panel>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Private Sub Page_Load(ByVal sender As Object, _
ByVal e As System.EventArgs)
' Add more rows and columns to the table than can
' be displayed in the panel area.
' Scroll bars will be required to view all the data.
' Add rows and columns to the table.
Dim rowNum As Integer
For rowNum = 0 To 50
Dim tempRow As New TableRow
Dim cellNum As Integer
For cellNum = 0 To 10
Dim tempCell As New TableCell
tempCell.Text = _
String.Format("({0}, {1})", rowNum, cellNum)
tempRow.Cells.Add(tempCell)
Next
Table1.Rows.Add(tempRow)
Next
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
<title>Panel Scrollbars - VB.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>Panel.ScrollBars Property Example</h3>
<asp:Panel ID="Panel1" runat="Server"
Height="300px" Width="400px"
BackColor="Aqua" ScrollBars="Auto">
<asp:Table ID="Table1" runat="Server"></asp:Table>
</asp:Panel>
</div>
</form>
</body>
</html>
下面的代码示例演示了 ScrollBars 枚举值。The following code example demonstrates the ScrollBars enumeration values. ListBox使用 ScrollBars 枚举值填充控件。A ListBox control is populated with the ScrollBars enumeration values. 面板中显示的滚动条将根据用户从列表框中选择的值更改。The scroll bars displayed in the panel change, based on the value the user selects from the list box.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
private void Page_Load(object sender, EventArgs e)
{
// Add more rows and columns to the table than can
// be displayed in the panel area.
// Scroll bars will be required to view all the data.
// Add rows and columns to the table.
for (int rowNum = 0; rowNum < 51; rowNum++)
{
TableRow tempRow = new TableRow();
for (int cellNum = 0; cellNum < 11; cellNum++)
{
TableCell tempCell = new TableCell();
tempCell.Text =
String.Format("({0}, {1})", rowNum, cellNum);
tempRow.Cells.Add(tempCell);
}
Table1.Rows.Add(tempRow);
}
}
private void ListBox1_SelectedIndexChanged(object sender, EventArgs e)
{
// Determine which list item was clicked.
// Display the selected scroll bars in the panel.
switch (ListBox1.SelectedIndex)
{
case 0:
Panel1.ScrollBars = ScrollBars.None;
break;
case 1:
Panel1.ScrollBars = ScrollBars.Horizontal;
break;
case 2:
Panel1.ScrollBars = ScrollBars.Vertical;
break;
case 3:
Panel1.ScrollBars = ScrollBars.Both;
break;
case 4:
Panel1.ScrollBars = ScrollBars.Auto;
break;
default:
throw new Exception("Select a valid list item.");
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
<title></title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>Panel.ScrollBars Property Example</h3>
<h4>Select the scrollbars to display in the panel.</h4>
<asp:ListBox ID="ListBox1" runat="Server"
Rows="5" AutoPostBack="True"
SelectionMode="Single"
OnSelectedIndexChanged="ListBox1_SelectedIndexChanged">
<asp:ListItem>None</asp:ListItem>
<asp:ListItem>Horizontal</asp:ListItem>
<asp:ListItem>Vertical</asp:ListItem>
<asp:ListItem>Both</asp:ListItem>
<asp:ListItem>Auto</asp:ListItem>
</asp:ListBox>
<hr />
<asp:Panel ID="Panel1" runat="Server"
Height="300px" Width="400px" BackColor="Aqua">
<asp:Table ID="Table1" runat="Server" />
</asp:Panel>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Private Sub Page_Load(ByVal sender As Object, _
ByVal e As System.EventArgs)
' Add more rows and columns to the table than can
' be displayed in the panel area.
' Scroll bars will be required to view all the data.
' Add rows and columns to the table.
Dim i As Integer
For i = 0 To 50
Dim tempRow As New TableRow
Dim j As Integer
For j = 0 To 10
Dim tempCell As New TableCell
tempCell.Text = "(" & i & "," & j & ")"
tempRow.Cells.Add(tempCell)
Next j
Table1.Rows.Add(tempRow)
Next i
End Sub
Sub ListBox1_SelectedIndexChanged(ByVal sender As Object, _
ByVal e As EventArgs)
' Determine which list item was clicked.
' Display the selected scroll bars in the panel.
Select Case (ListBox1.SelectedIndex)
Case 0
Panel1.ScrollBars = ScrollBars.None
Case 1
Panel1.ScrollBars = ScrollBars.Horizontal
Case 2
Panel1.ScrollBars = ScrollBars.Vertical
Case 3
Panel1.ScrollBars = ScrollBars.Both
Case 4
Panel1.ScrollBars = ScrollBars.Auto
Case Else
Throw New Exception("Select a valid list item.")
End Select
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
<title></title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>Panel.ScrollBars Property Example</h3>
<h4>Select the scrollbars to display in the panel.</h4>
<asp:ListBox ID="ListBox1" runat="Server"
Rows="5" AutoPostBack="True" SelectionMode="Single"
OnSelectedIndexChanged="ListBox1_SelectedIndexChanged">
<asp:ListItem>None</asp:ListItem>
<asp:ListItem>Horizontal</asp:ListItem>
<asp:ListItem>Vertical</asp:ListItem>
<asp:ListItem>Both</asp:ListItem>
<asp:ListItem>Auto</asp:ListItem>
</asp:ListBox>
<hr />
<asp:Panel ID="Panel1" runat="Server"
Height="300px" Width="400px" BackColor="Aqua">
<asp:Table ID="Table1" runat="Server" />
</asp:Panel>
</div>
</form>
</body>
</html>
注解
ScrollBars枚举表示控件中滚动条的可见性和位置 Panel 。The ScrollBars enumeration represents the visibility and position of the scroll bars in a Panel control. ScrollBars属性使用这些枚举值来指定要在控件中显示的滚动条的类型 Panel 。The ScrollBars property uses these enumeration values to specify the type of scroll bars to display in a Panel control. 属性的默认值 ScrollBars 为 None ,指示不显示任何滚动条。The default value for the ScrollBars property is None, indicating that no scroll bars are shown.
如果 Auto 为 ScrollBars 属性指定,控件中内容的大小超过控件的大小时,将自动显示滚动条 Panel Panel 。If you specify Auto for the ScrollBars property, scroll bars are automatically shown when the size of the content in a Panel control exceeds the size of the Panel control. 例如,如果 Panel 控件包含一个表,并且该面板的宽度不足以显示表中的所有行,则将显示一个垂直滚动条。For example, if a Panel control contains a table, and the panel is not wide enough to display all the rows in the table, a vertical scroll bar is shown. 如果表的大小超过面板的高度和宽度,则会同时显示垂直滚动条和水平滚动条。If the size of the table exceeds the height and width of the panel, both vertical and horizontal scroll bars are shown.