Класс Scrollbar

java.lang.Object

java.awt.Component

java.awt.Scrollbar

Все реализуемые интерфейсы:: Adjustable, ImageObserver, MenuContainer, Serializable, Accessible

public class Scrollbar extends Component implements Adjustable, Accessible

Класс Scrollbar представляет собой полосу прокрутки — знакомый элемент пользовательского интерфейса. Полоса прокрутки позволяет пользователю удобно выбирать значение из диапазона. Следующие три вертикальные полосы прокрутки можно использовать как ползунки для выбора красной, зелёной и синей составляющих цвета:

Image shows 3 vertical sliders,
side-by-side.

Каждую полосу прокрутки в этом примере можно создать с помощью кода, подобного следующему:

redSlider=new Scrollbar(Scrollbar.VERTICAL, 0, 1, 0, 255);
add(redSlider);

Кроме того, полоса прокрутки может представлять диапазон значений. Например, если полоса прокрутки используется для прокрутки текста, ширина «пузырька» (также называемого «ползунком» или «бегунком») может отражать количество видимого текста. Вот пример полосы прокрутки, представляющей диапазон:

Image shows horizontal slider with starting range of 0 and ending range
of 300. The slider thumb is labeled 60.

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

ranger = new Scrollbar(Scrollbar.HORIZONTAL, 0, 60, 0, 300);
add(ranger);

Обратите внимание, что фактическое максимальное значение полосы прокрутки равно maximum минус visible amount. В предыдущем примере, поскольку maximum равно 300, а visible amount равно 60, фактическое максимальное значение равно 240. Диапазон дорожки полосы прокрутки — от 0 до 300. Левый край пузырька указывает значение полосы прокрутки.

Обычно пользователь изменяет значение полосы прокрутки с помощью мыши. Например, пользователь может перетаскивать пузырёк полосы прокрутки вверх и вниз или щёлкать в областях шага единичного или блочного приращения. С полосой прокрутки также могут быть связаны действия с клавиатуры. По соглашению клавиши Page Up и Page Down эквивалентны щелчкам в областях блочного приращения и блочного уменьшения полосы прокрутки.

Когда пользователь изменяет значение полосы прокрутки, она получает экземпляр AdjustmentEvent. Полоса прокрутки обрабатывает это событие и передаёт его всем зарегистрированным слушателям.

Любой объект, которому необходимо получать уведомления об изменениях значения полосы прокрутки, должен реализовать AdjustmentListener — интерфейс, определённый в пакете java.awt.event. Слушателей можно динамически добавлять и удалять с помощью методов addAdjustmentListener и removeAdjustmentListener.

Класс AdjustmentEvent определяет пять типов события изменения значения, перечисленных ниже:

AdjustmentEvent.TRACK отправляется, когда пользователь перетаскивает пузырёк полосы прокрутки.
AdjustmentEvent.UNIT_INCREMENT отправляется, когда пользователь щёлкает стрелку влево горизонтальной полосы прокрутки или верхнюю стрелку вертикальной полосы прокрутки либо выполняет эквивалентное действие с клавиатуры.
AdjustmentEvent.UNIT_DECREMENT отправляется, когда пользователь щёлкает стрелку вправо горизонтальной полосы прокрутки или нижнюю стрелку вертикальной полосы прокрутки либо выполняет эквивалентное действие с клавиатуры.
AdjustmentEvent.BLOCK_INCREMENT отправляется, когда пользователь щёлкает дорожку слева от пузырька горизонтальной полосы прокрутки или выше пузырька вертикальной полосы прокрутки. По соглашению клавиша Page Up эквивалентна этому действию, если на клавиатуре пользователя есть клавиша Page Up.
AdjustmentEvent.BLOCK_DECREMENT отправляется, когда пользователь щёлкает дорожку справа от пузырька горизонтальной полосы прокрутки или ниже пузырька вертикальной полосы прокрутки. По соглашению клавиша Page Down эквивалентна этому действию, если на клавиатуре пользователя есть клавиша Page Down.

Система событий JDK 1.0 поддерживается для обратной совместимости, однако её использование с более новыми версиями платформы не рекомендуется. Пять типов событий изменения значения, появившиеся в JDK 1.1, соответствуют пяти типам событий, связанным с полосами прокрутки в предыдущих версиях платформы. В следующем списке указаны типы событий изменения значения и соответствующие им типы событий JDK 1.0, которые они заменяют.

AdjustmentEvent.TRACK заменяет Event.SCROLL_ABSOLUTE
AdjustmentEvent.UNIT_INCREMENT заменяет Event.SCROLL_LINE_UP
AdjustmentEvent.UNIT_DECREMENT заменяет Event.SCROLL_LINE_DOWN
AdjustmentEvent.BLOCK_INCREMENT заменяет Event.SCROLL_PAGE_UP
AdjustmentEvent.BLOCK_DECREMENT заменяет Event.SCROLL_PAGE_DOWN

Примечание: рекомендуем использовать Scrollbar только для выбора значения. Если вы хотите реализовать прокручиваемый компонент внутри контейнера, рекомендуем использовать ScrollPane. Если для этой цели использовать Scrollbar, могут возникнуть проблемы с отрисовкой, обработкой клавиш, размерами и позиционированием.

С версии:

1.0

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`Scrollbar.AccessibleAWTScrollBar`	Этот класс реализует поддержку специальных возможностей для класса `Scrollbar`.

Вложенные классы и интерфейсы, объявленные в классе Component

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

Модификатор и тип	Класс	Описание
`protected class`	`Component.AccessibleAWTComponent`	Внутренний класс Component, используемый для реализации поддержки специальных возможностей по умолчанию.
`static enum`	`Component.BaselineResizeBehavior`	Перечисление распространённых способов изменения базовой линии компонента при изменении его размера.
`protected class`	`Component.BltBufferStrategy`	Внутренний класс для копирования внеэкранных поверхностей на компонент.
`protected class`	`Component.FlipBufferStrategy`	Внутренний класс для переключения буферов компонента.

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`HORIZONTAL`	Константа, указывающая на горизонтальную полосу прокрутки.
`static final int`	`VERTICAL`	Константа, указывающая на вертикальную полосу прокрутки.

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Модификатор и тип	Поле	Описание
`protected AccessibleContext`	`accessibleContext`	`AccessibleContext`, связанный с этим `Component`.
`static final float`	`BOTTOM_ALIGNMENT`	Удобная константа для `getAlignmentY`.
`static final float`	`CENTER_ALIGNMENT`	Удобная константа для `getAlignmentY` и `getAlignmentX`.
`static final float`	`LEFT_ALIGNMENT`	Удобная константа для `getAlignmentX`.
`static final float`	`RIGHT_ALIGNMENT`	Удобная константа для `getAlignmentX`.
`static final float`	`TOP_ALIGNMENT`	Удобная константа для `getAlignmentY()`.

Поля, объявленные в интерфейсе Adjustable

NO_ORIENTATION

