Java tutorial
/******************************************************************************* * Copyright (c) 2000, 2011, 2012 IBM Corporation, Gerhardt Informatics Kft. 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 * Gerhardt Informatics Kft. - GEFGWT port *******************************************************************************/ package org.eclipse.swt.widgets; import org.eclipse.swt.SWT; import org.eclipse.swt.SWTException; import org.eclipse.swt.events.ModifyListener; import org.eclipse.swt.events.SelectionEvent; import org.eclipse.swt.events.SelectionListener; import org.eclipse.swt.events.VerifyListener; import org.eclipse.swt.graphics.Point; import org.eclipse.swt.graphics.Rectangle; import org.eclipse.swt.internal.gwt.GdkColor; import org.eclipse.swt.internal.gwt.GdkEventKey; import com.google.gwt.dom.client.Style; import com.google.gwt.dom.client.Style.BorderStyle; import com.google.gwt.dom.client.Style.Unit; import com.google.gwt.event.dom.client.BlurEvent; import com.google.gwt.event.dom.client.BlurHandler; import com.google.gwt.user.client.ui.LayoutPanel; import com.google.gwt.user.client.ui.TextArea; /** * Instances of this class are selectable user interface objects that allow the * user to enter and modify text. Text controls can be either single or * multi-line. When a text control is created with a border, the operating * system includes a platform specific inset around the contents of the control. * When created without a border, an effort is made to remove the inset such * that the preferred size of the control is the same size as the contents. * <p> * <dl> * <dt><b>Styles:</b></dt> * <dd>CENTER, ICON_CANCEL, ICON_SEARCH, LEFT, MULTI, PASSWORD, SEARCH, SINGLE, * RIGHT, READ_ONLY, WRAP</dd> * <dt><b>Events:</b></dt> * <dd>DefaultSelection, Modify, Verify, OrientationChange</dd> * </dl> * <p> * Note: Only one of the styles MULTI and SINGLE may be specified, and only one * of the styles LEFT, CENTER, and RIGHT may be specified. * </p> * <p> * Note: The styles ICON_CANCEL and ICON_SEARCH are hints used in combination * with SEARCH. When the platform supports the hint, the text control shows * these icons. When an icon is selected, a default selection event is sent with * the detail field set to one of ICON_CANCEL or ICON_SEARCH. Normally, * application code does not need to check the detail. In the case of * ICON_CANCEL, the text is cleared before the default selection event is sent * causing the application to search for an empty string. * </p> * <p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> * * @see <a href="http://www.eclipse.org/swt/snippets/#text">Text snippets</a> * @see <a href="http://www.eclipse.org/swt/examples.php">SWT Example: * ControlExample</a> * @see <a href="http://www.eclipse.org/swt/">Sample code and further * information</a> * @noextend This class is not intended to be subclassed by clients. */ public class Text extends Scrollable { long /* int */ bufferHandle; int tabs = 8, lastEventTime = 0; long /* int */ gdkEventKey = 0; int fixStart = -1, fixEnd = -1; boolean doubleClick; String message = ""; String text = ""; // static final int ITER_SIZEOF = OS.GtkTextIter_sizeof(); static final int SPACE_FOR_CURSOR = 1; /** * The maximum number of characters that can be entered into a text widget. * <p> * Note that this value is platform dependent, based upon the native widget * implementation. * </p> */ public final static int LIMIT; /** * The delimiter used by multi-line text widgets. When text is queried and * from the widget, it will be delimited using this delimiter. */ public final static String DELIMITER; /* * These values can be different on different platforms. Therefore they are * not initialized in the declaration to stop the compiler from inlining. */ static { LIMIT = 0x7FFFFFFF; DELIMITER = "\n"; } /** * Constructs a new instance of this class given its parent and a style * value describing its behavior and appearance. * <p> * The style value is either one of the style constants defined in class * <code>SWT</code> which is applicable to instances of this class, or must * be built by <em>bitwise OR</em>'ing together (that is, using the * <code>int</code> "|" operator) two or more of those <code>SWT</code> * style constants. The class description lists the style constants that are * applicable to the class. Style bits are also inherited from superclasses. * </p> * * @param parent * a composite control which will be the parent of the new * instance (cannot be null) * @param style * the style of control to construct * * @exception IllegalArgumentException * <ul> * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> * </ul> * @exception SWTException * <ul> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the parent</li> * <li>ERROR_INVALID_SUBCLASS - if this class is not an * allowed subclass</li> * </ul> * * @see SWT#SINGLE * @see SWT#MULTI * @see SWT#READ_ONLY * @see SWT#WRAP * @see SWT#LEFT * @see SWT#RIGHT * @see SWT#CENTER * @see SWT#PASSWORD * @see SWT#SEARCH * @see SWT#ICON_SEARCH * @see SWT#ICON_CANCEL * @see Widget#checkSubclass * @see Widget#getStyle */ private TextArea textArea; private LayoutPanel panel; public Text(Composite parent, int style) { this(new TextArea(), parent, style); textArea = (TextArea) getGwtWidget(); panel = (LayoutPanel) getParent().getGwtWidget().getParent(); panel.add(textArea); textArea.addBlurHandler(new BlurHandler() { @Override public void onBlur(BlurEvent event) { setText(textArea.getText()); textArea.removeFromParent(); sendEvent(SWT.Modify); sendEvent(SWT.FocusOut); } }); } public Text(TextArea textArea, Composite parent, int style) { super(textArea, parent, style); } void createHandle(int index) { } void createWidget(int index) { super.createWidget(index); doubleClick = true; } /** * Adds the listener to the collection of listeners who will be notified * when the receiver's text is modified, by sending it one of the messages * defined in the <code>ModifyListener</code> interface. * * @param listener * the listener which should be notified * * @exception IllegalArgumentException * <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> * </ul> * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @see ModifyListener * @see #removeModifyListener */ public void addModifyListener(ModifyListener listener) { checkWidget(); if (listener == null) error(SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener(listener); addListener(SWT.Modify, typedListener); } /** * Adds the listener to the collection of listeners who will be notified * when the control is selected by the user, by sending it one of the * messages defined in the <code>SelectionListener</code> interface. * <p> * <code>widgetSelected</code> is not called for texts. * <code>widgetDefaultSelected</code> is typically called when ENTER is * pressed in a single-line text, or when ENTER is pressed in a search text. * If the receiver has the <code>SWT.SEARCH | SWT.CANCEL</code> style and * the user cancels the search, the event object detail field contains the * value <code>SWT.CANCEL</code>. * </p> * * @param listener * the listener which should be notified when the control is * selected by the user * * @exception IllegalArgumentException * <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> * </ul> * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @see SelectionListener * @see #removeSelectionListener * @see SelectionEvent */ public void addSelectionListener(SelectionListener listener) { checkWidget(); if (listener == null) error(SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener(listener); addListener(SWT.Selection, typedListener); addListener(SWT.DefaultSelection, typedListener); } /** * Adds the listener to the collection of listeners who will be notified * when the receiver's text is verified, by sending it one of the messages * defined in the <code>VerifyListener</code> interface. * * @param listener * the listener which should be notified * * @exception IllegalArgumentException * <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> * </ul> * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @see VerifyListener * @see #removeVerifyListener */ public void addVerifyListener(VerifyListener listener) { checkWidget(); if (listener == null) error(SWT.ERROR_NULL_ARGUMENT); TypedListener typedListener = new TypedListener(listener); addListener(SWT.Verify, typedListener); } /** * Appends a string. * <p> * The new text is appended to the text at the end of the widget. * </p> * * @param string * the string to be appended * * @exception IllegalArgumentException * <ul> * <li>ERROR_NULL_ARGUMENT - if the string is null</li> * </ul> * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void append(String string) { checkWidget(); if (string == null) error(SWT.ERROR_NULL_ARGUMENT); this.text = text.concat(string); } /** * Clears the selection. * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void clearSelection() { } public Point computeSize(int wHint, int hHint, boolean changed) { int width = text.length() * 6; return new Point(width, 13); } public Rectangle computeTrim(int x, int y, int width, int height) { checkWidget(); Rectangle trim = super.computeTrim(x, y, width, height); return new Rectangle(trim.x, trim.y, trim.width, trim.height); } /** * Copies the selected text. * <p> * The current selection is copied to the clipboard. * </p> * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void copy() { } /** * Cuts the selected text. * <p> * The current selection is first copied to the clipboard and then deleted * from the widget. * </p> * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void cut() { } boolean dragDetect(int x, int y, boolean filter, boolean dragOnTimeout, boolean[] consume) { return false; } GdkColor getBackgroundColor() { return getBaseColor(); } public int getBorderWidth() { return 0; } /** * Returns the line number of the caret. * <p> * The line number of the caret is returned. * </p> * * @return the line number * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public int getCaretLineNumber() { return 0; } /** * Returns a point describing the receiver's location relative to its parent * (or its display if its parent is null). * <p> * The location of the caret is returned. * </p> * * @return a point, the location of the caret * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public Point getCaretLocation() { return null; } /** * Returns the character position of the caret. * <p> * Indexing is zero based. * </p> * * @return the position of the caret * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public int getCaretPosition() { return 0; } /** * Returns the number of characters. * * @return number of characters in the widget * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public int getCharCount() { return 0; } /** * Returns the double click enabled flag. * <p> * The double click flag enables or disables the default action of the text * widget when the user double clicks. * </p> * * @return whether or not double click is enabled * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public boolean getDoubleClickEnabled() { checkWidget(); return doubleClick; } /** * Returns the echo character. * <p> * The echo character is the character that is displayed when the user * enters text or the text is changed by the programmer. * </p> * * @return the echo character * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @see #setEchoChar */ public char getEchoChar() { return '\0'; } /** * Returns the editable state. * * @return whether or not the receiver is editable * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public boolean getEditable() { return false; } GdkColor getForegroundColor() { return getTextColor(); } /** * Returns the number of lines. * * @return the number of lines in the widget * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public int getLineCount() { return 0; } /** * Returns the line delimiter. * * @return a string that is the line delimiter * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @see #DELIMITER */ public String getLineDelimiter() { checkWidget(); return "\n"; } /** * Returns the height of a line. * * @return the height of a row of text * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public int getLineHeight() { return 0; } /** * Returns the widget message. The message text is displayed as a hint for * the user, indicating the purpose of the field. * <p> * Typically this is used in conjunction with <code>SWT.SEARCH</code>. * </p> * * @return the widget message * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @since 3.3 */ public String getMessage() { checkWidget(); return message; } /** * Returns the orientation of the receiver, which will be one of the * constants <code>SWT.LEFT_TO_RIGHT</code> or * <code>SWT.RIGHT_TO_LEFT</code>. * * @return the orientation style * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @since 2.1.2 */ public int getOrientation() { return super.getOrientation(); } /** * Returns a <code>Point</code> whose x coordinate is the character position * representing the start of the selected text, and whose y coordinate is * the character position representing the end of the selection. An "empty" * selection is indicated by the x and y coordinates having the same value. * <p> * Indexing is zero based. The range of a selection is from 0..N where N is * the number of characters in the widget. * </p> * * @return a point representing the selection start and end * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public Point getSelection() { return new Point(0, 0); } /** * Returns the number of selected characters. * * @return the number of selected characters. * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public int getSelectionCount() { checkWidget(); Point selection = getSelection(); return Math.abs(selection.y - selection.x); } /** * Gets the selected text, or an empty string if there is no current * selection. * * @return the selected text * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public String getSelectionText() { checkWidget(); Point selection = getSelection(); return getText().substring(selection.x, selection.y); } /** * Returns the number of tabs. * <p> * Tab stop spacing is specified in terms of the space (' ') character. The * width of a single tab stop is the pixel width of the spaces. * </p> * * @return the number of tab characters * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public int getTabs() { checkWidget(); return tabs; } int getTabWidth(int tabs) { return 0; } /** * Returns the widget text. * <p> * The text for a text widget is the characters in the widget, or an empty * string if this has never been set. * </p> * * @return the widget text * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public String getText() { return new String(getTextChars()); } /** * Returns a range of text. Returns an empty string if the start of the * range is greater than the end. * <p> * Indexing is zero based. The range of a selection is from 0..N-1 where N * is the number of characters in the widget. * </p> * * @param start * the start of the range * @param end * the end of the range * @return the range of text * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public String getText(int start, int end) { checkWidget(); if (!(start <= end && 0 <= end)) return ""; String str = getText(); int length = str.length(); end = Math.min(end, length - 1); if (start > end) return ""; start = Math.max(0, start); /* * NOTE: The current implementation uses substring () which can * reference a potentially large character array. */ return str.substring(start, end + 1); } /** * Returns the widget's text as a character array. * <p> * The text for a text widget is the characters in the widget, or a * zero-length array if this has never been set. * </p> * * @return a character array that contains the widget's text * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @see #setTextChars(char[]) * * @since 3.7 */ public char[] getTextChars() { return text.toCharArray(); } /** * Returns the maximum number of characters that the receiver is capable of * holding. * <p> * If this has not been changed by <code>setTextLimit()</code>, it will be * the constant <code>Text.LIMIT</code>. * </p> * * @return the text limit * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @see #LIMIT */ public int getTextLimit() { return 0; } /** * Returns the zero-relative index of the line which is currently at the top * of the receiver. * <p> * This index can change when lines are scrolled or new lines are added or * removed. * </p> * * @return the index of the top line * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public int getTopIndex() { return 0; } /** * Returns the top pixel. * <p> * The top pixel is the pixel position of the line that is currently at the * top of the widget. On some platforms, a text widget can be scrolled by * pixels instead of lines so that a partial line is displayed at the top of * the widget. * </p> * <p> * The top pixel changes when the widget is scrolled. The top pixel does not * include the widget trimming. * </p> * * @return the pixel position of the top line * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public int getTopPixel() { return 0; } void hookEvents() { } long /* int */ imContext() { return 0; } /** * Inserts a string. * <p> * The old selection is replaced with the new text. * </p> * * @param string * the string * * @exception IllegalArgumentException * <ul> * <li>ERROR_NULL_ARGUMENT - if the string is * <code>null</code></li> * </ul> * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void insert(String string) { } /** * Pastes text from clipboard. * <p> * The selected text is deleted from the widget and new text inserted from * the clipboard. * </p> * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void paste() { } void register() { super.register(); if (bufferHandle != 0) display.addWidget(bufferHandle, this); long /* int */ imContext = imContext(); if (imContext != 0) display.addWidget(imContext, this); } void releaseWidget() { } /** * Removes the listener from the collection of listeners who will be * notified when the receiver's text is modified. * * @param listener * the listener which should no longer be notified * * @exception IllegalArgumentException * <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> * </ul> * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @see ModifyListener * @see #addModifyListener */ public void removeModifyListener(ModifyListener listener) { checkWidget(); if (listener == null) error(SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook(SWT.Modify, listener); } /** * Removes the listener from the collection of listeners who will be * notified when the control is selected by the user. * * @param listener * the listener which should no longer be notified * * @exception IllegalArgumentException * <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> * </ul> * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @see SelectionListener * @see #addSelectionListener */ public void removeSelectionListener(SelectionListener listener) { checkWidget(); if (listener == null) error(SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook(SWT.Selection, listener); eventTable.unhook(SWT.DefaultSelection, listener); } /** * Removes the listener from the collection of listeners who will be * notified when the control is verified. * * @param listener * the listener which should no longer be notified * * @exception IllegalArgumentException * <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> * </ul> * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @see VerifyListener * @see #addVerifyListener */ public void removeVerifyListener(VerifyListener listener) { checkWidget(); if (listener == null) error(SWT.ERROR_NULL_ARGUMENT); if (eventTable == null) return; eventTable.unhook(SWT.Verify, listener); } /** * Selects all the text in the receiver. * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void selectAll() { ((TextArea) getGwtWidget()).selectAll(); } void setBackgroundColor(GdkColor color) { } @Override public void setBounds(int x, int y, int width, int height) { if (textArea.isAttached()) { textArea.setFocus(true); textArea.setText(getText()); Style textAreaStyle = textArea.getElement().getStyle(); textAreaStyle.setProperty("resize", "none"); textAreaStyle.setBorderStyle(BorderStyle.NONE); panel.setWidgetLeftWidth(textArea, x - 6, Unit.PX, width + 5, Unit.PX); panel.setWidgetTopHeight(textArea, y - 6, Unit.PX, height + 7, Unit.PX); textAreaStyle.setWidth(width + 5, Unit.PX); textAreaStyle.setHeight(height + 7, Unit.PX); } } /** * Sets the double click enabled flag. * <p> * The double click flag enables or disables the default action of the text * widget when the user double clicks. * </p> * <p> * Note: This operation is a hint and is not supported on platforms that do * not have this concept. * </p> * * @param doubleClick * the new double click flag * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void setDoubleClickEnabled(boolean doubleClick) { checkWidget(); this.doubleClick = doubleClick; } /** * Sets the echo character. * <p> * The echo character is the character that is displayed when the user * enters text or the text is changed by the programmer. Setting the echo * character to '\0' clears the echo character and redraws the original * text. If for any reason the echo character is invalid, or if the platform * does not allow modification of the echo character, the default echo * character for the platform is used. * </p> * * @param echo * the new echo character * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void setEchoChar(char echo) { } /** * Sets the editable state. * * @param editable * the new editable state * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void setEditable(boolean editable) { } void setFontDescription(long /* int */ font) { super.setFontDescription(font); setTabStops(tabs); } /** * Sets the widget message. The message text is displayed as a hint for the * user, indicating the purpose of the field. * <p> * Typically this is used in conjunction with <code>SWT.SEARCH</code>. * </p> * * @param message * the new message * * @exception IllegalArgumentException * <ul> * <li>ERROR_NULL_ARGUMENT - if the message is null</li> * </ul> * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @since 3.3 */ public void setMessage(String message) { checkWidget(); if (message == null) error(SWT.ERROR_NULL_ARGUMENT); this.message = message; redraw(false); } /** * Sets the orientation of the receiver, which must be one of the constants * <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>. * <p> * Note: This operation is a hint and is not supported on platforms that do * not have this concept. * </p> * * @param orientation * new orientation style * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @since 2.1.2 */ public void setOrientation(int orientation) { checkWidget(); } /** * Sets the selection. * <p> * Indexing is zero based. The range of a selection is from 0..N where N is * the number of characters in the widget. * </p> * <p> * Text selections are specified in terms of caret positions. In a text * widget that contains N characters, there are N+1 caret positions, ranging * from 0..N. This differs from other functions that address character * position such as getText () that use the regular array indexing rules. * </p> * * @param start * new caret position * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void setSelection(int start) { } /** * Sets the selection to the range specified by the given start and end * indices. * <p> * Indexing is zero based. The range of a selection is from 0..N where N is * the number of characters in the widget. * </p> * <p> * Text selections are specified in terms of caret positions. In a text * widget that contains N characters, there are N+1 caret positions, ranging * from 0..N. This differs from other functions that address character * position such as getText () that use the usual array indexing rules. * </p> * * @param start * the start of the range * @param end * the end of the range * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void setSelection(int start, int end) { } /** * Sets the selection to the range specified by the given point, where the x * coordinate represents the start index and the y coordinate represents the * end index. * <p> * Indexing is zero based. The range of a selection is from 0..N where N is * the number of characters in the widget. * </p> * <p> * Text selections are specified in terms of caret positions. In a text * widget that contains N characters, there are N+1 caret positions, ranging * from 0..N. This differs from other functions that address character * position such as getText () that use the usual array indexing rules. * </p> * * @param selection * the point * * @exception IllegalArgumentException * <ul> * <li>ERROR_NULL_ARGUMENT - if the point is null</li> * </ul> * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void setSelection(Point selection) { checkWidget(); if (selection == null) error(SWT.ERROR_NULL_ARGUMENT); setSelection(selection.x, selection.y); } /** * Sets the number of tabs. * <p> * Tab stop spacing is specified in terms of the space (' ') character. The * width of a single tab stop is the pixel width of the spaces. * </p> * * @param tabs * the number of tabs * * </ul> * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void setTabs(int tabs) { checkWidget(); if (tabs < 0) return; setTabStops(this.tabs = tabs); } void setTabStops(int tabs) { } /** * Sets the contents of the receiver to the given string. If the receiver * has style SINGLE and the argument contains multiple lines of text, the * result of this operation is undefined and may vary from platform to * platform. * * @param string * the new text * * @exception IllegalArgumentException * <ul> * <li>ERROR_NULL_ARGUMENT - if the string is null</li> * </ul> * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void setText(String string) { checkWidget(); if (string == null) error(SWT.ERROR_NULL_ARGUMENT); /* * Feature in gtk. When text is set in gtk, separate events are fired * for the deletion and insertion of the text. This is not wrong, but is * inconsistent with other platforms. The fix is to block the firing of * these events and fire them ourselves in a consistent manner. */ if (hooks(SWT.Verify) || filters(SWT.Verify)) { string = verifyText(string, 0, getCharCount()); if (string == null) return; } char[] text = new char[string.length()]; string.getChars(0, text.length, text, 0); setText(text); } /** * Sets the contents of the receiver to the characters in the array. If the * receiver has style <code>SWT.SINGLE</code> and the argument contains * multiple lines of text then the result of this operation is undefined and * may vary between platforms. * * @param text * a character array that contains the new text * * @exception IllegalArgumentException * <ul> * <li>ERROR_NULL_ARGUMENT - if the array is null</li> * </ul> * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @see #getTextChars() * * @since 3.7 */ public void setTextChars(char[] text) { checkWidget(); if (text == null) error(SWT.ERROR_NULL_ARGUMENT); /* * Feature in gtk. When text is set in gtk, separate events are fired * for the deletion and insertion of the text. This is not wrong, but is * inconsistent with other platforms. The fix is to block the firing of * these events and fire them ourselves in a consistent manner. */ if (hooks(SWT.Verify) || filters(SWT.Verify)) { String string = verifyText(new String(text), 0, getCharCount()); if (string == null) return; text = new char[string.length()]; string.getChars(0, text.length, text, 0); } setText(text); } void setText(char[] text) { this.text = String.copyValueOf(text, 0, text.length); } /** * Sets the maximum number of characters that the receiver is capable of * holding to be the argument. * <p> * Instead of trying to set the text limit to zero, consider creating a * read-only text widget. * </p> * <p> * To reset this value to the default, use * <code>setTextLimit(Text.LIMIT)</code>. Specifying a limit value larger * than <code>Text.LIMIT</code> sets the receiver's limit to * <code>Text.LIMIT</code>. * </p> * * @param limit * new text limit * * @exception IllegalArgumentException * <ul> * <li>ERROR_CANNOT_BE_ZERO - if the limit is zero</li> * </ul> * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> * * @see #LIMIT */ public void setTextLimit(int limit) { } /** * Sets the zero-relative index of the line which is currently at the top of * the receiver. This index can change when lines are scrolled or new lines * are added and removed. * * @param index * the index of the top item * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void setTopIndex(int index) { } /** * Shows the selection. * <p> * If the selection is already showing in the receiver, this method simply * returns. Otherwise, lines are scrolled until the selection is visible. * </p> * * @exception SWTException * <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been * disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the * thread that created the receiver</li> * </ul> */ public void showSelection() { } boolean translateTraversal(GdkEventKey keyEvent) { return false; } int traversalCode(int key, GdkEventKey event) { return 0; } String verifyText(String string, int start, int end) { return string; } }