projects/dwt-linux: dwt/widgets/Control.d comparison

comparison dwt/widgets/Control.d @ 259:c0d810de7093

Update SWT 3.4M7 to 3.4

author	Frank Benoit <benoit@tionex.de>
date	Sun, 29 Jun 2008 14:33:38 +0200
parents	5a30aa9820f3
children	f1bb3949939b

comparison

equal deleted inserted replaced

-:cc1d3de0e80b
+:c0d810de7093
 /*******************************************************************************
-* Copyright (c) 2000, 2007 IBM Corporation and others.
+* Copyright (c) 2000, 2008 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
 *
 * Only one of LEFT_TO_RIGHT or RIGHT_TO_LEFT may be specified.
 * </p><p>
 * IMPORTANT: This class is intended to be subclassed <em>only</em>
 * within the DWT implementation.
 * </p>
+*
+* @see <a href="http://www.eclipse.org/swt/snippets/#control">Control snippets</a>
+* @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a>
+* @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
 */
 public abstract class Control : Widget, Drawable {
 alias Widget.mnemonicHit mnemonicHit;
 alias Widget.mnemonicMatch mnemonicMatch;
 auto paintHandle = paintHandle ();
 OS.gtk_widget_realize (paintHandle);
 return OS.GTK_WIDGET_WINDOW (paintHandle);
 }
+/**
+* Prints the receiver and all children.
+*
+* @param gc the gc where the drawing occurs
+* @return <code>true</code> if the operation was successful and <code>false</code> otherwise
+*
+* @exception IllegalArgumentException <ul>
+*    <li>ERROR_NULL_ARGUMENT - if the gc is null</li>
+*    <li>ERROR_INVALID_ARGUMENT - if the gc has been disposed</li>
+* </ul>
+* @exception DWTException <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 bool print (GC gc) {
 checkWidget ();
 if (gc is null) error (DWT.ERROR_NULL_ARGUMENT);
 if (gc.isDisposed ()) error (DWT.ERROR_INVALID_ARGUMENT);
 auto topHandle_ = topHandle ();
 checkWidget ();
 if (size is null) error (DWT.ERROR_NULL_ARGUMENT);
 setBounds (0, 0, Math.max (0, size.x), Math.max (0, size.y), false, true);
 }
+/**
+* Sets the shape of the control to the region specified
+* by the argument.  When the argument is null, the
+* default shape of the control is restored.
+*
+* @param region the region that defines the shape of the control (or null)
+*
+* @exception IllegalArgumentException <ul>
+*    <li>ERROR_INVALID_ARGUMENT - if the region has been disposed</li>
+* </ul>
+* @exception DWTException <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 setRegion (Region region) {
 checkWidget ();
-if ((style & DWT.NO_TRIM) is 0) return;
 if (region !is null && region.isDisposed()) error (DWT.ERROR_INVALID_ARGUMENT);
 auto window = OS.GTK_WIDGET_WINDOW (topHandle ());
 auto shape_region = (region is null) ? null : region.handle;
 OS.gdk_window_shape_combine_region (window, shape_region, 0, 0);
 this.region = region;
 * Returns the receiver's cursor, or null if it has not been set.
 * <p>
 * When the mouse pointer passes over a control its appearance
 * is changed to match the control's cursor.
 * </p>
-* </ul>
+*
+* @return the receiver's cursor or <code>null</code>
+*
 * @exception DWTException <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>
 *
 control = control.parent;
 }
 return result;
 }
+/**
+* Returns the region that defines the shape of the control,
+* or null if the control has the default shape.
+*
+* @return the region that defines the shape of the shell (or null)
+*
+* @exception DWTException <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 Region getRegion () {
 checkWidget ();
 return region;
 }
 }
 /**
 * If the argument is <code>true</code>, causes the receiver to have
 * all mouse events delivered to it until the method is called with
-* <code>false</code> as the argument.
+* <code>false</code> as the argument.  Note that on some platforms,
+* a mouse button must currently be down for capture to be assigned.
 *
 * @param capture <code>true</code> to capture the mouse, and <code>false</code> to release it
 *
 * @exception DWTException <ul>
 *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
 }
 } else {
 OS.gtk_widget_realize (handle);
 auto parentHandle = parent.eventHandle ();
 auto window = parent.eventWindow();
-Rectangle rect = getBounds ();
+auto topHandle_ = topHandle ();
 GdkWindowAttr attributes;
-attributes.x = rect.x;
+attributes.x = OS.GTK_WIDGET_X (topHandle_);
-attributes.y = rect.y;
+attributes.y = OS.GTK_WIDGET_Y (topHandle_);
-attributes.width = rect.width;
+attributes.width = (state & ZERO_WIDTH) !is 0 ? 0 : OS.GTK_WIDGET_WIDTH (topHandle_);
-attributes.height = rect.height;
+attributes.height = (state & ZERO_HEIGHT) !is 0 ? 0 : OS.GTK_WIDGET_HEIGHT (topHandle_);
 attributes.event_mask = (0xFFFFFFFF & ~OS.ExposureMask);
 attributes.wclass = OS.GDK_INPUT_ONLY;
 attributes.window_type = OS.GDK_WINDOW_CHILD;
 enableWindow = OS.gdk_window_new (window, &attributes, OS.GDK_WA_X | OS.GDK_WA_Y);
 if (enableWindow !is null) {
-auto topHandle_ = topHandle ();
 OS.gdk_window_set_user_data (enableWindow, parentHandle);
 if (!OS.GDK_WINDOWING_X11 ()) {
 OS.gdk_window_raise (enableWindow);
 } else {
 auto topWindow = OS.GTK_WIDGET_WINDOW (topHandle_);

Mercurial > projects > dwt-linux

comparison dwt/widgets/Control.d @ 259:c0d810de7093