java.awt

Класс ScrollPane

java.lang. Объект

java.awt. Компонент

java.awt. Контейнер

java.awt. ScrollPane

Все Реализованные Интерфейсы:

ImageObserver, MenuContainer, Сериализуемый, Доступный

public class ScrollPane
extends Container
implements Accessible

Контейнерный class, который реализует автоматическую горизонталь и/или вертикальную прокрутку для единственного дочернего компонента. Политика дисплея для полос прокрутки может быть установлена в:

1. как необходимый: полосы прокрутки, создаваемые и показанные только при необходимости областью прокрутки
2. всегда: создаваемые полосы прокрутки и всегда показываемый областью прокрутки
3. никогда: полосы прокрутки, никогда создаваемые или показанные областью прокрутки

Состояние горизонтали и вертикальных полос прокрутки представляется два ScrollPaneAdjustable объекты (один для каждой размерности), которые реализуют Adjustable интерфейс. API обеспечивает методы, чтобы получить доступ к тем объектам так, что, атрибутами на Корректируемом объекте (такими как unitIncrement, значение, и т.д.) можно управлять.

Определенные корректируемые свойства (минимум, максимум, blockIncrement, и visibleAmount) устанавливаются внутренне областью прокрутки в соответствии с геометрией области прокрутки и ее дочернего элемента, и они не должны быть установлены программами, используя область прокрутки.

Если политика дисплея полосы прокрутки не определяется как "никогда", то область прокрутки может все еще быть программно прокручена, используя setScrollPosition (), метод и область прокрутки переместят и отсекут содержание дочернего элемента соответственно. Эта политика полезна, если программа должна создать и управлять своими собственными корректируемыми средствами управления.

Размещением полос прокрутки управляют специфичные для платформы свойства, установленные пользователем за пределами программы.

Начальный размер этого контейнера устанавливается в 100x100, но может быть сброшен, используя setSize ().

Прокрутка с колесом на оборудованной колесом мыши включается по умолчанию. Это может быть отключено, используя setWheelScrollingEnabled. Колесо, прокручивающее, может быть настроено, устанавливая блок и инкремент модуля горизонтали и вертикального Adjustables. Для получения информации о том, как события колеса мыши диспетчеризируются, видят описание class для MouseWheelEvent.

Вставки используются, чтобы определить любое пространство, использованное полосами прокрутки и любые границы, создаваемые областью прокрутки. getInsets () может использоваться, чтобы получить текущую стоимость для вставок. Если значение scrollbarsAlwaysVisible будет ложью, то значение вставок изменится динамически в зависимости от того, в настоящий момент видимы ли полосы прокрутки или нет.

См. Также:

Сериализированная Форма

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Класс и Описание
protected class	ScrollPane. AccessibleAWTScrollPane Этот class реализует поддержку доступности ScrollPane class.

Вложенные классы/интерфейсы, наследованные от class java.awt. Контейнер

Контейнер. AccessibleAWTContainer

Вложенные классы/интерфейсы, наследованные от class java.awt. Компонент

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static int	SCROLLBARS_ALWAYS Определяет, что полосы прокрутки горизонтали/вертикали нужно всегда показывать независимо от соответствующих размеров области прокрутки и дочернего элемента.
static int	SCROLLBARS_AS_NEEDED Определяет, что полосу прокрутки горизонтали/вертикали нужно показать только, когда размер дочернего элемента превышает размер области прокрутки в горизонтали/измерении по вертикали.
static int	SCROLLBARS_NEVER Определяет, что полосы прокрутки горизонтали/вертикали никогда нельзя показывать независимо от соответствующих размеров области прокрутки и дочернего элемента.

Поля, наследованные от class java.awt. Компонент

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, наследованные от интерфейса java.awt.image. ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Сводка конструктора

Конструкторы

Конструктор и Описание
ScrollPane() Создайте новый контейнер области прокрутки с политикой дисплея полосы прокрутки "как необходимый".
ScrollPane(int scrollbarDisplayPolicy) Создайте новый контейнер области прокрутки.

Сводка метода

