summaryrefslogtreecommitdiffstats
path: root/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Button.java
diff options
context:
space:
mode:
authorSilenio Quarti <silenio>2009-07-01 14:50:54 +0000
committerSilenio Quarti <silenio>2009-07-01 14:50:54 +0000
commit093c579a4ffd9551acb901bba9617e7aa776989d (patch)
tree71cf23798b651ef92f188390841a8d130908fb11 /bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Button.java
parentf664d297f7bb009784868bf3fcf0b3e3bb9a646b (diff)
downloadeclipse.platform.swt-093c579a4ffd9551acb901bba9617e7aa776989d.tar.gz
eclipse.platform.swt-093c579a4ffd9551acb901bba9617e7aa776989d.tar.xz
eclipse.platform.swt-093c579a4ffd9551acb901bba9617e7aa776989d.zip
restore HEAD after accidental deletion by error in automated build script
Diffstat (limited to 'bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Button.java')
-rw-r--r--bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Button.java836
1 files changed, 836 insertions, 0 deletions
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Button.java b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Button.java
new file mode 100644
index 0000000000..41802dc836
--- /dev/null
+++ b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Button.java
@@ -0,0 +1,836 @@
+/*******************************************************************************
+ * Copyright (c) 2000, 2009 IBM Corporation and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ *
+ * Contributors:
+ * IBM Corporation - initial API and implementation
+ *******************************************************************************/
+package org.eclipse.swt.widgets;
+
+
+import org.eclipse.swt.internal.*;
+import org.eclipse.swt.internal.gtk.*;
+import org.eclipse.swt.*;
+import org.eclipse.swt.graphics.*;
+import org.eclipse.swt.events.*;
+
+/**
+ * Instances of this class represent a selectable user interface object that
+ * issues notification when pressed and released.
+ * <dl>
+ * <dt><b>Styles:</b></dt>
+ * <dd>ARROW, CHECK, PUSH, RADIO, TOGGLE, FLAT</dd>
+ * <dd>UP, DOWN, LEFT, RIGHT, CENTER</dd>
+ * <dt><b>Events:</b></dt>
+ * <dd>Selection</dd>
+ * </dl>
+ * <p>
+ * Note: Only one of the styles ARROW, CHECK, PUSH, RADIO, and TOGGLE
+ * may be specified.
+ * </p><p>
+ * Note: Only one of the styles LEFT, RIGHT, and CENTER may be specified.
+ * </p><p>
+ * Note: Only one of the styles UP, DOWN, LEFT, and RIGHT may be specified
+ * when the ARROW style is specified.
+ * </p><p>
+ * IMPORTANT: This class is intended to be subclassed <em>only</em>
+ * within the SWT implementation.
+ * </p>
+ *
+ * @see <a href="http://www.eclipse.org/swt/snippets/#button">Button 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 Button extends Control {
+ int /*long*/ boxHandle, labelHandle, imageHandle, arrowHandle, groupHandle;
+ boolean selected, grayed;
+ ImageList imageList;
+ Image image;
+ String text;
+
+/**
+ * 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#ARROW
+ * @see SWT#CHECK
+ * @see SWT#PUSH
+ * @see SWT#RADIO
+ * @see SWT#TOGGLE
+ * @see SWT#FLAT
+ * @see SWT#UP
+ * @see SWT#DOWN
+ * @see SWT#LEFT
+ * @see SWT#RIGHT
+ * @see SWT#CENTER
+ * @see Widget#checkSubclass
+ * @see Widget#getStyle
+ */
+public Button (Composite parent, int style) {
+ super (parent, checkStyle (style));
+}
+
+static int checkStyle (int style) {
+ style = checkBits (style, SWT.PUSH, SWT.ARROW, SWT.CHECK, SWT.RADIO, SWT.TOGGLE, 0);
+ if ((style & (SWT.PUSH | SWT.TOGGLE)) != 0) {
+ return checkBits (style, SWT.CENTER, SWT.LEFT, SWT.RIGHT, 0, 0, 0);
+ }
+ if ((style & (SWT.CHECK | SWT.RADIO)) != 0) {
+ return checkBits (style, SWT.LEFT, SWT.RIGHT, SWT.CENTER, 0, 0, 0);
+ }
+ if ((style & SWT.ARROW) != 0) {
+ style |= SWT.NO_FOCUS;
+ return checkBits (style, SWT.UP, SWT.DOWN, SWT.LEFT, SWT.RIGHT, 0, 0);
+ }
+ return style;
+}
+
+/**
+ * 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 called when the control is selected by the user.
+ * <code>widgetDefaultSelected</code> is not called.
+ * </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) {
+ checkWidget ();
+ if (listener == null) error (SWT.ERROR_NULL_ARGUMENT);
+ TypedListener typedListener = new TypedListener (listener);
+ addListener (SWT.Selection,typedListener);
+ addListener (SWT.DefaultSelection,typedListener);
+}
+
+public Point computeSize (int wHint, int hHint, boolean changed) {
+ checkWidget ();
+ if (wHint != SWT.DEFAULT && wHint < 0) wHint = 0;
+ if (hHint != SWT.DEFAULT && hHint < 0) hHint = 0;
+ /*
+ * Feature in GTK, GtkCheckButton and GtkRadioButton allocate
+ * only the minimum size necessary for its child. This causes the child
+ * alignment to fail. The fix is to set the child size to the size
+ * of the button.
+ */
+ forceResize ();
+ int [] reqWidth = null, reqHeight = null;
+ if ((style & (SWT.CHECK | SWT.RADIO)) != 0) {
+ reqWidth = new int [1];
+ reqHeight = new int [1];
+ OS.gtk_widget_get_size_request (boxHandle, reqWidth, reqHeight);
+ OS.gtk_widget_set_size_request (boxHandle, -1, -1);
+ }
+ Point size = computeNativeSize (handle, wHint, hHint, changed);
+ if ((style & (SWT.CHECK | SWT.RADIO)) != 0) {
+ OS.gtk_widget_set_size_request (boxHandle, reqWidth [0], reqHeight [0]);
+ }
+ if (wHint != SWT.DEFAULT || hHint != SWT.DEFAULT) {
+ if ((OS.GTK_WIDGET_FLAGS (handle) & OS.GTK_CAN_DEFAULT) != 0) {
+ int /*long*/ [] buffer = new int /*long*/ [1];
+ GtkBorder border = new GtkBorder ();
+ OS.gtk_widget_style_get (handle, OS.default_border, buffer, 0);
+ if (buffer[0] != 0) {
+ OS.memmove (border, buffer[0], GtkBorder.sizeof);
+ } else {
+ /* Use the GTK+ default value of 1 for each. */
+ border.left = border.right = border.top = border.bottom = 1;
+ }
+ if (wHint != SWT.DEFAULT) size.x += border.left + border.right;
+ if (hHint != SWT.DEFAULT) size.y += border.top + border.bottom;
+ }
+ }
+ return size;
+}
+
+void createHandle (int index) {
+ state |= HANDLE;
+ if ((style & (SWT.PUSH | SWT.TOGGLE)) == 0) state |= THEME_BACKGROUND;
+ int bits = SWT.ARROW | SWT.TOGGLE | SWT.CHECK | SWT.RADIO | SWT.PUSH;
+ fixedHandle = OS.g_object_new (display.gtk_fixed_get_type (), 0);
+ if (fixedHandle == 0) error (SWT.ERROR_NO_HANDLES);
+ OS.gtk_fixed_set_has_window (fixedHandle, true);
+ switch (style & bits) {
+ case SWT.ARROW:
+ int arrow_type = OS.GTK_ARROW_UP;
+ if ((style & SWT.UP) != 0) arrow_type = OS.GTK_ARROW_UP;
+ if ((style & SWT.DOWN) != 0) arrow_type = OS.GTK_ARROW_DOWN;
+ if ((style & SWT.LEFT) != 0) arrow_type = OS.GTK_ARROW_LEFT;
+ if ((style & SWT.RIGHT) != 0) arrow_type = OS.GTK_ARROW_RIGHT;
+ handle = OS.gtk_button_new ();
+ if (handle == 0) error (SWT.ERROR_NO_HANDLES);
+ arrowHandle = OS.gtk_arrow_new (arrow_type, OS.GTK_SHADOW_OUT);
+ if (arrowHandle == 0) error (SWT.ERROR_NO_HANDLES);
+ break;
+ case SWT.TOGGLE:
+ handle = OS.gtk_toggle_button_new ();
+ if (handle == 0) error (SWT.ERROR_NO_HANDLES);
+ break;
+ case SWT.CHECK:
+ handle = OS.gtk_check_button_new ();
+ if (handle == 0) error (SWT.ERROR_NO_HANDLES);
+ break;
+ case SWT.RADIO:
+ /*
+ * Feature in GTK. In GTK, radio button must always be part of
+ * a radio button group. In a GTK radio group, one button is always
+ * selected. This means that it is not possible to have a single
+ * radio button that is unselected. This is necessary to allow
+ * applications to implement their own radio behavior or use radio
+ * buttons outside of radio groups. The fix is to create a hidden
+ * radio button for each radio button we create and add them
+ * to the same group. This allows the visible button to be
+ * unselected.
+ */
+ groupHandle = OS.gtk_radio_button_new (0);
+ if (groupHandle == 0) error (SWT.ERROR_NO_HANDLES);
+ OS.g_object_ref (groupHandle);
+ OS.gtk_object_sink (groupHandle);
+ handle = OS.gtk_radio_button_new (OS.gtk_radio_button_get_group (groupHandle));
+ if (handle == 0) error (SWT.ERROR_NO_HANDLES);
+ break;
+ case SWT.PUSH:
+ default:
+ handle = OS.gtk_button_new ();
+ if (handle == 0) error (SWT.ERROR_NO_HANDLES);
+ OS.GTK_WIDGET_SET_FLAGS(handle, OS.GTK_CAN_DEFAULT);
+ break;
+ }
+ if ((style & SWT.ARROW) != 0) {
+ OS.gtk_container_add (handle, arrowHandle);
+ } else {
+ boxHandle = OS.gtk_hbox_new (false, 4);
+ if (boxHandle == 0) error (SWT.ERROR_NO_HANDLES);
+ labelHandle = OS.gtk_label_new_with_mnemonic (null);
+ if (labelHandle == 0) error (SWT.ERROR_NO_HANDLES);
+ imageHandle = OS.gtk_image_new ();
+ if (imageHandle == 0) error (SWT.ERROR_NO_HANDLES);
+ OS.gtk_container_add (handle, boxHandle);
+ OS.gtk_container_add (boxHandle, imageHandle);
+ OS.gtk_container_add (boxHandle, labelHandle);
+ }
+ OS.gtk_container_add (fixedHandle, handle);
+
+ if ((style & SWT.ARROW) != 0) return;
+ _setAlignment (style & (SWT.LEFT | SWT.CENTER | SWT.RIGHT));
+}
+
+void createWidget (int index) {
+ super.createWidget (index);
+ text = "";
+}
+
+void deregister () {
+ super.deregister ();
+ if (boxHandle != 0) display.removeWidget (boxHandle);
+ if (labelHandle != 0) display.removeWidget (labelHandle);
+ if (imageHandle != 0) display.removeWidget (imageHandle);
+ if (arrowHandle != 0) display.removeWidget (arrowHandle);
+}
+
+int /*long*/ fontHandle () {
+ if (labelHandle != 0) return labelHandle;
+ return super.fontHandle ();
+}
+
+/**
+ * Returns a value which describes the position of the
+ * text or image in the receiver. The value will be one of
+ * <code>LEFT</code>, <code>RIGHT</code> or <code>CENTER</code>
+ * unless the receiver is an <code>ARROW</code> button, in
+ * which case, the alignment will indicate the direction of
+ * the arrow (one of <code>LEFT</code>, <code>RIGHT</code>,
+ * <code>UP</code> or <code>DOWN</code>).
+ *
+ * @return the alignment
+ *
+ * @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 getAlignment () {
+ checkWidget ();
+ if ((style & SWT.ARROW) != 0) {
+ if ((style & SWT.UP) != 0) return SWT.UP;
+ if ((style & SWT.DOWN) != 0) return SWT.DOWN;
+ if ((style & SWT.LEFT) != 0) return SWT.LEFT;
+ if ((style & SWT.RIGHT) != 0) return SWT.RIGHT;
+ return SWT.UP;
+ }
+ if ((style & SWT.LEFT) != 0) return SWT.LEFT;
+ if ((style & SWT.CENTER) != 0) return SWT.CENTER;
+ if ((style & SWT.RIGHT) != 0) return SWT.RIGHT;
+ return SWT.LEFT;
+}
+
+/**
+ * Returns <code>true</code> if the receiver is grayed,
+ * and false otherwise. When the widget does not have
+ * the <code>CHECK</code> style, return false.
+ *
+ * @return the grayed state of the checkbox
+ *
+ * @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.4
+ */
+public boolean getGrayed () {
+ checkWidget();
+ if ((style & SWT.CHECK) == 0) return false;
+ return grayed;
+}
+
+/**
+ * Returns the receiver's image if it has one, or null
+ * if it does not.
+ *
+ * @return the receiver's image
+ *
+ * @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 Image getImage () {
+ checkWidget ();
+ return image;
+}
+
+String getNameText () {
+ return getText ();
+}
+
+/**
+ * Returns <code>true</code> if the receiver is selected,
+ * and false otherwise.
+ * <p>
+ * When the receiver is of type <code>CHECK</code> or <code>RADIO</code>,
+ * it is selected when it is checked. When it is of type <code>TOGGLE</code>,
+ * it is selected when it is pushed in. If the receiver is of any other type,
+ * this method returns false.
+ *
+ * @return the selection 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 getSelection () {
+ checkWidget ();
+ if ((style & (SWT.CHECK | SWT.RADIO | SWT.TOGGLE)) == 0) return false;
+ return OS.gtk_toggle_button_get_active (handle);
+}
+
+/**
+ * Returns the receiver's text, which will be an empty
+ * string if it has never been set or if the receiver is
+ * an <code>ARROW</code> button.
+ *
+ * @return the receiver'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>
+ */
+public String getText () {
+ checkWidget();
+ if ((style & SWT.ARROW) != 0) return "";
+ return text;
+}
+
+int /*long*/ gtk_button_press_event (int /*long*/ widget, int /*long*/ event) {
+ int /*long*/ result = super.gtk_button_press_event (widget, event);
+ if (result != 0) return result;
+ if ((style & SWT.RADIO) != 0) selected = getSelection ();
+ return result;
+}
+
+int /*long*/ gtk_clicked (int /*long*/ widget) {
+ if ((style & SWT.RADIO) != 0) {
+ if ((parent.getStyle () & SWT.NO_RADIO_GROUP) != 0) {
+ setSelection (!selected);
+ } else {
+ selectRadio ();
+ }
+ } else {
+ if ((style & SWT.CHECK) != 0) {
+ if (grayed) {
+ if (OS.gtk_toggle_button_get_active (handle)) {
+ OS.gtk_toggle_button_set_inconsistent (handle, true);
+ } else {
+ OS.gtk_toggle_button_set_inconsistent (handle, false);
+ }
+ }
+ }
+ }
+ postEvent (SWT.Selection);
+ return 0;
+}
+
+int /*long*/ gtk_focus_in_event (int /*long*/ widget, int /*long*/ event) {
+ int /*long*/ result = super.gtk_focus_in_event (widget, event);
+ // widget could be disposed at this point
+ if (handle == 0) return 0;
+ if ((style & SWT.PUSH) != 0 && OS.GTK_WIDGET_HAS_DEFAULT (handle)) {
+ Decorations menuShell = menuShell ();
+ menuShell.defaultButton = this;
+ }
+ return result;
+}
+
+int /*long*/ gtk_focus_out_event (int /*long*/ widget, int /*long*/ event) {
+ int /*long*/ result = super.gtk_focus_out_event (widget, event);
+ // widget could be disposed at this point
+ if (handle == 0) return 0;
+ if ((style & SWT.PUSH) != 0 && !OS.GTK_WIDGET_HAS_DEFAULT (handle)) {
+ Decorations menuShell = menuShell ();
+ if (menuShell.defaultButton == this) {
+ menuShell.defaultButton = null;
+ }
+ }
+ return result;
+}
+
+int /*long*/ gtk_key_press_event (int /*long*/ widget, int /*long*/ event) {
+ int /*long*/ result = super.gtk_key_press_event (widget, event);
+ if (result != 0) return result;
+ if ((style & SWT.RADIO) != 0) selected = getSelection ();
+ return result;
+}
+
+void hookEvents () {
+ super.hookEvents();
+ OS.g_signal_connect_closure (handle, OS.clicked, display.closures [CLICKED], false);
+ if (labelHandle != 0) {
+ OS.g_signal_connect_closure_by_id (labelHandle, display.signalIds [MNEMONIC_ACTIVATE], 0, display.closures [MNEMONIC_ACTIVATE], false);
+ }
+}
+
+boolean isDescribedByLabel () {
+ return false;
+}
+
+boolean mnemonicHit (char key) {
+ if (labelHandle == 0) return false;
+ boolean result = super.mnemonicHit (labelHandle, key);
+ if (result) setFocus ();
+ return result;
+}
+
+boolean mnemonicMatch (char key) {
+ if (labelHandle == 0) return false;
+ return mnemonicMatch (labelHandle, key);
+}
+
+void register () {
+ super.register ();
+ if (boxHandle != 0) display.addWidget (boxHandle, this);
+ if (labelHandle != 0) display.addWidget (labelHandle, this);
+ if (imageHandle != 0) display.addWidget (imageHandle, this);
+ if (arrowHandle != 0) display.addWidget (arrowHandle, this);
+}
+
+void releaseHandle () {
+ super.releaseHandle ();
+ boxHandle = imageHandle = labelHandle = arrowHandle = 0;
+}
+
+void releaseWidget () {
+ super.releaseWidget ();
+ if (groupHandle != 0) OS.g_object_unref (groupHandle);
+ groupHandle = 0;
+ if (imageList != null) imageList.dispose ();
+ imageList = null;
+ image = null;
+ text = null;
+}
+
+/**
+ * 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);
+}
+
+void resizeHandle (int width, int height) {
+ super.resizeHandle (width, height);
+ /*
+ * Feature in GTK, GtkCheckButton and GtkRadioButton allocate
+ * only the minimum size necessary for its child. This causes the child
+ * alignment to fail. The fix is to set the child size to the size
+ * of the button.
+ */
+ if ((style & (SWT.CHECK | SWT.RADIO)) != 0) {
+ OS.gtk_widget_set_size_request (boxHandle, width, -1);
+ }
+}
+
+void selectRadio () {
+ /*
+ * This code is intentionally commented. When two groups
+ * of radio buttons with the same parent are separated by
+ * another control, the correct behavior should be that
+ * the two groups act independently. This is consistent
+ * with radio tool and menu items. The commented code
+ * implements this behavior.
+ */
+// int index = 0;
+// Control [] children = parent._getChildren ();
+// while (index < children.length && children [index] != this) index++;
+// int i = index - 1;
+// while (i >= 0 && children [i].setRadioSelection (false)) --i;
+// int j = index + 1;
+// while (j < children.length && children [j].setRadioSelection (false)) j++;
+// setSelection (true);
+ Control [] children = parent._getChildren ();
+ for (int i=0; i<children.length; i++) {
+ Control child = children [i];
+ if (this != child) child.setRadioSelection (false);
+ }
+ setSelection (true);
+}
+
+/**
+ * Controls how text, images and arrows will be displayed
+ * in the receiver. The argument should be one of
+ * <code>LEFT</code>, <code>RIGHT</code> or <code>CENTER</code>
+ * unless the receiver is an <code>ARROW</code> button, in
+ * which case, the argument indicates the direction of
+ * the arrow (one of <code>LEFT</code>, <code>RIGHT</code>,
+ * <code>UP</code> or <code>DOWN</code>).
+ *
+ * @param alignment the new alignment
+ *
+ * @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 setAlignment (int alignment) {
+ checkWidget ();
+ _setAlignment (alignment);
+}
+
+void _setAlignment (int alignment) {
+ if ((style & SWT.ARROW) != 0) {
+ if ((style & (SWT.UP | SWT.DOWN | SWT.LEFT | SWT.RIGHT)) == 0) return;
+ style &= ~(SWT.UP | SWT.DOWN | SWT.LEFT | SWT.RIGHT);
+ style |= alignment & (SWT.UP | SWT.DOWN | SWT.LEFT | SWT.RIGHT);
+ int arrow_type = OS.GTK_ARROW_UP;
+ boolean isRTL = (style & SWT.RIGHT_TO_LEFT) != 0;
+ switch (alignment) {
+ case SWT.UP: arrow_type = OS.GTK_ARROW_UP; break;
+ case SWT.DOWN: arrow_type = OS.GTK_ARROW_DOWN; break;
+ case SWT.LEFT: arrow_type = isRTL ? OS.GTK_ARROW_RIGHT : OS.GTK_ARROW_LEFT; break;
+ case SWT.RIGHT: arrow_type = isRTL ? OS.GTK_ARROW_LEFT : OS.GTK_ARROW_RIGHT; break;
+ }
+ OS.gtk_arrow_set (arrowHandle, arrow_type, OS.GTK_SHADOW_OUT);
+ return;
+ }
+ if ((alignment & (SWT.LEFT | SWT.RIGHT | SWT.CENTER)) == 0) return;
+ style &= ~(SWT.LEFT | SWT.RIGHT | SWT.CENTER);
+ style |= alignment & (SWT.LEFT | SWT.RIGHT | SWT.CENTER);
+ /* Alignment not honoured when image and text are visible */
+ boolean bothVisible = OS.GTK_WIDGET_VISIBLE (labelHandle) && OS.GTK_WIDGET_VISIBLE (imageHandle);
+ if (bothVisible) {
+ if ((style & (SWT.RADIO | SWT.CHECK)) != 0) alignment = SWT.LEFT;
+ if ((style & (SWT.PUSH | SWT.TOGGLE)) != 0) alignment = SWT.CENTER;
+ }
+ if ((alignment & SWT.LEFT) != 0) {
+ if (bothVisible) {
+ OS.gtk_box_set_child_packing (boxHandle, labelHandle, false, false, 0, OS.GTK_PACK_START);
+ OS.gtk_box_set_child_packing (boxHandle, imageHandle, false, false, 0, OS.GTK_PACK_START);
+ }
+ OS.gtk_misc_set_alignment (labelHandle, 0.0f, 0.5f);
+ OS.gtk_label_set_justify (labelHandle, OS.GTK_JUSTIFY_LEFT);
+ OS.gtk_misc_set_alignment (imageHandle, 0.0f, 0.5f);
+ return;
+ }
+ if ((alignment & SWT.CENTER) != 0) {
+ if (bothVisible) {
+ OS.gtk_box_set_child_packing (boxHandle, labelHandle, true, true, 0, OS.GTK_PACK_END);
+ OS.gtk_box_set_child_packing (boxHandle, imageHandle, true, true, 0, OS.GTK_PACK_START);
+ OS.gtk_misc_set_alignment (labelHandle, 0f, 0.5f);
+ OS.gtk_misc_set_alignment (imageHandle, 1f, 0.5f);
+ } else {
+ OS.gtk_misc_set_alignment (labelHandle, 0.5f, 0.5f);
+ OS.gtk_label_set_justify (labelHandle, OS.GTK_JUSTIFY_CENTER);
+ OS.gtk_misc_set_alignment (imageHandle, 0.5f, 0.5f);
+ }
+ return;
+ }
+ if ((alignment & SWT.RIGHT) != 0) {
+ if (bothVisible) {
+ OS.gtk_box_set_child_packing (boxHandle, labelHandle, false, false, 0, OS.GTK_PACK_END);
+ OS.gtk_box_set_child_packing (boxHandle, imageHandle, false, false, 0, OS.GTK_PACK_END);
+ }
+ OS.gtk_misc_set_alignment (labelHandle, 1.0f, 0.5f);
+ OS.gtk_label_set_justify (labelHandle, OS.GTK_JUSTIFY_RIGHT);
+ OS.gtk_misc_set_alignment (imageHandle, 1.0f, 0.5f);
+ return;
+ }
+}
+
+void setBackgroundColor (GdkColor color) {
+ super.setBackgroundColor (color);
+ setBackgroundColor(fixedHandle, color);
+ if (labelHandle != 0) setBackgroundColor(labelHandle, color);
+ if (imageHandle != 0) setBackgroundColor(imageHandle, color);
+}
+
+void setFontDescription (int /*long*/ font) {
+ super.setFontDescription (font);
+ if (labelHandle != 0) OS.gtk_widget_modify_font (labelHandle, font);
+ if (imageHandle != 0) OS.gtk_widget_modify_font (imageHandle, font);
+}
+
+boolean setRadioSelection (boolean value) {
+ if ((style & SWT.RADIO) == 0) return false;
+ if (getSelection () != value) {
+ setSelection (value);
+ postEvent (SWT.Selection);
+ }
+ return true;
+}
+
+void setForegroundColor (GdkColor color) {
+ super.setForegroundColor (color);
+ setForegroundColor (fixedHandle, color);
+ if (labelHandle != 0) setForegroundColor (labelHandle, color);
+ if (imageHandle != 0) setForegroundColor (imageHandle, color);
+}
+
+/**
+ * Sets the grayed state of the receiver. This state change
+ * only applies if the control was created with the SWT.CHECK
+ * style.
+ *
+ * @param grayed the new grayed 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>
+ *
+ * @since 3.4
+ */
+public void setGrayed (boolean grayed) {
+ checkWidget();
+ if ((style & SWT.CHECK) == 0) return;
+ this.grayed = grayed;
+ if (grayed && OS.gtk_toggle_button_get_active (handle)) {
+ OS.gtk_toggle_button_set_inconsistent (handle, true);
+ } else {
+ OS.gtk_toggle_button_set_inconsistent (handle, false);
+ }
+}
+
+/**
+ * Sets the receiver's image to the argument, which may be
+ * <code>null</code> indicating that no image should be displayed.
+ * <p>
+ * Note that a Button can display an image and text simultaneously
+ * on Windows (starting with XP), GTK+ and OSX. On other platforms,
+ * a Button that has an image and text set into it will display the
+ * image or text that was set most recently.
+ * </p>
+ * @param image the image to display on the receiver (may be <code>null</code>)
+ *
+ * @exception IllegalArgumentException <ul>
+ * <li>ERROR_INVALID_ARGUMENT - if the image has been disposed</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 setImage (Image image) {
+ checkWidget ();
+ if ((style & SWT.ARROW) != 0) return;
+ if (imageList != null) imageList.dispose ();
+ imageList = null;
+ if (image != null) {
+ if (image.isDisposed()) error (SWT.ERROR_INVALID_ARGUMENT);
+ imageList = new ImageList ();
+ int imageIndex = imageList.add (image);
+ int /*long*/ pixbuf = imageList.getPixbuf (imageIndex);
+ OS.gtk_image_set_from_pixbuf (imageHandle, pixbuf);
+ if (text.length () == 0) OS.gtk_widget_hide (labelHandle);
+ OS.gtk_widget_show (imageHandle);
+ } else {
+ OS.gtk_image_set_from_pixbuf (imageHandle, 0);
+ OS.gtk_widget_show (labelHandle);
+ OS.gtk_widget_hide (imageHandle);
+ }
+ this.image = image;
+ _setAlignment (style);
+}
+
+void setOrientation () {
+ super.setOrientation ();
+ if ((style & SWT.RIGHT_TO_LEFT) != 0) {
+ if (boxHandle != 0) OS.gtk_widget_set_direction (boxHandle, OS.GTK_TEXT_DIR_RTL);
+ if (labelHandle != 0) OS.gtk_widget_set_direction (labelHandle, OS.GTK_TEXT_DIR_RTL);
+ if (imageHandle != 0) OS.gtk_widget_set_direction (imageHandle, OS.GTK_TEXT_DIR_RTL);
+ if (arrowHandle != 0) {
+ switch (style & (SWT.LEFT | SWT.RIGHT)) {
+ case SWT.LEFT: OS.gtk_arrow_set (arrowHandle, OS.GTK_ARROW_RIGHT, OS.GTK_SHADOW_OUT); break;
+ case SWT.RIGHT: OS.gtk_arrow_set (arrowHandle, OS.GTK_ARROW_LEFT, OS.GTK_SHADOW_OUT); break;
+ }
+ }
+ }
+}
+
+/**
+ * Sets the selection state of the receiver, if it is of type <code>CHECK</code>,
+ * <code>RADIO</code>, or <code>TOGGLE</code>.
+ *
+ * <p>
+ * When the receiver is of type <code>CHECK</code> or <code>RADIO</code>,
+ * it is selected when it is checked. When it is of type <code>TOGGLE</code>,
+ * it is selected when it is pushed in.
+ *
+ * @param selected the new selection 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 setSelection (boolean selected) {
+ checkWidget();
+ if ((style & (SWT.CHECK | SWT.RADIO | SWT.TOGGLE)) == 0) return;
+ OS.g_signal_handlers_block_matched (handle, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, CLICKED);
+ OS.gtk_toggle_button_set_active (handle, selected);
+ if ((style & SWT.CHECK) != 0) {
+ if (selected && grayed) {
+ OS.gtk_toggle_button_set_inconsistent (handle, true);
+ } else {
+ OS.gtk_toggle_button_set_inconsistent (handle, false);
+ }
+ }
+ if ((style & SWT.RADIO) != 0) OS.gtk_toggle_button_set_active (groupHandle, !selected);
+ OS.g_signal_handlers_unblock_matched (handle, OS.G_SIGNAL_MATCH_DATA, 0, 0, 0, 0, CLICKED);
+}
+
+/**
+ * Sets the receiver's text.
+ * <p>
+ * This method sets the button label. The label may include
+ * the mnemonic character but must not contain line delimiters.
+ * </p>
+ * <p>
+ * Mnemonics are indicated by an '&amp;' that causes the next
+ * character to be the mnemonic. When the user presses a
+ * key sequence that matches the mnemonic, a selection
+ * event occurs. On most platforms, the mnemonic appears
+ * underlined but may be emphasized in a platform specific
+ * manner. The mnemonic indicator character '&amp;' can be
+ * escaped by doubling it in the string, causing a single
+ * '&amp;' to be displayed.
+ * </p><p>
+ * Note that a Button can display an image and text simultaneously
+ * on Windows (starting with XP), GTK+ and OSX. On other platforms,
+ * a Button that has an image and text set into it will display the
+ * image or text that was set most recently.
+ * </p>
+ * @param string the new text
+ *
+ * @exception IllegalArgumentException <ul>
+ * <li>ERROR_NULL_ARGUMENT - if the text 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);
+ if ((style & SWT.ARROW) != 0) return;
+ text = string;
+ char [] chars = fixMnemonic (string);
+ byte [] buffer = Converter.wcsToMbcs (null, chars, true);
+ OS.gtk_label_set_text_with_mnemonic (labelHandle, buffer);
+ if (image == null) OS.gtk_widget_hide (imageHandle);
+ OS.gtk_widget_show (labelHandle);
+ _setAlignment (style);
+}
+
+void showWidget () {
+ super.showWidget ();
+ if (boxHandle != 0) OS.gtk_widget_show (boxHandle);
+ if (labelHandle != 0) OS.gtk_widget_show (labelHandle);
+ if (arrowHandle != 0) OS.gtk_widget_show (arrowHandle);
+}
+
+int traversalCode (int key, GdkEventKey event) {
+ int code = super.traversalCode (key, event);
+ if ((style & SWT.ARROW) != 0) code &= ~(SWT.TRAVERSE_TAB_NEXT | SWT.TRAVERSE_TAB_PREVIOUS);
+ if ((style & SWT.RADIO) != 0) code |= SWT.TRAVERSE_ARROW_NEXT | SWT.TRAVERSE_ARROW_PREVIOUS;
+ return code;
+}
+
+}