Dicas de ferramentas com várias linhas em Java?

105

Estou tentando exibir dicas de ferramentas em Java que podem ou não ter o comprimento de um parágrafo. Como posso moldar as dicas de ferramentas longas?

java swing tooltip Amanda S
fonte
Forneça um exemplo de código.
Stefan Thyberg
1
As dicas de ferramentas não quebram automaticamente se estiverem contidas em tags HTML? Não tenho certeza, então não estou colocando isso como uma resposta.
Paul Tomblin
Paul: Somente se você tiver quebras de linha explícitas.
Amanda S

Respostas:

146

Se você envolver a dica de ferramenta em tags <html>e </html>, poderá quebrar as linhas com <br>tags. Consulte http://www.jguru.com/faq/view.jsp?EID=10653 para obter exemplos e discussão.

Ou você pode usar a classe JMultiLineToolTip que pode ser encontrada em muitos lugares na rede, incluindo https://github.com/ls-cwi/yoshiko-app/blob/master/src/main/java/com/yoshiko/internal/ view / JMultiLineToolTip.java

Paul Tomblin
fonte
1
Usei a classe JMultiLineToolTip que você sugeriu. Depois de usar setFixedWidth () para limitar a dica de ferramenta a um tamanho razoável, funcionou muito bem. Obrigado!
Amanda S
24

O texto da dica de ferramenta que começa com " <html>" será tratado como HTML. Claro que pode ser um HTML muito amplo.

Você pode substituir JComponent.createTooltip para substituir a dica de ferramenta por seu próprio componente, que pode exibir o que você quiser.

Tom Hawtin - tackline
fonte
20

Eu sei que este é muito antigo, mas encontrei uma solução bastante simples usando o código HTML!

Basta usar um parágrafo HTML com largura fixa:

setToolTipText("<html><p width=\"500\">" +value+"</p></html>");
phwoelfel
fonte
E se eu quiser exibir um texto muito menor do que o tamanho da dica de ferramenta? A tag "max-width" não funciona aqui
nickolay.laptev
5

Use dicas de ferramentas HTML e quebre manualmente suas linhas (um tokenizador de palavras simples com um comprimento de linha fixo deve servir). Apenas certifique-se de que o texto da sua ferramenta comece com "<HTML>". Quebre as linhas com "<BR/>" ou "<P>". Sei que não é a solução mais limpa e o suporte a HTML do Java é horrível, mas deve resolver o problema.

basszero
fonte
4

Exemplo:

jTextField1.setToolTipText("<html>"
                              + "Line One"
                              +"<br>"
                              + "Line 2"
                         + "</html>");
ja4
fonte
Isso não responde à pergunta do autor da pergunta. Ele estava perguntando sobre o empacotamento quando for exibido, não no código-fonte.
Trenó de
2
@ArtB este código de exemplo fornece uma dica de ferramenta de duas linhas, conforme solicitado.
Thelema
4

Isso poderia ser melhorado um pouco, mas minha abordagem era uma função auxiliar chamada antes de definir a dica de ferramenta que dividia o texto da dica de ferramenta no comprimento fornecido, mas ajustada para quebrar palavras no espaço onde possível.

import java.util.ArrayList;
import java.util.List;

/**
 *
 */
public class MultiLineTooltips
{
    private static int DIALOG_TOOLTIP_MAX_SIZE = 75;
    private static final int SPACE_BUFFER = 10;

    public static String splitToolTip(String tip)
    {
        return splitToolTip(tip,DIALOG_TOOLTIP_MAX_SIZE);
    }
    public static String splitToolTip(String tip,int length)
    {
        if(tip.length()<=length + SPACE_BUFFER )
        {
            return tip;
        }

        List<String>  parts = new ArrayList<>();

        int maxLength = 0;
        String overLong = tip.substring(0, length + SPACE_BUFFER);
        int lastSpace = overLong.lastIndexOf(' ');
        if(lastSpace >= length)
        {
            parts.add(tip.substring(0,lastSpace));
            maxLength = lastSpace;
        }
        else
        {
            parts.add(tip.substring(0,length));
            maxLength = length;
        }

        while(maxLength < tip.length())
        {
            if(maxLength + length < tip.length())
            {
                parts.add(tip.substring(maxLength, maxLength + length));
                maxLength+=maxLength+length;
            }
            else
            {
                parts.add(tip.substring(maxLength));
                break;
            }
        }

        StringBuilder  sb = new StringBuilder("<html>");
        for(int i=0;i<parts.size() - 1;i++)
        {
            sb.append(parts.get(i)+"<br>");
        }
        sb.append(parts.get(parts.size() - 1));
        sb.append(("</html>"));
        return sb.toString();
    }
}