Модификатор и тип	Поле	Описание
`static final int`	`NO_ORIENTATION`	Указывает, что у `Adjustable` нет ориентации.

Поля, объявленные в интерфейсе ImageObserver

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

Модификатор и тип	Поле	Описание
`static final int`	`ABORT`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что асинхронно отслеживаемое изображение было отменено до завершения его формирования.
`static final int`	`ALLBITS`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что ранее нарисованное статическое изображение теперь полностью сформировано и может быть нарисовано повторно в окончательном виде.
`static final int`	`ERROR`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что в асинхронно отслеживаемом изображении произошла ошибка.
`static final int`	`FRAMEBITS`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что теперь доступен для повторной отрисовки ещё один полностью сформированный кадр ранее нарисованного многокадрового изображения.
`static final int`	`HEIGHT`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что высота исходного изображения теперь доступна и может быть получена из аргумента height метода обратного вызова imageUpdate.
`static final int`	`PROPERTIES`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что свойства изображения теперь доступны.
`static final int`	`SOMEBITS`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что стали доступны дополнительные пиксели, необходимые для отрисовки масштабированной версии изображения.
`static final int`	`WIDTH`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что ширина исходного изображения теперь доступна и может быть получена из аргумента width метода обратного вызова imageUpdate.

Краткое описание конструкторов

