|
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 в интерфейсе LayoutManagername - имя компонентаcomp - компонент, который будет добавленpublic void removeLayoutComponent(Component comp)
removeLayoutComponent в интерфейсе LayoutManagercomp - компонент, который будет удаленpublic Dimension preferredLayoutSize(Container parent)
Привилегированным width расположения сетки является самый большой привилегированный width всех компонентов в контейнерные времена число столбцов, плюс горизонтальные дополнительные времена число столбцов минус один, плюс левые и правые вставки целевого контейнера.
Привилегированным height расположения сетки является самый большой привилегированный height всех компонентов в контейнерные времена число строк, плюс вертикальные дополнительные времена число строк минус один, плюс вершина и нижние вставки целевого контейнера.
preferredLayoutSize в интерфейсе LayoutManagerparent - контейнер, в котором можно сделать расположениеminimumLayoutSize(java.awt.Container), Container.getPreferredSize()public Dimension minimumLayoutSize(Container parent)
Минимальным width расположения сетки является самый большой минимальный width всех компонентов в контейнерные времена число столбцов, плюс горизонтальные дополнительные времена число столбцов минус один, плюс левые и правые вставки целевого контейнера.
Минимальным height расположения сетки является самый большой минимальный height всех компонентов в контейнерные времена число строк, плюс вертикальные дополнительные времена число строк минус один, плюс вершина и нижние вставки целевого контейнера.
minimumLayoutSize в интерфейсе LayoutManagerparent - контейнер, в котором можно сделать расположениеpreferredLayoutSize(java.awt.Container), Container.doLayout()public void layoutContainer(Container parent)
Этот метод изменяет компоненты в указанном целевом контейнере, чтобы удовлетворить ограничения GridLayout объект.
Менеджер по расположению сетки определяет размер отдельных компонентов, деля свободное пространство на контейнер в части равного размера согласно числу строк и столбцов в расположении. Свободное пространство контейнера равняется размеру контейнера минус любые вставки и любая указанная горизонталь или вертикальный разрыв. Всем компонентам в расположении сетки дают тот же самый размер.
layoutContainer в интерфейсе LayoutManagerparent - контейнер, в котором можно сделать расположениеContainer, Container.doLayout()
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92