- java.lang.Object
-
- javax.swing.text.Utilities
-
public class Utilities extends Object
A collection of methods to deal with various text related activities.
-
-
Constructor Summary
Constructors Constructor and Description Utilities()
-
Method Summary
Methods Modifier and Type Method and Description static int
drawTabbedText(Segment s, int x, int y, Graphics g, TabExpander e, int startOffset)
Draws the given text, expanding any tabs that are contained using the given tab expansion technique.static int
getBreakLocation(Segment s, FontMetrics metrics, int x0, int x, TabExpander e, int startOffset)
Determine where to break the given text to fit within the given span.static int
getNextWord(JTextComponent c, int offs)
Determines the start of the next word for the given location.static Element
getParagraphElement(JTextComponent c, int offs)
Determines the element to use for a paragraph/line.static int
getPositionAbove(JTextComponent c, int offs, int x)
Determines the position in the model that is closest to the given view location in the row above.static int
getPositionBelow(JTextComponent c, int offs, int x)
Determines the position in the model that is closest to the given view location in the row below.static int
getPreviousWord(JTextComponent c, int offs)
Determine the start of the prev word for the given location.static int
getRowEnd(JTextComponent c, int offs)
Determines the ending row model position of the row that contains the specified model position.static int
getRowStart(JTextComponent c, int offs)
Determines the starting row model position of the row that contains the specified model position.static int
getTabbedTextOffset(Segment s, FontMetrics metrics, int x0, int x, TabExpander e, int startOffset)
Determines the relative offset into the given text that best represents the given span in the view coordinate system.static int
getTabbedTextOffset(Segment s, FontMetrics metrics, int x0, int x, TabExpander e, int startOffset, boolean round)
static int
getTabbedTextWidth(Segment s, FontMetrics metrics, int x, TabExpander e, int startOffset)
Determines the width of the given segment of text taking tabs into consideration.static int
getWordEnd(JTextComponent c, int offs)
Determines the end of a word for the given location.static int
getWordStart(JTextComponent c, int offs)
Determines the start of a word for the given model location.
-
-
-
Method Detail
-
drawTabbedText
public static final int drawTabbedText(Segment s, int x, int y, Graphics g, TabExpander e, int startOffset)
Draws the given text, expanding any tabs that are contained using the given tab expansion technique. This particular implementation renders in a 1.1 style coordinate system where ints are used and 72dpi is assumed.- Parameters:
s
- the source of the textx
- the X origin >= 0y
- the Y origin >= 0g
- the graphics contexte
- how to expand the tabs. If this value is null, tabs will be expanded as a space character.startOffset
- starting offset of the text in the document >= 0- Returns:
- the X location at the end of the rendered text
-
getTabbedTextWidth
public static final int getTabbedTextWidth(Segment s, FontMetrics metrics, int x, TabExpander e, int startOffset)
Determines the width of the given segment of text taking tabs into consideration. This is implemented in a 1.1 style coordinate system where ints are used and 72dpi is assumed.- Parameters:
s
- the source of the textmetrics
- the font metrics to use for the calculationx
- the X origin >= 0e
- how to expand the tabs. If this value is null, tabs will be expanded as a space character.startOffset
- starting offset of the text in the document >= 0- Returns:
- the width of the text
-
getTabbedTextOffset
public static final int getTabbedTextOffset(Segment s, FontMetrics metrics, int x0, int x, TabExpander e, int startOffset)
Determines the relative offset into the given text that best represents the given span in the view coordinate system. This is implemented in a 1.1 style coordinate system where ints are used and 72dpi is assumed.- Parameters:
s
- the source of the textmetrics
- the font metrics to use for the calculationx0
- the starting view location representing the start of the given text >= 0.x
- the target view location to translate to an offset into the text >= 0.e
- how to expand the tabs. If this value is null, tabs will be expanded as a space character.startOffset
- starting offset of the text in the document >= 0- Returns:
- the offset into the text >= 0
-
getTabbedTextOffset
public static final int getTabbedTextOffset(Segment s, FontMetrics metrics, int x0, int x, TabExpander e, int startOffset, boolean round)
-
getBreakLocation
public static final int getBreakLocation(Segment s, FontMetrics metrics, int x0, int x, TabExpander e, int startOffset)
Determine where to break the given text to fit within the given span. This tries to find a word boundary.- Parameters:
s
- the source of the textmetrics
- the font metrics to use for the calculationx0
- the starting view location representing the start of the given text.x
- the target view location to translate to an offset into the text.e
- how to expand the tabs. If this value is null, tabs will be expanded as a space character.startOffset
- starting offset in the document of the text- Returns:
- the offset into the given text
-
getRowStart
public static final int getRowStart(JTextComponent c, int offs) throws BadLocationException
Determines the starting row model position of the row that contains the specified model position. The component given must have a size to compute the result. If the component doesn't have a size a value of -1 will be returned.- Parameters:
c
- the editoroffs
- the offset in the document >= 0- Returns:
- the position >= 0 if the request can be computed, otherwise a value of -1 will be returned.
- Throws:
BadLocationException
- if the offset is out of range
-
getRowEnd
public static final int getRowEnd(JTextComponent c, int offs) throws BadLocationException
Determines the ending row model position of the row that contains the specified model position. The component given must have a size to compute the result. If the component doesn't have a size a value of -1 will be returned.- Parameters:
c
- the editoroffs
- the offset in the document >= 0- Returns:
- the position >= 0 if the request can be computed, otherwise a value of -1 will be returned.
- Throws:
BadLocationException
- if the offset is out of range
-
getPositionAbove
public static final int getPositionAbove(JTextComponent c, int offs, int x) throws BadLocationException
Determines the position in the model that is closest to the given view location in the row above. The component given must have a size to compute the result. If the component doesn't have a size a value of -1 will be returned.- Parameters:
c
- the editoroffs
- the offset in the document >= 0x
- the X coordinate >= 0- Returns:
- the position >= 0 if the request can be computed, otherwise a value of -1 will be returned.
- Throws:
BadLocationException
- if the offset is out of range
-
getPositionBelow
public static final int getPositionBelow(JTextComponent c, int offs, int x) throws BadLocationException
Determines the position in the model that is closest to the given view location in the row below. The component given must have a size to compute the result. If the component doesn't have a size a value of -1 will be returned.- Parameters:
c
- the editoroffs
- the offset in the document >= 0x
- the X coordinate >= 0- Returns:
- the position >= 0 if the request can be computed, otherwise a value of -1 will be returned.
- Throws:
BadLocationException
- if the offset is out of range
-
getWordStart
public static final int getWordStart(JTextComponent c, int offs) throws BadLocationException
Determines the start of a word for the given model location. Uses BreakIterator.getWordInstance() to actually get the words.- Parameters:
c
- the editoroffs
- the offset in the document >= 0- Returns:
- the location in the model of the word start >= 0
- Throws:
BadLocationException
- if the offset is out of range
-
getWordEnd
public static final int getWordEnd(JTextComponent c, int offs) throws BadLocationException
Determines the end of a word for the given location. Uses BreakIterator.getWordInstance() to actually get the words.- Parameters:
c
- the editoroffs
- the offset in the document >= 0- Returns:
- the location in the model of the word end >= 0
- Throws:
BadLocationException
- if the offset is out of range
-
getNextWord
public static final int getNextWord(JTextComponent c, int offs) throws BadLocationException
Determines the start of the next word for the given location. Uses BreakIterator.getWordInstance() to actually get the words.- Parameters:
c
- the editoroffs
- the offset in the document >= 0- Returns:
- the location in the model of the word start >= 0
- Throws:
BadLocationException
- if the offset is out of range
-
getPreviousWord
public static final int getPreviousWord(JTextComponent c, int offs) throws BadLocationException
Determine the start of the prev word for the given location. Uses BreakIterator.getWordInstance() to actually get the words.- Parameters:
c
- the editoroffs
- the offset in the document >= 0- Returns:
- the location in the model of the word start >= 0
- Throws:
BadLocationException
- if the offset is out of range
-
getParagraphElement
public static final Element getParagraphElement(JTextComponent c, int offs)
Determines the element to use for a paragraph/line.- Parameters:
c
- the editoroffs
- the starting offset in the document >= 0- Returns:
- the element
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-javax/swing/text/utilities.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.