Конструктор	Описание
`Scrollbar()`	Создаёт новую вертикальную полосу прокрутки.
`Scrollbar(int orientation)`	Создаёт новую полосу прокрутки с указанной ориентацией.
`Scrollbar(int orientation, int value, int visible, int minimum, int maximum)`	Создаёт новую полосу прокрутки с указанной ориентацией, начальным значением, видимой областью, а также минимальным и максимальным значениями.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addAdjustmentListener(AdjustmentListener l)`	Добавляет указанный слушатель изменения значения, чтобы он получал экземпляры `AdjustmentEvent` от этой полосы прокрутки.
`void`	`addNotify()`	Создаёт системный ресурс `Scrollbar`.
`AccessibleContext`	`getAccessibleContext()`	Получает `AccessibleContext`, связанный с этим `Scrollbar`.
`AdjustmentListener[]`	`getAdjustmentListeners()`	Возвращает массив всех слушателей изменения значения, зарегистрированных для этой полосы прокрутки.
`int`	`getBlockIncrement()`	Получает шаг блочного приращения этой полосы прокрутки.
`int`	`getLineIncrement()`	Устарело. Начиная с JDK версии 1.1 заменено на `getUnitIncrement()`.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, зарегистрированных в данный момент как `FooListener` для этого `Scrollbar`.
`int`	`getMaximum()`	Получает максимальное значение этой полосы прокрутки.
`int`	`getMinimum()`	Получает минимальное значение этой полосы прокрутки.
`int`	`getOrientation()`	Возвращает ориентацию этой полосы прокрутки.
`int`	`getPageIncrement()`	Устарело. Начиная с JDK версии 1.1 заменено на `getBlockIncrement()`.
`int`	`getUnitIncrement()`	Получает шаг единичного приращения этой полосы прокрутки.
`int`	`getValue()`	Получает текущее значение этой полосы прокрутки.
`boolean`	`getValueIsAdjusting()`	Возвращает true, если значение изменяется в результате действий пользователя.
`int`	`getVisible()`	Устарело. Начиная с JDK версии 1.1 заменено на `getVisibleAmount()`.
`int`	`getVisibleAmount()`	Получает видимую область этой полосы прокрутки.
`protected String`	`paramString()`	Возвращает строку, представляющую состояние этого `Scrollbar`.
`protected void`	`processAdjustmentEvent(AdjustmentEvent e)`	Обрабатывает события изменения значения, возникающие в этой полосе прокрутки, передавая их всем зарегистрированным объектам `AdjustmentListener`.
`protected void`	`processEvent(AWTEvent e)`	Обрабатывает события этой полосы прокрутки.
`void`	`removeAdjustmentListener(AdjustmentListener l)`	Удаляет указанный слушатель изменения значения, чтобы он больше не получал экземпляры `AdjustmentEvent` от этой полосы прокрутки.
`void`	`setBlockIncrement(int v)`	Задаёт шаг блочного приращения этой полосы прокрутки.
`void`	`setLineIncrement(int v)`	Устарело. Начиная с JDK версии 1.1 заменено на `setUnitIncrement(int)`.
`void`	`setMaximum(int newMaximum)`	Задаёт максимальное значение этой полосы прокрутки.
`void`	`setMinimum(int newMinimum)`	Задаёт минимальное значение этой полосы прокрутки.
`void`	`setOrientation(int orientation)`	Задаёт ориентацию этой полосы прокрутки.
`void`	`setPageIncrement(int v)`	Устарело. Начиная с JDK версии 1.1 заменено на `setBlockIncrement()`.
`void`	`setUnitIncrement(int v)`	Задаёт шаг единичного приращения этой полосы прокрутки.
`void`	`setValue(int newValue)`	Задаёт указанное значение для этой полосы прокрутки.
`void`	`setValueIsAdjusting(boolean b)`	Задаёт свойство `valueIsAdjusting`.
`void`	`setValues(int value, int visible, int minimum, int maximum)`	Задаёт значения четырёх свойств этой полосы прокрутки: `value`, `visibleAmount`, `minimum` и `maximum`.
`void`	`setVisibleAmount(int newAmount)`	Задаёт видимую область этой полосы прокрутки.

Методы, объявленные в классе Component

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

Модификатор и тип	Метод	Описание
`boolean`	`action(Event evt, Object what)`	Устарел. Начиная с JDK версии 1.1, следует зарегистрировать этот компонент в качестве ActionListener для компонента, который генерирует события действия.
`void`	`add(PopupMenu popup)`	Добавляет указанное всплывающее меню к компоненту.
`void`	`addComponentListener(ComponentListener l)`	Добавляет указанный слушатель компонента для получения событий компонента от этого компонента.
`void`	`addFocusListener(FocusListener l)`	Добавляет указанный слушатель фокуса для получения событий фокуса от этого компонента при получении им фокуса ввода.
`void`	`addHierarchyBoundsListener(HierarchyBoundsListener l)`	Добавляет указанный слушатель границ иерархии для получения событий границ иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
`void`	`addHierarchyListener(HierarchyListener l)`	Добавляет указанный слушатель иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
`void`	`addInputMethodListener(InputMethodListener l)`	Добавляет указанный слушатель методов ввода для получения событий методов ввода от этого компонента.
`void`	`addKeyListener(KeyListener l)`	Добавляет указанный слушатель клавиатуры для получения событий клавиатуры от этого компонента.
`void`	`addMouseListener(MouseListener l)`	Добавляет указанный слушатель мыши для получения событий мыши от этого компонента.
`void`	`addMouseMotionListener(MouseMotionListener l)`	Добавляет указанный слушатель движения мыши для получения событий движения мыши от этого компонента.
`void`	`addMouseWheelListener(MouseWheelListener l)`	Добавляет указанный слушатель колеса мыши для получения событий колеса мыши от этого компонента.
`void`	`addPropertyChangeListener(PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список слушателей.
`void`	`addPropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список слушателей для определённого свойства.
`void`	`applyComponentOrientation(ComponentOrientation orientation)`	Устанавливает свойство `ComponentOrientation` этого компонента и всех содержащихся в нём компонентов.
`boolean`	`areFocusTraversalKeysSet(int id)`	Возвращает, было ли явно задано для этого Component множество клавиш перехода фокуса для указанной операции перехода фокуса.
`Rectangle`	`bounds()`	Устарел. Начиная с JDK версии 1.1, заменён на `getBounds()`.
`int`	`checkImage(Image image, int width, int height, ImageObserver observer)`	Возвращает состояние создания экранного представления указанного изображения.
`int`	`checkImage(Image image, ImageObserver observer)`	Возвращает состояние создания экранного представления указанного изображения.
`protected AWTEvent`	`coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)`	При возможности объединяет публикуемое событие с уже существующим событием.
`boolean`	`contains(int x, int y)`	Проверяет, «содержит» ли этот компонент указанную точку, где `x` и `y` определены относительно системы координат этого компонента.
`boolean`	`contains(Point p)`	Проверяет, «содержит» ли этот компонент указанную точку, координаты x и y которой определены относительно системы координат этого компонента.
`Image`	`createImage(int width, int height)`	Создаёт рисуемое изображение вне экрана для двойной буферизации.
`Image`	`createImage(ImageProducer producer)`	Создаёт изображение из указанного производителя изображений.
`VolatileImage`	`createVolatileImage(int width, int height)`	Создаёт изменяемое рисуемое изображение вне экрана для двойной буферизации.
`VolatileImage`	`createVolatileImage(int width, int height, ImageCapabilities caps)`	Создаёт изменяемое рисуемое изображение вне экрана с указанными возможностями.
`void`	`deliverEvent(Event e)`	Устарел. Начиная с JDK версии 1.1, заменён на `dispatchEvent(AWTEvent e)`.
`void`	`disable()`	Устарел. Начиная с JDK версии 1.1, заменён на `setEnabled(boolean)`.
`protected final void`	`disableEvents(long eventsToDisable)`	Запрещает доставку этому компоненту событий, определённых параметром маски событий.
`final void`	`dispatchEvent(AWTEvent e)`	Передаёт событие этому компоненту или одному из его подкомпонентов.
`void`	`doLayout()`	Предлагает менеджеру компоновки выполнить компоновку этого компонента.
`void`	`enable()`	Устарел. Начиная с JDK версии 1.1, заменён на `setEnabled(boolean)`.
`void`	`enable(boolean b)`	Устарел. Начиная с JDK версии 1.1, заменён на `setEnabled(boolean)`.
`protected final void`	`enableEvents(long eventsToEnable)`	Разрешает доставку этому компоненту событий, определённых параметром маски событий.
`void`	`enableInputMethods(boolean enable)`	Включает или отключает поддержку методов ввода для этого компонента.
`protected void`	`firePropertyChange(String propertyName, boolean oldValue, boolean newValue)`	Поддержка оповещения об изменениях связанных свойств типа boolean.
`void`	`firePropertyChange(String propertyName, byte oldValue, byte newValue)`	Оповещает об изменении связанного свойства.
`void`	`firePropertyChange(String propertyName, char oldValue, char newValue)`	Оповещает об изменении связанного свойства.
`void`	`firePropertyChange(String propertyName, double oldValue, double newValue)`	Оповещает об изменении связанного свойства.
`void`	`firePropertyChange(String propertyName, float oldValue, float newValue)`	Оповещает об изменении связанного свойства.
`protected void`	`firePropertyChange(String propertyName, int oldValue, int newValue)`	Поддержка оповещения об изменениях связанных свойств типа integer.
`void`	`firePropertyChange(String propertyName, long oldValue, long newValue)`	Оповещает об изменении связанного свойства.
`void`	`firePropertyChange(String propertyName, short oldValue, short newValue)`	Оповещает об изменении связанного свойства.
`protected void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)`	Поддержка оповещения об изменениях связанных свойств типа Object.
`float`	`getAlignmentX()`	Возвращает выравнивание вдоль оси x.
`float`	`getAlignmentY()`	Возвращает выравнивание вдоль оси y.
`Color`	`getBackground()`	Получает цвет фона этого компонента.
`int`	`getBaseline(int width, int height)`	Возвращает базовую линию.
`Component.BaselineResizeBehavior`	`getBaselineResizeBehavior()`	Возвращает перечисление, указывающее, как изменяется базовая линия компонента при изменении его размера.
`Rectangle`	`getBounds()`	Получает границы этого компонента в виде объекта `Rectangle`.
`Rectangle`	`getBounds(Rectangle rv)`	Сохраняет границы этого компонента в «возвращаемое значение» rv и возвращает rv.
`ColorModel`	`getColorModel()`	Получает экземпляр `ColorModel`, используемый для отображения компонента на устройстве вывода.
`Component`	`getComponentAt(int x, int y)`	Определяет, содержит ли этот компонент или один из его непосредственных подкомпонентов точку (x, y), и, если да, возвращает содержащий её компонент.
`Component`	`getComponentAt(Point p)`	Возвращает компонент или подкомпонент, содержащий указанную точку.
`ComponentListener[]`	`getComponentListeners()`	Возвращает массив всех слушателей компонента, зарегистрированных для этого компонента.
`ComponentOrientation`	`getComponentOrientation()`	Получает языковую ориентацию, используемую для упорядочения элементов или текста в этом компоненте.
`Cursor`	`getCursor()`	Получает курсор, установленный для компонента.
`DropTarget`	`getDropTarget()`	Получает `DropTarget`, связанный с этим `Component`.
`Container`	`getFocusCycleRootAncestor()`	Возвращает Container, являющийся корнем цикла перехода фокуса для этого Component.
`FocusListener[]`	`getFocusListeners()`	Возвращает массив всех слушателей фокуса, зарегистрированных для этого компонента.
`Set<AWTKeyStroke>`	`getFocusTraversalKeys(int id)`	Возвращает множество клавиш перехода фокуса для указанной операции перехода этого Component.
`boolean`	`getFocusTraversalKeysEnabled()`	Возвращает, включены ли клавиши перехода фокуса для этого Component.
`Font`	`getFont()`	Получает шрифт этого компонента.
`FontMetrics`	`getFontMetrics(Font font)`	Получает метрики указанного шрифта.
`Color`	`getForeground()`	Получает цвет переднего плана этого компонента.
`Graphics`	`getGraphics()`	Создаёт графический контекст для этого компонента.
`GraphicsConfiguration`	`getGraphicsConfiguration()`	Получает `GraphicsConfiguration`, связанный с этим `Component`.
`int`	`getHeight()`	Возвращает текущую высоту этого компонента.
`HierarchyBoundsListener[]`	`getHierarchyBoundsListeners()`	Возвращает массив всех слушателей границ иерархии, зарегистрированных для этого компонента.
`HierarchyListener[]`	`getHierarchyListeners()`	Возвращает массив всех слушателей иерархии, зарегистрированных для этого компонента.
`boolean`	`getIgnoreRepaint()`	Возвращает, следует ли игнорировать сообщения о рисовании, полученные от операционной системы.
`InputContext`	`getInputContext()`	Получает контекст ввода, используемый этим компонентом для обработки взаимодействия с методами ввода при вводе текста в компонент.
`InputMethodListener[]`	`getInputMethodListeners()`	Возвращает массив всех слушателей методов ввода, зарегистрированных для этого компонента.
`InputMethodRequests`	`getInputMethodRequests()`	Получает обработчик запросов методов ввода, поддерживающий запросы методов ввода для этого компонента.
`KeyListener[]`	`getKeyListeners()`	Возвращает массив всех слушателей клавиатуры, зарегистрированных для этого компонента.
`Locale`	`getLocale()`	Получает локаль этого компонента.
`Point`	`getLocation()`	Получает местоположение этого компонента в виде точки, задающей его верхний левый угол.
`Point`	`getLocation(Point rv)`	Сохраняет координаты начала координат x,y этого компонента в «возвращаемое значение» rv и возвращает rv.
`Point`	`getLocationOnScreen()`	Получает местоположение этого компонента в экранной системе координат в виде точки, задающей его верхний левый угол.
`Dimension`	`getMaximumSize()`	Получает максимальный размер этого компонента.
`Dimension`	`getMinimumSize()`	Получает минимальный размер этого компонента.
`MouseListener[]`	`getMouseListeners()`	Возвращает массив всех слушателей мыши, зарегистрированных для этого компонента.
`MouseMotionListener[]`	`getMouseMotionListeners()`	Возвращает массив всех слушателей движения мыши, зарегистрированных для этого компонента.
`Point`	`getMousePosition()`	Возвращает положение указателя мыши в системе координат этого `Component`, если `Component` находится непосредственно под указателем мыши; в противном случае возвращает `null`.
`MouseWheelListener[]`	`getMouseWheelListeners()`	Возвращает массив всех слушателей колеса мыши, зарегистрированных для этого компонента.
`String`	`getName()`	Получает имя компонента.
`Container`	`getParent()`	Получает родительский компонент этого компонента.
`Dimension`	`getPreferredSize()`	Получает предпочтительный размер этого компонента.
`PropertyChangeListener[]`	`getPropertyChangeListeners()`	Возвращает массив всех слушателей изменения свойств, зарегистрированных для этого компонента.
`PropertyChangeListener[]`	`getPropertyChangeListeners(String propertyName)`	Возвращает массив всех слушателей, связанных с именованным свойством.
`Dimension`	`getSize()`	Возвращает размер этого компонента в виде объекта `Dimension`.
`Dimension`	`getSize(Dimension rv)`	Сохраняет ширину и высоту этого компонента в «возвращаемое значение» rv и возвращает rv.
`Toolkit`	`getToolkit()`	Получает инструментарий этого компонента.
`final Object`	`getTreeLock()`	Получает объект блокировки этого компонента (объект, которому принадлежит монитор синхронизации потоков) для операций с деревом компонентов AWT и компоновкой.
`int`	`getWidth()`	Возвращает текущую ширину этого компонента.
`int`	`getX()`	Возвращает текущую координату x начала координат компонента.
`int`	`getY()`	Возвращает текущую координату y начала координат компонента.
`boolean`	`gotFocus(Event evt, Object what)`	Устарел. Начиная с JDK версии 1.1, заменён на processFocusEvent(FocusEvent).
`boolean`	`handleEvent(Event evt)`	Устарел. Начиная с JDK версии 1.1, заменён на processEvent(AWTEvent).
`boolean`	`hasFocus()`	Возвращает `true`, если этот `Component` является владельцем фокуса.
`void`	`hide()`	Устарел. Начиная с JDK версии 1.1, заменён на `setVisible(boolean)`.
`boolean`	`imageUpdate(Image img, int infoflags, int x, int y, int w, int h)`	Перерисовывает компонент при изменении изображения.
`boolean`	`inside(int x, int y)`	Устарел. Начиная с JDK версии 1.1, заменён на contains(int, int).
`void`	`invalidate()`	Делает этот компонент и его предков недействительными.
`boolean`	`isBackgroundSet()`	Возвращает, был ли явно задан цвет фона для этого Component.
`boolean`	`isCursorSet()`	Возвращает, был ли явно задан курсор для этого Component.
`boolean`	`isDisplayable()`	Определяет, может ли этот компонент отображаться.
`boolean`	`isDoubleBuffered()`	Возвращает true, если этот компонент рисуется во внеэкранное изображение («буфер»), которое затем копируется на экран.
`boolean`	`isEnabled()`	Определяет, включён ли этот компонент.
`boolean`	`isFocusable()`	Возвращает, может ли этот Component получать фокус.
`boolean`	`isFocusCycleRoot(Container container)`	Возвращает, является ли указанный Container корнем цикла перехода фокуса для этого Component.
`boolean`	`isFocusOwner()`	Возвращает `true`, если этот `Component` является владельцем фокуса.
`boolean`	`isFocusTraversable()`	Устарел. Начиная с версии 1.4, заменён на `isFocusable()`.
`boolean`	`isFontSet()`	Возвращает, был ли явно задан шрифт для этого Component.
`boolean`	`isForegroundSet()`	Возвращает, был ли явно задан цвет переднего плана для этого Component.
`boolean`	`isLightweight()`	Лёгкий компонент не имеет собственного системного узла инструментального средства.
`boolean`	`isMaximumSizeSet()`	Возвращает true, если максимальный размер задан ненулевым значением `null`; в противном случае возвращает false.
`boolean`	`isMinimumSizeSet()`	Возвращает, был ли вызван `setMinimumSize` с ненулевым значением.
`boolean`	`isOpaque()`	Возвращает true, если этот компонент полностью непрозрачен; по умолчанию возвращает false.
`boolean`	`isPreferredSizeSet()`	Возвращает true, если предпочтительный размер задан ненулевым значением `null`; в противном случае возвращает false.
`boolean`	`isShowing()`	Определяет, отображается ли этот компонент на экране.
`boolean`	`isValid()`	Определяет, является ли этот компонент действительным.
`boolean`	`isVisible()`	Определяет, должен ли этот компонент быть видимым, когда виден его родитель.
`boolean`	`keyDown(Event evt, int key)`	Устарел. Начиная с JDK версии 1.1, заменён на processKeyEvent(KeyEvent).
`boolean`	`keyUp(Event evt, int key)`	Устарел. Начиная с JDK версии 1.1, заменён на processKeyEvent(KeyEvent).
`void`	`layout()`	Устарел. Начиная с JDK версии 1.1, заменён на `doLayout()`.
`void`	`list()`	Выводит сведения об этом компоненте в стандартный системный поток вывода `System.out`.
`void`	`list(PrintStream out)`	Выводит сведения об этом компоненте в указанный поток вывода.
`void`	`list(PrintStream out, int indent)`	Выводит список в указанный поток печати, начиная с заданного отступа.
`void`	`list(PrintWriter out)`	Выводит сведения в указанный объект записи для печати.
`void`	`list(PrintWriter out, int indent)`	Выводит список в указанный объект записи для печати, начиная с заданного отступа.
`Component`	`locate(int x, int y)`	Устарел. Начиная с JDK версии 1.1, заменён на getComponentAt(int, int).
`Point`	`location()`	Устарел. Начиная с JDK версии 1.1, заменён на `getLocation()`.
`boolean`	`lostFocus(Event evt, Object what)`	Устарел. Начиная с JDK версии 1.1, заменён на processFocusEvent(FocusEvent).
`Dimension`	`minimumSize()`	Устарел. Начиная с JDK версии 1.1, заменён на `getMinimumSize()`.
`boolean`	`mouseDown(Event evt, int x, int y)`	Устарел. Начиная с JDK версии 1.1, заменён на processMouseEvent(MouseEvent).
`boolean`	`mouseDrag(Event evt, int x, int y)`	Устарел. Начиная с JDK версии 1.1, заменён на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseEnter(Event evt, int x, int y)`	Устарел. Начиная с JDK версии 1.1, заменён на processMouseEvent(MouseEvent).
`boolean`	`mouseExit(Event evt, int x, int y)`	Устарел. Начиная с JDK версии 1.1, заменён на processMouseEvent(MouseEvent).
`boolean`	`mouseMove(Event evt, int x, int y)`	Устарел. Начиная с JDK версии 1.1, заменён на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseUp(Event evt, int x, int y)`	Устарел. Начиная с JDK версии 1.1, заменён на processMouseEvent(MouseEvent).
`void`	`move(int x, int y)`	Устарел. Начиная с JDK версии 1.1, заменён на `setLocation(int, int)`.
`void`	`nextFocus()`	Устарел. Начиная с JDK версии 1.1, заменён на transferFocus().
`void`	`paint(Graphics g)`	Рисует этот компонент.
`void`	`paintAll(Graphics g)`	Рисует этот компонент и все его подкомпоненты.
`boolean`	`postEvent(Event e)`	Устарел. Начиная с JDK версии 1.1, заменён на dispatchEvent(AWTEvent).
`Dimension`	`preferredSize()`	Устарел. Начиная с JDK версии 1.1, заменён на `getPreferredSize()`.
`boolean`	`prepareImage(Image image, int width, int height, ImageObserver observer)`	Подготавливает изображение к отображению в этом компоненте с указанными шириной и высотой.
`boolean`	`prepareImage(Image image, ImageObserver observer)`	Подготавливает изображение к отображению в этом компоненте.
`void`	`print(Graphics g)`	Печатает этот компонент.
`void`	`printAll(Graphics g)`	Печатает этот компонент и все его подкомпоненты.

`protected void`	`processComponentEvent(ComponentEvent e)`	Обрабатывает события компонента, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `ComponentListener`.
`protected void`	`processFocusEvent(FocusEvent e)`	Обрабатывает события фокуса, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `FocusListener`.
`protected void`	`processHierarchyBoundsEvent(HierarchyEvent e)`	Обрабатывает события границ иерархии, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `HierarchyBoundsListener`.
`protected void`	`processHierarchyEvent(HierarchyEvent e)`	Обрабатывает события иерархии, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `HierarchyListener`.
`protected void`	`processInputMethodEvent(InputMethodEvent e)`	Обрабатывает события метода ввода, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `InputMethodListener`.
`protected void`	`processKeyEvent(KeyEvent e)`	Обрабатывает события клавиатуры, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `KeyListener`.
`protected void`	`processMouseEvent(MouseEvent e)`	Обрабатывает события мыши, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `MouseListener`.
`protected void`	`processMouseMotionEvent(MouseEvent e)`	Обрабатывает события перемещения мыши, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `MouseMotionListener`.
`protected void`	`processMouseWheelEvent(MouseWheelEvent e)`	Обрабатывает события колеса мыши, возникающие в этом компоненте, передавая их всем зарегистрированным объектам `MouseWheelListener`.
`void`	`remove(MenuComponent popup)`	Удаляет указанное всплывающее меню из компонента.
`void`	`removeComponentListener(ComponentListener l)`	Удаляет указанный слушатель событий компонента, чтобы он больше не получал события компонента от этого компонента.
`void`	`removeFocusListener(FocusListener l)`	Удаляет указанный слушатель фокуса, чтобы он больше не получал события фокуса от этого компонента.
`void`	`removeHierarchyBoundsListener(HierarchyBoundsListener l)`	Удаляет указанный слушатель границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента.
`void`	`removeHierarchyListener(HierarchyListener l)`	Удаляет указанный слушатель иерархии, чтобы он больше не получал события изменения иерархии от этого компонента.
`void`	`removeInputMethodListener(InputMethodListener l)`	Удаляет указанный слушатель метода ввода, чтобы он больше не получал события метода ввода от этого компонента.
`void`	`removeKeyListener(KeyListener l)`	Удаляет указанный слушатель клавиатуры, чтобы он больше не получал события клавиатуры от этого компонента.
`void`	`removeMouseListener(MouseListener l)`	Удаляет указанный слушатель мыши, чтобы он больше не получал события мыши от этого компонента.
`void`	`removeMouseMotionListener(MouseMotionListener l)`	Удаляет указанный слушатель перемещения мыши, чтобы он больше не получал события перемещения мыши от этого компонента.
`void`	`removeMouseWheelListener(MouseWheelListener l)`	Удаляет указанный слушатель колеса мыши, чтобы он больше не получал события колеса мыши от этого компонента.
`void`	`removeNotify()`	Делает этот `Component` невидимым, уничтожая его собственный экранный ресурс.
`void`	`removePropertyChangeListener(PropertyChangeListener listener)`	Удаляет PropertyChangeListener из списка слушателей.
`void`	`removePropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Удаляет `PropertyChangeListener` из списка слушателей для определённого свойства.
`void`	`repaint()`	Перерисовывает этот компонент.
`void`	`repaint(int x, int y, int width, int height)`	Перерисовывает указанный прямоугольник этого компонента.
`void`	`repaint(long tm)`	Перерисовывает компонент.
`void`	`repaint(long tm, int x, int y, int width, int height)`	Перерисовывает указанный прямоугольник этого компонента в течение `tm` миллисекунд.
`void`	`requestFocus()`	Запрашивает передачу этому компоненту фокуса ввода и получение фокуса окном — предком этого компонента верхнего уровня.
`protected boolean`	`requestFocus(boolean temporary)`	Запрашивает передачу этому `Component` фокуса ввода и получение фокуса `Window` — предком этого `Component` верхнего уровня.
`protected boolean`	`requestFocus(boolean temporary, FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу этому `Component` фокуса ввода и получение фокуса `Window` — предком этого `Component` верхнего уровня.
`void`	`requestFocus(FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу этому компоненту фокуса ввода и получение фокуса окном — предком этого компонента верхнего уровня.
`boolean`	`requestFocusInWindow()`	Запрашивает передачу этому компоненту фокуса ввода, если окно — предок этого компонента верхнего уровня — уже находится в фокусе.
`protected boolean`	`requestFocusInWindow(boolean temporary)`	Запрашивает передачу этому `Component` фокуса ввода, если `Window` — предок этого `Component` верхнего уровня — уже находится в фокусе.
`boolean`	`requestFocusInWindow(FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу этому компоненту фокуса ввода, если окно — предок этого компонента верхнего уровня — уже находится в фокусе.
`void`	`reshape(int x, int y, int width, int height)`	Устарело. Начиная с JDK версии 1.1 заменено на `setBounds(int, int, int, int)`.
`void`	`resize(int width, int height)`	Устарело. Начиная с JDK версии 1.1 заменено на `setSize(int, int)`.
`void`	`resize(Dimension d)`	Устарело. Начиная с JDK версии 1.1 заменено на `setSize(Dimension)`.
`void`	`revalidate()`	Повторно проверяет иерархию компонентов вплоть до ближайшего корня проверки.
`void`	`setBackground(Color c)`	Задаёт цвет фона этого компонента.
`void`	`setBounds(int x, int y, int width, int height)`	Перемещает компонент и изменяет его размер.
`void`	`setBounds(Rectangle r)`	Перемещает компонент и изменяет его размер в соответствии с новым ограничивающим прямоугольником `r`.
`void`	`setComponentOrientation(ComponentOrientation o)`	Задаёт зависящую от языка ориентацию, используемую для упорядочивания элементов или текста в этом компоненте.
`void`	`setCursor(Cursor cursor)`	Задаёт изображение курсора для указанного курсора.
`void`	`setDropTarget(DropTarget dt)`	Связывает `DropTarget` с этим компонентом.
`void`	`setEnabled(boolean b)`	Включает или отключает этот компонент в зависимости от значения параметра `b`.
`void`	`setFocusable(boolean focusable)`	Задаёт для этого компонента значение состояния возможности получения фокуса.
`void`	`setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)`	Задаёт клавиши перехода фокуса для указанной операции перемещения фокуса этого компонента.
`void`	`setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)`	Задаёт, включены ли клавиши перехода фокуса для этого компонента.
`void`	`setFont(Font f)`	Задаёт шрифт этого компонента.
`void`	`setForeground(Color c)`	Задаёт цвет переднего плана этого компонента.
`void`	`setIgnoreRepaint(boolean ignoreRepaint)`	Задаёт, следует ли игнорировать сообщения о рисовании, получаемые от операционной системы.
`void`	`setLocale(Locale l)`	Задаёт локаль этого компонента.
`void`	`setLocation(int x, int y)`	Перемещает этот компонент в новое место.
`void`	`setLocation(Point p)`	Перемещает этот компонент в новое место.
`void`	`setMaximumSize(Dimension maximumSize)`	Задаёт постоянное максимальное значение размера этого компонента.
`void`	`setMinimumSize(Dimension minimumSize)`	Задаёт постоянное минимальное значение размера этого компонента.
`void`	`setMixingCutoutShape(Shape shape)`	Задаёт форму «mixing-cutout» для этого легковесного компонента.
`void`	`setName(String name)`	Задаёт для компонента указанную строку в качестве имени.
`void`	`setPreferredSize(Dimension preferredSize)`	Задаёт постоянное значение предпочтительного размера этого компонента.
`void`	`setSize(int width, int height)`	Изменяет размер этого компонента так, чтобы его ширина составляла `width`, а высота — `height`.
`void`	`setSize(Dimension d)`	Изменяет размер этого компонента так, чтобы его ширина составляла `d.width`, а высота — `d.height`.
`void`	`setVisible(boolean b)`	Отображает или скрывает этот компонент в зависимости от значения параметра `b`.
`void`	`show()`	Устарело. Начиная с JDK версии 1.1 заменено на `setVisible(boolean)`.
`void`	`show(boolean b)`	Устарело. Начиная с JDK версии 1.1 заменено на `setVisible(boolean)`.
`Dimension`	`size()`	Устарело. Начиная с JDK версии 1.1 заменено на `getSize()`.
`String`	`toString()`	Возвращает строковое представление этого компонента и его значений.
`void`	`transferFocus()`	Передаёт фокус следующему компоненту, как если бы этот компонент владел фокусом.
`void`	`transferFocusBackward()`	Передаёт фокус предыдущему компоненту, как если бы этот компонент владел фокусом.
`void`	`transferFocusUpCycle()`	Переводит фокус на один цикл обхода фокуса вверх.
`void`	`update(Graphics g)`	Обновляет этот компонент.
`void`	`validate()`	Проверяет этот компонент.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание полей

HORIZONTAL

public static final int HORIZONTAL

Константа, обозначающая горизонтальную полосу прокрутки.

См. также:

VERTICAL

public static final int VERTICAL

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

См. также:

Подробное описание конструкторов

Scrollbar

public Scrollbar() throws HeadlessException

Создаёт новую вертикальную полосу прокрутки. Свойства полосы прокрутки по умолчанию перечислены в следующей таблице:

Свойства Scrollbar по умолчанию
Свойство	Описание	Значение по умолчанию
orientation	указывает, является ли полоса прокрутки вертикальной или горизонтальной	`Scrollbar.VERTICAL`
value	значение, определяющее положение ползунка полосы прокрутки	0
visible amount	видимая часть диапазона полосы прокрутки, обычно представленная размером её ползунка	10
minimum	минимальное значение полосы прокрутки	0
maximum	максимальное значение полосы прокрутки	100
unit increment	величина изменения значения при нажатии клавиши Line Up или Line Down либо при щелчке по концевым стрелкам полосы прокрутки	1
block increment	величина изменения значения при нажатии клавиши Page Up или Page Down либо при щелчке по дорожке полосы прокрутки с любой стороны от ползунка	10

Вызывает исключение:

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

См. также:

Scrollbar

public Scrollbar(int orientation) throws HeadlessException

Создаёт новую полосу прокрутки с указанной ориентацией.

Аргумент orientation должен принимать одно из двух значений: Scrollbar.HORIZONTAL или Scrollbar.VERTICAL, обозначающих соответственно горизонтальную или вертикальную полосу прокрутки.

Параметры:

orientation — задаёт ориентацию полосы прокрутки

Вызывает исключение:

IllegalArgumentException — если для аргумента orientation указано недопустимое значение

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

См. также:

Scrollbar

public Scrollbar(int orientation, int value, int visible, int minimum, int maximum) throws HeadlessException

Создаёт новую полосу прокрутки с указанной ориентацией, начальным значением, видимой частью, а также минимальным и максимальным значениями.

Передаваемые этому конструктору параметры должны соответствовать ограничениям, описанным в setValues(int, int, int, int).

Параметры:

orientation — задаёт ориентацию полосы прокрутки.

value — начальное значение полосы прокрутки

visible — видимая часть полосы прокрутки, обычно представленная размером ползунка

minimum — минимальное значение полосы прокрутки

maximum — максимальное значение полосы прокрутки

Вызывает исключение:

IllegalArgumentException — если для аргумента orientation указано недопустимое значение

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

См. также:

Подробное описание методов

addNotify

public void addNotify()

Создаёт peer для Scrollbar. Peer позволяет изменять внешний вид Scrollbar, не изменяя её функциональность.

Переопределяет:

addNotify в классе Component

См. также:

getOrientation

public int getOrientation()

Возвращает ориентацию этой полосы прокрутки.

Определён в:

getOrientation в интерфейсе Adjustable

Возвращает:

ориентацию этой полосы прокрутки: Scrollbar.HORIZONTAL или Scrollbar.VERTICAL

См. также:

setOrientation

public void setOrientation(int orientation)

Задаёт ориентацию этой полосы прокрутки.

Параметры:

orientation — ориентация этой полосы прокрутки: Scrollbar.HORIZONTAL или Scrollbar.VERTICAL

Вызывает исключение:

IllegalArgumentException — если значение, указанное для orientation, недопустимо

Начиная с:

1.1

См. также:

getValue

public int getValue()

Получает текущее значение этой полосы прокрутки.

Определён в:

getValue в интерфейсе Adjustable

Возвращает:

текущее значение этой полосы прокрутки

См. также:

setValue

public void setValue(int newValue)

Задаёт для этой полосы прокрутки указанное значение.

Если переданное значение меньше текущего minimum или больше текущего maximum - visibleAmount, вместо него используется соответственно minimum или maximum - visibleAmount.

Как правило, программе следует изменять значение полосы прокрутки только вызовом setValues. Метод setValues одновременно и синхронно задаёт свойства минимального и максимального значений, видимой части и значения полосы прокрутки, обеспечивая их взаимную согласованность.

Вызов этого метода не генерирует AdjustmentEvent.

Определён в:

setValue в интерфейсе Adjustable

Параметры:

newValue — новое значение полосы прокрутки

См. также:

getMinimum

public int getMinimum()

Получает минимальное значение этой полосы прокрутки.

Определён в:

getMinimum в интерфейсе Adjustable

Возвращает:

минимальное значение этой полосы прокрутки

См. также:

setMinimum

public void setMinimum(int newMinimum)

Задаёт минимальное значение этой полосы прокрутки.

При вызове setMinimum минимальное значение изменяется, а другие значения (включая максимальное значение, видимую часть и текущее значение полосы прокрутки) корректируются в соответствии с новым минимумом.

Как правило, программе следует изменять минимальное значение полосы прокрутки только вызовом setValues. Метод setValues одновременно и синхронно задаёт свойства минимального и максимального значений, видимой части и значения полосы прокрутки, обеспечивая их взаимную согласованность.

Обратите внимание: если задать минимальное значение Integer.MAX_VALUE, новое минимальное значение будет установлено равным Integer.MAX_VALUE - 1.

Определён в:

setMinimum в интерфейсе Adjustable

Параметры:

newMinimum — новое минимальное значение этой полосы прокрутки

Начиная с:

1.1

См. также:

getMaximum

public int getMaximum()

Получает максимальное значение этой полосы прокрутки.

Определён в:

getMaximum в интерфейсе Adjustable

Возвращает:

максимальное значение этой полосы прокрутки

См. также:

setMaximum

public void setMaximum(int newMaximum)

Задаёт максимальное значение этой полосы прокрутки.

При вызове setMaximum максимальное значение изменяется, а другие значения (включая минимальное значение, видимую часть и текущее значение полосы прокрутки) корректируются в соответствии с новым максимумом.

Как правило, программе следует изменять максимальное значение полосы прокрутки только вызовом setValues. Метод setValues одновременно и синхронно задаёт свойства минимального и максимального значений, видимой части и значения полосы прокрутки, обеспечивая их взаимную согласованность.

Обратите внимание: если задать максимальное значение Integer.MIN_VALUE, новое максимальное значение будет установлено равным Integer.MIN_VALUE + 1.

Определён в:

setMaximum в интерфейсе Adjustable

Параметры:

newMaximum — новое максимальное значение этой полосы прокрутки

Начиная с:

1.1

См. также:

getVisibleAmount

public int getVisibleAmount()

Получает видимую часть этой полосы прокрутки.

Когда полоса прокрутки используется для выбора диапазона значений, видимая часть обозначает диапазон значений, отображаемых в данный момент. Размер ползунка полосы прокрутки (также называемого бегунком или движком) обычно наглядно показывает отношение видимой части к диапазону полосы прокрутки. Обратите внимание: в зависимости от платформы значение свойства видимой части может не отображаться визуально размером ползунка.

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

Определён в:

getVisibleAmount в интерфейсе Adjustable

Возвращает:

видимую часть этой полосы прокрутки

Начиная с:

1.1

См. также:

getVisible

@Deprecated public int getVisible()

Устарел.

Начиная с JDK версии 1.1 заменён методом getVisibleAmount().

Возвращает видимую часть этой полосы прокрутки.

Возвращает:: видимую часть этой полосы прокрутки

setVisibleAmount

public void setVisibleAmount(int newAmount)

Задаёт видимую часть этой полосы прокрутки.

Если переданная видимая часть меньше one или больше текущего maximum - minimum, вместо неё используется соответственно one или maximum - minimum.

Определён в:

setVisibleAmount в интерфейсе Adjustable

Параметры:

newAmount — новая видимая часть

Начиная с:

1.1

См. также:

setUnitIncrement

public void setUnitIncrement(int v)

Задаёт шаг прокрутки для этой полосы прокрутки.

Шаг прокрутки — это величина, на которую увеличивается или уменьшается значение, когда пользователь активирует область пошаговой прокрутки, обычно с помощью действий мыши или клавиатуры, которые полоса прокрутки получает как событие изменения. Шаг прокрутки должен быть больше нуля. При попытке задать шаг меньше 1 устанавливается значение 1.

В некоторых операционных системах базовые элементы управления могут игнорировать это свойство.

Определён в:

setUnitIncrement в интерфейсе Adjustable

Параметры:

v — величина увеличения или уменьшения значения полосы прокрутки

Начиная с:

1.1

См. также:

setLineIncrement

@Deprecated public void setLineIncrement(int v)

Устарел.

Начиная с JDK версии 1.1 заменён методом setUnitIncrement(int).

Задаёт шаг прокрутки для этой полосы прокрутки.

Параметры:: v — величина шага

getUnitIncrement

public int getUnitIncrement()

Получает шаг прокрутки для этой полосы прокрутки.

В некоторых операционных системах базовые элементы управления могут игнорировать это свойство.

Определён в:

getUnitIncrement в интерфейсе Adjustable

Возвращает:

шаг прокрутки этой полосы прокрутки

Начиная с:

1.1

См. также:

getLineIncrement

@Deprecated public int getLineIncrement()

Устарел.

Начиная с JDK версии 1.1 заменён методом getUnitIncrement().

Возвращает шаг прокрутки для этой полосы прокрутки.

Возвращает:: шаг прокрутки для этой полосы прокрутки

setBlockIncrement

public void setBlockIncrement(int v)

Задаёт шаг постраничной прокрутки для этой полосы прокрутки.

Шаг постраничной прокрутки — это величина, на которую увеличивается или уменьшается значение, когда пользователь активирует область постраничной прокрутки, обычно с помощью действий мыши или клавиатуры, которые полоса прокрутки получает как событие изменения. Шаг постраничной прокрутки должен быть больше нуля. При попытке задать шаг меньше 1 устанавливается значение 1.

Определён в:

setBlockIncrement в интерфейсе Adjustable

Параметры:

v — величина увеличения или уменьшения значения полосы прокрутки

Начиная с:

1.1

См. также:

setPageIncrement

@Deprecated public void setPageIncrement(int v)

Устарел.

Начиная с JDK версии 1.1 заменён методом setBlockIncrement().

Задаёт шаг постраничной прокрутки для этой полосы прокрутки.

Параметры:: v — шаг постраничной прокрутки

getBlockIncrement

public int getBlockIncrement()

Получает шаг постраничной прокрутки для этой полосы прокрутки.

Определён в:

getBlockIncrement в интерфейсе Adjustable

Возвращает:

шаг постраничной прокрутки этой полосы прокрутки

Начиная с:

1.1

См. также:

getPageIncrement

@Deprecated public int getPageIncrement()

Устарел.

Начиная с JDK версии 1.1 заменён методом getBlockIncrement().

Возвращает шаг постраничной прокрутки этой полосы прокрутки.

Возвращает:: шаг постраничной прокрутки этой полосы прокрутки

setValues

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

Задаёт значения четырёх свойств этой полосы прокрутки: value, visibleAmount, minimum и maximum. Если переданные значения этих свойств несогласованны или недопустимы, они будут скорректированы для обеспечения согласованности.

Этот метод одновременно и синхронно задаёт значения четырёх свойств полосы прокрутки, обеспечивая их взаимную согласованность. Он применяет следующие ограничения: maximum должно быть больше minimum, maximum - minimum не должно быть больше Integer.MAX_VALUE, visibleAmount должно быть больше нуля. visibleAmount не должно быть больше maximum - minimum, value не должно быть меньше minimum, а value не должно быть больше maximum - visibleAmount

Вызов этого метода не генерирует AdjustmentEvent.

Параметры:

value — положение в текущем окне

visible — видимая часть полосы прокрутки

minimum — минимальное значение полосы прокрутки

maximum — максимальное значение полосы прокрутки

См. также:

getValueIsAdjusting

public boolean getValueIsAdjusting()

Возвращает true, если значение изменяется в результате действий пользователя.

Возвращает:

значение свойства valueIsAdjusting

Начиная с:

1.4

См. также:

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

Задаёт свойство valueIsAdjusting.

Параметры:

b — новое состояние процесса изменения

Начиная с:

1.4

См. также:

addAdjustmentListener

public void addAdjustmentListener(AdjustmentListener l)

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

Подробнее о модели многопоточности AWT см. в разделе Проблемы многопоточности AWT.

Определён в:

addAdjustmentListener в интерфейсе Adjustable

Параметры:

l — слушатель изменений

Начиная с:

1.1

См. также:

removeAdjustmentListener

public void removeAdjustmentListener(AdjustmentListener l)

Удаляет указанный слушатель изменений, чтобы он больше не получал экземпляры AdjustmentEvent от этой полосы прокрутки. Если l равно null, исключение не выбрасывается и никаких действий не выполняется.

Подробнее о модели многопоточности AWT см. в разделе Проблемы многопоточности AWT.

Определён в:

removeAdjustmentListener в интерфейсе Adjustable

Параметры:

l — слушатель изменений

Начиная с:

1.1

См. также:

getAdjustmentListeners

public AdjustmentListener[] getAdjustmentListeners()

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

Возвращает:

все AdjustmentListener этой полосы прокрутки или пустой массив, если слушатели изменений не зарегистрированы

Начиная с:

1.4

См. также:

getListeners

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

Возвращает массив всех объектов, зарегистрированных в данный момент как FooListeners для этого Scrollbar. Регистрация FooListeners выполняется с помощью метода addFooListener.

В качестве аргумента listenerType можно указать литерал класса, например FooListener.class. Например, можно запросить у Scrollbar c зарегистрированные слушатели мыши с помощью следующего кода:

MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));

Если таких слушателей нет, этот метод возвращает пустой массив.

Переопределяет:

getListeners в классе Component

Параметры типа:

T — тип слушателей

Параметры:

listenerType — тип запрашиваемых слушателей; этот параметр должен указывать интерфейс, являющийся подтипом java.util.EventListener

Возвращает:

массив всех объектов, зарегистрированных в качестве FooListeners для этого компонента, или пустой массив, если такие слушатели не добавлены

Вызывает исключение:

ClassCastException — если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener

Начиная с:

1.3

См. также:

processEvent

protected void processEvent(AWTEvent e)

Обрабатывает события этой полосы прокрутки. Если событие является экземпляром AdjustmentEvent, вызывается метод processAdjustmentEvent. В противном случае вызывается метод processEvent суперкласса.

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

Переопределяет:

processEvent в классе Component

Параметры:

e — событие

Начиная с:

1.1

См. также:

processAdjustmentEvent

protected void processAdjustmentEvent(AdjustmentEvent e)

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

Этот метод вызывается только в том случае, если для компонента включены события изменения. События изменения включаются при выполнении одного из следующих условий:

Объект AdjustmentListener зарегистрирован с помощью addAdjustmentListener.
События изменения включены с помощью enableEvents.

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

Параметры:

e — событие изменения

Начиная с:

1.1

См. также:

paramString

protected String paramString()

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

Переопределяет:: paramString в классе Component
Возвращает:: строку параметров этой полосы прокрутки

getAccessibleContext

public AccessibleContext getAccessibleContext()

Возвращает AccessibleContext, связанный с этим Scrollbar. Для полос прокрутки AccessibleContext имеет вид AccessibleAWTScrollBar. При необходимости создается новый экземпляр AccessibleAWTScrollBar.

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: AccessibleAWTScrollBar, служащий в качестве AccessibleContext этого ScrollBar
Начиная с:: 1.3

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.