Java tutorial
/******************************************************************************* * Copyright (c) 2000, 2018 IBM Corporation and others. * * This program and the accompanying materials * are made available under the terms of the Eclipse Public License 2.0 * which accompanies this distribution, and is available at * https://www.eclipse.org/legal/epl-2.0/ * * SPDX-License-Identifier: EPL-2.0 * * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ package org.eclipse.swt.widgets; import org.eclipse.swt.*; import org.eclipse.swt.events.*; import org.eclipse.swt.graphics.*; import org.eclipse.swt.internal.*; import org.eclipse.swt.internal.cairo.*; import org.eclipse.swt.internal.gtk.*; /** * Instances of this class represent popup windows that are used * to inform or warn the user. * <dl> * <dt><b>Styles:</b></dt> * <dd>BALLOON, ICON_ERROR, ICON_INFORMATION, ICON_WARNING</dd> * <dt><b>Events:</b></dt> * <dd>Selection</dd> * </dl> * <p> * Note: Only one of the styles ICON_ERROR, ICON_INFORMATION, * and ICON_WARNING may be specified. * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> * * @see <a href="http://www.eclipse.org/swt/snippets/#tooltips">Tool Tips 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> * * @since 3.2 * @noextend This class is not intended to be subclassed by clients. */ public class ToolTip extends Widget { Shell parent; String text, message; TrayItem item; int x, y, timerId; long layoutText = 0, layoutMessage = 0; long provider; int[] borderPolygon; boolean spikeAbove, autohide; static final int BORDER = 5; static final int PADDING = 5; static final int INSET = 4; static final int TIP_HEIGHT = 20; static final int IMAGE_SIZE = 16; static final int DELAY = 8000; /** * 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#BALLOON * @see SWT#ICON_ERROR * @see SWT#ICON_INFORMATION * @see SWT#ICON_WARNING * @see Widget#checkSubclass * @see Widget#getStyle */ public ToolTip(Shell parent, int style) { super(parent, checkStyle(style)); this.parent = parent; createWidget(0); parent.addToolTip(this); } static int checkStyle(int style) { int mask = SWT.ICON_ERROR | SWT.ICON_INFORMATION | SWT.ICON_WARNING; if ((style & mask) == 0) return style; return checkBits(style, SWT.ICON_INFORMATION, SWT.ICON_WARNING, SWT.ICON_ERROR, 0, 0, 0); } /** * Adds the listener to the collection of listeners who will * be notified when the receiver 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 receiver is selected. * <code>widgetDefaultSelected</code> is not called. * </p> * * @param listener the listener which should be notified when the receiver 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); } void configure() { GTK.gtk_widget_realize(handle); /* * Feature in GTK: using gdk_screen_get_monitor_at_window() does not accurately get the correct monitor on the machine. * Using gdk_screen_get_monitor_at_point() returns it correctly. Using getLocation() on point will get * the coordinates for where the tooltip should appear on the host. */ Point point = getLocation(); boolean multipleMonitors; int monitorNumber; GdkRectangle dest = new GdkRectangle(); if (GTK.GTK_VERSION >= OS.VERSION(3, 22, 0)) { long display = GDK.gdk_display_get_default(); multipleMonitors = GDK.gdk_display_get_n_monitors(display) > 1; long monitor = GDK.gdk_display_get_monitor_at_point(display, point.x, point.y); GDK.gdk_monitor_get_geometry(monitor, dest); } else { long screen = GDK.gdk_screen_get_default(); multipleMonitors = GDK.gdk_screen_get_n_monitors(screen) > 1; monitorNumber = GDK.gdk_screen_get_monitor_at_point(screen, point.x, point.y); GDK.gdk_screen_get_monitor_geometry(screen, monitorNumber, dest); } point = getSize(dest.width / 4); int w = point.x; int h = point.y; point = getLocation(); int x = point.x; int y = point.y; GTK.gtk_window_resize(handle, w, h + TIP_HEIGHT); int[] polyline; Rectangle bounds = display.getBounds(); int width = bounds != null && GTK.GTK4 ? bounds.width : GDK.gdk_screen_width(); spikeAbove = dest.height >= y + h + TIP_HEIGHT; if ((dest.width >= x + w) || (multipleMonitors && width >= x + w)) { if (dest.height >= y + h + TIP_HEIGHT) { int t = TIP_HEIGHT; polyline = new int[] { 0, 5 + t, 1, 5 + t, 1, 3 + t, 3, 1 + t, 5, 1 + t, 5, t, 16, t, 16, 0, 35, t, w - 5, t, w - 5, 1 + t, w - 3, 1 + t, w - 1, 3 + t, w - 1, 5 + t, w, 5 + t, w, h - 5 + t, w - 1, h - 5 + t, w - 1, h - 3 + t, w - 2, h - 3 + t, w - 2, h - 2 + t, w - 3, h - 2 + t, w - 3, h - 1 + t, w - 5, h - 1 + t, w - 5, h + t, 5, h + t, 5, h - 1 + t, 3, h - 1 + t, 3, h - 2 + t, 2, h - 2 + t, 2, h - 3 + t, 1, h - 3 + t, 1, h - 5 + t, 0, h - 5 + t, 0, 5 + t }; borderPolygon = new int[] { 0, 5 + t, 1, 4 + t, 1, 3 + t, 3, 1 + t, 4, 1 + t, 5, t, 16, t, 16, 1, 35, t, w - 6, 0 + t, w - 5, 1 + t, w - 4, 1 + t, w - 2, 3 + t, w - 2, 4 + t, w - 1, 5 + t, w - 1, h - 6 + t, w - 2, h - 5 + t, w - 2, h - 4 + t, w - 4, h - 2 + t, w - 5, h - 2 + t, w - 6, h - 1 + t, 5, h - 1 + t, 4, h - 2 + t, 3, h - 2 + t, 1, h - 4 + t, 1, h - 5 + t, 0, h - 6 + t, 0, 5 + t }; if ((parent.style & SWT.MIRRORED) != 0) { x -= w - 36; polyline[12] = w - 36; polyline[14] = w - 16; polyline[16] = w - 15; borderPolygon[12] = w - 35; borderPolygon[14] = borderPolygon[16] = w - 16; } GTK.gtk_window_move(handle, Math.max(0, x - 17), y); } else { polyline = new int[] { 0, 5, 1, 5, 1, 3, 3, 1, 5, 1, 5, 0, w - 5, 0, w - 5, 1, w - 3, 1, w - 1, 3, w - 1, 5, w, 5, w, h - 5, w - 1, h - 5, w - 1, h - 3, w - 2, h - 3, w - 2, h - 2, w - 3, h - 2, w - 3, h - 1, w - 5, h - 1, w - 5, h, 35, h, 16, h + TIP_HEIGHT, 16, h, 5, h, 5, h - 1, 3, h - 1, 3, h - 2, 2, h - 2, 2, h - 3, 1, h - 3, 1, h - 5, 0, h - 5, 0, 5 }; borderPolygon = new int[] { 0, 5, 1, 4, 1, 3, 3, 1, 4, 1, 5, 0, w - 6, 0, w - 5, 1, w - 4, 1, w - 2, 3, w - 2, 4, w - 1, 5, w - 1, h - 6, w - 2, h - 5, w - 2, h - 4, w - 4, h - 2, w - 5, h - 2, w - 6, h - 1, 35, h - 1, 17, h + TIP_HEIGHT - 2, 17, h - 1, 5, h - 1, 4, h - 2, 3, h - 2, 1, h - 4, 1, h - 5, 0, h - 6, 0, 5 }; if ((parent.style & SWT.MIRRORED) != 0) { x -= w - 36; polyline[42] = polyline[44] = w - 16; polyline[46] = w - 35; borderPolygon[36] = borderPolygon[38] = w - 17; borderPolygon[40] = w - 35; } GTK.gtk_window_move(handle, Math.max(0, x - 17), y - h - TIP_HEIGHT); } } else { if (dest.height >= y + h + TIP_HEIGHT) { int t = TIP_HEIGHT; polyline = new int[] { 0, 5 + t, 1, 5 + t, 1, 3 + t, 3, 1 + t, 5, 1 + t, 5, t, w - 35, t, w - 16, 0, w - 16, t, w - 5, t, w - 5, 1 + t, w - 3, 1 + t, w - 1, 3 + t, w - 1, 5 + t, w, 5 + t, w, h - 5 + t, w - 1, h - 5 + t, w - 1, h - 3 + t, w - 2, h - 3 + t, w - 2, h - 2 + t, w - 3, h - 2 + t, w - 3, h - 1 + t, w - 5, h - 1 + t, w - 5, h + t, 5, h + t, 5, h - 1 + t, 3, h - 1 + t, 3, h - 2 + t, 2, h - 2 + t, 2, h - 3 + t, 1, h - 3 + t, 1, h - 5 + t, 0, h - 5 + t, 0, 5 + t }; borderPolygon = new int[] { 0, 5 + t, 1, 4 + t, 1, 3 + t, 3, 1 + t, 4, 1 + t, 5, t, w - 35, t, w - 17, 2, w - 17, t, w - 6, t, w - 5, 1 + t, w - 4, 1 + t, w - 2, 3 + t, w - 2, 4 + t, w - 1, 5 + t, w - 1, h - 6 + t, w - 2, h - 5 + t, w - 2, h - 4 + t, w - 4, h - 2 + t, w - 5, h - 2 + t, w - 6, h - 1 + t, 5, h - 1 + t, 4, h - 2 + t, 3, h - 2 + t, 1, h - 4 + t, 1, h - 5 + t, 0, h - 6 + t, 0, 5 + t }; if ((parent.style & SWT.MIRRORED) != 0) { x += w - 35; polyline[12] = polyline[14] = 16; polyline[16] = 35; borderPolygon[12] = borderPolygon[14] = 16; borderPolygon[16] = 35; } GTK.gtk_window_move(handle, Math.max(dest.width - w, x - w + 17), y); } else { polyline = new int[] { 0, 5, 1, 5, 1, 3, 3, 1, 5, 1, 5, 0, w - 5, 0, w - 5, 1, w - 3, 1, w - 1, 3, w - 1, 5, w, 5, w, h - 5, w - 1, h - 5, w - 1, h - 3, w - 2, h - 3, w - 2, h - 2, w - 3, h - 2, w - 3, h - 1, w - 5, h - 1, w - 5, h, w - 16, h, w - 16, h + TIP_HEIGHT, w - 35, h, 5, h, 5, h - 1, 3, h - 1, 3, h - 2, 2, h - 2, 2, h - 3, 1, h - 3, 1, h - 5, 0, h - 5, 0, 5 }; borderPolygon = new int[] { 0, 5, 1, 4, 1, 3, 3, 1, 4, 1, 5, 0, w - 6, 0, w - 5, 1, w - 4, 1, w - 2, 3, w - 2, 4, w - 1, 5, w - 1, h - 6, w - 2, h - 5, w - 2, h - 4, w - 4, h - 2, w - 5, h - 2, w - 6, h - 1, w - 17, h - 1, w - 17, h + TIP_HEIGHT - 2, w - 36, h - 1, 5, h - 1, 4, h - 2, 3, h - 2, 1, h - 4, 1, h - 5, 0, h - 6, 0, 5 }; if ((parent.style & SWT.MIRRORED) != 0) { x += w - 35; polyline[42] = 35; polyline[44] = polyline[46] = 16; borderPolygon[36] = 35; borderPolygon[38] = borderPolygon[40] = 17; } GTK.gtk_window_move(handle, Math.max(dest.width - w, x - w + 17), y - h - TIP_HEIGHT); } } GTK.gtk_widget_realize(handle); Region region = new Region(display); region.add(DPIUtil.autoScaleDown(polyline)); GTK.gtk_widget_shape_combine_region(handle, region.handle); region.dispose(); } @Override void createHandle(int index) { if ((style & SWT.BALLOON) != 0) { state |= HANDLE; handle = GTK.gtk_window_new(GTK.GTK_WINDOW_POPUP); Color background = display.getSystemColor(SWT.COLOR_INFO_BACKGROUND); long context = GTK.gtk_widget_get_style_context(handle); GdkRGBA bgRGBA = background.handle; String name = GTK.GTK_VERSION >= OS.VERSION(3, 20, 0) ? "window" : "GtkWindow"; String css = name + " {background-color: " + display.gtk_rgba_to_css_string(bgRGBA) + ";}"; gtk_css_provider_load_from_css(context, css); GTK.gtk_style_context_invalidate(context); GTK.gtk_window_set_type_hint(handle, GDK.GDK_WINDOW_TYPE_HINT_TOOLTIP); } } void gtk_css_provider_load_from_css(long context, String css) { /* Utility function. */ //@param css : a 'css java' string like "{\nbackground: red;\n}". if (provider == 0) { provider = GTK.gtk_css_provider_new(); GTK.gtk_style_context_add_provider(context, provider, GTK.GTK_STYLE_PROVIDER_PRIORITY_APPLICATION); OS.g_object_unref(provider); } if (GTK.GTK4) { GTK.gtk_css_provider_load_from_data(provider, Converter.wcsToMbcs(css, true), -1); } else { GTK.gtk_css_provider_load_from_data(provider, Converter.wcsToMbcs(css, true), -1, null); } } @Override void createWidget(int index) { super.createWidget(index); text = ""; message = ""; x = y = -1; autohide = true; } @Override void destroyWidget() { long topHandle = topHandle(); if (parent != null) parent.removeTooTip(this); releaseHandle(); if (topHandle != 0 && (state & HANDLE) != 0) { if ((style & SWT.BALLOON) != 0) { GTK.gtk_widget_destroy(topHandle); } else { OS.g_object_unref(topHandle); } } } /** * Returns <code>true</code> if the receiver is automatically * hidden by the platform, and <code>false</code> otherwise. * * @return the receiver's auto hide 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 getAutoHide() { checkWidget(); return autohide; } Point getLocation() { int x = this.x; int y = this.y; if (item != null) { long itemHandle = item.handle; GdkRectangle area = new GdkRectangle(); GTK.gtk_status_icon_get_geometry(itemHandle, 0, area, 0); x = area.x + area.width / 2; y = area.y + area.height / 2; } if (x == -1 || y == -1) { int[] px = new int[1], py = new int[1]; if (GTK.GTK4) { /* * TODO: calling gdk_window_get_device_position() with a 0 * for the GdkWindow uses gdk_get_default_root_window(), * which doesn't exist on GTK4. */ } else { display.gdk_window_get_device_position(0, px, py, null); } x = px[0]; y = py[0]; } return new Point(x, y); } /** * Returns the receiver's message, which will be an empty * string if it has never been set. * * @return the receiver's 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> */ public String getMessage() { checkWidget(); return message; } @Override String getNameText() { return getText(); } /** * Returns the receiver's parent, which must be a <code>Shell</code>. * * @return the receiver's parent * * @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 Shell getParent() { checkWidget(); return parent; } Point getSize(int maxWidth) { int textWidth = 0, messageWidth = 0; int[] w = new int[1], h = new int[1]; if (layoutText != 0) { OS.pango_layout_set_width(layoutText, -1); OS.pango_layout_get_pixel_size(layoutText, w, h); textWidth = w[0]; } if (layoutMessage != 0) { OS.pango_layout_set_width(layoutMessage, -1); OS.pango_layout_get_pixel_size(layoutMessage, w, h); messageWidth = w[0]; } int messageTrim = 2 * INSET + 2 * BORDER + 2 * PADDING; boolean hasImage = layoutText != 0 && (style & (SWT.ICON_ERROR | SWT.ICON_INFORMATION | SWT.ICON_WARNING)) != 0; int textTrim = messageTrim + (hasImage ? IMAGE_SIZE : 0); int width = Math.min(maxWidth, Math.max(textWidth + textTrim, messageWidth + messageTrim)); int textHeight = 0, messageHeight = 0; if (layoutText != 0) { OS.pango_layout_set_width(layoutText, (maxWidth - textTrim) * OS.PANGO_SCALE); OS.pango_layout_get_pixel_size(layoutText, w, h); textHeight = h[0]; } if (layoutMessage != 0) { OS.pango_layout_set_width(layoutMessage, (maxWidth - messageTrim) * OS.PANGO_SCALE); OS.pango_layout_get_pixel_size(layoutMessage, w, h); messageHeight = h[0]; } int height = 2 * BORDER + 2 * PADDING + messageHeight; if (layoutText != 0) height += Math.max(IMAGE_SIZE, textHeight) + 2 * PADDING; return new Point(width, height); } /** * Returns the receiver's text, which will be an empty * string if it has never been set. * * @return the receiver's text * * @exception SWTException <ul> * <li>ERROR_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(); return text; } /** * Returns <code>true</code> if the receiver is visible, and * <code>false</code> otherwise. * <p> * If one of the receiver's ancestors is not visible or some * other condition makes the receiver not visible, this method * may still indicate that it is considered visible even though * it may not actually be showing. * </p> * * @return the receiver's visibility 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 getVisible() { checkWidget(); if ((style & SWT.BALLOON) != 0) return GTK.gtk_widget_get_visible(handle); return false; } @Override long gtk_event(long widget, long event) { if (!GTK.GTK4) return 0; int eventType = GDK.gdk_event_get_event_type(event); switch (eventType) { case GDK.GDK4_BUTTON_PRESS: { return gtk_button_press_event(widget, event); } case GDK.GDK4_BUTTON_RELEASE: { return gtk_button_release_event(widget, event); } } return 0; } @Override long gtk_button_press_event(long widget, long event) { sendSelectionEvent(SWT.Selection, null, true); setVisible(false); return 0; } void drawTooltip(long cairo) { int x = BORDER + PADDING; int y = BORDER + PADDING; if (cairo == 0) error(SWT.ERROR_NO_HANDLES); int count = borderPolygon.length / 2; if (count != 0) { Cairo.cairo_set_line_width(cairo, 1); Cairo.cairo_move_to(cairo, borderPolygon[0], borderPolygon[1]); for (int i = 1, j = 2; i < count; i++, j += 2) { Cairo.cairo_line_to(cairo, borderPolygon[j] + 0.5, borderPolygon[j + 1] + 0.5); } Cairo.cairo_close_path(cairo); Cairo.cairo_stroke(cairo); } if (spikeAbove) y += TIP_HEIGHT; if (layoutText != 0) { byte[] buffer = null; int id = style & (SWT.ICON_ERROR | SWT.ICON_INFORMATION | SWT.ICON_WARNING); switch (id) { case SWT.ICON_ERROR: buffer = Converter.wcsToMbcs("dialog-error", true); break; case SWT.ICON_INFORMATION: buffer = Converter.wcsToMbcs("dialog-information", true); break; case SWT.ICON_WARNING: buffer = Converter.wcsToMbcs("dialog-warning", true); break; } if (buffer != null) { long pixbuf = GTK.gtk_icon_theme_load_icon(GTK.gtk_icon_theme_get_default(), buffer, GTK.GTK_ICON_SIZE_MENU, 0, 0); GDK.gdk_cairo_set_source_pixbuf(cairo, pixbuf, x, y); Cairo.cairo_paint(cairo); OS.g_object_unref(pixbuf); x += IMAGE_SIZE; } x += INSET; int[] w = new int[1], h = new int[1]; Color foreground = display.getSystemColor(SWT.COLOR_INFO_FOREGROUND); GDK.gdk_cairo_set_source_rgba(cairo, foreground.handle); Cairo.cairo_move_to(cairo, x, y); OS.pango_cairo_show_layout(cairo, layoutText); OS.pango_layout_get_pixel_size(layoutText, w, h); y += 2 * PADDING + Math.max(IMAGE_SIZE, h[0]); } if (layoutMessage != 0) { x = BORDER + PADDING + INSET; Color foreground = display.getSystemColor(SWT.COLOR_INFO_FOREGROUND); GDK.gdk_cairo_set_source_rgba(cairo, foreground.handle); Cairo.cairo_move_to(cairo, x, y); OS.pango_cairo_show_layout(cairo, layoutMessage); } } @Override long gtk_draw(long widget, long cairo) { if ((state & OBSCURED) != 0) return 0; drawTooltip(cairo); return 0; } @Override long gtk_size_allocate(long widget, long allocation) { Point point = getLocation(); int x = point.x; int y = point.y; GTK.gtk_widget_realize(widget); GdkRectangle dest = new GdkRectangle(); if (GTK.GTK_VERSION >= OS.VERSION(3, 22, 0)) { long display = GDK.gdk_display_get_default(); long monitor = GDK.gdk_display_get_monitor_at_point(display, x, y); GDK.gdk_monitor_get_geometry(monitor, dest); } else { long screen = GDK.gdk_screen_get_default(); int monitorNumber = GDK.gdk_screen_get_monitor_at_point(screen, point.x, point.y); GDK.gdk_screen_get_monitor_geometry(screen, monitorNumber, dest); } GtkAllocation widgetAllocation = new GtkAllocation(); GTK.gtk_widget_get_allocation(widget, widgetAllocation); int w = widgetAllocation.width; int h = widgetAllocation.height; if (dest.height < y + h) y -= h; if (dest.width < x + w) x -= w; GTK.gtk_window_move(widget, x, y); return 0; } @Override void hookEvents() { if ((style & SWT.BALLOON) != 0) { OS.g_signal_connect_closure_by_id(handle, display.signalIds[EXPOSE_EVENT], 0, display.getClosure(EXPOSE_EVENT), true); OS.g_signal_connect_closure_by_id(handle, display.signalIds[EXPOSE_EVENT_INVERSE], 0, display.getClosure(EXPOSE_EVENT_INVERSE), true); GTK.gtk_widget_add_events(handle, GDK.GDK_BUTTON_PRESS_MASK); if (GTK.GTK4) { OS.g_signal_connect_closure_by_id(handle, display.signalIds[EVENT], 0, display.getClosure(EVENT), false); } else { OS.g_signal_connect_closure(handle, OS.button_press_event, display.getClosure(BUTTON_PRESS_EVENT), false); } } } /** * Returns <code>true</code> if the receiver is visible and all * of the receiver's ancestors are visible and <code>false</code> * otherwise. * * @return the receiver's visibility 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> * * @see #getVisible */ public boolean isVisible() { checkWidget(); return getVisible(); } @Override void releaseWidget() { super.releaseWidget(); setVisible(false); if (layoutText != 0) OS.g_object_unref(layoutText); layoutText = 0; if (layoutMessage != 0) OS.g_object_unref(layoutMessage); layoutMessage = 0; if (timerId != 0) OS.g_source_remove(timerId); timerId = 0; text = null; message = null; borderPolygon = null; } /** * Removes the listener from the collection of listeners who will * be notified when the receiver 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); } /** * Makes the receiver hide automatically when <code>true</code>, * and remain visible when <code>false</code>. * * @param autoHide the auto hide 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> * * @see #getVisible * @see #setVisible */ public void setAutoHide(boolean autoHide) { checkWidget(); this.autohide = autoHide; //TODO - update when visible } /** * Sets the location of the receiver, which must be a tooltip, * to the point specified by the arguments which are relative * to the display. * <p> * Note that this is different from most widgets where the * location of the widget is relative to the parent. * </p> * * @param x the new x coordinate for the receiver * @param y the new y coordinate for 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 setLocation(int x, int y) { checkWidget(); setLocation(new Point(x, y)); } void setLocationInPixels(int x, int y) { checkWidget(); this.x = x; this.y = y; if ((style & SWT.BALLOON) != 0) { if (GTK.gtk_widget_get_visible(handle)) configure(); } } /** * Sets the location of the receiver, which must be a tooltip, * to the point specified by the argument which is relative * to the display. * <p> * Note that this is different from most widgets where the * location of the widget is relative to the parent. * </p><p> * Note that the platform window manager ultimately has control * over the location of tooltips. * </p> * * @param location the new location for the receiver * * @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 setLocation(Point location) { checkWidget(); setLocationInPixels(DPIUtil.autoScaleUp(location)); } void setLocationInPixels(Point location) { checkWidget(); if (location == null) error(SWT.ERROR_NULL_ARGUMENT); setLocationInPixels(location.x, location.y); } /** * Sets the receiver's message. * * @param string the new message * * @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 setMessage(String string) { checkWidget(); if (string == null) error(SWT.ERROR_NULL_ARGUMENT); message = string; if ((style & SWT.BALLOON) == 0) return; if (layoutMessage != 0) OS.g_object_unref(layoutMessage); layoutMessage = 0; if (message.length() != 0) { byte[] buffer = Converter.wcsToMbcs(message, true); layoutMessage = GTK.gtk_widget_create_pango_layout(handle, buffer); OS.pango_layout_set_auto_dir(layoutMessage, false); OS.pango_layout_set_wrap(layoutMessage, OS.PANGO_WRAP_WORD_CHAR); } if (GTK.gtk_widget_get_visible(handle)) configure(); } /** * Sets the receiver's text. * * @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); text = string; if ((style & SWT.BALLOON) == 0) return; if (layoutText != 0) OS.g_object_unref(layoutText); layoutText = 0; if (text.length() != 0) { byte[] buffer = Converter.wcsToMbcs(text, true); layoutText = GTK.gtk_widget_create_pango_layout(handle, buffer); OS.pango_layout_set_auto_dir(layoutText, false); long boldAttr = OS.pango_attr_weight_new(OS.PANGO_WEIGHT_BOLD); PangoAttribute attribute = new PangoAttribute(); OS.memmove(attribute, boldAttr, PangoAttribute.sizeof); attribute.start_index = 0; attribute.end_index = buffer.length; OS.memmove(boldAttr, attribute, PangoAttribute.sizeof); long attrList = OS.pango_attr_list_new(); OS.pango_attr_list_insert(attrList, boldAttr); OS.pango_layout_set_attributes(layoutText, attrList); OS.pango_attr_list_unref(attrList); OS.pango_layout_set_wrap(layoutText, OS.PANGO_WRAP_WORD_CHAR); } if (GTK.gtk_widget_get_visible(handle)) configure(); } /** * Marks the receiver as visible if the argument is <code>true</code>, * and marks it invisible otherwise. * <p> * If one of the receiver's ancestors is not visible or some * other condition makes the receiver not visible, marking * it visible may not actually cause it to be displayed. * </p> * * @param visible the new visibility 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 setVisible(boolean visible) { checkWidget(); if (timerId != 0) OS.g_source_remove(timerId); timerId = 0; if (visible) { if ((style & SWT.BALLOON) != 0) { configure(); GTK.gtk_widget_show(handle); } else { long vboxHandle = parent.vboxHandle; StringBuilder string = new StringBuilder(text); if (text.length() > 0) string.append("\n\n"); string.append(message); byte[] buffer = Converter.wcsToMbcs(string.toString(), true); GTK.gtk_widget_set_tooltip_text(vboxHandle, buffer); } if (autohide) timerId = OS.g_timeout_add(DELAY, display.windowTimerProc, handle); } else { if ((style & SWT.BALLOON) != 0) { GTK.gtk_widget_hide(handle); } else { long vboxHandle = parent.vboxHandle; byte[] buffer = Converter.wcsToMbcs("", true); GTK.gtk_widget_set_tooltip_text(vboxHandle, buffer); } } } @Override long timerProc(long widget) { if ((style & SWT.BALLOON) != 0) { GTK.gtk_widget_hide(handle); } return 0; } }