Как Использовать Границы

Каждый JComponent может иметь одну или более границ. Границы являются невероятно полезными объектами, которые, в то время как не непосредственно компоненты, знают, как потянуть края компонентов Swing. Границы полезны не только для проведения линий и необычных краев, но также и для обеспечения заголовков и пустого места вокруг компонентов.

Помещать границу вокруг a JComponent, Вы используете setBorder метод. Можно использовать BorderFactory class, чтобы создать большинство границ, которые обеспечивает Swing. Если Вы нуждаетесь в ссылке на границу — говорят, потому что Вы хотите использовать это в многократных компонентах — можно сохранить это в переменной типа Border. Вот пример кода, который создает ограниченный контейнер:

JPanel pane = new JPanel();
pane.setBorder(BorderFactory.createLineBorder(Color.black));

Вот изображение контейнера, который содержит компонент метки. Черное пятно, оттянутое символами границы край контейнера.

Остальная часть этой страницы обсуждает следующие темы:

• Пример BorderDemo
• Используя Границы, Обеспеченные Swing
• Создание Пользовательских Границ
• API Границы
• Примеры Использования Границ

Пример BorderDemo

Следующие изображения показывают вызванное приложение BorderDemo это выводит на экран границы, которые обеспечивает Swing. Мы показываем код для того, чтобы создать эти границы немного позже в Использовании Границ, Обеспеченных Swing.

Нажмите кнопку Launch, чтобы работать, пример BorderDemo, используя Сеть Java™ Запускаются (загрузите JDK 6 или позже). Альтернативно, чтобы скомпилировать и выполнить пример самостоятельно, консультируйтесь, пример индексируют.

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

Следующие шоу изображения названные границы. Используя названную границу, можно преобразовать любую границу в тот, который выводит на экран текстовое описание. Если Вы не определяете границу, стиль, определенная граница используется. Например, значение по умолчанию, названная граница в стили Java использует серую строку, и значение по умолчанию названная граница в стили Windows, использует вытравленную границу. По умолчанию title колеблется между верхней левой из границы, как показано наверху следующего числа.

Следующее изображение показывает составные границы. С составными границами можно объединить любые две границы, которые могут самостоятельно быть составными границами.

Используя Границы, Обеспеченные Swing

Код, который следует за шоу, как создать и установить границы, которые Вы видели в предыдущих числах. Можно найти код программы в BorderDemo.java.

//Keep references to the next few borders,
//for use in titles and compound borders.
Border blackline, raisedetched, loweredetched,
       raisedbevel, loweredbevel, empty;

blackline = BorderFactory.createLineBorder(Color.black);
raisedetched = BorderFactory.createEtchedBorder(EtchedBorder.RAISED);
loweredetched = BorderFactory.createEtchedBorder(EtchedBorder.LOWERED);
raisedbevel = BorderFactory.createRaisedBevelBorder();
loweredbevel = BorderFactory.createLoweredBevelBorder();
empty = BorderFactory.createEmptyBorder();

//Simple borders
jComp1.setBorder(blackline);
jComp2.setBorder(raisedbevel);
jComp3.setBorder(loweredbevel);
jComp4.setBorder(empty);

//Matte borders
ImageIcon icon = createImageIcon("images/wavy.gif",
                                 "wavy-line border icon"); //20x22

jComp5.setBorder(BorderFactory.createMatteBorder(
                                   -1, -1, -1, -1, icon));
jComp6.setBorder(BorderFactory.createMatteBorder(
                                    1, 5, 1, 1, Color.red));
jComp7.setBorder(BorderFactory.createMatteBorder(
                                    0, 20, 0, 0, icon));

//Titled borders
TitledBorder title;
title = BorderFactory.createTitledBorder("title");
jComp8.setBorder(title);

title = BorderFactory.createTitledBorder(
                       blackline, "title");
title.setTitleJustification(TitledBorder.CENTER);
jComp9.setBorder(title);

title = BorderFactory.createTitledBorder(
                       loweredetched, "title");
title.setTitleJustification(TitledBorder.RIGHT);
jComp10.setBorder(title);

title = BorderFactory.createTitledBorder(
                       loweredbevel, "title");
title.setTitlePosition(TitledBorder.ABOVE_TOP);
jComp11.setBorder(title);

title = BorderFactory.createTitledBorder(
                       empty, "title");
title.setTitlePosition(TitledBorder.BOTTOM);
jComp12.setBorder(title);

//Compound borders
Border compound;
Border redline = BorderFactory.createLineBorder(Color.red);

//This creates a nice frame.
compound = BorderFactory.createCompoundBorder(
                          raisedbevel, loweredbevel);
jComp13.setBorder(compound);

//Add a red outline to the frame.
compound = BorderFactory.createCompoundBorder(
                          redline, compound);
jComp14.setBorder(compound);

//Add a title to the red-outlined frame.
compound = BorderFactory.createTitledBorder(
                          compound, "title",
                          TitledBorder.CENTER,
                          TitledBorder.BELOW_BOTTOM);
jComp15.setBorder(compound);

Как Вы, вероятно, заметили, код использует BorderFactory class, чтобы создать каждую границу. BorderFactory class, который находится в javax.swing пакет, возвраты возражают что реализация Border интерфейс.

Border интерфейс, так же как его обеспеченные Swing реализации, находится в javax.swing.border пакет. Вы часто ничего не должны непосредственно использовать в пакете границы, кроме тех случаев, когда определение констант, которые являются определенными для определенной границы class или обращаясь к Border ввести.

Создание Пользовательских Границ

Если BorderFactory не предлагает Вам достаточное управление формой границы, тогда Вы, возможно, должны были бы непосредственно использовать API в пакете границы — или даже определить Вашу собственную границу. В дополнение к содержанию Border интерфейс, пакет границы содержит классы, которые реализуют границы, которые Вы уже видели: LineBorder, EtchedBorder, BevelBorder, EmptyBorder, MatteBorder, TitledBorder, и CompoundBorder. Пакет границы также содержит названный class SoftBevelBorder, который приводит к результату, подобному BevelBorder, но с более мягкими краями.

Если ни одна из границ Swing не является подходящей, можно реализовать свою собственную границу. Обычно, Вы делаете это, создавая подкласс AbstractBorder class. В Вашем подклассе следует реализовать по крайней мере одного конструктора и следующие два метода:

• paintBorder, который содержит код для прорисовки это a JComponent выполняется, чтобы потянуть границу.
• getBorderInsets, который определяет количество пространства, граница должна потянуть себя.

Если у пользовательской границы есть вставки (и у них обычно есть вставки), Вы должны переопределить обоих AbstractBorder.getBorderInsets(Component c) и AbstractBorder.getBorderInsets(Component c, Insets insets) обеспечить корректные вставки.

Для примеров реализации границ см. исходный код для классов в javax.swing.border пакет.

API Границы

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

• Создание Границы с BorderFactory
• Установка или Получение Границы Компонента

Примеры то Использование Границы

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