2.8 Класс Table
java.lang.Object
org.eclipse.swt.widgets.Widget
org.eclipse.swt.widgets.Control
org.eclipse.swt.widgets.Scrollable
org.eclipse.swt.widgets.Composite
org.eclipse.swt.widgets.Table
Объекты этого класса осуществляют интерфейс пользователя таблицы, которая отображает список изображений и строк и обеспечивает подачу уведомления при выборе ее строки (таблица 2.7).
Дочерние строки добавляются к этим объектам как экземпляры класса TableItem. Заметьте, что хотя этот класс является подклассом Composite, нельзя к нему добавлять дочерние элементы управления или устанавливать для него макеты.
Стили являются логической суммой "|" констант, определенных в классе SWT, применимых к объектам этого класса.
SINGLE – для единственного выбора в списке;
MULTI – для множественного выбора в списке; CHECK – для создания колонки check box; FULL_SELECTION – для выбора всей строки в списке;
HIDE_SELECTION – скрывать выделение при потере фокуса ввода; VIRTUAL – допускать виртуальные данные.
Примечание: Только один из стилей SINGLE и MULTI может быть определен. Этот класс не должен иметь подклассов.
Таблица 2.7 – Методы компонентов класса Table
Конструктор
Table(Composite parent, int style) – Создает новый объект этого класса имеющего родителя parent и стиль style, описывающих поведение и вид
Методы
void |
addSelectionListener(SelectionListener listener) – Добавляет |
|
обработчик, который будет извещен когда изменяется выбор |
||
|
||
|
получателя, посылая одно из сообщений определенных в |
|
|
интерфейсе SelectionListener |
|
protected void |
checkSubclass() – Проверяет, что этот класс может быть |
|
подклассом |
||
|
58
void |
clear(int index) – Очищает пункт для заданного относительно |
|
нуля индекса получателя |
||
|
||
|
|
|
void |
clear (int[ ] indices) – Очищает пункт для заданного |
|
относительно нуля массива индексов получателя |
||
|
||
void |
clear (int start, int end) – Очищает пункты получателя между |
|
заданными стартовыми и конечными индексами (включая их) |
||
|
||
void |
clearAll() – Очищает все строки |
|
|
|
|
Point |
computeSize(int wHint, int hHint, boolean changed) – |
|
Возвращает предпочтительный размер получателя |
||
|
||
void |
deselect(int index) – Отменяет выбор пункта для заданного |
|
относительно нуля индекса получателя |
||
|
||
void |
deselect (int[ ] indices) ) – Отменяет выбор пунктов для |
|
заданного относительно нуля массива индексов |
||
|
||
void |
deselect (int start, int end) – Отменяет выбор пунктов для |
|
заданного относительно нуля диапазона индексов |
||
|
||
void |
deselectAll()) – Отменяет выбор всех пунктов |
|
TableColumn |
getColumn(int index) – Возвращает заданную индексом |
|
колонку (относительно нуля) получателя |
||
|
||
int |
getColumnCount() – Возвращает число колонок |
|
int[ ] |
getColumnOrder() – Возвращает массив целых, которые |
|
отображают порядок создания пунктов получателя в порядок |
||
|
||
|
в котором они к настоящему времени отображаются |
|
TableColumn[ |
getColumns() – Возвращает массив TableColumns колонок |
|
] |
||
|
||
int |
getGridLineWidth() – Возвращает ширину в пикселях линии |
|
сетки |
||
|
||
int |
getHeaderHeight() – Возвращает высоту заголовка получателя |
|
|
|
|
boolean |
getHeaderVisible() – Возвращается верно, если заголовок |
|
получателя — видимый, и ложный в противном случае |
||
|
||
TableItem |
getItem(int index) – Возвращает пункт с заданным индексом |
|
на получателе |
||
|
||
TableItem |
getItem(Point point) – Возвращает пункт в заданной точке или |
|
null, если пункт не существует |
||
|
||
|
59 |
int |
getItemCount() – Возвращает количество пунктов |
|
int |
getItemHeight() – Возвращает высоту области, которая |
|
должна быть использована, чтобы отображать один пункт |
||
|
||
TableItem[ ] |
getItems() – Возвращает массив (возможно пустой) TableItems |
|
пунктов |
||
|
||
boolean |
getLinesVisible() – Возвращается верно если линии видимые |
|
и ложь в противном случае |
||
|
||
TableItem[ ] |
getSelection() – Возвращает массив (возможно пустой) |
|
TableItems выбранных пунктов |
||
|
||
int |
getSelectionCount() – Возвращает число выбранных пунктов |
|
|
|
|
int |
getSelectionIndex() – Возвращает индекс выбранного пункта |
|
|
|
|
int[ ] |
getSelectionIndices() – Возвращает массив индексов |
|
выбранных пунктов |
||
|
||
int |
getTopIndex() – Возвращает индекс пункта, который — к |
|
настоящему времени наверху получателя |
||
|
||
int |
indexOf(TableColumn column) – Ищет индекс колонки |
|
int |
indexOf (TableItem item) – Ищет индекс строки |
|
boolean |
isSelected(int index) – Возвращается верно если пункт выбран |
|
и ложь в противном случае |
||
|
||
void |
remove(int index) – Удаляет пункт по заданному индексу |
|
void |
remove (int[ ] indices) ) – Удаляет пункты по заданному |
|
массиву индексов |
||
|
||
void |
remove (int start, int end) – Удаляет пункты по заданному |
|
диапазону индексов |
||
|
||
void |
removeAll() – Удаляет все пункты |
|
void |
removeSelectionListener(SelectionListener listener) – Удаляет |
|
обработчик изменения выбора получателя |
||
|
||
void |
select(int index) – Выбирается пункт по индексу |
|
void |
select (int[ ] indices) – Выбираются пункты по массиву |
|
индексов |
||
|
||
void |
select (int start, int end) – Выбираются пункты по диапазону |
|
индексов |
||
|
60
void |
selectAll() – Выбираются все пункты |
|
void |
setColumnOrder(int[ ] order) – Установить порядок |
|
отображения колонок |
||
|
||
void |
setFont(Font font) – Установить шрифт. Если null, то |
|
использовать шрифт по умолчанию |
||
|
||
void |
setHeaderVisible(boolean show) – Установить видимость |
|
заголовков |
||
|
||
void |
setItemCount(int count) – Установить число строк в таблице |
|
void |
setLinesVisible(boolean show) – Установить видимость линий |
|
void |
setRedraw(boolean redraw) – Если false, то игнорировать все |
|
последующие операции |
||
|
||
void |
setSelection(int index) – Установить выбор строки по индексу |
|
|
|
|
void |
setSelection(int[ ] indices) – Установить выбор строк по |
|
массиву индексов |
||
|
||
void |
setSelection(int start, int end) – Установить выбор строк по |
|
диапазону индексов |
||
|
||
void |
setSelection(TableItem[ ] items) – Установить выбор по |
|
массиву строк |
||
|
||
void |
setTopIndex(int index) – Устанавливает индекс пункта, |
|
который к настоящему времени на верху получателя |
||
|
||
void |
showColumn(TableColumn column) – Показать колонку |
|
void |
showItem(TableItem item) – Показать строку |
|
|
|
|
void |
showSelection()– Показать выбранные |
|
|
|
|
|
|
Пример (рисунок 2.7).
Display display = new Display ();
Shell shell = new Shell (display);
Table table = new Table (shell, SWT.MULTI | SWT.BORDER |
SWT.FULL_SELECTION); table.setLinesVisible (true); table.setHeaderVisible (true);
String[ ] titles = {" ", "C", "!", "Description", "Resource",
"In Folder", "Location"};
for (int i=0; i<titles.length; i++) {
TableColumn column = new TableColumn (table, SWT.NONE);
61