Usar como

jComponent.setToolTipText(MultiLineTooltips.splitToolTip(TOOLTIP));
Paul Taylor
fonte
2

Você pode criar uma subclasse de JToolTip, que é um componente, e substituir createToolTip () no componente.

user101884
fonte
1

Esta é uma versão que usei antes, ela funciona bem se você estiver carregando suas dicas de ferramentas do ResourceBundles:

import javax.swing.JComponent;
import javax.swing.JToolTip;
import javax.swing.LookAndFeel;
import javax.swing.UIManager;
import javax.swing.plaf.ComponentUI;
import javax.swing.plaf.ToolTipUI;
import java.awt.Dimension;
import java.awt.FontMetrics;
import java.awt.Graphics;
import java.util.regex.Pattern;

/**
 * A tooltip that wraps multi-line text.
 */
public final class MultiLineToolTipUI extends ToolTipUI {

    private static final int INSET = 2;

    private static final Pattern LINE_SPLITTER = Pattern.compile("$", Pattern.MULTILINE);

    private static final MultiLineToolTipUI SHARED_INSTANCE = new MultiLineToolTipUI();

    /**
     * Install the multi-line tooltip into the UI manager.
     */
    public static void installUI() {
        String toolTipUI = MultiLineToolTipUI.class.getName();
        UIManager.put("ToolTipUI", toolTipUI);
        UIManager.put(toolTipUI, MultiLineToolTipUI.class);
    }

    @SuppressWarnings("UnusedDeclaration")
    public static ComponentUI createUI(JComponent c) {
        return SHARED_INSTANCE;
    }

    private MultiLineToolTipUI() {}

    @Override
    public Dimension getMaximumSize(JComponent c) {
        return getPreferredSize(c);
    }

    @Override
    public Dimension getMinimumSize(JComponent c) {
        return getPreferredSize(c);
    }

    @Override
    public Dimension getPreferredSize(JComponent c) {
        String[] lines = LINE_SPLITTER.split(((JToolTip) c).getTipText());
        if (lines.length == 0) {
            return new Dimension(2 * INSET, 2 * INSET);
        }
        FontMetrics metrics = c.getFontMetrics(c.getFont());
        Graphics g = c.getGraphics();
        int w = 0;
        for (String line : lines) {
            w = Math.max(w, (int) metrics.getStringBounds(line, g).getWidth());
        }
        int h = lines.length * metrics.getHeight();
        return new Dimension(w + 2 * INSET, h + 2 * INSET);
    }

    @Override
    public void installUI(JComponent c) {
        LookAndFeel.installColorsAndFont(c, "ToolTip.background", "ToolTip.foreground", "ToolTip.font");
        LookAndFeel.installBorder(c, "ToolTip.border");
    }

    @Override
    public void paint(Graphics g, JComponent c) {
        int w = c.getWidth(), h = c.getHeight();
        g.setColor(c.getBackground());
        g.fillRect(0, 0, w, h);
        g.setColor(c.getForeground());
        g.drawRect(0, 0, w, h);
        String[] lines = LINE_SPLITTER.split(((JToolTip) c).getTipText());
        if (lines.length != 0) {
            FontMetrics metrics = c.getFontMetrics(c.getFont());
            int height = metrics.getHeight();
            int y = INSET + metrics.getAscent();
            for (String line : lines) {
                g.drawString(line, INSET, y);
                y += height;
            }
        }
    }

    @Override
    public void uninstallUI(JComponent c) {
        LookAndFeel.uninstallBorder(c);
    }

}

E você o usaria chamando este método, antes de sua IU ser criada:

MultiLineToolTipUI.installUI();

Em seguida, em seus arquivos de propriedades, basta inserir novas linhas para envolver as dicas de ferramenta conforme desejado.

Ian Phillips
fonte
1

Criei uma classe de utilitário que formata automaticamente strings para um comprimento específico com <br>tags. Ele é baseado na classe MultiLineToolTips postada por Paul Taylor, mas há um bug que pula partes da string e não a limita a um comprimento específico.

Para usar minha classe, basta invocar o método splitToolTip escrevendo MultiLineToolTips.splitToolTip(yourString);ou MultiLineToolTips.splitToolTip(yourString, maxLength);se quiser dividi-lo em um comprimento máximo específico. Isso criará strings de dicas de ferramenta bem formatadas.

import java.util.ArrayList;
import java.util.List;

/** A helper class to split strings into a certain length,
 * formatted with html {@literal<br>} tags for multi-line tool tips.
 * Based on the MultiLineToolTips class posted by
 * <a href="https://stackoverflow.com/users/1480018/paul-taylor">Paul Taylor</a>
 * on <a href="https://stackoverflow.com/a/13503677/9567822">Stack Overflow</a>
 * @author <a href="https://stackoverflow.com/users/9567822/andrew-lemaitre?tab=profile">Andrew LeMaitre</a>
 */
public final class MultiLineToolTips {

    /** Private constructor for utility class. */
    private MultiLineToolTips() {
    }

    /** Default max length of the tool tip when split with {@link #splitToolTip(String)}. */
    private static final int DIALOG_TOOLTIP_MAX_SIZE = 75;

    /** A function that splits a string into sections of {@value #DIALOG_TOOLTIP_MAX_SIZE} characters or less.
     * If you want the lines to be shorter or longer call {@link #splitToolTip(String, int)}.
     * @param toolTip The tool tip string to be split
     * @return the tool tip string with HTML formatting to break it into sections of the correct length
     */
    public static String splitToolTip(final String toolTip) {
        return splitToolTip(toolTip, DIALOG_TOOLTIP_MAX_SIZE);
    }

    /**  An overloaded function that splits a tool tip string into sections of a specified length.
     * @param toolTip The tool tip string to be split
     * @param desiredLength The maximum length of the tool tip per line
     * @return The tool tip string with HTML formatting to break it into sections of the correct length
     */
    public static String splitToolTip(final String toolTip, final int desiredLength) {
        if (toolTip.length() <= desiredLength) {
            return toolTip;
        }

        List<String>  parts = new ArrayList<>();
        int stringPosition = 0;

        while (stringPosition < toolTip.length()) {
            if (stringPosition + desiredLength < toolTip.length()) {
                String tipSubstring = toolTip.substring(stringPosition, stringPosition + desiredLength);
                int lastSpace = tipSubstring.lastIndexOf(' ');
                if (lastSpace == -1 || lastSpace == 0) {
                    parts.add(toolTip.substring(stringPosition, stringPosition + desiredLength));
                    stringPosition += desiredLength;
                } else {
                    parts.add(toolTip.substring(stringPosition, stringPosition + lastSpace));
                    stringPosition += lastSpace;
                }
            } else {
                parts.add(toolTip.substring(stringPosition));
                break;
            }
        }

        StringBuilder  sb = new StringBuilder("<html>");
        for (int i = 0; i < parts.size() - 1; i++) {
            sb.append(parts.get(i) + "<br>");
        }
        sb.append(parts.get(parts.size() - 1));
        sb.append(("</html>"));
        return sb.toString();
    }
}
Andrew LeMaitre
fonte
0

Se você apenas adicionar <html>ao texto de dica de ferramenta, ele parecerá funcionar até que você tenha um /*...*/HTML em seu texto. Use <html><pre>ou escape seu texto. Eu também tive que usar <font size=3>para deixá-lo um tanto decente.

NateS
fonte