Spec-Zone .ru
спецификации, руководства, описания, API
|
public class GridLayout extends Object implements LayoutManager, Serializable
GridLayout
class является менеджером по расположению, который размечает компоненты контейнера в прямоугольной сетке. Контейнер делится на прямоугольники равного размера, и один компонент помещается в каждый прямоугольник. Например, следующее является апплетом, который размечает шесть кнопок в три строки и два столбца:
import java.awt.*; import java.applet.Applet; public class ButtonGrid extends Applet { public void init() { setLayout(new GridLayout(3,2)); add(new Button("1")); add(new Button("2")); add(new Button("3")); add(new Button("4")); add(new Button("5")); add(new Button("6")); } }
Если контейнер ComponentOrientation
свойство является горизонталью и слева направо, вышеупомянутый пример производит вывод, показанный в рисунке 1. Если контейнер ComponentOrientation
свойство является горизонталью и справа налево, пример производит вывод, показанный в рисунке 2.
Рисунок 1: Горизонталь, Слева направо | Рисунок 2: Горизонталь, Справа налево |
Когда и число строк и число столбцов были установлены в ненулевые значения, или конструктором или методами setRows И setColumns, число определенных столбцов игнорируется. Вместо этого число столбцов определяется от конкретного количества строк и общего количества компонентов в расположении. Так, например, если три строки и два столбца были определены, и девять компонентов добавляются к расположению, они будут выведены на экран как три строки трех столбцов. Определение числа столбцов влияет на расположение только, когда число строк обнуляется.
Конструктор и Описание |
---|
GridLayout()
Создает расположение сетки со значением по умолчанию одного столбца за компонент, в единственной строке.
|
GridLayout(int rows, int cols)
Создает расположение сетки с конкретным количеством строк и столбцов.
|
GridLayout(int rows, int cols, int hgap, int vgap)
Создает расположение сетки с конкретным количеством строк и столбцов.
|
Модификатор и Тип | Метод и Описание |
---|---|
void |
addLayoutComponent(String name, Component comp)
Добавляет указанный компонент с указанным именем к расположению.
|
int |
getColumns()
Получает число столбцов в этом расположении.
|
int |
getHgap()
Получает горизонтальный разрыв между компонентами.
|
int |
getRows()
Получает число строк в этом расположении.
|
int |
getVgap()
Получает вертикальный разрыв между компонентами.
|
void |
layoutContainer(Container parent)
Размечает указанный контейнер, используя это расположение.
|
Размерность |
minimumLayoutSize(Container parent)
Определяет минимальный размер контейнерного параметра, используя это расположение сетки.
|
Размерность |
preferredLayoutSize(Container parent)
Определяет привилегированный размер контейнерного параметра, используя это расположение сетки.
|
void |
removeLayoutComponent(Component comp)
Удаляет указанный компонент из расположения.
|
void |
setColumns(int cols)
Определяет номер столбцов в этом расположении к указанному значению.
|
void |
setHgap(int hgap)
Устанавливает горизонтальный разрыв между компонентами к указанному значению.
|
void |
setRows(int rows)
Определяет номер строк в этом расположении к указанному значению.
|
void |
setVgap(int vgap)
Устанавливает вертикальный разрыв между компонентами к указанному значению.
|
Строка |
toString()
Возвращает строковое представление этой сетки значения расположения.
|
public GridLayout()
public GridLayout(int rows, int cols)
Один, но не оба, rows
и cols
может быть нуль, что означает, что любое число объектов может быть помещено подряд или в столбце.
rows
- строки, с нулем значения значение любого числа строк.cols
- столбцы, с нулем значения значение любого числа столбцов.public GridLayout(int rows, int cols, int hgap, int vgap)
Кроме того, горизонталь и вертикальные разрывы устанавливаются в указанные значения. Горизонтальные разрывы помещаются между каждым из столбцов. Вертикальные разрывы помещаются между каждой из строк.
Один, но не оба, rows
и cols
может быть нуль, что означает, что любое число объектов может быть помещено подряд или в столбце.
Все GridLayout
конструкторы подчиняются этому.
rows
- строки, с нулем значения значение любого числа строкcols
- столбцы, с нулем значения значение любого числа столбцовhgap
- горизонтальный разрывvgap
- вертикальный разрывIllegalArgumentException
- если значение обоих rows
и cols
обнуляетсяpublic int getRows()
public void setRows(int rows)
rows
- число строк в этом расположенииIllegalArgumentException
- если значение обоих rows
и cols
обнуляетсяpublic int getColumns()
public void setColumns(int cols)
cols
- число столбцов в этом расположенииIllegalArgumentException
- если значение обоих rows
и cols
обнуляетсяpublic int getHgap()
public void setHgap(int hgap)
hgap
- горизонтальный разрыв между компонентамиpublic int getVgap()
public void setVgap(int vgap)
vgap
- вертикальный разрыв между компонентамиpublic void addLayoutComponent(String name, Component comp)
addLayoutComponent
в интерфейсе LayoutManager
name
- имя компонентаcomp
- компонент, который будет добавленpublic void removeLayoutComponent(Component comp)
removeLayoutComponent
в интерфейсе LayoutManager
comp
- компонент, который будет удаленpublic Dimension preferredLayoutSize(Container parent)
Привилегированным width расположения сетки является самый большой привилегированный width всех компонентов в контейнерные времена число столбцов, плюс горизонтальные дополнительные времена число столбцов минус один, плюс левые и правые вставки целевого контейнера.
Привилегированным height расположения сетки является самый большой привилегированный height всех компонентов в контейнерные времена число строк, плюс вертикальные дополнительные времена число строк минус один, плюс вершина и нижние вставки целевого контейнера.
preferredLayoutSize
в интерфейсе LayoutManager
parent
- контейнер, в котором можно сделать расположениеminimumLayoutSize(java.awt.Container)
, Container.getPreferredSize()
public Dimension minimumLayoutSize(Container parent)
Минимальным width расположения сетки является самый большой минимальный width всех компонентов в контейнерные времена число столбцов, плюс горизонтальные дополнительные времена число столбцов минус один, плюс левые и правые вставки целевого контейнера.
Минимальным height расположения сетки является самый большой минимальный height всех компонентов в контейнерные времена число строк, плюс вертикальные дополнительные времена число строк минус один, плюс вершина и нижние вставки целевого контейнера.
minimumLayoutSize
в интерфейсе LayoutManager
parent
- контейнер, в котором можно сделать расположениеpreferredLayoutSize(java.awt.Container)
, Container.doLayout()
public void layoutContainer(Container parent)
Этот метод изменяет компоненты в указанном целевом контейнере, чтобы удовлетворить ограничения GridLayout
объект.
Менеджер по расположению сетки определяет размер отдельных компонентов, деля свободное пространство на контейнер в части равного размера согласно числу строк и столбцов в расположении. Свободное пространство контейнера равняется размеру контейнера минус любые вставки и любая указанная горизонталь или вертикальный разрыв. Всем компонентам в расположении сетки дают тот же самый размер.
layoutContainer
в интерфейсе LayoutManager
parent
- контейнер, в котором можно сделать расположениеContainer
, Container.doLayout()
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92