Модификатор и Тип	Метод и Описание
protected void	addImpl(Component comp, Object constraints, int index) Добавляет указанный компонент к этому контейнеру области прокрутки.
void	addNotify() Создает коллегу области прокрутки.
void	doLayout() Размечает этот контейнер, изменяя размеры его дочернего элемента к его привилегированному размеру.
protected boolean	eventTypeEnabled(int type) Если колесо, прокручивающее, включается, мы возвращаем true для MouseWheelEvents
AccessibleContext	getAccessibleContext() Связали AccessibleContext с этим ScrollPane.
Корректируемый	getHAdjustable() Возвраты ScrollPaneAdjustable объект, который представляет состояние горизонтальной полосы прокрутки.
int	getHScrollbarHeight() Возвращает height, который был бы занят горизонтальной полосой прокрутки, которая независима от того, выводится ли он в настоящий момент на экран областью прокрутки или нет.
int	getScrollbarDisplayPolicy() Возвращает политику дисплея для полос прокрутки.
Точка	getScrollPosition() Возвращает ток x, y позиция в пределах дочернего элемента, который выводится на экран в 0,0 расположениях порта представления прокрученной панели.
Корректируемый	getVAdjustable() Возвраты ScrollPaneAdjustable объект, который представляет состояние вертикальной полосы прокрутки.
Размерность	getViewportSize() Возвращает текущий размер порта представления области прокрутки.
int	getVScrollbarWidth() Возвращает width, который был бы занят вертикальной полосой прокрутки, которая независима от того, выводится ли он в настоящий момент на экран областью прокрутки или нет.
boolean	isWheelScrollingEnabled() Указывает, будет ли прокрутка иметь место в ответ на колесо мыши.
void	layout() Осуждаемый. С версии 1.1 JDK, замененной doLayout().
Строка	paramString() Возвращает строку, представляющую состояние этого ScrollPane.
void	printComponents(Graphics g) Печатает компонент в этой области прокрутки.
protected void	processMouseWheelEvent(MouseWheelEvent e) События колеса мыши процесса, которые поставляются этому ScrollPane прокручивая соответствующее количество.
void	setLayout(LayoutManager mgr) Устанавливает менеджера по расположению по этому контейнеру.
void	setScrollPosition(int x, int y) Прокрутки к указанной позиции в пределах дочернего компонента.
void	setScrollPosition(Point p) Прокрутки к указанной позиции в пределах дочернего компонента.
void	setWheelScrollingEnabled(boolean handleWheel) Позволяет/отключает прокрутить в ответ на перемещение колеса мыши.

Методы, наследованные от class java.awt. Контейнер

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, isValidateRoot, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, update, validate, validateTree

Методы, наследованные от class java.awt. Компонент

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Полевая Деталь

SCROLLBARS_AS_NEEDED

public static final int SCROLLBARS_AS_NEEDED

Определяет, что полосу прокрутки горизонтали/вертикали нужно показать только, когда размер дочернего элемента превышает размер области прокрутки в горизонтали/измерении по вертикали.

См. Также:

Постоянные Значения полей

SCROLLBARS_ALWAYS

public static final int SCROLLBARS_ALWAYS

Определяет, что полосы прокрутки горизонтали/вертикали нужно всегда показывать независимо от соответствующих размеров области прокрутки и дочернего элемента.

См. Также:

Постоянные Значения полей

SCROLLBARS_NEVER

public static final int SCROLLBARS_NEVER

Определяет, что полосы прокрутки горизонтали/вертикали никогда нельзя показывать независимо от соответствующих размеров области прокрутки и дочернего элемента.

См. Также:

Постоянные Значения полей

Деталь конструктора

ScrollPane

public ScrollPane()
           throws HeadlessException

Создайте новый контейнер области прокрутки с политикой дисплея полосы прокрутки "как необходимый".

Броски:

HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true

См. Также:

GraphicsEnvironment.isHeadless()

ScrollPane

@ConstructorProperties(value="scrollbarDisplayPolicy")
public ScrollPane(int scrollbarDisplayPolicy)
                                                                  throws HeadlessException

Создайте новый контейнер области прокрутки.

Параметры:

