X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=src%2Fjalview%2Fgui%2FJvSwingUtils.java;h=e7f992dd37faff03ba188e5f32600d10a4a1a75e;hb=57738a1f3c19b1c3a00bd3ac5108f8cd0af32f99;hp=b921a81fda1e129facc764c7aff60f6d42178ad8;hpb=cb4b4b590add93fb0fb5c5ecd1d0532f1456ecc2;p=jalview.git diff --git a/src/jalview/gui/JvSwingUtils.java b/src/jalview/gui/JvSwingUtils.java index b921a81..e7f992d 100644 --- a/src/jalview/gui/JvSwingUtils.java +++ b/src/jalview/gui/JvSwingUtils.java @@ -1,35 +1,52 @@ /* - * Jalview - A Sequence Alignment Editor and Viewer (Version 2.6) - * Copyright (C) 2010 J Procter, AM Waterhouse, G Barton, M Clamp, S Searle + * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$) + * Copyright (C) $$Year-Rel$$ The Jalview Authors * * This file is part of Jalview. * * Jalview is free software: you can redistribute it and/or * modify it under the terms of the GNU General Public License - * as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. - * + * as published by the Free Software Foundation, either version 3 + * of the License, or (at your option) any later version. + * * Jalview is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty * of MERCHANTABILITY or FITNESS FOR A PARTICULAR * PURPOSE. See the GNU General Public License for more details. * - * You should have received a copy of the GNU General Public License along with Jalview. If not, see . + * You should have received a copy of the GNU General Public License + * along with Jalview. If not, see . + * The Jalview Authors are detailed in the 'AUTHORS' file. */ package jalview.gui; +import java.awt.BorderLayout; import java.awt.Color; +import java.awt.Component; import java.awt.Font; +import java.awt.GridLayout; import java.awt.Rectangle; import java.awt.event.ActionListener; +import java.awt.event.MouseAdapter; +import java.awt.event.MouseEvent; +import java.util.List; +import java.util.Objects; +import javax.swing.AbstractButton; +import javax.swing.BorderFactory; import javax.swing.JButton; +import javax.swing.JComboBox; import javax.swing.JComponent; import javax.swing.JLabel; import javax.swing.JMenu; import javax.swing.JMenuItem; import javax.swing.JPanel; -import javax.swing.JTextArea; +import javax.swing.JScrollBar; import javax.swing.SwingConstants; +import javax.swing.border.Border; +import javax.swing.border.TitledBorder; + +import jalview.util.MessageManager; /** * useful functions for building Swing GUIs @@ -40,25 +57,53 @@ import javax.swing.SwingConstants; public final class JvSwingUtils { /** - * wrap a bare html safe string to around 60 characters per line using a - * - * - * field + * wrap a bare html safe string to around 60 characters per line using a CSS + * style class specifying word-wrap and break-word * + * @param enclose + * if true, add <html> wrapper tags * @param ttext + * * @return */ - public static String wrapTooltip(String ttext) + public static String wrapTooltip(boolean enclose, String ttext) { - if (ttext.length() < 60) + Objects.requireNonNull(ttext, + "Tootip text to format must not be null!"); + ttext = ttext.trim(); + boolean maxLengthExceeded = false; + + if (ttext.contains("
")) { - return ttext; + String[] htmllines = ttext.split("
"); + for (String line : htmllines) + { + maxLengthExceeded = line.length() > 60; + if (maxLengthExceeded) + { + break; + } + } } else { - return "
" + ttext - + "
"; + maxLengthExceeded = ttext.length() > 60; } + + if (!maxLengthExceeded) + { + return enclose ? "" + ttext + "" : ttext; + } + + return (enclose ? "" : "") + // BH 2018 + + "
" + // + "

" + + ttext + "

" + // + "

" + + ((enclose ? "" : "")); } public static JButton makeButton(String label, String tooltip, @@ -88,8 +133,8 @@ public final class JvSwingUtils for (int i = 0, iSize = menu.getMenuComponentCount(); i < iSize; i++) { if (menu.getMenuComponent(i) instanceof JMenu - && ((JMenu) menu.getMenuComponent(i)).getText().equals( - submenu)) + && ((JMenu) menu.getMenuComponent(i)).getText() + .equals(submenu)) { submenuinstance = (JMenu) menu.getMenuComponent(i); } @@ -100,7 +145,7 @@ public final class JvSwingUtils menu.add(submenuinstance); } return submenuinstance; - + } /** @@ -109,18 +154,18 @@ public final class JvSwingUtils * @param tooltip * @param label * @param valBox - * @return the GUI element created that was added to the layout so it's attributes can be changed. + * @return the GUI element created that was added to the layout so it's + * attributes can be changed. */ - public static JPanel addtoLayout(JPanel panel, String tooltip, JComponent label, JComponent valBox) + public static JPanel addtoLayout(JPanel panel, String tooltip, + JComponent label, JComponent valBox) { - JPanel laypanel = new JPanel(),labPanel=new JPanel(), valPanel=new JPanel(); - // laypanel.setSize(panel.getPreferredSize()); - // laypanel.setLayout(null); + JPanel laypanel = new JPanel(new GridLayout(1, 2)); + JPanel labPanel = new JPanel(new BorderLayout()); + JPanel valPanel = new JPanel(); labPanel.setBounds(new Rectangle(7, 7, 158, 23)); - valPanel.setBounds(new Rectangle(172, 7, 270,23)); - //labPanel.setLayout(new GridLayout(1,1)); - //valPanel.setLayout(new GridLayout(1,1)); - labPanel.add(label); + valPanel.setBounds(new Rectangle(172, 7, 270, 23)); + labPanel.add(label, BorderLayout.WEST); valPanel.add(valBox); laypanel.add(labPanel); laypanel.add(valPanel); @@ -135,60 +180,209 @@ public final class JvSwingUtils public static void mgAddtoLayout(JPanel cpanel, String tooltip, JLabel jLabel, JComponent name) { - mgAddtoLayout(cpanel, tooltip, jLabel, name,null); + mgAddtoLayout(cpanel, tooltip, jLabel, name, null); } + public static void mgAddtoLayout(JPanel cpanel, String tooltip, JLabel jLabel, JComponent name, String params) { cpanel.add(jLabel); - if (params==null) { + if (params == null) + { cpanel.add(name); - } else {cpanel.add(name, params); + } + else + { + cpanel.add(name, params); } name.setToolTipText(tooltip); jLabel.setToolTipText(tooltip); } /** - * standard font for labels and check boxes in dialog boxes + * standard font for labels and check boxes in dialog boxes + * * @return */ public static Font getLabelFont() { - return getLabelFont(false,false); + return getLabelFont(false, false); } + public static Font getLabelFont(boolean bold, boolean italic) { - return new java.awt.Font("Verdana", (!bold && !italic) ? Font.PLAIN : (bold ? Font.BOLD : 0) + (italic ? Font.ITALIC : 0), 11); + return new java.awt.Font("Verdana", + (!bold && !italic) ? Font.PLAIN + : (bold ? Font.BOLD : 0) + (italic ? Font.ITALIC : 0), + 11); } /** * standard font for editable text areas + * * @return */ public static Font getTextAreaFont() { - return getLabelFont(false,false); + return getLabelFont(false, false); } /** - * clean up a swing menu. - * Removes any empty submenus without selection listeners. + * clean up a swing menu. Removes any empty submenus without selection + * listeners. + * * @param webService */ public static void cleanMenu(JMenu webService) { - for (int i=0;i buildComboWithTooltips( + List entries, List tooltips) + { + JComboBox combo = new JComboBox<>(); + final ComboBoxTooltipRenderer renderer = new ComboBoxTooltipRenderer(); + combo.setRenderer(renderer); + for (Object attName : entries) + { + combo.addItem(attName); + } + renderer.setTooltips(tooltips); + final MouseAdapter mouseListener = new MouseAdapter() + { + @Override + public void mouseEntered(MouseEvent e) + { + int j = combo.getSelectedIndex(); + if (j > -1) + { + combo.setToolTipText(tooltips.get(j)); + } + } + + @Override + public void mouseExited(MouseEvent e) + { + combo.setToolTipText(null); + } + }; + for (Component c : combo.getComponents()) + { + c.addMouseListener(mouseListener); + } + return combo; + } + + /** + * Adds a titled border to the component in the default font and position (top + * left), optionally witht italic text + * + * @param comp + * @param title + * @param italic + */ + public static TitledBorder createTitledBorder(JComponent comp, + String title, boolean italic) + { + Font font = comp.getFont(); + if (italic) + { + font = new Font(font.getName(), Font.ITALIC, font.getSize()); + } + Border border = BorderFactory.createTitledBorder(""); + TitledBorder titledBorder = BorderFactory.createTitledBorder(border, + title, TitledBorder.LEADING, TitledBorder.DEFAULT_POSITION, + font); + comp.setBorder(titledBorder); + + return titledBorder; + } + }