Classe AWT Scrollbar

Introdução

O controle da barra de rolagem representa um componente da barra de rolagem para permitir que o usuário selecione um intervalo de valores.

Declaração de classe

A seguir está a declaração para java.awt.Scrollbar classe:

public class Scrollbar
   extends Component
      implements Adjustable, Accessible

Campo

A seguir estão os campos para java.awt.Image classe:

  • static int HORIZONTAL - Uma constante que indica uma barra de rolagem horizontal.

  • static int VERTICAL - Uma constante que indica uma barra de rolagem vertical.

Construtores de classe

SNConstrutor e descrição
1

Scrollbar()

Constrói uma nova barra de rolagem vertical.

2

Scrollbar(int orientation)

Constrói uma nova barra de rolagem com a orientação especificada.

3

Scrollbar(int orientation, int value, int visible, int minimum, int maximum)

Constrói uma nova barra de rolagem com a orientação especificada, valor inicial, quantidade visível e valores mínimo e máximo.

Métodos de aula

SNMétodo e Descrição
1

void addAdjustmentListener(AdjustmentListener l)

Adiciona o ouvinte de ajuste especificado para receber instâncias de AdjustmentEvent desta barra de rolagem.

2

void addNotify()

Cria o par da barra de rolagem.

3

int getBlockIncrement()

Obtém o incremento de bloco desta barra de rolagem.

4

int getLineIncrement()

Descontinuada. A partir do JDK versão 1.1, substituído por getUnitIncrement ().

5

int getMaximum()

Obtém o valor máximo desta barra de rolagem.

6

int getMinimum()

Obtém o valor mínimo desta barra de rolagem.

7

int getOrientation()

Retorna a orientação desta barra de rolagem.

8

int getPageIncrement()

Descontinuada. A partir do JDK versão 1.1, substituído por getBlockIncrement ().

9

int getUnitIncrement()

Obtém o incremento da unidade para esta barra de rolagem.

10

int getValue()

Obtém o valor atual desta barra de rolagem.

11

boolean

getValueIsAdjusting ()

Retorna verdadeiro se o valor estiver em processo de alteração como resultado de ações tomadas pelo usuário.

12

int getVisible()

Descontinuada. A partir do JDK versão 1.1, substituído por getVisibleAmount ().

13

int getVisibleAmount()

Obtém a quantidade visível desta barra de rolagem.

14

protected String paramString()

Retorna uma string que representa o estado desta barra de rolagem.

15

protected void processAdjustmentEvent(AdjustmentEvent e)

Processa eventos de ajuste que ocorrem nesta barra de rolagem, despachando-os para quaisquer objetos AdjustmentListener registrados.

16

protected void processEvent(AWTEvent e)

Processa eventos nesta barra de rolagem.

17

void removeAdjustmentListener(AdjustmentListener l)

Remove o ouvinte de ajuste especificado para que ele não receba mais instâncias de AdjustmentEvent desta barra de rolagem.

18

void setBlockIncrement(int v)

Define o incremento do bloco para esta barra de rolagem.

19

void setLineIncrement(int v)

Descontinuada. A partir do JDK versão 1.1, substituído por setUnitIncrement (int).

20

void setMaximum(int newMaximum)

Define o valor máximo desta barra de rolagem.

21

void setMinimum(int newMinimum)

Define o valor mínimo desta barra de rolagem.

22

void setOrientation(int orientation)

Define a orientação desta barra de rolagem.

23

void setPageIncrement(int v)

Descontinuada. A partir do JDK versão 1.1, substituído por setBlockIncrement ().

24

void setUnitIncrement(int v)

Define o incremento da unidade para esta barra de rolagem.

25

void setValue(int newValue)

Define o valor desta barra de rolagem para o valor especificado.

26

void setValueIsAdjusting(boolean b)

Define a propriedade valueIsAdjusting.

27

void setValues(int value, int visible, int minimum, int maximum)

Define os valores de quatro propriedades para esta barra de rolagem: value, visibleAmount, minimum e maximum.

28

void setVisibleAmount(int newAmount)

Define a quantidade visível desta barra de rolagem.

29

AccessibleContext getAccessibleContext()

Obtém o AccessibleContext associado a esta barra de rolagem.

30

AdjustmentListener[] getAdjustmentListeners()

Retorna uma matriz de todos os ouvintes de ajuste registrados nesta barra de rolagem.

31

<T extends EventListener>T[] getListeners(Class<T> listenerType)

Retorna um array de todos os objetos atualmente registrados como FooListeners nesta barra de rolagem.

Métodos herdados

Esta classe herda métodos das seguintes classes:

  • java.awt.Component

  • java.lang.Object

Exemplo de escolha

Crie o seguinte programa java usando qualquer editor de sua escolha em dizer D:/ > AWT > com > tutorialspoint > gui >

AwtControlDemo
package com.tutorialspoint.gui;

import java.awt.*;
import java.awt.event.*;

public class AwtControlDemo {

   private Frame mainFrame;
   private Label headerLabel;
   private Label statusLabel;
   private Panel controlPanel;

   public AwtControlDemo(){
      prepareGUI();
   }

   public static void main(String[] args){
      AwtControlDemo  awtControlDemo = new AwtControlDemo();
      awtControlDemo.showScrollbarDemo();
   }

   private void prepareGUI(){
      mainFrame = new Frame("Java AWT Examples");
      mainFrame.setSize(400,400);
      mainFrame.setLayout(new GridLayout(3, 1));
      mainFrame.addWindowListener(new WindowAdapter() {
         public void windowClosing(WindowEvent windowEvent){
            System.exit(0);
         }        
      });    
      headerLabel = new Label();
      headerLabel.setAlignment(Label.CENTER);
      statusLabel = new Label();        
      statusLabel.setAlignment(Label.CENTER);
      statusLabel.setSize(350,100);

      controlPanel = new Panel();
      controlPanel.setLayout(new FlowLayout());

      mainFrame.add(headerLabel);
      mainFrame.add(controlPanel);
      mainFrame.add(statusLabel);
      mainFrame.setVisible(true);  
   }

   private void showScrollbarDemo(){                                       
      headerLabel.setText("Control in action: Scrollbar"); 

      final Scrollbar horizontalScroller = new Scrollbar(Scrollbar.HORIZONTAL);
      final Scrollbar verticalScroller = new Scrollbar();
      verticalScroller.setOrientation(Scrollbar.VERTICAL);
      horizontalScroller.setMaximum (100);
      horizontalScroller.setMinimum (1);
      verticalScroller.setMaximum (100);
      verticalScroller.setMinimum (1);

      horizontalScroller.addAdjustmentListener(new AdjustmentListener() {

         @Override
         public void adjustmentValueChanged(AdjustmentEvent e) {
            statusLabel.setText("Horozontal: "
               +horizontalScroller.getValue() 
               +" ,Vertical: "
               + verticalScroller.getValue());
            }
         });

      verticalScroller.addAdjustmentListener(new AdjustmentListener() {

            @Override
            public void adjustmentValueChanged(AdjustmentEvent e) {
               statusLabel.setText("Horozontal: "
               +horizontalScroller.getValue() 
               +" ,Vertical: "+ verticalScroller.getValue());
            }
         });

      controlPanel.add(horizontalScroller);
      controlPanel.add(verticalScroller);

      mainFrame.setVisible(true);  
   }
}

Compile o programa usando o prompt de comando. Vamos paraD:/ > AWT e digite o seguinte comando.

D:\AWT>javac com\tutorialspoint\gui\AwtControlDemo.java

Se nenhum erro ocorrer, significa que a compilação foi bem-sucedida. Execute o programa usando o seguinte comando.

D:\AWT>java com.tutorialspoint.gui.AwtControlDemo

Verifique a seguinte saída