Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Propriedade Panel.ScrollBars

Obtém ou define a visibilidade e a posição das barras de rolagem em um Panel de controle.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

public virtual ScrollBars ScrollBars { get; set; }
<asp:Panel ScrollBars="ScrollBars" />

Valor de propriedade

Tipo: System.Web.UI.WebControls.ScrollBars
Dentre as ScrollBars valores de enumeração. The default is None.

Use o ScrollBars barras de propriedade para especificar a visibilidade e a posição de rolagem em um Panel de controle. Essa propriedade é definida usando um do ScrollBars valores de enumeração. A tabela a seguir lista os valores possíveis.

Value

Descrição

None

Não há barras de rolagem são mostradas.

Horizontal

Uma barra de rolagem horizontal é mostrada.

Vertical

Uma barra de rolagem vertical é mostrada.

Both

Ambas as barras de rolagem horizontais e verticais são mostradas.

Auto

Se necessário, horizontal, vertical ou ambas as barras de rolagem são mostradas. Caso contrário, não há barras de rolagem são mostradas.

Se você especificar Auto para o ScrollBars propriedade, as barras de rolagem são exibidas automaticamente quando o tamanho do conteúdo em um Panel controle excede o tamanho da Panel controle propriamente dito. Por exemplo, se um Panel controle contém uma tabela e o painel não é suficiente para exibir todas as linhas na tabela, uma barra de rolagem vertical é mostrada. Se o tamanho da tabela exceder a altura e largura do painel, ambas as barras de rolagem vertical e horizontal são mostradas.

ObservaçãoObservação

Esta propriedade é suportada apenas em navegadores que oferecem suporte a HTML 4.0 ou posterior.

O exemplo de código a seguir demonstra como declarativamente definir o ScrollBars propriedade para Auto. O painel contém uma tabela, todo o conteúdo que excede o tamanho do painel. Isso faz com que ambas as barras de rolagem vertical e horizontal ser exibida automaticamente quando o painel é renderizado. Em seguida, o usuário pode rolar para exibir todos os dados na tabela.

ObservaçãoObservação

The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code sample must be copied into an empty text file that has an .aspx extension. Para obter mais informações sobre o modelo de código de formulários da Web, consulte Modelo de código de página Web do ASP.NET.


<%@ 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>


O exemplo de código a seguir demonstra como programaticamente definir o ScrollBars propriedade. Um ListBox controle é preenchido com o ScrollBars valores de enumeração. As barras de rolagem exibidas na alteração do painel, com base no valor que o usuário seleciona a caixa de listagem.

ObservaçãoObservação

The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code sample must be copied into an empty text file that has an .aspx extension. Para obter mais informações sobre o modelo de código de formulários da Web, consulte Modelo de código de página Web do ASP.NET.


<%@ 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>


.NET Framework

Com suporte em: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos de sistema do .NET Framework.
Mostrar: