| /******************************************************************************* |
| * Copyright (c) 2000, 2010 IBM Corporation and others. |
| * All rights reserved. This program and the accompanying materials |
| * are made available under the terms of the Eclipse Public License v1.0 |
| * which accompanies this distribution, and is available at |
| * http://www.eclipse.org/legal/epl-v10.html |
| * |
| * Contributors: |
| * IBM Corporation - initial API and implementation |
| *******************************************************************************/ |
| package org.eclipse.swt.graphics; |
| |
| import org.eclipse.swt.internal.*; |
| import org.eclipse.swt.internal.motif.*; |
| import org.eclipse.swt.*; |
| |
| /** |
| * <code>TextLayout</code> is a graphic object that represents |
| * styled text. |
| * <p> |
| * Instances of this class provide support for drawing, cursor |
| * navigation, hit testing, text wrapping, alignment, tab expansion |
| * line breaking, etc. These are aspects required for rendering internationalized text. |
| * </p><p> |
| * Application code must explicitly invoke the <code>TextLayout#dispose()</code> |
| * method to release the operating system resources managed by each instance |
| * when those instances are no longer required. |
| * </p> |
| * |
| * @see <a href="http://www.eclipse.org/swt/snippets/#textlayout">TextLayout, TextStyle snippets</a> |
| * @see <a href="http://www.eclipse.org/swt/examples.php">SWT Example: CustomControlExample, StyledText tab</a> |
| * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> |
| * |
| * @since 3.0 |
| */ |
| public final class TextLayout extends Resource { |
| Font font; |
| String text; |
| int lineSpacing; |
| int ascent, descent; |
| int alignment; |
| int wrapWidth; |
| int orientation; |
| int indent, wrapIndent; |
| boolean justify; |
| int[] tabs; |
| int[] segments; |
| char[] segmentsChars; |
| StyleItem[] styles; |
| |
| StyleItem[][] runs; |
| int[] lineOffset, lineY, lineWidth; |
| int defaultAscent, defaultDescent; |
| |
| static final RGB LINK_FOREGROUND = new RGB (0, 51, 153); |
| |
| static class StyleItem { |
| TextStyle style; |
| int start, length, width, height, baseline; |
| boolean lineBreak, softBreak, tab; |
| |
| public String toString () { |
| return "StyleItem {" + start + ", " + style + "}"; |
| } |
| } |
| |
| /** |
| * Constructs a new instance of this class on the given device. |
| * <p> |
| * You must dispose the text layout when it is no longer required. |
| * </p> |
| * |
| * @param device the device on which to allocate the text layout |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_NULL_ARGUMENT - if device is null and there is no current device</li> |
| * </ul> |
| * |
| * @see #dispose() |
| */ |
| public TextLayout (Device device) { |
| super(device); |
| wrapWidth = ascent = descent = -1; |
| lineSpacing = 0; |
| orientation = SWT.LEFT_TO_RIGHT; |
| XFontStruct fontStruct = getFontHeigth(this.device.getSystemFont()); |
| defaultAscent = fontStruct.ascent; |
| defaultDescent = fontStruct.descent; |
| styles = new StyleItem[2]; |
| styles[0] = new StyleItem(); |
| styles[1] = new StyleItem(); |
| text = ""; //$NON-NLS-1$ |
| init(); |
| } |
| |
| void checkLayout () { |
| if (isDisposed()) SWT.error(SWT.ERROR_GRAPHIC_DISPOSED); |
| } |
| |
| int stringWidth (StyleItem run, char[] ch) { |
| if (ch.length == 0) return 0; |
| Font font = getItemFont(run); |
| int fontList = font.handle; |
| byte[] buffer = Converter.wcsToMbcs(font.codePage, ch, true); |
| int xmString = OS.XmStringCreateLocalized(buffer); |
| int width = OS.XmStringWidth(fontList, xmString); |
| OS.XmStringFree(xmString); |
| return width; |
| } |
| |
| void computeRuns () { |
| if (runs != null) return; |
| StyleItem[] allRuns = itemize(); |
| for (int i=0; i<allRuns.length-1; i++) { |
| StyleItem run = allRuns[i]; |
| place(run); |
| } |
| int lineWidth = indent, lineStart = 0, lineCount = 1; |
| for (int i=0; i<allRuns.length - 1; i++) { |
| StyleItem run = allRuns[i]; |
| if (run.length == 1) { |
| char ch = text.charAt(run.start); |
| switch (ch) { |
| case '\t': { |
| run.tab = true; |
| run.baseline = 0; |
| if (tabs == null) break; |
| int tabsLength = tabs.length, j; |
| for (j = 0; j < tabsLength; j++) { |
| if (tabs[j] > lineWidth) { |
| run.width = tabs[j] - lineWidth; |
| break; |
| } |
| } |
| if (j == tabsLength) { |
| int tabX = tabs[tabsLength-1]; |
| int lastTabWidth = tabsLength > 1 ? tabs[tabsLength-1] - tabs[tabsLength-2] : tabs[0]; |
| if (lastTabWidth > 0) { |
| while (tabX <= lineWidth) tabX += lastTabWidth; |
| run.width = tabX - lineWidth; |
| } |
| } |
| break; |
| } |
| case '\n': |
| run.lineBreak = true; |
| run.baseline = run.width = 0; |
| break; |
| case '\r': |
| run.lineBreak = true; |
| run.baseline = run.width = 0; |
| StyleItem next = allRuns[i + 1]; |
| if (next.length != 0 && text.charAt(next.start) == '\n') { |
| run.length += 1; |
| i++; |
| } |
| break; |
| } |
| } |
| if (wrapWidth != -1 && lineWidth + run.width > wrapWidth && !run.tab && run.length > 0) { |
| int start = 0; |
| char[] chars = new char[run.length]; |
| text.getChars(run.start, run.start + run.length, chars, 0); |
| if (!(run.style != null && run.style.metrics != null)) { |
| int width = 0, maxWidth = wrapWidth - lineWidth; |
| char[] buffer = new char[1]; |
| buffer[0] = chars[start]; |
| int charWidth = stringWidth(run, buffer); |
| while (width + charWidth < maxWidth) { |
| width += charWidth; |
| start++; |
| buffer[0] = chars[start]; |
| charWidth = stringWidth(run, buffer); |
| } |
| } |
| int firstStart = start; |
| int firstIndice = i; |
| while (i >= lineStart) { |
| chars = new char[run.length]; |
| text.getChars(run.start, run.start + run.length, chars, 0); |
| while(start >= 0) { |
| if (Compatibility.isSpaceChar(chars[start]) || Compatibility.isWhitespace(chars[start])) break; |
| start--; |
| } |
| if (start >= 0 || i == lineStart) break; |
| run = allRuns[--i]; |
| start = run.length - 1; |
| } |
| if (start == 0 && i != lineStart) { |
| run = allRuns[--i]; |
| } else if (start <= 0 && i == lineStart) { |
| i = firstIndice; |
| run = allRuns[i]; |
| start = Math.max(1, firstStart); |
| } |
| chars = new char[run.length]; |
| text.getChars(run.start, run.start + run.length, chars, 0); |
| while (start < run.length) { |
| if (!Compatibility.isWhitespace(chars[start])) break; |
| start++; |
| } |
| if (0 < start && start < run.length) { |
| StyleItem newRun = new StyleItem(); |
| newRun.start = run.start + start; |
| newRun.length = run.length - start; |
| newRun.style = run.style; |
| run.length = start; |
| place (run); |
| place (newRun); |
| StyleItem[] newAllRuns = new StyleItem[allRuns.length + 1]; |
| System.arraycopy(allRuns, 0, newAllRuns, 0, i + 1); |
| System.arraycopy(allRuns, i + 1, newAllRuns, i + 2, allRuns.length - i - 1); |
| allRuns = newAllRuns; |
| allRuns[i + 1] = newRun; |
| } |
| if (i != allRuns.length - 2) { |
| run.softBreak = run.lineBreak = true; |
| } |
| } |
| lineWidth += run.width; |
| if (run.lineBreak) { |
| lineStart = i + 1; |
| lineWidth = run.softBreak ? wrapIndent : indent;; |
| lineCount++; |
| } |
| } |
| lineWidth = 0; |
| runs = new StyleItem[lineCount][]; |
| lineOffset = new int[lineCount + 1]; |
| lineY = new int[lineCount + 1]; |
| this.lineWidth = new int[lineCount]; |
| int lineRunCount = 0, line = 0; |
| int ascent = Math.max(defaultAscent, this.ascent); |
| int descent = Math.max(defaultDescent, this.descent); |
| StyleItem[] lineRuns = new StyleItem[allRuns.length]; |
| XFontStruct fontStruct; |
| for (int i=0; i<allRuns.length; i++) { |
| StyleItem run = allRuns[i]; |
| lineRuns[lineRunCount++] = run; |
| lineWidth += run.width; |
| if (run.style != null ) { |
| int runAscent = defaultAscent; |
| int runDescent = defaultDescent; |
| if (run.style.metrics != null) { |
| GlyphMetrics metrics = run.style.metrics; |
| runAscent = metrics.ascent; |
| runDescent = metrics.descent; |
| } else if (run.style.font != null) { |
| fontStruct = getFontHeigth(run.style.font); |
| runAscent = fontStruct.ascent; |
| runDescent = fontStruct.descent; |
| } |
| ascent = Math.max(ascent, runAscent + run.style.rise); |
| descent = Math.max(descent, runDescent - run.style.rise); |
| if (run.style.rise != 0) { |
| run.baseline += run.style.rise; |
| } |
| } |
| if (run.lineBreak || i == allRuns.length - 1) { |
| runs[line] = new StyleItem[lineRunCount]; |
| System.arraycopy(lineRuns, 0, runs[line], 0, lineRunCount); |
| StyleItem lastRun = runs[line][lineRunCount - 1]; |
| this.lineWidth[line] = lineWidth; |
| line++; |
| lineY[line] = lineY[line - 1] + ascent + descent + lineSpacing; |
| lineOffset[line] = lastRun.start + lastRun.length; |
| lineRunCount = lineWidth = 0; |
| ascent = Math.max(defaultAscent, this.ascent); |
| descent = Math.max(defaultDescent, this.descent); |
| } |
| } |
| } |
| |
| void destroy() { |
| freeRuns(); |
| font = null; |
| text = null; |
| tabs = null; |
| styles = null; |
| lineOffset = null; |
| lineY = null; |
| lineWidth = null; |
| segments = null; |
| segmentsChars = null; |
| } |
| |
| /** |
| * Draws the receiver's text using the specified GC at the specified |
| * point. |
| * |
| * @param gc the GC to draw |
| * @param x the x coordinate of the top left corner of the rectangular area where the text is to be drawn |
| * @param y the y coordinate of the top left corner of the rectangular area where the text is to be drawn |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_NULL_ARGUMENT - if the gc is null</li> |
| * </ul> |
| */ |
| public void draw (GC gc, int x, int y) { |
| draw(gc, x, y, -1, -1, null, null); |
| } |
| |
| /** |
| * Draws the receiver's text using the specified GC at the specified |
| * point. |
| * |
| * @param gc the GC to draw |
| * @param x the x coordinate of the top left corner of the rectangular area where the text is to be drawn |
| * @param y the y coordinate of the top left corner of the rectangular area where the text is to be drawn |
| * @param selectionStart the offset where the selections starts, or -1 indicating no selection |
| * @param selectionEnd the offset where the selections ends, or -1 indicating no selection |
| * @param selectionForeground selection foreground, or NULL to use the system default color |
| * @param selectionBackground selection background, or NULL to use the system default color |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_NULL_ARGUMENT - if the gc is null</li> |
| * </ul> |
| */ |
| public void draw(GC gc, int x, int y, int selectionStart, int selectionEnd, Color selectionForeground, Color selectionBackground) { |
| draw(gc, x, y, selectionStart, selectionEnd, selectionForeground, selectionBackground, 0); |
| } |
| |
| /** |
| * Draws the receiver's text using the specified GC at the specified |
| * point. |
| * <p> |
| * The parameter <code>flags</code> can include one of <code>SWT.DELIMITER_SELECTION</code> |
| * or <code>SWT.FULL_SELECTION</code> to specify the selection behavior on all lines except |
| * for the last line, and can also include <code>SWT.LAST_LINE_SELECTION</code> to extend |
| * the specified selection behavior to the last line. |
| * </p> |
| * @param gc the GC to draw |
| * @param x the x coordinate of the top left corner of the rectangular area where the text is to be drawn |
| * @param y the y coordinate of the top left corner of the rectangular area where the text is to be drawn |
| * @param selectionStart the offset where the selections starts, or -1 indicating no selection |
| * @param selectionEnd the offset where the selections ends, or -1 indicating no selection |
| * @param selectionForeground selection foreground, or NULL to use the system default color |
| * @param selectionBackground selection background, or NULL to use the system default color |
| * @param flags drawing options |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_NULL_ARGUMENT - if the gc is null</li> |
| * </ul> |
| * |
| * @since 3.3 |
| */ |
| public void draw(GC gc, int x, int y, int selectionStart, int selectionEnd, Color selectionForeground, Color selectionBackground, int flags) { |
| checkLayout(); |
| computeRuns(); |
| if (gc == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); |
| if (gc.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); |
| if (selectionForeground != null && selectionForeground.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); |
| if (selectionBackground != null && selectionBackground.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); |
| gc.checkGC(GC.FOREGROUND); |
| int length = text.length(); |
| if (length == 0 && flags == 0) return; |
| boolean hasSelection = selectionStart <= selectionEnd && selectionStart != -1 && selectionEnd != -1; |
| if (hasSelection || ((flags & SWT.LAST_LINE_SELECTION) != 0 && (flags & (SWT.FULL_SELECTION | SWT.DELIMITER_SELECTION)) != 0)) { |
| selectionStart = Math.min(Math.max(0, selectionStart), length - 1); |
| selectionEnd = Math.min(Math.max(0, selectionEnd), length - 1); |
| if (selectionForeground == null) selectionForeground = device.getSystemColor(SWT.COLOR_LIST_SELECTION_TEXT); |
| if (selectionBackground == null) selectionBackground = device.getSystemColor(SWT.COLOR_LIST_SELECTION); |
| } |
| final Color foreground = gc.getForeground(); |
| final Color background = gc.getBackground(); |
| final Font gcFont = gc.getFont(); |
| Color linkColor = null; |
| Rectangle clip = gc.getClipping(); |
| for (int line=0; line<runs.length; line++) { |
| int drawX = x + getLineIndent(line); |
| int drawY = y + lineY[line]; |
| StyleItem[] lineRuns = runs[line]; |
| int lineHeight = lineY[line+1] - lineY[line]; |
| if ((flags & (SWT.FULL_SELECTION | SWT.DELIMITER_SELECTION)) != 0 && (hasSelection || (flags & SWT.LAST_LINE_SELECTION) != 0)) { |
| boolean extent = false; |
| if (line == runs.length - 1 && (flags & SWT.LAST_LINE_SELECTION) != 0) { |
| extent = true; |
| } else { |
| StyleItem run = lineRuns[lineRuns.length - 1]; |
| if (run.lineBreak && !run.softBreak) { |
| if (selectionStart <= run.start && run.start <= selectionEnd) extent = true; |
| } else { |
| int endOffset = run.start + run.length - 1; |
| if (selectionStart <= endOffset && endOffset < selectionEnd && (flags & SWT.FULL_SELECTION) != 0) { |
| extent = true; |
| } |
| } |
| } |
| if (extent) { |
| gc.setBackground(selectionBackground); |
| int width = (flags & SWT.FULL_SELECTION) != 0 ? 0x7fffffff : lineHeight / 3; |
| gc.fillRectangle(drawX + lineWidth[line], drawY, width, lineHeight); |
| } |
| } |
| if (drawX > clip.x + clip.width) continue; |
| if (drawX + lineWidth[line] < clip.x) continue; |
| int baseline = Math.max(0, this.ascent); |
| for (int i = 0; i < lineRuns.length; i++) { |
| baseline = Math.max(baseline, lineRuns[i].baseline); |
| } |
| for (int i = 0; i < lineRuns.length; i++) { |
| StyleItem run = lineRuns[i]; |
| if (run.length == 0) continue; |
| if (drawX > clip.x + clip.width) break; |
| if (drawX + run.width >= clip.x) { |
| if (!run.lineBreak || run.softBreak) { |
| String string = text.substring(run.start, run.start + run.length); |
| int drawRunY = drawY + (baseline - run.baseline); |
| int end = run.start + run.length - 1; |
| gc.setFont(getItemFont(run)); |
| boolean fullSelection = hasSelection && selectionStart <= run.start && selectionEnd >= end; |
| TextStyle style = run.style; |
| if (fullSelection) { |
| gc.setBackground(selectionBackground); |
| gc.fillRectangle(drawX, drawY, run.width, lineHeight); |
| if (!run.tab && !(style != null && style.metrics != null)) { |
| gc.setForeground(selectionForeground); |
| gc.drawString(string, drawX, drawRunY, true); |
| drawLines(gc, run, drawX, drawRunY, run.width); |
| } |
| } else { |
| if (style != null && style.background != null) { |
| Color bg = style.background; |
| gc.setBackground(bg); |
| gc.fillRectangle(drawX, drawRunY, run.width, run.height); |
| } |
| if (!run.tab) { |
| Color fg = foreground; |
| if (style != null) { |
| if (style.foreground != null) { |
| fg = style.foreground; |
| } else { |
| if (style.underline && style.underlineStyle == SWT.UNDERLINE_LINK) { |
| if (linkColor == null) { |
| linkColor = new Color(device, LINK_FOREGROUND); |
| } |
| fg = linkColor; |
| } |
| } |
| } |
| if (!(style != null && style.metrics != null)) { |
| gc.setForeground(fg); |
| gc.drawString(string, drawX, drawRunY, true); |
| drawLines(gc, run, drawX, drawRunY, run.width); |
| } |
| boolean partialSelection = hasSelection && !(selectionStart > end || run.start > selectionEnd); |
| if (partialSelection) { |
| int selStart = Math.max(selectionStart, run.start); |
| int selEnd = Math.min(selectionEnd, end); |
| string = text.substring(run.start, selStart); |
| int selX = drawX + gc.stringExtent(string).x; |
| string = text.substring(selStart, selEnd + 1); |
| int selWidth = gc.stringExtent(string).x; |
| gc.setBackground(selectionBackground); |
| gc.fillRectangle(selX, drawY, selWidth, lineHeight); |
| if (fg != selectionForeground && !(style != null && style.metrics != null)) { |
| gc.setForeground(selectionForeground); |
| gc.drawString(string, selX, drawRunY, true); |
| drawLines(gc, run, selX, drawRunY, selWidth); |
| } |
| } |
| } |
| } |
| drawBorder(gc, lineRuns, i, drawX, drawY, lineHeight, foreground); |
| } |
| } |
| drawX += run.width; |
| } |
| } |
| gc.setForeground(foreground); |
| gc.setBackground(background); |
| gc.setFont(gcFont); |
| if (linkColor != null) linkColor.dispose(); |
| } |
| |
| void drawBorder(GC gc, StyleItem[] line, int index, int x, int y, int lineHeight, Color color) { |
| StyleItem run = line[index]; |
| TextStyle style = run.style; |
| if (style == null) return; |
| if (style.borderStyle != SWT.NONE && (index + 1 >= line.length || !style.isAdherentBorder(line[index + 1].style))) { |
| int width = run.width; |
| for (int i = index; i > 0 && style.isAdherentBorder(line[i - 1].style); i--) { |
| x -= line[i - 1].width; |
| width += line[i - 1].width; |
| } |
| if (style.borderColor != null) { |
| color = style.borderColor; |
| } else { |
| if (style.foreground != null) { |
| color = style.foreground; |
| } |
| } |
| gc.setForeground(color); |
| int lineStyle = gc.getLineStyle(); |
| int[] dashes = null; |
| if (lineStyle == SWT.LINE_CUSTOM) { |
| dashes = gc.getLineDash(); |
| } |
| switch (style.borderStyle) { |
| case SWT.BORDER_SOLID: |
| gc.setLineStyle(SWT.LINE_SOLID); |
| break; |
| case SWT.BORDER_DASH: |
| gc.setLineStyle(SWT.LINE_DASH); |
| break; |
| case SWT.BORDER_DOT: |
| gc.setLineStyle(SWT.LINE_DOT); |
| break; |
| } |
| gc.drawRectangle(x, y, width - 1, lineHeight - 1); |
| gc.setLineStyle(lineStyle); |
| if (dashes != null) { |
| gc.setLineDash(dashes); |
| } |
| } |
| } |
| |
| void drawLines(GC gc, StyleItem run, int x, int y, int width) { |
| TextStyle style = run.style; |
| if (style == null) return; |
| if (style.underline) { |
| int underlineY = y + run.baseline + 1 - style.rise; |
| if (style.underlineColor != null) { |
| gc.setForeground(style.underlineColor); |
| } |
| switch (style.underlineStyle) { |
| case SWT.UNDERLINE_SQUIGGLE: |
| case SWT.UNDERLINE_ERROR: |
| int squigglyThickness = 1; |
| int squigglyHeight = 2 * squigglyThickness; |
| int squigglyY = Math.min(underlineY, y + run.height - squigglyHeight - 1); |
| int[] points = computePolyline(x, squigglyY, x + width, squigglyY + squigglyHeight); |
| gc.drawPolyline(points); |
| break; |
| case SWT.UNDERLINE_DOUBLE: |
| gc.drawLine (x, underlineY + 2, x + width, underlineY + 2); |
| //FALLTHROU |
| case SWT.UNDERLINE_LINK: |
| case SWT.UNDERLINE_SINGLE: |
| gc.drawLine (x, underlineY, x + width, underlineY); |
| } |
| } |
| if (style.strikeout) { |
| int strikeoutY = y + run.height - run.height/2 - 1; |
| if (style.strikeoutColor != null) { |
| gc.setForeground(style.strikeoutColor); |
| } |
| gc.drawLine (x, strikeoutY, x + width, strikeoutY); |
| } |
| } |
| |
| int[] computePolyline(int left, int top, int right, int bottom) { |
| int height = bottom - top; // can be any number |
| int width = 2 * height; // must be even |
| int peaks = (right - left) / width; |
| if (peaks == 0 && right - left > 2) { |
| peaks = 1; |
| } |
| int length = ((2 * peaks) + 1) * 2; |
| if (length < 0) return new int[0]; |
| |
| int[] coordinates = new int[length]; |
| for (int i = 0; i < peaks; i++) { |
| int index = 4 * i; |
| coordinates[index] = left + (width * i); |
| coordinates[index+1] = bottom; |
| coordinates[index+2] = coordinates[index] + width / 2; |
| coordinates[index+3] = top; |
| } |
| coordinates[length-2] = Math.min(Math.max(0, right - 1), left + (width * peaks)); |
| coordinates[length-1] = bottom; |
| return coordinates; |
| } |
| |
| void freeRuns() { |
| runs = null; |
| } |
| |
| /** |
| * Returns the receiver's horizontal text alignment, which will be one |
| * of <code>SWT.LEFT</code>, <code>SWT.CENTER</code> or |
| * <code>SWT.RIGHT</code>. |
| * |
| * @return the alignment used to positioned text horizontally |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public int getAlignment () { |
| checkLayout(); |
| return alignment; |
| } |
| |
| /** |
| * Returns the ascent of the receiver. |
| * |
| * @return the ascent |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #getDescent() |
| * @see #setDescent(int) |
| * @see #setAscent(int) |
| * @see #getLineMetrics(int) |
| */ |
| public int getAscent () { |
| checkLayout(); |
| return ascent; |
| } |
| |
| /** |
| * Returns the bounds of the receiver. The width returned is either the |
| * width of the longest line or the width set using {@link TextLayout#setWidth(int)}. |
| * To obtain the text bounds of a line use {@link TextLayout#getLineBounds(int)}. |
| * |
| * @return the bounds of the receiver |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #setWidth(int) |
| * @see #getLineBounds(int) |
| */ |
| public Rectangle getBounds () { |
| checkLayout(); |
| computeRuns(); |
| int width = 0; |
| if (wrapWidth != -1) { |
| width = wrapWidth; |
| } else { |
| for (int line=0; line<runs.length; line++) { |
| width = Math.max(width, lineWidth[line] + getLineIndent(line)); |
| } |
| } |
| return new Rectangle (0, 0, width, lineY[lineY.length - 1]); |
| } |
| |
| /** |
| * Returns the bounds for the specified range of characters. The |
| * bounds is the smallest rectangle that encompasses all characters |
| * in the range. The start and end offsets are inclusive and will be |
| * clamped if out of range. |
| * |
| * @param start the start offset |
| * @param end the end offset |
| * @return the bounds of the character range |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public Rectangle getBounds (int start, int end) { |
| checkLayout(); |
| computeRuns(); |
| int length = text.length(); |
| if (length == 0) return new Rectangle(0, 0, 0, 0); |
| if (start > end) return new Rectangle(0, 0, 0, 0); |
| start = Math.min(Math.max(0, start), length - 1); |
| end = Math.min(Math.max(0, end), length - 1); |
| int startLine = getLineIndex(start); |
| int endLine = getLineIndex(end); |
| |
| Rectangle rect = new Rectangle(0, 0, 0, 0); |
| rect.y = lineY[startLine]; |
| rect.height = lineY[endLine + 1] - rect.y - lineSpacing; |
| if (startLine == endLine) { |
| rect.x = getLocation(start, false).x; |
| rect.width = getLocation(end, true).x - rect.x; |
| } else { |
| while (startLine <= endLine) { |
| rect.width = Math.max(rect.width, lineWidth[startLine++]); |
| } |
| } |
| return rect; |
| } |
| |
| /** |
| * Returns the descent of the receiver. |
| * |
| * @return the descent |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #getAscent() |
| * @see #setAscent(int) |
| * @see #setDescent(int) |
| * @see #getLineMetrics(int) |
| */ |
| public int getDescent () { |
| checkLayout(); |
| return descent; |
| } |
| |
| /** |
| * Returns the default font currently being used by the receiver |
| * to draw and measure text. |
| * |
| * @return the receiver's font |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public Font getFont () { |
| checkLayout(); |
| return font; |
| } |
| |
| XFontStruct getFontHeigth(Font font) { |
| int fontList = font.handle; |
| int [] buffer = new int [1]; |
| if (!OS.XmFontListInitFontContext (buffer, fontList)) { |
| SWT.error(SWT.ERROR_NO_HANDLES); |
| } |
| int context = buffer [0]; |
| int ascent = 0, descent = 0; |
| XFontStruct fontStruct = new XFontStruct (); |
| int fontListEntry; |
| int [] fontStructPtr = new int [1]; |
| int [] fontNamePtr = new int [1]; |
| while ((fontListEntry = OS.XmFontListNextEntry (context)) != 0) { |
| int fontPtr = OS.XmFontListEntryGetFont (fontListEntry, buffer); |
| if (buffer [0] == 0) { |
| OS.memmove (fontStruct, fontPtr, XFontStruct.sizeof); |
| ascent = Math.max(ascent, fontStruct.ascent); |
| descent = Math.max(descent, fontStruct.descent); |
| } else { |
| int nFonts = OS.XFontsOfFontSet (fontPtr, fontStructPtr, fontNamePtr); |
| int [] fontStructs = new int [nFonts]; |
| OS.memmove (fontStructs, fontStructPtr [0], nFonts * 4); |
| for (int i=0; i<nFonts; i++) { |
| OS.memmove (fontStruct, fontStructs[i], XFontStruct.sizeof); |
| ascent = Math.max(ascent, fontStruct.ascent); |
| descent = Math.max(descent, fontStruct.descent); |
| } |
| } |
| } |
| OS.XmFontListFreeFontContext (context); |
| fontStruct.ascent = ascent; |
| fontStruct.descent = descent; |
| return fontStruct; |
| } |
| |
| /** |
| * Returns the receiver's indent. |
| * |
| * @return the receiver's indent |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @since 3.2 |
| */ |
| public int getIndent () { |
| checkLayout(); |
| return indent; |
| } |
| |
| /** |
| * Returns the receiver's justification. |
| * |
| * @return the receiver's justification |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @since 3.2 |
| */ |
| public boolean getJustify () { |
| checkLayout(); |
| return justify; |
| } |
| |
| /** |
| * Returns the embedding level for the specified character offset. The |
| * embedding level is usually used to determine the directionality of a |
| * character in bidirectional text. |
| * |
| * @param offset the character offset |
| * @return the embedding level |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_INVALID_ARGUMENT - if the character offset is out of range</li> |
| * </ul> |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| */ |
| public int getLevel (int offset) { |
| checkLayout(); |
| int length = text.length(); |
| if (!(0 <= offset && offset <= length)) SWT.error(SWT.ERROR_INVALID_RANGE); |
| return 0; |
| } |
| |
| /** |
| * Returns the line offsets. Each value in the array is the |
| * offset for the first character in a line except for the last |
| * value, which contains the length of the text. |
| * |
| * @return the line offsets |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public int[] getLineOffsets () { |
| checkLayout(); |
| computeRuns(); |
| int[] offsets = new int[lineOffset.length]; |
| System.arraycopy(lineOffset, 0, offsets, 0, offsets.length); |
| return offsets; |
| } |
| |
| /** |
| * Returns the bounds of the line for the specified line index. |
| * |
| * @param lineIndex the line index |
| * @return the line bounds |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_INVALID_ARGUMENT - if the line index is out of range</li> |
| * </ul> |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public Rectangle getLineBounds(int lineIndex) { |
| checkLayout(); |
| computeRuns(); |
| if (!(0 <= lineIndex && lineIndex < runs.length)) SWT.error(SWT.ERROR_INVALID_RANGE); |
| int x = getLineIndent(lineIndex); |
| int y = lineY[lineIndex]; |
| int width = lineWidth[lineIndex]; |
| int height = lineY[lineIndex + 1] - y - lineSpacing; |
| return new Rectangle (x, y, width, height); |
| } |
| |
| /** |
| * Returns the receiver's line count. This includes lines caused |
| * by wrapping. |
| * |
| * @return the line count |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public int getLineCount () { |
| checkLayout(); |
| computeRuns(); |
| return runs.length; |
| } |
| |
| int getLineIndent (int lineIndex) { |
| int lineIndent = wrapIndent; |
| if (lineIndex == 0) { |
| lineIndent = indent; |
| } else { |
| StyleItem[] previousLine = runs[lineIndex - 1]; |
| StyleItem previousRun = previousLine[previousLine.length - 1]; |
| if (previousRun.lineBreak && !previousRun.softBreak) { |
| lineIndent = indent; |
| } |
| } |
| if (wrapWidth != -1) { |
| boolean partialLine = true; |
| // if (justify) { |
| // StyleItem[] lineRun = runs[lineIndex]; |
| // if (lineRun[lineRun.length - 1].softBreak) { |
| // partialLine = false; |
| // } |
| // } |
| if (partialLine) { |
| int lineWidth = this.lineWidth[lineIndex] + lineIndent; |
| switch (alignment) { |
| case SWT.CENTER: lineIndent += (wrapWidth - lineWidth) / 2; break; |
| case SWT.RIGHT: lineIndent += wrapWidth - lineWidth; break; |
| } |
| } |
| } |
| return lineIndent; |
| } |
| |
| /** |
| * Returns the index of the line that contains the specified |
| * character offset. |
| * |
| * @param offset the character offset |
| * @return the line index |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_INVALID_ARGUMENT - if the character offset is out of range</li> |
| * </ul> |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public int getLineIndex (int offset) { |
| checkLayout(); |
| computeRuns(); |
| int length = text.length(); |
| if (!(0 <= offset && offset <= length)) SWT.error(SWT.ERROR_INVALID_RANGE); |
| for (int line=0; line<runs.length; line++) { |
| if (lineOffset[line + 1] > offset) { |
| return line; |
| } |
| } |
| return runs.length - 1; |
| } |
| |
| /** |
| * Returns the font metrics for the specified line index. |
| * |
| * @param lineIndex the line index |
| * @return the font metrics |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_INVALID_ARGUMENT - if the line index is out of range</li> |
| * </ul> |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public FontMetrics getLineMetrics (int lineIndex) { |
| checkLayout(); |
| computeRuns(); |
| if (!(0 <= lineIndex && lineIndex < runs.length)) SWT.error(SWT.ERROR_INVALID_RANGE); |
| int ascent = Math.max(defaultAscent, this.ascent); |
| int descent = Math.max(defaultDescent, this.descent); |
| if (text.length() != 0) { |
| GC gc = new GC(device); |
| StyleItem[] lineRuns = runs[lineIndex]; |
| for (int i = 0; i < lineRuns.length; i++) { |
| StyleItem run = lineRuns[i]; |
| if (run.style != null) { |
| int runAscent = 0; |
| int runDescent = 0; |
| if (run.style.metrics != null) { |
| GlyphMetrics glyphMetrics = run.style.metrics; |
| runAscent = glyphMetrics.ascent; |
| runDescent = glyphMetrics.descent; |
| } else if (run.style.font != null) { |
| gc.setFont(run.style.font); |
| FontMetrics metrics = gc.getFontMetrics(); |
| runAscent = metrics.getAscent(); |
| runDescent = metrics.getDescent(); |
| } |
| ascent = Math.max(ascent, runAscent + run.style.rise); |
| descent = Math.max(descent, runDescent - run.style.rise); |
| } |
| } |
| gc.dispose(); |
| } |
| return FontMetrics.motif_new(ascent, descent, 0, 0, ascent + descent); |
| } |
| |
| /** |
| * Returns the location for the specified character offset. The |
| * <code>trailing</code> argument indicates whether the offset |
| * corresponds to the leading or trailing edge of the cluster. |
| * |
| * @param offset the character offset |
| * @param trailing the trailing flag |
| * @return the location of the character offset |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #getOffset(Point, int[]) |
| * @see #getOffset(int, int, int[]) |
| */ |
| public Point getLocation (int offset, boolean trailing) { |
| checkLayout(); |
| computeRuns(); |
| int length = text.length(); |
| if (!(0 <= offset && offset <= length)) SWT.error(SWT.ERROR_INVALID_RANGE); |
| int line; |
| for (line=0; line<runs.length; line++) { |
| if (lineOffset[line + 1] > offset) break; |
| } |
| line = Math.min(line, runs.length - 1); |
| StyleItem[] lineRuns = runs[line]; |
| Point result = null; |
| if (offset == length) { |
| result = new Point(lineWidth[line], lineY[line]); |
| } else { |
| int width = 0; |
| for (int i=0; i<lineRuns.length; i++) { |
| StyleItem run = lineRuns[i]; |
| int end = run.start + run.length; |
| if (run.start <= offset && offset < end) { |
| if (run.tab) { |
| if (trailing || offset == length) width += run.width; |
| } else { |
| if (trailing) offset++; |
| if (run.style != null && run.style.metrics != null) { |
| GlyphMetrics metrics = run.style.metrics; |
| width += metrics.width * (offset - run.start); |
| } else { |
| char[] chars = new char[offset - run.start]; |
| text.getChars(run.start, offset, chars, 0); |
| width += stringWidth(run, chars); |
| } |
| } |
| result = new Point(width, lineY[line]); |
| break; |
| } |
| width += run.width; |
| } |
| } |
| if (result == null) result = new Point(0, 0); |
| result.x += getLineIndent(line); |
| return result; |
| } |
| |
| Font getItemFont(StyleItem item) { |
| if (item.style != null && item.style.font != null) { |
| return item.style.font; |
| } |
| if (this.font != null) { |
| return this.font; |
| } |
| return device.systemFont; |
| } |
| |
| /** |
| * Returns the next offset for the specified offset and movement |
| * type. The movement is one of <code>SWT.MOVEMENT_CHAR</code>, |
| * <code>SWT.MOVEMENT_CLUSTER</code>, <code>SWT.MOVEMENT_WORD</code>, |
| * <code>SWT.MOVEMENT_WORD_END</code> or <code>SWT.MOVEMENT_WORD_START</code>. |
| * |
| * @param offset the start offset |
| * @param movement the movement type |
| * @return the next offset |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_INVALID_ARGUMENT - if the offset is out of range</li> |
| * </ul> |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #getPreviousOffset(int, int) |
| */ |
| public int getNextOffset (int offset, int movement) { |
| checkLayout(); |
| computeRuns(); |
| int length = text.length(); |
| if (!(0 <= offset && offset <= length)) SWT.error(SWT.ERROR_INVALID_RANGE); |
| if (offset == length) return length; |
| if ((movement & (SWT.MOVEMENT_CHAR | SWT.MOVEMENT_CLUSTER)) != 0) return offset + 1; |
| int lineEnd = 0; |
| for (int i=1; i<lineOffset.length; i++) { |
| if (lineOffset[i] > offset) { |
| lineEnd = Math.max(lineOffset[i - 1], lineOffset[i] - 1); |
| if (i == runs.length) lineEnd++; |
| break; |
| } |
| } |
| boolean previousSpaceChar = !Compatibility.isLetterOrDigit(text.charAt(offset)); |
| offset++; |
| while (offset < lineEnd) { |
| boolean spaceChar = !Compatibility.isLetterOrDigit(text.charAt(offset)); |
| if (movement == SWT.MOVEMENT_WORD || movement == SWT.MOVEMENT_WORD_END) { |
| if (spaceChar && !previousSpaceChar) break; |
| } |
| if (movement == SWT.MOVEMENT_WORD_START) { |
| if (!spaceChar && previousSpaceChar) break; |
| } |
| previousSpaceChar = spaceChar; |
| offset++; |
| } |
| return offset; |
| } |
| |
| /** |
| * Returns the character offset for the specified point. |
| * For a typical character, the trailing argument will be filled in to |
| * indicate whether the point is closer to the leading edge (0) or |
| * the trailing edge (1). When the point is over a cluster composed |
| * of multiple characters, the trailing argument will be filled with the |
| * position of the character in the cluster that is closest to |
| * the point. |
| * |
| * @param point the point |
| * @param trailing the trailing buffer |
| * @return the character offset |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_INVALID_ARGUMENT - if the trailing length is less than <code>1</code></li> |
| * <li>ERROR_NULL_ARGUMENT - if the point is null</li> |
| * </ul> |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #getLocation(int, boolean) |
| */ |
| public int getOffset (Point point, int[] trailing) { |
| checkLayout(); |
| if (point == null) SWT.error (SWT.ERROR_NULL_ARGUMENT); |
| return getOffset (point.x, point.y, trailing); |
| } |
| |
| /** |
| * Returns the character offset for the specified point. |
| * For a typical character, the trailing argument will be filled in to |
| * indicate whether the point is closer to the leading edge (0) or |
| * the trailing edge (1). When the point is over a cluster composed |
| * of multiple characters, the trailing argument will be filled with the |
| * position of the character in the cluster that is closest to |
| * the point. |
| * |
| * @param x the x coordinate of the point |
| * @param y the y coordinate of the point |
| * @param trailing the trailing buffer |
| * @return the character offset |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_INVALID_ARGUMENT - if the trailing length is less than <code>1</code></li> |
| * </ul> |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #getLocation(int, boolean) |
| */ |
| public int getOffset (int x, int y, int[] trailing) { |
| checkLayout(); |
| computeRuns(); |
| if (trailing != null && trailing.length < 1) SWT.error(SWT.ERROR_INVALID_ARGUMENT); |
| int line; |
| int lineCount = runs.length; |
| for (line=0; line<lineCount; line++) { |
| if (lineY[line + 1] > y) break; |
| } |
| line = Math.min(line, runs.length - 1); |
| x -= getLineIndent(line); |
| if (x >= lineWidth[line]) x = lineWidth[line] - 1; |
| if (x < 0) x = 0; |
| StyleItem[] lineRuns = runs[line]; |
| int width = 0; |
| for (int i = 0; i < lineRuns.length; i++) { |
| StyleItem run = lineRuns[i]; |
| if (run.lineBreak && !run.softBreak) return run.start; |
| if (width + run.width > x) { |
| if (run.style != null && run.style.metrics != null) { |
| int xRun = x - width; |
| GlyphMetrics metrics = run.style.metrics; |
| if (metrics.width > 0) { |
| if (trailing != null) { |
| trailing[0] = (xRun % metrics.width < metrics.width / 2) ? 0 : 1; |
| } |
| return run.start + xRun / metrics.width; |
| } |
| } |
| if (run.tab) { |
| if (trailing != null) { |
| trailing[0] = x < (width + run.width / 2) ? 0 : 1; |
| } |
| return run.start; |
| } |
| int offset = 0; |
| char[] buffer = new char[1]; |
| char[] chars = new char[run.length]; |
| text.getChars(run.start, run.start + run.length, chars, 0); |
| for (offset = 0; offset < chars.length; offset++) { |
| buffer[0] = chars[offset]; |
| int charWidth = stringWidth(run, buffer); |
| if (width + charWidth > x) { |
| if (trailing != null) { |
| trailing[0] = x < (width + charWidth / 2) ? 0 : 1; |
| } |
| break; |
| } |
| width += charWidth; |
| } |
| return run.start + offset; |
| } |
| width += run.width; |
| } |
| if (trailing != null) trailing[0] = 0; |
| return lineOffset[line + 1]; |
| } |
| |
| /** |
| * Returns the orientation of the receiver. |
| * |
| * @return the orientation style |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public int getOrientation () { |
| checkLayout(); |
| return orientation; |
| } |
| |
| /** |
| * Returns the previous offset for the specified offset and movement |
| * type. The movement is one of <code>SWT.MOVEMENT_CHAR</code>, |
| * <code>SWT.MOVEMENT_CLUSTER</code> or <code>SWT.MOVEMENT_WORD</code>, |
| * <code>SWT.MOVEMENT_WORD_END</code> or <code>SWT.MOVEMENT_WORD_START</code>. |
| * |
| * @param offset the start offset |
| * @param movement the movement type |
| * @return the previous offset |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_INVALID_ARGUMENT - if the offset is out of range</li> |
| * </ul> |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #getNextOffset(int, int) |
| */ |
| public int getPreviousOffset (int offset, int movement) { |
| checkLayout(); |
| computeRuns(); |
| int length = text.length(); |
| if (!(0 <= offset && offset <= length)) SWT.error(SWT.ERROR_INVALID_RANGE); |
| if (offset == 0) return 0; |
| if ((movement & (SWT.MOVEMENT_CHAR | SWT.MOVEMENT_CLUSTER)) != 0) return offset - 1; |
| int lineStart = 0; |
| for (int i=0; i<lineOffset.length-1; i++) { |
| int lineEnd = lineOffset[i+1]; |
| if (i == runs.length - 1) lineEnd++; |
| if (lineEnd > offset) { |
| lineStart = lineOffset[i]; |
| break; |
| } |
| } |
| offset--; |
| boolean previousSpaceChar = !Compatibility.isLetterOrDigit(text.charAt(offset)); |
| while (lineStart < offset) { |
| boolean spaceChar = !Compatibility.isLetterOrDigit(text.charAt(offset - 1)); |
| if (movement == SWT.MOVEMENT_WORD_END) { |
| if (!spaceChar && previousSpaceChar) break; |
| } |
| if (movement == SWT.MOVEMENT_WORD || movement == SWT.MOVEMENT_WORD_START) { |
| if (spaceChar && !previousSpaceChar) break; |
| } |
| offset--; |
| previousSpaceChar = spaceChar; |
| } |
| return offset; |
| } |
| |
| /** |
| * Gets the ranges of text that are associated with a <code>TextStyle</code>. |
| * |
| * @return the ranges, an array of offsets representing the start and end of each |
| * text style. |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #getStyles() |
| * |
| * @since 3.2 |
| */ |
| public int[] getRanges () { |
| checkLayout(); |
| int[] result = new int[styles.length * 2]; |
| int count = 0; |
| for (int i=0; i<styles.length - 1; i++) { |
| if (styles[i].style != null) { |
| result[count++] = styles[i].start; |
| result[count++] = styles[i + 1].start - 1; |
| } |
| } |
| if (count != result.length) { |
| int[] newResult = new int[count]; |
| System.arraycopy(result, 0, newResult, 0, count); |
| result = newResult; |
| } |
| return result; |
| } |
| |
| /** |
| * Returns the text segments offsets of the receiver. |
| * |
| * @return the text segments offsets |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public int[] getSegments() { |
| checkLayout(); |
| return segments; |
| } |
| |
| /** |
| * Returns the segments characters of the receiver. |
| * |
| * @return the segments characters |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @since 3.6 |
| */ |
| public char[] getSegmentsChars () { |
| checkLayout(); |
| return segmentsChars; |
| } |
| |
| /** |
| * Returns the line spacing of the receiver. |
| * |
| * @return the line spacing |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public int getSpacing () { |
| checkLayout(); |
| return lineSpacing; |
| } |
| |
| /** |
| * Gets the style of the receiver at the specified character offset. |
| * |
| * @param offset the text offset |
| * @return the style or <code>null</code> if not set |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_INVALID_ARGUMENT - if the character offset is out of range</li> |
| * </ul> |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public TextStyle getStyle (int offset) { |
| checkLayout(); |
| int length = text.length(); |
| if (!(0 <= offset && offset < length)) SWT.error(SWT.ERROR_INVALID_RANGE); |
| for (int i=1; i<styles.length; i++) { |
| StyleItem item = styles[i]; |
| if (item.start > offset) { |
| return styles[i - 1].style; |
| } |
| } |
| return null; |
| } |
| |
| /** |
| * Gets all styles of the receiver. |
| * |
| * @return the styles |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #getRanges() |
| * |
| * @since 3.2 |
| */ |
| public TextStyle[] getStyles () { |
| checkLayout(); |
| TextStyle[] result = new TextStyle[styles.length]; |
| int count = 0; |
| for (int i=0; i<styles.length; i++) { |
| if (styles[i].style != null) { |
| result[count++] = styles[i].style; |
| } |
| } |
| if (count != result.length) { |
| TextStyle[] newResult = new TextStyle[count]; |
| System.arraycopy(result, 0, newResult, 0, count); |
| result = newResult; |
| } |
| return result; |
| } |
| |
| /** |
| * Returns the tab list of the receiver. |
| * |
| * @return the tab list |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public int[] getTabs () { |
| checkLayout(); |
| return tabs; |
| } |
| |
| /** |
| * Gets the receiver's text, which will be an empty |
| * string if it has never been set. |
| * |
| * @return the receiver's text |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public String getText () { |
| checkLayout(); |
| return text; |
| } |
| |
| /** |
| * Returns the width of the receiver. |
| * |
| * @return the width |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public int getWidth () { |
| checkLayout(); |
| return wrapWidth; |
| } |
| |
| /** |
| * Returns the receiver's wrap indent. |
| * |
| * @return the receiver's wrap indent |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @since 3.6 |
| */ |
| public int getWrapIndent () { |
| checkLayout(); |
| return wrapIndent; |
| } |
| |
| /** |
| * Returns <code>true</code> if the text layout has been disposed, |
| * and <code>false</code> otherwise. |
| * <p> |
| * This method gets the dispose state for the text layout. |
| * When a text layout has been disposed, it is an error to |
| * invoke any other method (except {@link #dispose()}) using the text layout. |
| * </p> |
| * |
| * @return <code>true</code> when the text layout is disposed and <code>false</code> otherwise |
| */ |
| public boolean isDisposed () { |
| return device == null; |
| } |
| |
| /* |
| * Itemize the receiver text, create run for |
| */ |
| StyleItem[] itemize () { |
| int length = text.length(); |
| if (length == 0) { |
| return new StyleItem[]{new StyleItem(), new StyleItem()}; |
| } |
| int runCount = 0, start = 0; |
| StyleItem[] runs = new StyleItem[length]; |
| char[] chars = text.toCharArray(); |
| for (int i = 0; i<length; i++) { |
| char ch = chars[i]; |
| if (ch == '\t' || ch == '\r' || ch == '\n') { |
| if (i != start) { |
| StyleItem item = new StyleItem(); |
| item.start = start; |
| runs[runCount++] = item; |
| } |
| StyleItem item = new StyleItem(); |
| item.start = i; |
| runs[runCount++] = item; |
| start = i + 1; |
| } |
| } |
| char lastChar = chars[length - 1]; |
| if (!(lastChar == '\t' || lastChar == '\r' || lastChar == '\n')) { |
| StyleItem item = new StyleItem(); |
| item.start = start; |
| runs[runCount++] = item; |
| } |
| if (runCount != length) { |
| StyleItem[] newRuns = new StyleItem[runCount]; |
| System.arraycopy(runs, 0, newRuns, 0, runCount); |
| runs = newRuns; |
| } |
| runs = merge(runs, runCount); |
| return runs; |
| } |
| |
| /* |
| * Merge styles ranges and script items |
| */ |
| StyleItem[] merge (StyleItem[] items, int itemCount) { |
| int length = text.length(); |
| int count = 0, start = 0, end = length, itemIndex = 0, styleIndex = 0; |
| StyleItem[] runs = new StyleItem[itemCount + styles.length]; |
| while (start < end) { |
| StyleItem item = new StyleItem(); |
| item.start = start; |
| item.style = styles[styleIndex].style; |
| runs[count++] = item; |
| int itemLimit = itemIndex + 1 < items.length ? items[itemIndex + 1].start : length; |
| int styleLimit = styleIndex + 1 < styles.length ? styles[styleIndex + 1].start : length; |
| if (styleLimit <= itemLimit) { |
| styleIndex++; |
| start = styleLimit; |
| } |
| if (itemLimit <= styleLimit) { |
| itemIndex++; |
| start = itemLimit; |
| } |
| item.length = start - item.start; |
| } |
| StyleItem item = new StyleItem(); |
| item.start = end; |
| runs[count++] = item; |
| if (runs.length != count) { |
| StyleItem[] result = new StyleItem[count]; |
| System.arraycopy(runs, 0, result, 0, count); |
| return result; |
| } |
| return runs; |
| } |
| |
| void place (StyleItem run) { |
| if (run.length == 0) return; |
| if (run.style != null && run.style.metrics != null) { |
| GlyphMetrics glyphMetrics = run.style.metrics; |
| run.width = glyphMetrics.width * run.length; |
| run.baseline = glyphMetrics.ascent; |
| run.height = glyphMetrics.ascent + glyphMetrics.descent; |
| } else { |
| char[] chars = new char[run.length]; |
| text.getChars(run.start, run.start + run.length, chars, 0); |
| Font font = getItemFont(run); |
| int fontList = font.handle; |
| byte[] buffer = Converter.wcsToMbcs(font.codePage, chars, true); |
| short[] width = new short[1], height = new short[1]; |
| int xmString = OS.XmStringCreateLocalized(buffer); |
| OS.XmStringExtent(fontList, xmString, width, height); |
| run.width = width[0] & 0xFFFF; |
| run.height = height[0] & 0xFFFF; |
| run.baseline = OS.XmStringBaseline(fontList, xmString); |
| OS.XmStringFree(xmString); |
| } |
| } |
| |
| /** |
| * Sets the text alignment for the receiver. The alignment controls |
| * how a line of text is positioned horizontally. The argument should |
| * be one of <code>SWT.LEFT</code>, <code>SWT.RIGHT</code> or <code>SWT.CENTER</code>. |
| * <p> |
| * The default alignment is <code>SWT.LEFT</code>. Note that the receiver's |
| * width must be set in order to use <code>SWT.RIGHT</code> or <code>SWT.CENTER</code> |
| * alignment. |
| * </p> |
| * |
| * @param alignment the new alignment |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #setWidth(int) |
| */ |
| public void setAlignment (int alignment) { |
| checkLayout(); |
| int mask = SWT.LEFT | SWT.CENTER | SWT.RIGHT; |
| alignment &= mask; |
| if (alignment == 0) return; |
| if ((alignment & SWT.LEFT) != 0) alignment = SWT.LEFT; |
| if ((alignment & SWT.RIGHT) != 0) alignment = SWT.RIGHT; |
| freeRuns(); |
| this.alignment = alignment; |
| } |
| |
| /** |
| * Sets the ascent of the receiver. The ascent is distance in pixels |
| * from the baseline to the top of the line and it is applied to all |
| * lines. The default value is <code>-1</code> which means that the |
| * ascent is calculated from the line fonts. |
| * |
| * @param ascent the new ascent |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_INVALID_ARGUMENT - if the ascent is less than <code>-1</code></li> |
| * </ul> |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #setDescent(int) |
| * @see #getLineMetrics(int) |
| */ |
| public void setAscent (int ascent) { |
| checkLayout(); |
| if (ascent < -1) SWT.error(SWT.ERROR_INVALID_ARGUMENT); |
| if (this.ascent == ascent) return; |
| freeRuns(); |
| this.ascent = ascent; |
| } |
| |
| /** |
| * Sets the descent of the receiver. The descent is distance in pixels |
| * from the baseline to the bottom of the line and it is applied to all |
| * lines. The default value is <code>-1</code> which means that the |
| * descent is calculated from the line fonts. |
| * |
| * @param descent the new descent |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_INVALID_ARGUMENT - if the descent is less than <code>-1</code></li> |
| * </ul> |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #setAscent(int) |
| * @see #getLineMetrics(int) |
| */ |
| public void setDescent (int descent) { |
| checkLayout(); |
| if (descent < -1) SWT.error(SWT.ERROR_INVALID_ARGUMENT); |
| if (this.descent == descent) return; |
| freeRuns(); |
| this.descent = descent; |
| } |
| |
| /** |
| * Sets the default font which will be used by the receiver |
| * to draw and measure text. If the |
| * argument is null, then a default font appropriate |
| * for the platform will be used instead. Note that a text |
| * style can override the default font. |
| * |
| * @param font the new font for the receiver, or null to indicate a default font |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_INVALID_ARGUMENT - if the font has been disposed</li> |
| * </ul> |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public void setFont (Font font) { |
| checkLayout (); |
| if (font != null && font.isDisposed()) SWT.error(SWT.ERROR_INVALID_ARGUMENT); |
| Font oldFont = this.font; |
| if (oldFont == font) return; |
| this.font = font; |
| if (oldFont != null && oldFont.equals(font)) return; |
| freeRuns(); |
| XFontStruct fontStruct = getFontHeigth(font != null ? font : device.systemFont); |
| defaultAscent = fontStruct.ascent; |
| defaultDescent = fontStruct.descent; |
| } |
| |
| /** |
| * Sets the indent of the receiver. This indent is applied to the first line of |
| * each paragraph. |
| * |
| * @param indent new indent |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #setWrapIndent(int) |
| * |
| * @since 3.2 |
| */ |
| public void setIndent (int indent) { |
| checkLayout(); |
| if (indent < 0) return; |
| if (this.indent == indent) return; |
| freeRuns(); |
| this.indent = indent; |
| } |
| |
| /** |
| * Sets the justification of the receiver. Note that the receiver's |
| * width must be set in order to use justification. |
| * |
| * @param justify new justify |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @since 3.2 |
| */ |
| public void setJustify (boolean justify) { |
| checkLayout(); |
| if (this.justify == justify) return; |
| freeRuns(); |
| this.justify = justify; |
| } |
| |
| /** |
| * Sets the orientation of the receiver, which must be one |
| * of <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>. |
| * |
| * @param orientation new orientation style |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public void setOrientation (int orientation) { |
| checkLayout(); |
| int mask = SWT.RIGHT_TO_LEFT | SWT.LEFT_TO_RIGHT; |
| orientation &= mask; |
| if (orientation == 0) return; |
| if ((orientation & SWT.LEFT_TO_RIGHT) != 0) orientation = SWT.LEFT_TO_RIGHT; |
| this.orientation = orientation; |
| } |
| |
| /** |
| * Sets the line spacing of the receiver. The line spacing |
| * is the space left between lines. |
| * |
| * @param spacing the new line spacing |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_INVALID_ARGUMENT - if the spacing is negative</li> |
| * </ul> |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public void setSpacing (int spacing) { |
| checkLayout(); |
| if (spacing < 0) SWT.error(SWT.ERROR_INVALID_ARGUMENT); |
| if (this.lineSpacing == spacing) return; |
| freeRuns(); |
| this.lineSpacing = spacing; |
| } |
| |
| /** |
| * Sets the offsets of the receiver's text segments. Text segments are used to |
| * override the default behavior of the bidirectional algorithm. |
| * Bidirectional reordering can happen within a text segment but not |
| * between two adjacent segments. |
| * <p> |
| * Each text segment is determined by two consecutive offsets in the |
| * <code>segments</code> arrays. The first element of the array should |
| * always be zero and the last one should always be equals to length of |
| * the text. |
| * </p> |
| * <p> |
| * When segments characters are set, the segments are the offsets where |
| * the characters are inserted in the text. |
| * <p> |
| * |
| * @param segments the text segments offset |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #setSegmentsChars(char[]) |
| */ |
| public void setSegments(int[] segments) { |
| checkLayout(); |
| if (this.segments == null && segments == null) return; |
| if (this.segments != null && segments !=null) { |
| if (this.segments.length == segments.length) { |
| int i; |
| for (i = 0; i <segments.length; i++) { |
| if (this.segments[i] != segments[i]) break; |
| } |
| if (i == segments.length) return; |
| } |
| } |
| freeRuns(); |
| this.segments = segments; |
| } |
| |
| /** |
| * Sets the characters to be used in the segments boundaries. The segments |
| * are set by calling <code>setSegments(int[])</code>. The application can |
| * use this API to insert Unicode Control Characters in the text to control |
| * the display of the text and bidi reordering. The characters are not |
| * accessible by any other API in <code>TextLayout</code>. |
| * |
| * @param segmentsChars the segments characters |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #setSegments(int[]) |
| * |
| * @since 3.6 |
| */ |
| public void setSegmentsChars(char[] segmentsChars) { |
| checkLayout(); |
| if (this.segmentsChars == null && segmentsChars == null) return; |
| if (this.segmentsChars != null && segmentsChars != null) { |
| if (this.segmentsChars.length == segmentsChars.length) { |
| int i; |
| for (i = 0; i <segmentsChars.length; i++) { |
| if (this.segmentsChars[i] != segmentsChars[i]) break; |
| } |
| if (i == segmentsChars.length) return; |
| } |
| } |
| freeRuns(); |
| this.segmentsChars = segmentsChars; |
| } |
| |
| /** |
| * Sets the style of the receiver for the specified range. Styles previously |
| * set for that range will be overwritten. The start and end offsets are |
| * inclusive and will be clamped if out of range. |
| * |
| * @param style the style |
| * @param start the start offset |
| * @param end the end offset |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public void setStyle (TextStyle style, int start, int end) { |
| checkLayout(); |
| int length = text.length(); |
| if (length == 0) return; |
| if (start > end) return; |
| start = Math.min(Math.max(0, start), length - 1); |
| end = Math.min(Math.max(0, end), length - 1); |
| int low = -1; |
| int high = styles.length; |
| while (high - low > 1) { |
| int index = (high + low) / 2; |
| if (styles[index + 1].start > start) { |
| high = index; |
| } else { |
| low = index; |
| } |
| } |
| if (0 <= high && high < styles.length) { |
| StyleItem item = styles[high]; |
| if (item.start == start && styles[high + 1].start - 1 == end) { |
| if (style == null) { |
| if (item.style == null) return; |
| } else { |
| if (style.equals(item.style)) return; |
| } |
| } |
| } |
| freeRuns(); |
| int modifyStart = high; |
| int modifyEnd = modifyStart; |
| while (modifyEnd < styles.length) { |
| if (styles[modifyEnd + 1].start > end) break; |
| modifyEnd++; |
| } |
| if (modifyStart == modifyEnd) { |
| int styleStart = styles[modifyStart].start; |
| int styleEnd = styles[modifyEnd + 1].start - 1; |
| if (styleStart == start && styleEnd == end) { |
| styles[modifyStart].style = style; |
| return; |
| } |
| if (styleStart != start && styleEnd != end) { |
| StyleItem[] newStyles = new StyleItem[styles.length + 2]; |
| System.arraycopy(styles, 0, newStyles, 0, modifyStart + 1); |
| StyleItem item = new StyleItem(); |
| item.start = start; |
| item.style = style; |
| newStyles[modifyStart + 1] = item; |
| item = new StyleItem(); |
| item.start = end + 1; |
| item.style = styles[modifyStart].style; |
| newStyles[modifyStart + 2] = item; |
| System.arraycopy(styles, modifyEnd + 1, newStyles, modifyEnd + 3, styles.length - modifyEnd - 1); |
| styles = newStyles; |
| return; |
| } |
| } |
| if (start == styles[modifyStart].start) modifyStart--; |
| if (end == styles[modifyEnd + 1].start - 1) modifyEnd++; |
| int newLength = styles.length + 1 - (modifyEnd - modifyStart - 1); |
| StyleItem[] newStyles = new StyleItem[newLength]; |
| System.arraycopy(styles, 0, newStyles, 0, modifyStart + 1); |
| StyleItem item = new StyleItem(); |
| item.start = start; |
| item.style = style; |
| newStyles[modifyStart + 1] = item; |
| styles[modifyEnd].start = end + 1; |
| System.arraycopy(styles, modifyEnd, newStyles, modifyStart + 2, styles.length - modifyEnd); |
| styles = newStyles; |
| } |
| |
| /** |
| * Sets the receiver's tab list. Each value in the tab list specifies |
| * the space in pixels from the origin of the text layout to the respective |
| * tab stop. The last tab stop width is repeated continuously. |
| * |
| * @param tabs the new tab list |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public void setTabs (int[] tabs) { |
| checkLayout(); |
| if (this.tabs == null && tabs == null) return; |
| if (this.tabs != null && tabs !=null) { |
| if (this.tabs.length == tabs.length) { |
| int i; |
| for (i = 0; i <tabs.length; i++) { |
| if (this.tabs[i] != tabs[i]) break; |
| } |
| if (i == tabs.length) return; |
| } |
| } |
| freeRuns(); |
| this.tabs = tabs; |
| } |
| |
| /** |
| * Sets the receiver's text. |
| *<p> |
| * Note: Setting the text also clears all the styles. This method |
| * returns without doing anything if the new text is the same as |
| * the current text. |
| * </p> |
| * |
| * @param text the new text |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_NULL_ARGUMENT - if the text is null</li> |
| * </ul> |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| */ |
| public void setText (String text) { |
| checkLayout(); |
| if (text == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); |
| if (text.equals(this.text)) return; |
| freeRuns(); |
| this.text = text; |
| styles = new StyleItem[2]; |
| styles[0] = new StyleItem(); |
| styles[1] = new StyleItem(); |
| styles[1].start = text.length(); |
| } |
| |
| /** |
| * Sets the line width of the receiver, which determines how |
| * text should be wrapped and aligned. The default value is |
| * <code>-1</code> which means wrapping is disabled. |
| * |
| * @param width the new width |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_INVALID_ARGUMENT - if the width is <code>0</code> or less than <code>-1</code></li> |
| * </ul> |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #setAlignment(int) |
| */ |
| public void setWidth (int width) { |
| checkLayout(); |
| if (width < -1 || width == 0) SWT.error(SWT.ERROR_INVALID_ARGUMENT); |
| if (this.wrapWidth == width) return; |
| freeRuns(); |
| this.wrapWidth = width; |
| } |
| |
| /** |
| * Sets the wrap indent of the receiver. This indent is applied to all lines |
| * in the paragraph except the first line. |
| * |
| * @param wrapIndent new wrap indent |
| * |
| * @exception SWTException <ul> |
| * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> |
| * </ul> |
| * |
| * @see #setIndent(int) |
| * |
| * @since 3.6 |
| */ |
| public void setWrapIndent (int wrapIndent) { |
| checkLayout(); |
| if (wrapIndent < 0) return; |
| if (this.wrapIndent == wrapIndent) return; |
| freeRuns(); |
| this.wrapIndent = wrapIndent; |
| } |
| |
| /** |
| * Returns a string containing a concise, human-readable |
| * description of the receiver. |
| * |
| * @return a string representation of the receiver |
| */ |
| public String toString () { |
| if (isDisposed()) return "TextLayout {*DISPOSED*}"; |
| return "TextLayout {}"; |
| } |
| } |