scrollbarDisplayPolicy - политика для того, когда полосы прокрутки нужно показать

Броски:

IllegalArgumentException - если указанная политика дисплея полосы прокрутки недопустима

HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true

См. Также:

GraphicsEnvironment.isHeadless()

Деталь метода

addImpl

protected final void addImpl(Component comp,
                             Object constraints,
                             int index)

Добавляет указанный компонент к этому контейнеру области прокрутки. Если у области прокрутки есть существующий дочерний компонент, тот компонент удаляется, и новый добавляется.

Переопределения:

addImpl в class Container

Параметры:

comp - компонент, который будет добавлен

constraints - не применимый

index - позиция дочернего компонента (должен быть <= 0)

См. Также:

Container.add(Component), Container.add(Component, int), Container.add(Component, java.lang.Object), Container.invalidate(), LayoutManager, LayoutManager2

getScrollbarDisplayPolicy

public int getScrollbarDisplayPolicy()

Возвращает политику дисплея для полос прокрутки.

Возвраты:

политика дисплея для полос прокрутки

getViewportSize

public Dimension getViewportSize()

Возвращает текущий размер порта представления области прокрутки.

Возвраты:

размер порта представления в пикселях

getHScrollbarHeight

public int getHScrollbarHeight()

Возвращает height, который был бы занят горизонтальной полосой прокрутки, которая независима от того, выводится ли он в настоящий момент на экран областью прокрутки или нет.

Возвраты:

height горизонтальной полосы прокрутки в пикселях

getVScrollbarWidth

public int getVScrollbarWidth()

Возвращает width, который был бы занят вертикальной полосой прокрутки, которая независима от того, выводится ли он в настоящий момент на экран областью прокрутки или нет.

Возвраты:

width вертикальной полосы прокрутки в пикселях

getVAdjustable

public Adjustable getVAdjustable()

Возвраты ScrollPaneAdjustable объект, который представляет состояние вертикальной полосы прокрутки. Объявленный тип возврата этого метода Adjustable поддержать обратную совместимость.

См. Также:

ScrollPaneAdjustable

getHAdjustable

public Adjustable getHAdjustable()

Возвраты ScrollPaneAdjustable объект, который представляет состояние горизонтальной полосы прокрутки. Объявленный тип возврата этого метода Adjustable поддержать обратную совместимость.

См. Также:

ScrollPaneAdjustable

setScrollPosition

public void setScrollPosition(int x,
                              int y)

Прокрутки к указанной позиции в пределах дочернего компонента. Звонок в этот метод только допустим, если область прокрутки содержит дочерний элемент. Определение позиции за пределами юридических границ прокрутки дочернего элемента прокрутит к самому близкому юридическому статусу. Юридические границы определяются, чтобы быть прямоугольником: x = 0, y = 0, width = (дочерний width - просматривают порт width), height = (дочерний height - порт представления height). Это - метод удобства, который взаимодействует через интерфейс с Корректируемыми объектами, которые представляют состояние полос прокрутки.

Параметры:

x - x позиция, чтобы прокрутить к

y - y позиция, чтобы прокрутить к

Броски:

NullPointerException - если область прокрутки не содержит дочерний элемент

setScrollPosition

public void setScrollPosition(Point p)

Прокрутки к указанной позиции в пределах дочернего компонента. Звонок в этот метод только допустим, если область прокрутки содержит дочерний элемент, и указанная позиция в пределах юридических границ прокрутки дочернего элемента. Определение позиции за пределами юридических границ прокрутки дочернего элемента прокрутит к самому близкому юридическому статусу. Юридические границы определяются, чтобы быть прямоугольником: x = 0, y = 0, width = (дочерний width - просматривают порт width), height = (дочерний height - порт представления height). Это - метод удобства, который взаимодействует через интерфейс с Корректируемыми объектами, которые представляют состояние полос прокрутки.

Параметры:

p - Точка, представляющая позицию, чтобы прокрутить к

Броски:

NullPointerException - если p null

getScrollPosition

public Point getScrollPosition()

