| package org.eclipse.swt.widgets;
|
|
|
| /*
|
| * (c) Copyright IBM Corp. 2000, 2001.
|
| * All Rights Reserved
|
| */
|
|
|
| import org.eclipse.swt.internal.*;
|
| import org.eclipse.swt.internal.motif.*;
|
| import org.eclipse.swt.*;
|
| import org.eclipse.swt.graphics.*;
|
| import org.eclipse.swt.events.*;
|
|
|
| /** |
| * Instances of this class are selectable user interface |
| * objects that allow the user to enter and modify text. |
| * <p> |
| * <dl> |
| * <dt><b>Styles:</b></dt> |
| * <dd>MULTI, SINGLE, READ_ONLY, WRAP</dd> |
| * <dt><b>Events:</b></dt> |
| * <dd>DefaultSelection, Modify, Verify</dd> |
| * </dl> |
| * </p> |
| * IMPORTANT: This class is <em>not</em> intended to be subclassed. |
| */
|
|
|
| public class Text extends Scrollable {
|
| char echoCharacter;
|
| boolean ignoreChange;
|
| String hiddenText;
|
| XmTextVerifyCallbackStruct textVerify;
|
| int drawCount;
|
|
|
| public static final int LIMIT;
|
| public static final 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
|
| * for all SWT widget classes should include a comment which
|
| * describes the style constants which are applicable to the class.
|
| * </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
|
| * @see Widget#checkSubclass
|
| * @see Widget#getStyle
|
| */
|
| public Text (Composite parent, int style) {
|
| super (parent, checkStyle (style));
|
| }
|
| /** |
| * 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) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| 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 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.
|
| * </p>
|
| *
|
| * @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 SelectionListener
|
| * @see #removeSelectionListener
|
| * @see SelectionEvent
|
| */
|
| public void addSelectionListener(SelectionListener listener) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| 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) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| 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 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> |
| */
|
| public void append (String string) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| if (string == null) error (SWT.ERROR_NULL_ARGUMENT);
|
| int position = OS.XmTextGetLastPosition (handle);
|
| byte [] buffer = Converter.wcsToMbcs (null, string, true);
|
| Display display = getDisplay ();
|
| boolean warnings = display.getWarnings ();
|
| display.setWarnings (false);
|
| OS.XmTextSetInsertionPosition (handle, position);
|
| OS.XmTextInsert (handle, position, buffer);
|
| position = OS.XmTextGetLastPosition (handle);
|
| OS.XmTextSetInsertionPosition (handle, position);
|
| display.setWarnings(warnings);
|
| }
|
| static int checkStyle (int style) {
|
| if ((style & SWT.SINGLE) != 0) style &= ~(SWT.H_SCROLL | SWT.V_SCROLL);
|
| if ((style & (SWT.SINGLE | SWT.MULTI)) != 0) return style;
|
| if ((style & (SWT.H_SCROLL | SWT.V_SCROLL)) != 0) {
|
| return style | SWT.MULTI;
|
| }
|
| return style | SWT.SINGLE;
|
| }
|
| /** |
| * 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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| int xDisplay = OS.XtDisplay (handle);
|
| if (xDisplay == 0) return;
|
| OS.XmTextClearSelection (handle, OS.XtLastTimestampProcessed (xDisplay));
|
| }
|
| public Point computeSize (int wHint, int hHint, boolean changed) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| int width = wHint;
|
| int height = hHint;
|
| if (wHint == SWT.DEFAULT || hHint == SWT.DEFAULT) {
|
| int [] argList = {OS.XmNfontList, 0};
|
| OS.XtGetValues (handle, argList, argList.length / 2);
|
| int ptr = OS.XmTextGetString (handle);
|
| if (ptr == 0) return new Point (0, 0);
|
| int size = OS.strlen (ptr);
|
| if (size == 0) {
|
| if (hHint == SWT.DEFAULT) {
|
| if ((style & SWT.SINGLE) != 0) {
|
| height = getLineHeight ();
|
| } else {
|
| height = DEFAULT_HEIGHT;
|
| }
|
| }
|
| if (wHint == SWT.DEFAULT) {
|
| width = DEFAULT_WIDTH;
|
| }
|
| } else {
|
| byte [] buffer = new byte [size + 1];
|
| OS.memmove (buffer, ptr, size);
|
| int xmString = OS.XmStringParseText (
|
| buffer,
|
| 0,
|
| OS.XmFONTLIST_DEFAULT_TAG,
|
| OS.XmCHARSET_TEXT,
|
| null,
|
| 0,
|
| 0);
|
| if (hHint == SWT.DEFAULT) {
|
| if ((style & SWT.SINGLE) != 0) {
|
| height = getLineHeight ();
|
| } else {
|
| height = OS.XmStringHeight (argList [1], xmString);
|
| }
|
| }
|
| if (wHint == SWT.DEFAULT) width = OS.XmStringWidth(argList [1], xmString);
|
| OS.XmStringFree (xmString);
|
| }
|
| OS.XtFree (ptr);
|
| }
|
| if (horizontalBar != null) {
|
| int [] argList1 = {OS.XmNheight, 0};
|
| OS.XtGetValues (horizontalBar.handle, argList1, argList1.length / 2);
|
| height += argList1 [1] + 4;
|
| }
|
| if (verticalBar != null) {
|
| int [] argList1 = {OS.XmNwidth, 0};
|
| OS.XtGetValues (verticalBar.handle, argList1, argList1.length / 2);
|
| width += argList1 [1] + 4;
|
| }
|
| XRectangle rect = new XRectangle ();
|
| OS.XmWidgetGetDisplayRect (handle, rect);
|
| width += rect.x * 2; height += rect.y * 2;
|
| if ((style & (SWT.MULTI | SWT.BORDER)) != 0) height++;
|
| return new Point (width, height);
|
| }
|
| public Rectangle computeTrim (int x, int y, int width, int height) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| Rectangle trim = super.computeTrim(x, y, width, height);
|
| XRectangle rect = new XRectangle ();
|
| OS.XmWidgetGetDisplayRect (handle, rect);
|
| trim.x -= rect.x;
|
| trim.y -= rect.y;
|
| trim.width += rect.x;
|
| trim.height += rect.y;
|
| if ((style & (SWT.MULTI | SWT.BORDER)) != 0) trim.height += 3;
|
| return trim;
|
| }
|
| /** |
| * 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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| int xDisplay = OS.XtDisplay (handle);
|
| if (xDisplay == 0) return;
|
| OS.XmTextCopy (handle, OS.XtLastTimestampProcessed (xDisplay));
|
| }
|
| void createHandle (int index) {
|
| state |= HANDLE;
|
| int [] argList1 = {
|
| OS.XmNverifyBell, 0,
|
| OS.XmNeditMode, (style & SWT.SINGLE) != 0 ? OS.XmSINGLE_LINE_EDIT : OS.XmMULTI_LINE_EDIT,
|
| OS.XmNscrollHorizontal, (style & SWT.H_SCROLL) != 0 ? 1 : 0,
|
| OS.XmNscrollVertical, (style & SWT.V_SCROLL) != 0 ? 1 : 0,
|
| OS.XmNwordWrap, (style & SWT.WRAP) != 0 ? 1: 0,
|
| OS.XmNeditable, (style & SWT.READ_ONLY) != 0 ? 0 : 1,
|
| OS.XmNcursorPositionVisible, (style & SWT.READ_ONLY) != 0 && (style & SWT.SINGLE) != 0 ? 0 : 1,
|
| // OS.XmNmarginWidth, 3,
|
| // OS.XmNmarginHeight, 1,
|
| OS.XmNancestorSensitive, 1,
|
| };
|
| int parentHandle = parent.handle;
|
| if ((style & SWT.SINGLE) != 0) {
|
| handle = OS.XmCreateTextField (parentHandle, null, argList1, argList1.length / 2);
|
| if (handle == 0) error (SWT.ERROR_NO_HANDLES);
|
| int [] argList2 = new int [] {OS.XmNcursorPositionVisible, 0};
|
| OS.XtSetValues (handle, argList2, argList2.length / 2);
|
| if ((style & SWT.BORDER) == 0) {
|
| int [] argList3 = new int [] {
|
| OS.XmNmarginHeight, 0,
|
| OS.XmNshadowThickness, 0,
|
| };
|
| OS.XtSetValues (handle, argList3, argList3.length / 2);
|
| }
|
| } else {
|
| handle = OS.XmCreateScrolledText (parentHandle, null, argList1, argList1.length / 2);
|
| if (handle == 0) error (SWT.ERROR_NO_HANDLES);
|
| scrolledHandle = OS.XtParent (handle);
|
| }
|
| }
|
| ScrollBar createScrollBar (int type) {
|
| return createStandardBar (type);
|
| }
|
| /** |
| * Cuts the selected text. |
| * <p> |
| * The current selection is first copied to the |
| * clipboard and then deleted from the widget. |
| * </p> |
| * |
| * @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> |
| */ |
| public void cut () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| int xDisplay = OS.XtDisplay (handle);
|
| if (xDisplay == 0) return;
|
| OS.XmTextCut (handle, OS.XtLastTimestampProcessed (xDisplay));
|
| }
|
| int defaultBackground () {
|
| return getDisplay ().textBackground;
|
| }
|
| int defaultFont () {
|
| return getDisplay ().textFont;
|
| }
|
| int defaultForeground () {
|
| return getDisplay ().textForeground;
|
| }
|
| /** |
| * Gets the line number of the caret. |
| * <p> |
| * The line number of the caret is returned. |
| * </p> |
| * |
| * @return the line number |
| * |
| * @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> |
| */
|
| public int getCaretLineNumber () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| return getLineNumber (OS.XmTextGetInsertionPosition (handle));
|
| }
|
| /** |
| * Gets the location the caret. |
| * <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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| int position;
|
| if (textVerify != null) {
|
| position = textVerify.currInsert;
|
| } else {
|
| position = OS.XmTextGetInsertionPosition (handle);
|
| }
|
| short [] x = new short [1], y = new short [1];
|
| OS.XmTextPosToXY (handle, position, x, y);
|
| return new Point (x [0], y [0] - getFontAscent ());
|
| }
|
| /** |
| * Gets the position of the caret. |
| * <p> |
| * The character position of the caret is returned. |
| * </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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| return OS.XmTextGetInsertionPosition (handle);
|
| }
|
| /** |
| * Gets 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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| return OS.XmTextGetLastPosition (handle);
|
| }
|
| /** |
| * Gets 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> |
| * |
| * @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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| int [] argList = {OS.XmNselectionArrayCount, 0};
|
| OS.XtGetValues (handle, argList, argList.length / 2);
|
| return argList [1] != 1;
|
| }
|
| /** |
| * Gets 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> |
| * |
| * @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 char getEchoChar () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| return echoCharacter;
|
| }
|
| /** |
| * Gets the 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 boolean getEditable () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| /*
|
| * Bug in MOTIF. For some reason, when XmTextGetEditable () is called
|
| * from inside an XmNvalueChangedCallback or XmNModifyVerifyCallback,
|
| * it always returns TRUE. Calls to XmTextGetEditable () outside of
|
| * these callbacks return the correct value. The fix is to query the
|
| * resource directly instead of using the convenience function.
|
| */
|
| int [] argList = {OS.XmNeditable, 0};
|
| OS.XtGetValues (handle, argList, argList.length / 2);
|
| return argList [1] != 0;
|
| }
|
| /** |
| * Gets 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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| return getLineNumber (echoCharacter != '\0' ? hiddenText.length () : OS.XmTextGetLastPosition (handle));
|
| }
|
| /** |
| * Gets 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> |
| */
|
| public String getLineDelimiter () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| return "\n";
|
| }
|
| /** |
| * Gets 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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| return getFontHeight ();
|
| }
|
| int getLineNumber (int position) {
|
| if (position == 0) return 0;
|
| int count = 0, start = 0, page = 1024;
|
| char [] buffer = new char [page + 1];
|
| /*
|
| * Bug in Linux. For some reason, XmTextGetSubstringWcs () does
|
| * not copy wchar_t characters into the buffer. Instead, it
|
| * copies 4 bytes per character. This does not happen on other
|
| * platforms such as AIX. The fix is to call XmTextGetSubstring ()
|
| * instead on Linux and rely on the fact that Metrolink Motif 1.2
|
| * does not support multibyte locales.
|
| */
|
| byte [] buffer1 = null;
|
| if (IsLinux) buffer1 = new byte [page + 1];
|
| int end = ((position + page - 1) / page) * page;
|
| while (start < end) {
|
| int length = page;
|
| if (start + page > position) length = position - start;
|
| if (echoCharacter != '\0') {
|
| hiddenText.getChars (start, start + length, buffer, 0);
|
| } else {
|
| if (IsLinux) {
|
| OS.XmTextGetSubstring (handle, start, length, buffer1.length, buffer1);
|
| for (int i=0; i<length; i++) buffer [i] = (char) buffer1 [i];
|
| } else {
|
| OS.XmTextGetSubstringWcs (handle, start, length, buffer.length, buffer);
|
| }
|
| }
|
| for (int i=0; i<length; i++) {
|
| if (buffer [i] == '\n') count++;
|
| }
|
| start += page;
|
| }
|
| return count;
|
| }
|
| /** |
| * Gets the position of the selected text. |
| * <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 the start and end of 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 Point getSelection () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| if (textVerify != null) {
|
| return new Point (textVerify.startPos, textVerify.endPos);
|
| }
|
| int [] start = new int [1], end = new int [1];
|
| OS.XmTextGetSelectionPosition (handle, start, end);
|
| if (start [0] == end [0]) {
|
| start [0] = end [0] = OS.XmTextGetInsertionPosition (handle);
|
| }
|
| return new Point (start [0], end [0]);
|
| }
|
| /** |
| * Gets 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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| if (textVerify != null) {
|
| return textVerify.endPos - textVerify.startPos;
|
| }
|
| int [] start = new int [1], end = new int [1];
|
| OS.XmTextGetSelectionPosition (handle, start, end);
|
| return end [0] - start [0];
|
| }
|
| /** |
| * Gets the selected text. |
| * |
| * @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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| if (echoCharacter != '\0' || textVerify != null) {
|
| Point selection = getSelection ();
|
| return getText (selection.x, selection.y);
|
| }
|
| int ptr = OS.XmTextGetSelection (handle);
|
| if (ptr == 0) return "";
|
| int length = OS.strlen (ptr);
|
| byte [] buffer = new byte [length];
|
| OS.memmove (buffer, ptr, length);
|
| OS.XtFree (ptr);
|
| return new String (Converter.mbcsToWcs (null, buffer));
|
| }
|
| /** |
| * Gets 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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| /* Tabs are not supported in MOTIF. */
|
| return 8;
|
| }
|
| /** |
| * Gets the widget text. |
| * <p> |
| * The text for a text widget is the characters in the widget. |
| * </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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| if (echoCharacter != '\0') return hiddenText;
|
| int ptr = OS.XmTextGetString (handle);
|
| if (ptr == 0) return "";
|
| int length = OS.strlen (ptr);
|
| byte [] buffer = new byte [length];
|
| OS.memmove (buffer, ptr, length);
|
| OS.XtFree (ptr);
|
| return new String (Converter.mbcsToWcs (null, buffer));
|
| }
|
| /** |
| * Gets a range of text. |
| * <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) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| int numChars = end - start + 1;
|
| if (numChars < 0 || start < 0) return "";
|
| if (echoCharacter != '\0') {
|
| return hiddenText.substring (start, Math.min (hiddenText.length (), end));
|
| }
|
| int length = (numChars * 4 /* MB_CUR_MAX */) + 1;
|
| byte [] buffer = new byte [length];
|
| int code = OS.XmTextGetSubstring (handle, start, numChars, length, buffer);
|
| if (code == OS.XmCOPY_FAILED) return "";
|
| char [] unicode = Converter.mbcsToWcs (null, buffer);
|
| if (code == OS.XmCOPY_TRUNCATED) {
|
| numChars = OS.XmTextGetLastPosition (handle) - start;
|
| }
|
| return new String (unicode, 0, numChars);
|
| }
|
| /** |
| * 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> |
| */
|
| public int getTextLimit () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| return OS.XmTextGetMaxLength (handle);
|
| }
|
| /** |
| * 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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| if ((style & SWT.SINGLE) != 0) return 0;
|
| if (scrolledHandle == 0) return 0;
|
| int [] argList1 = {OS.XmNverticalScrollBar, 0};
|
| OS.XtGetValues (scrolledHandle, argList1, argList1.length / 2);
|
| if (argList1 [1] == 0) return 0;
|
| int [] argList2 = {OS.XmNvalue, 0};
|
| OS.XtGetValues (argList1 [1], argList2, argList2.length / 2);
|
| return argList2 [1];
|
| }
|
| /** |
| * Gets 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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| return getTopIndex () * getLineHeight ();
|
| }
|
| boolean getWrap () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| int [] argList = {OS.XmNwordWrap, 0};
|
| OS.XtGetValues (handle, argList, argList.length / 2);
|
| return argList [1] != 0;
|
| }
|
| void hookEvents () {
|
| super.hookEvents ();
|
| int windowProc = getDisplay ().windowProc;
|
| OS.XtAddCallback (handle, OS.XmNactivateCallback, windowProc, SWT.DefaultSelection);
|
| OS.XtAddCallback (handle, OS.XmNvalueChangedCallback, windowProc, SWT.Modify);
|
| OS.XtAddCallback (handle, OS.XmNmodifyVerifyCallback, windowProc, SWT.Verify);
|
| }
|
| int inputContext () {
|
| /* Answer zero. The text widget uses the default MOTIF input context. */
|
| return 0;
|
| }
|
| /** |
| * Inserts a string. |
| * <p> |
| * The old selection is replaced with the new text. |
| * </p> |
| * |
| * @param string the string |
| * |
| * @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) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| if (string == null) error (SWT.ERROR_NULL_ARGUMENT);
|
| int [] start = new int [1], end = new int [1];
|
| OS.XmTextGetSelectionPosition (handle, start, end);
|
| if (start [0] == end [0]) {
|
| start [0] = end [0] = OS.XmTextGetInsertionPosition (handle);
|
| }
|
| byte [] buffer = Converter.wcsToMbcs (null, string, true);
|
| Display display = getDisplay ();
|
| boolean warnings = display.getWarnings ();
|
| display.setWarnings (false);
|
| OS.XmTextReplace (handle, start [0], end [0], buffer);
|
| int position = start [0] + buffer.length - 1;
|
| OS.XmTextSetInsertionPosition (handle, position);
|
| display.setWarnings (warnings);
|
| }
|
| /** |
| * 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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| Display display = getDisplay ();
|
| boolean warnings = display.getWarnings ();
|
| display.setWarnings (false);
|
| /*
|
| * Bug in Motif. Despite the fact that the documentation
|
| * claims that XmText functions work for XmTextFields, when
|
| * a text field is passed to XmTextPaste, Motif segment faults.
|
| * The fix is to call XmTextFieldPaste instead.
|
| */
|
| if ((style & SWT.SINGLE) != 0) {
|
| OS.XmTextFieldPaste (handle);
|
| } else {
|
| OS.XmTextPaste (handle);
|
| }
|
| display.setWarnings (warnings);
|
| }
|
| int processFocusIn () {
|
| super.processFocusIn ();
|
| // widget could be disposed at this point
|
| if (handle == 0) return 0;
|
| if ((style & SWT.READ_ONLY) != 0) return 0;
|
| if ((style & SWT.MULTI) != 0) return 0;
|
| int [] argList = {OS.XmNcursorPositionVisible, 1};
|
| OS.XtSetValues (handle, argList, argList.length / 2);
|
| return 0;
|
| }
|
| int processFocusOut () {
|
| super.processFocusOut ();
|
| // widget could be disposed at this point
|
| if (handle == 0) return 0;
|
| if ((style & SWT.READ_ONLY) != 0) return 0;
|
| if ((style & SWT.MULTI) != 0) return 0;
|
| int [] argList = {OS.XmNcursorPositionVisible, 0};
|
| OS.XtSetValues (handle, argList, argList.length / 2);
|
| return 0;
|
| }
|
| int processModify (int callData) {
|
| if (!ignoreChange) super.processModify (callData);
|
| return 0;
|
| }
|
| int processVerify (int callData) {
|
| super.processVerify (callData);
|
| if (echoCharacter == '\0' && !hooks (SWT.Verify)) return 0;
|
| XmTextVerifyCallbackStruct textVerify = new XmTextVerifyCallbackStruct ();
|
| OS.memmove (textVerify, callData, XmTextVerifyCallbackStruct.sizeof);
|
| XmTextBlockRec textBlock = new XmTextBlockRec ();
|
| OS.memmove (textBlock, textVerify.text, XmTextBlockRec.sizeof);
|
| byte [] buffer = new byte [textBlock.length];
|
| OS.memmove (buffer, textBlock.ptr, textBlock.length);
|
| String text = new String (Converter.mbcsToWcs (null, buffer));
|
| String newText = text;
|
| if (!ignoreChange) {
|
| Event event = new Event ();
|
| if (textVerify.event != 0) {
|
| XKeyEvent xEvent = new XKeyEvent ();
|
| OS.memmove (xEvent, textVerify.event, XKeyEvent.sizeof);
|
| setKeyState (event, xEvent);
|
| }
|
| event.start = textVerify.startPos;
|
| event.end = textVerify.endPos;
|
| event.doit = textVerify.doit == 1;
|
| event.text = text;
|
| sendEvent (SWT.Verify, event);
|
| newText = event.text;
|
| textVerify.doit = (byte) ((event.doit && newText != null) ? 1 : 0);
|
| }
|
| if (newText != null) {
|
| if (echoCharacter != '\0' && (textVerify.doit != 0)) {
|
| String prefix = hiddenText.substring (0, textVerify.startPos);
|
| String suffix = hiddenText.substring (textVerify.endPos, hiddenText.length ());
|
| hiddenText = prefix + newText + suffix;
|
| char [] charBuffer = new char [newText.length ()];
|
| for (int i=0; i<charBuffer.length; i++) {
|
| charBuffer [i] = echoCharacter;
|
| }
|
| newText = new String (charBuffer);
|
| }
|
| if (newText != text) {
|
| byte [] buffer2 = Converter.wcsToMbcs (null, newText, true);
|
| int length = buffer2.length;
|
| int ptr = OS.XtMalloc (length);
|
| OS.memmove (ptr, buffer2, length);
|
| textBlock.ptr = ptr;
|
| textBlock.length = buffer2.length - 1;
|
| OS.memmove (textVerify.text, textBlock, XmTextBlockRec.sizeof);
|
| }
|
| }
|
| OS.memmove (callData, textVerify, XmTextVerifyCallbackStruct.sizeof);
|
| textVerify = null;
|
| return 0;
|
| }
|
| /** |
| * 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) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| 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. |
| * |
| * @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 SelectionListener |
| * @see #addSelectionListener |
| */
|
| public void removeSelectionListener(SelectionListener listener) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| 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 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) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| 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 () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
|
|
| /* Clear the highlight before setting the selection. */
|
| int position = OS.XmTextGetLastPosition (handle);
|
| // OS.XmTextSetHighlight (handle, 0, position, OS.XmHIGHLIGHT_NORMAL);
|
|
|
| /*
|
| * Bug in MOTIF. XmTextSetSelection () fails to set the
|
| * selection when the receiver is not realized. The fix
|
| * is to force the receiver to be realized by forcing the
|
| * shell to be realized. If the receiver is realized before
|
| * the shell, MOTIF fails to draw the text widget and issues
|
| * lots of X BadDrawable errors.
|
| */
|
| if (!OS.XtIsRealized (handle)) getShell ().realizeWidget ();
|
|
|
| /* Set the selection. */
|
| int xDisplay = OS.XtDisplay (handle);
|
| if (xDisplay == 0) return;
|
| Display display = getDisplay ();
|
| boolean warnings = display.getWarnings ();
|
| display.setWarnings (false);
|
| OS.XmTextSetSelection (handle, 0, position, OS.XtLastTimestampProcessed (xDisplay));
|
|
|
| /* Force the i-beam to follow the highlight/selection. */
|
| OS.XmTextSetInsertionPosition (handle, 0);
|
| display.setWarnings (warnings);
|
| }
|
| /**
|
| * Sets the bounds.
|
| */
|
| public void setBounds (int x, int y, int width, int height) {
|
| super.setBounds (x, y, width, height);
|
| /*
|
| * Bug in Motif. When the receiver is a Text widget
|
| * (not a Text Field) and is resized to be smaller than
|
| * the inset that surrounds the text and the selection
|
| * is set, the receiver scrolls to the left. When the
|
| * receiver is resized larger, the text is not scrolled
|
| * back. The fix is to detect this case and scroll the
|
| * text back.
|
| */
|
| // inset := self inset.
|
| // nWidth := self dimensionAt: XmNwidth.
|
| // self noWarnings: [super resizeWidget].
|
| // nWidth > inset x ifTrue: [^self].
|
| // self showPosition: self topCharacter
|
| }
|
| /** |
| * 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> |
| * |
| * @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) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| int [] argList = {OS.XmNselectionArrayCount, doubleClick ? 4 : 1};
|
| OS.XtSetValues (handle, argList, argList.length / 2);
|
| }
|
| /** |
| * 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. |
| * </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) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| if (echoCharacter == echo) return;
|
| String newText;
|
| if (echo == 0) {
|
| newText = hiddenText;
|
| hiddenText = null;
|
| } else {
|
| newText = hiddenText = getText();
|
| }
|
| echoCharacter = echo;
|
| Point selection = getSelection();
|
| boolean oldValue = ignoreChange;
|
| ignoreChange = true;
|
| setText(newText);
|
| setSelection(selection);
|
| ignoreChange = oldValue;
|
| }
|
| /** |
| * 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) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| OS.XmTextSetEditable (handle, editable);
|
| style &= ~SWT.READ_ONLY;
|
| if (!editable) style |= SWT.READ_ONLY;
|
| if ((style & SWT.MULTI) != 0) return;
|
| int [] argList = {OS.XmNcursorPositionVisible, editable && hasFocus () ? 1 : 0};
|
| OS.XtSetValues (handle, argList, argList.length / 2);
|
| }
|
| /**
|
| * Sets the redraw flag.
|
| */
|
| public void setRedraw (boolean redraw) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| if ((style & SWT.SINGLE) != 0) return;
|
| if (redraw) {
|
| if (--drawCount == 0) OS.XmTextEnableRedisplay(handle);
|
| } else {
|
| if (drawCount++ == 0) OS.XmTextDisableRedisplay(handle);
|
| }
|
| }
|
| /** |
| * 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 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 setSelection (int start) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
|
|
| /* Clear the selection and highlight before moving the i-beam. */
|
| int xDisplay = OS.XtDisplay (handle);
|
| if (xDisplay == 0) return;
|
| int position = OS.XmTextGetLastPosition (handle);
|
| int nStart = Math.min (Math.max (start, 0), position);
|
| Display display = getDisplay ();
|
| boolean warnings = display.getWarnings ();
|
| display.setWarnings (false);
|
| // OS.XmTextSetHighlight (handle, 0, position, OS.XmHIGHLIGHT_NORMAL);
|
| OS.XmTextClearSelection (handle, OS.XtLastTimestampProcessed (xDisplay));
|
|
|
| /* Set the i-beam position. */
|
| OS.XmTextSetInsertionPosition (handle, nStart);
|
| display.setWarnings (warnings);
|
| }
|
| /** |
| * 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 |
| * usual array indexing rules. |
| * </p> |
| * |
| * @param start the start of the range |
| * @param end the end of the range |
| * |
| * @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 setSelection (int start, int end) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
|
|
| /* Clear the highlight before setting the selection. */
|
| int position = OS.XmTextGetLastPosition (handle);
|
| // OS.XmTextSetHighlight (handle, 0, position, OS.XmHIGHLIGHT_NORMAL);
|
|
|
| /*
|
| * Bug in MOTIF. XmTextSetSelection () fails to set the
|
| * selection when the receiver is not realized. The fix
|
| * is to force the receiver to be realized by forcing the
|
| * shell to be realized. If the receiver is realized before
|
| * the shell, MOTIF fails to draw the text widget and issues
|
| * lots of X BadDrawable errors.
|
| */
|
| if (!OS.XtIsRealized (handle)) getShell ().realizeWidget ();
|
|
|
| /* Set the selection. */
|
| int xDisplay = OS.XtDisplay (handle);
|
| if (xDisplay == 0) return;
|
| int nStart = Math.min (Math.max (Math.min (start, end), 0), position);
|
| int nEnd = Math.min (Math.max (Math.max (start, end), 0), position);
|
| Display display = getDisplay ();
|
| boolean warnings = display.getWarnings ();
|
| display.setWarnings (false);
|
| OS.XmTextSetSelection (handle, nStart, nEnd, OS.XtLastTimestampProcessed (xDisplay));
|
|
|
| /* Force the i-beam to follow the highlight/selection. */
|
| OS.XmTextSetInsertionPosition (handle, nEnd);
|
| display.setWarnings (warnings);
|
| }
|
| /** |
| * 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 |
| * usual array indexing rules. |
| * </p> |
| * |
| * @param selection the point |
| * |
| * @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 setSelection (Point selection) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| if (selection == null) error (SWT.ERROR_NULL_ARGUMENT);
|
| setSelection (selection.x, selection.y);
|
| }
|
| public void setSize (int width, int height) {
|
| super.setSize (width, height);
|
| /*
|
| * Bug in Motif. When the receiver is a Text widget
|
| * (not a Text Field) and is resized to be smaller than
|
| * the inset that surrounds the text and the selection
|
| * is set, the receiver scrolls to the left. When the
|
| * receiver is resized larger, the text is not scrolled
|
| * back. The fix is to detect this case and scroll the
|
| * text back.
|
| */
|
| // inset := self inset.
|
| // nWidth := self dimensionAt: XmNwidth.
|
| // self noWarnings: [super resizeWidget].
|
| // nWidth > inset x ifTrue: [^self].
|
| // self showPosition: self topCharacter
|
| }
|
| /** |
| * 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) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| /* Do nothing. Tabs are not supported in MOTIF. */
|
| }
|
| /** |
| * Sets the contents of the receiver to the given string. |
| * |
| * @param text 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) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| if (string == null) error (SWT.ERROR_NULL_ARGUMENT);
|
| byte [] buffer = Converter.wcsToMbcs (null, string, true);
|
| Display display = getDisplay ();
|
| boolean warnings = display.getWarnings ();
|
| display.setWarnings (false);
|
| OS.XmTextSetString (handle, buffer);
|
| OS.XmTextSetInsertionPosition (handle, 0);
|
| display.setWarnings(warnings);
|
| /*
|
| * Bug in Linux. When the widget is multi-line
|
| * it does not send a Modify to notify the application
|
| * that the text has changed. The fix is to send the event.
|
| */
|
| if (IsLinux && (style & SWT.MULTI) != 0) sendEvent (SWT.Modify);
|
| }
|
| /** |
| * Sets the maximum number of characters that the receiver |
| * is capable of holding to be the argument. |
| * |
| * @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> |
| */
|
| public void setTextLimit (int limit) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| if (limit == 0) error (SWT.ERROR_CANNOT_BE_ZERO);
|
| OS.XmTextSetMaxLength (handle, 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) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| if ((style & SWT.SINGLE) != 0) return;
|
| if (scrolledHandle == 0) return;
|
| int [] argList1 = {OS.XmNverticalScrollBar, 0};
|
| OS.XtGetValues (scrolledHandle, argList1, argList1.length / 2);
|
| if (argList1 [1] == 0) return;
|
| int [] argList2 = {OS.XmNvalue, 0};
|
| OS.XtGetValues (argList1 [1], argList2, argList2.length / 2);
|
| OS.XmTextScroll (handle, index - argList2 [1]);
|
| }
|
| void setWrap (boolean wrap) {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| int [] argList = {OS.XmNwordWrap, wrap ? 1 : 0};
|
| OS.XtSetValues (handle, argList, argList.length / 2);
|
| }
|
| /** |
| * 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 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> |
| */
|
| public void showSelection () {
|
| if (!isValidThread ()) error (SWT.ERROR_THREAD_INVALID_ACCESS);
|
| if (!isValidWidget ()) error (SWT.ERROR_WIDGET_DISPOSED);
|
| Display display = getDisplay ();
|
| boolean warnings = display.getWarnings ();
|
| display.setWarnings (false);
|
| int position = OS.XmTextGetInsertionPosition (handle);
|
| OS.XmTextShowPosition (handle, position);
|
| display.setWarnings (warnings);
|
| }
|
| int traversalCode () {
|
| if ((style & SWT.SINGLE) != 0) return super.traversalCode ();
|
| return SWT.TRAVERSE_ESCAPE;
|
| }
|
| }
|