ScrollBars ScrollBars ScrollBars ScrollBars Enum

Definition

Gibt die Sichtbarkeit und Position der Schiebeleisten in einem Panel-Steuerelement an.Specifies the visibility and position of scroll bars in a Panel control.

Diese Enumeration weist ein FlagsAttribute-Attribut auf, die eine bitweise Kombination der Memberwerte zulässt.

public enum class ScrollBars
[System.Flags]
public enum ScrollBars
type ScrollBars = 
Public Enum ScrollBars
Vererbung
Attribute

Felder

Auto Auto Auto Auto 4

Gegebenenfalls werden die horizontale oder die vertikale Schiebeleiste bzw. sowohl die horizontale als auch die vertikale Schiebeleiste angezeigt.Displays, horizontal, vertical, or both scroll bars as necessary. Andernfalls werden keine Schiebeleisten angezeigt.Otherwise, no scroll bars are shown.

Both Both Both Both 3

Es werden immer sowohl eine horizontale als auch eine vertikale Schiebeleiste angezeigt.Displays both a horizontal and a vertical scroll bar.

Horizontal Horizontal Horizontal Horizontal 1

Es wird immer eine horizontale Schiebeleiste angezeigt.Displays only a horizontal scroll bar.

None None None None 0

Es werden keine Schiebeleisten angezeigt.Displays no scroll bars.

Vertical Vertical Vertical Vertical 2

Es wird immer eine vertikale Schiebeleiste angezeigt.Displays only a vertical scroll bar.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ScrollBars -Eigenschaft deklarativ auf Autofestgelegt wird.The following code example demonstrates how to declaratively set the ScrollBars property to Auto. Der Bereich enthält eine Tabelle, deren gesamter Inhalt die Größe des Panels überschreitet.The panel contains a table, the entire contents of which exceed the size of the panel. Dies bewirkt, dass sowohl vertikale als auch horizontale Schiebe leisten automatisch angezeigt werden, wenn der Bereich gerendert wird.This causes both vertical and horizontal scroll bars to be automatically displayed when the panel is rendered. Der Benutzer kann dann einen Bildlauf durchführen, um alle Daten in der Tabelle anzuzeigen.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>

Im folgenden Codebeispiel werden die ScrollBars -Enumerationswerte veranschaulicht.The following code example demonstrates the ScrollBars enumeration values. Ein ListBox -Steuerelement wird mit ScrollBars den-Enumerationswerten aufgefüllt.A ListBox control is populated with the ScrollBars enumeration values. Die im Panel angezeigten Bild Lauf leisten ändern sich basierend auf dem Wert, den der Benutzer aus dem Listenfeld auswählt.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>

Hinweise

Die ScrollBars -Enumeration stellt die Sichtbarkeit und Position der Schiebe leisten in Panel einem-Steuerelement dar.The ScrollBars enumeration represents the visibility and position of the scroll bars in a Panel control. Die ScrollBars -Eigenschaft verwendet diese Enumerationswerte, um den Typ der Scrollleisten anzugeben, Panel der in einem-Steuerelement angezeigt werden soll.The ScrollBars property uses these enumeration values to specify the type of scroll bars to display in a Panel control. Der Standardwert für die ScrollBars -Eigenschaft Noneist, was bedeutet, dass keine Schiebe leisten angezeigt werden.The default value for the ScrollBars property is None, indicating that no scroll bars are shown.

Wenn Sie für Auto die ScrollBars -Eigenschaft angeben, werden Scrollleisten automatisch angezeigt, wenn die Größe des Inhalts in Panel einem-Steuerelement die Größe Panel des Steuer Elements überschreitet.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. Wenn z. b. Panel ein-Steuerelement eine Tabelle enthält und das Panel nicht breit genug ist, um alle Zeilen in der Tabelle anzuzeigen, wird eine vertikale Schiebe Leiste angezeigt.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. Wenn die Größe der Tabelle die Höhe und die Breite des Panels überschreitet, werden sowohl vertikale als auch horizontale Schiebe leisten angezeigt.If the size of the table exceeds the height and width of the panel, both vertical and horizontal scroll bars are shown.

Gilt für:

Siehe auch