Возвращает ток x, y позиция в пределах дочернего элемента, который выводится на экран в 0,0 расположениях порта представления прокрученной панели. Это - метод удобства, который взаимодействует через интерфейс с корректируемыми объектами, которые представляют состояние полос прокрутки.

Возвраты:

координатная позиция для текущей позиции прокрутки

Броски:

NullPointerException - если область прокрутки не содержит дочерний элемент

setLayout

public final void setLayout(LayoutManager mgr)

Устанавливает менеджера по расположению по этому контейнеру. Этот метод переопределяется, чтобы препятствовать тому, чтобы расположение магистр было установлено.

Переопределения:

setLayout в class Container

Параметры:

mgr - указанный менеджер по расположению

См. Также:

Container.doLayout(), Container.getLayout(), Container.invalidate()

doLayout

public void doLayout()

Размечает этот контейнер, изменяя размеры его дочернего элемента к его привилегированному размеру. Если новый привилегированный размер дочернего элемента заставляет текущую позицию прокрутки быть недопустимой, позиция прокрутки устанавливается в самую близкую допустимую позицию.

Переопределения:

doLayout в class Container

См. Также:

Component.validate()

расположение

@Deprecated
public void layout()

Осуждаемый. С версии 1.1 JDK, замененной doLayout().

Переопределения:

layout в class Container

printComponents

public void printComponents(Graphics g)

Печатает компонент в этой области прокрутки.

Переопределения:

printComponents в class Container

Параметры:

g - указанное Графическое окно

См. Также:

Component.print(java.awt.Graphics), Component.printAll(java.awt.Graphics)

addNotify

public void addNotify()

Создает коллегу области прокрутки.

Переопределения:

addNotify в class Container

См. Также:

Component.isDisplayable(), Container.removeNotify()

paramString

public String paramString()

Возвращает строку, представляющую состояние этого ScrollPane. Этот метод предназначается, чтобы использоваться только для того, чтобы отладить цели, и контент и формат возвращенной строки могут измениться между реализациями. Возвращенная строка может быть пустой, но, возможно, не null.

Переопределения:

paramString в class Container

Возвраты:

строка параметра этой области прокрутки

processMouseWheelEvent

protected void processMouseWheelEvent(MouseWheelEvent e)

События колеса мыши процесса, которые поставляются этому ScrollPane прокручивая соответствующее количество.

Отметьте это, если параметр события null поведение является неуказанным и может привести к исключению.

Переопределения:

processMouseWheelEvent в class Component

Параметры:

e - событие колеса мыши

С тех пор:

1.4

См. Также:

MouseWheelEvent, MouseWheelListener, Component.addMouseWheelListener(java.awt.event.MouseWheelListener), Component.enableEvents(long)

eventTypeEnabled

protected boolean eventTypeEnabled(int type)

Если колесо, прокручивающее, включается, мы возвращаем true для MouseWheelEvents

С тех пор:

1.4

setWheelScrollingEnabled

public void setWheelScrollingEnabled(boolean handleWheel)

Позволяет/отключает прокрутить в ответ на перемещение колеса мыши. Колесо, прокручивающее, включается по умолчанию.

Параметры:

handleWheel - true если прокрутка должна быть сделана автоматически для MouseWheelEvent, false иначе.

С тех пор:

1.4

См. Также:

isWheelScrollingEnabled(), MouseWheelEvent, MouseWheelListener

isWheelScrollingEnabled

public boolean isWheelScrollingEnabled()

Указывает, будет ли прокрутка иметь место в ответ на колесо мыши. Колесо, прокручивающее, включается по умолчанию.

С тех пор:

1.4

См. Также:

setWheelScrollingEnabled(boolean)

getAccessibleContext

public AccessibleContext getAccessibleContext()

Связали AccessibleContext с этим ScrollPane. Для областей прокрутки AccessibleContext принимает форму AccessibleAWTScrollPane. Новый экземпляр AccessibleAWTScrollPane создается в случае необходимости.

Определенный:

getAccessibleContext в интерфейсе Accessible

Переопределения:

getAccessibleContext в class Component

Возвраты:

AccessibleAWTScrollPane, который служит AccessibleContext этого ScrollPane

С тех пор:

1.3