root/dwt/DWT.d

/*******************************************************************************
 * 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
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 * Port to the D programming language:
 *     Frank Benoit <benoit@tionex.de>
 *******************************************************************************/
module dwt.DWT;


import dwt.internal.Compatibility;
import dwt.internal.Library;
import dwt.internal.Platform;
import dwt.DWTError;
import dwt.DWTException;

import dwt.dwthelper.utils;

import tango.core.Exception;
version( build ){
pragma(link, "gtk-x11-2.0" );
pragma(link, "gdk-x11-2.0" );
pragma(link, "atk-1.0" );
pragma(link, "gdk_pixbuf-2.0" );
pragma(link, "gthread-2.0" );
pragma(link, "pangocairo-1.0" );
pragma(link, "fontconfig" );
pragma(link, "Xtst" );
pragma(link, "Xext" );
pragma(link, "Xrender" );
pragma(link, "Xinerama" );
pragma(link, "Xi" );
pragma(link, "Xrandr" );
pragma(link, "Xcursor" );
pragma(link, "Xcomposite" );
pragma(link, "Xdamage" );
pragma(link, "X11" );
pragma(link, "Xfixes" );
pragma(link, "pango-1.0" );
pragma(link, "gobject-2.0" );
pragma(link, "gmodule-2.0" );
pragma(link, "dl" );
pragma(link, "glib-2.0" );
pragma(link, "cairo" );
}
//version=CARBON;


/**
 * This class provides access to a small number of DWT system-wide
 * methods, and in addition defines the public constants provided
 * by DWT.
 * <p>
 * By defining constants like UP and DOWN in a single class, DWT
 * can share common names and concepts at the same time minimizing
 * the number of classes, names and constants for the application
 * programmer.
 * </p><p>
 * Note that some of the constants provided by this class represent
 * optional, appearance related aspects of widgets which are available
 * either only on some window systems, or for a differing set of
 * widgets on each window system. These constants are marked
 * as <em>HINT</em>s. The set of widgets which support a particular
 * <em>HINT</em> may change from release to release, although we typically
 * will not withdraw support for a <em>HINT</em> once it is made available.
 * </p>
 *
 * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
 */

/* NOTE:
 *   Good javadoc coding style is to put the values of static const
 *   constants in the comments. This reinforces the fact that
 *   consumers are allowed to rely on the value (and they must
 *   since the values are compiled inline in their code). We
 *   can <em>not</em> change the values of these constants between
 *   releases.
 */
public class DWT {

    /* Widget Event Constants */

    /**
     * The null event type (value is 0).
     *
     * @since 3.0
     */
    public static const int None = 0;

    /**
     * The key down event type (value is 1).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addKeyListener
     * @see dwt.widgets.Tracker#addKeyListener
     * @see dwt.events.KeyListener#keyPressed
     * @see dwt.events.KeyEvent
     */
    public static const int KeyDown = 1;

    /**
     * The key up event type (value is 2).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addKeyListener
     * @see dwt.widgets.Tracker#addKeyListener
     * @see dwt.events.KeyListener#keyReleased
     * @see dwt.events.KeyEvent
     */
    public static const int KeyUp = 2;

    /**
     * The mouse down event type (value is 3).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addMouseListener
     * @see dwt.events.MouseListener#mouseDown
     * @see dwt.events.MouseEvent
     */
    public static const int MouseDown = 3;

    /**
     * The mouse up event type (value is 4).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addMouseListener
     * @see dwt.events.MouseListener#mouseUp
     * @see dwt.events.MouseEvent
     */
    public static const int MouseUp = 4;

    /**
     * The mouse move event type (value is 5).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addMouseMoveListener
     * @see dwt.events.MouseMoveListener#mouseMove
     * @see dwt.events.MouseEvent
     */
    public static const int MouseMove = 5;

    /**
     * The mouse enter event type (value is 6).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addMouseTrackListener
     * @see dwt.events.MouseTrackListener#mouseEnter
     * @see dwt.events.MouseEvent
     */
    public static const int MouseEnter = 6;

    /**
     * The mouse exit event type (value is 7).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addMouseTrackListener
     * @see dwt.events.MouseTrackListener#mouseExit
     * @see dwt.events.MouseEvent
     */
    public static const int MouseExit = 7;

    /**
     * The mouse double click event type (value is 8).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addMouseListener
     * @see dwt.events.MouseListener#mouseDoubleClick
     * @see dwt.events.MouseEvent
     */
    public static const int MouseDoubleClick = 8;

    /**
     * The paint event type (value is 9).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addPaintListener
     * @see dwt.events.PaintListener#paintControl
     * @see dwt.events.PaintEvent
     */
    public static const int Paint = 9;

    /**
     * The move event type (value is 10).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addControlListener
     * @see dwt.widgets.TableColumn#addControlListener
     * @see dwt.widgets.Tracker#addControlListener
     * @see dwt.widgets.TreeColumn#addControlListener
     * @see dwt.events.ControlListener#controlMoved
     * @see dwt.events.ControlEvent
     */
    public static const int Move = 10;

    /**
     * The resize event type (value is 11).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addControlListener
     * @see dwt.widgets.TableColumn#addControlListener
     * @see dwt.widgets.Tracker#addControlListener
     * @see dwt.widgets.TreeColumn#addControlListener
     * @see dwt.events.ControlListener#controlResized
     * @see dwt.events.ControlEvent
     */
    public static const int Resize = 11;

    /**
     * The dispose event type (value is 12).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Widget#addDisposeListener
     * @see dwt.events.DisposeListener#widgetDisposed
     * @see dwt.events.DisposeEvent
     */
    public static const int Dispose = 12;

    /**
     * The selection event type (value is 13).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Button#addSelectionListener
     * @see dwt.widgets.Combo#addSelectionListener
     * @see dwt.widgets.CoolItem#addSelectionListener
     * @see dwt.widgets.Link#addSelectionListener
     * @see dwt.widgets.List#addSelectionListener
     * @see dwt.widgets.MenuItem#addSelectionListener
     * @see dwt.widgets.Sash#addSelectionListener
     * @see dwt.widgets.Scale#addSelectionListener
     * @see dwt.widgets.ScrollBar#addSelectionListener
     * @see dwt.widgets.Slider#addSelectionListener
     * @see dwt.widgets.TabFolder#addSelectionListener
     * @see dwt.widgets.Table#addSelectionListener
     * @see dwt.widgets.TableColumn#addSelectionListener
     * @see dwt.widgets.ToolItem#addSelectionListener
     * @see dwt.widgets.TrayItem#addSelectionListener
     * @see dwt.widgets.Tree#addSelectionListener
     * @see dwt.widgets.TreeColumn#addSelectionListener
     * @see dwt.events.SelectionListener#widgetSelected
     * @see dwt.events.SelectionEvent
     */
    public static const int Selection = 13;

    /**
     * The default selection event type (value is 14).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Combo#addSelectionListener
     * @see dwt.widgets.List#addSelectionListener
     * @see dwt.widgets.Spinner#addSelectionListener
     * @see dwt.widgets.Table#addSelectionListener
     * @see dwt.widgets.Text#addSelectionListener
     * @see dwt.widgets.TrayItem#addSelectionListener
     * @see dwt.widgets.Tree#addSelectionListener
     * @see dwt.events.SelectionListener#widgetDefaultSelected
     * @see dwt.events.SelectionEvent
     */
    public static const int DefaultSelection = 14;

    /**
     * The focus in event type (value is 15).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addFocusListener
     * @see dwt.events.FocusListener#focusGained
     * @see dwt.events.FocusEvent
     */
    public static const int FocusIn = 15;

    /**
     * The focus out event type (value is 16).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addFocusListener
     * @see dwt.events.FocusListener#focusLost
     * @see dwt.events.FocusEvent
     */
    public static const int FocusOut = 16;

    /**
     * The expand event type (value is 17).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Tree#addTreeListener
     * @see dwt.events.TreeListener#treeExpanded
     * @see dwt.events.TreeEvent
     */
    public static const int Expand = 17;

    /**
     * The collapse event type (value is 18).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Tree#addTreeListener
     * @see dwt.events.TreeListener#treeCollapsed
     * @see dwt.events.TreeEvent
     */
    public static const int Collapse = 18;

    /**
     * The iconify event type (value is 19).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Shell#addShellListener
     * @see dwt.events.ShellListener#shellIconified
     * @see dwt.events.ShellEvent
     */
    public static const int Iconify = 19;

    /**
     * The de-iconify event type (value is 20).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Shell#addShellListener
     * @see dwt.events.ShellListener#shellDeiconified
     * @see dwt.events.ShellEvent
     */
    public static const int Deiconify = 20;

    /**
     * The close event type (value is 21).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Shell#addShellListener
     * @see dwt.events.ShellListener#shellClosed
     * @see dwt.events.ShellEvent
     */
    public static const int Close = 21;

    /**
     * The show event type (value is 22).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Menu#addMenuListener
     * @see dwt.events.MenuListener#menuShown
     * @see dwt.events.MenuEvent
     */
    public static const int Show = 22;

    /**
     * The hide event type (value is 23).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Menu#addMenuListener
     * @see dwt.events.MenuListener#menuHidden
     * @see dwt.events.MenuEvent
     */
    public static const int Hide = 23;

    /**
     * The modify event type (value is 24).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Combo#addModifyListener
     * @see dwt.widgets.Spinner#addModifyListener
     * @see dwt.widgets.Text#addModifyListener
     * @see dwt.events.ModifyListener#modifyText
     * @see dwt.events.ModifyEvent
     */
    public static const int Modify = 24;

    /**
     * The verify event type (value is 25).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.custom.CCombo#addVerifyListener
     * @see dwt.widgets.Combo#addVerifyListener
     * @see dwt.custom.StyledText#addVerifyListener
     * @see dwt.widgets.Text#addVerifyListener
     * @see dwt.events.VerifyListener#verifyText
     * @see dwt.events.VerifyEvent
     */
    public static const int Verify = 25;

    /**
     * The activate event type (value is 26).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Shell#addShellListener
     * @see dwt.events.ShellListener#shellActivated
     * @see dwt.events.ShellEvent
     */
    public static const int Activate = 26;

    /**
     * The deactivate event type (value is 27).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Shell#addShellListener
     * @see dwt.events.ShellListener#shellDeactivated
     * @see dwt.events.ShellEvent
     */
    public static const int Deactivate = 27;

    /**
     * The help event type (value is 28).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addHelpListener
     * @see dwt.widgets.Menu#addHelpListener
     * @see dwt.widgets.MenuItem#addHelpListener
     * @see dwt.events.HelpListener#helpRequested
     * @see dwt.events.HelpEvent
     */
    public static const int Help = 28;

    /**
     * The drag detect event type (value is 29).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.dnd.DragSource
     */
    public static const int DragDetect = 29;

    /**
     * The arm event type (value is 30).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.MenuItem#addArmListener
     * @see dwt.events.ArmListener#widgetArmed
     * @see dwt.events.ArmEvent
     */
    public static const int Arm = 30;

    /**
     * The traverse event type (value is 31).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addTraverseListener
     * @see dwt.events.TraverseListener#keyTraversed
     * @see dwt.events.TraverseEvent
     */
    public static const int Traverse = 31;

    /**
     * The mouse hover event type (value is 32).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Control#addMouseTrackListener
     * @see dwt.events.MouseTrackListener#mouseHover
     * @see dwt.events.MouseEvent
     */
    public static const int MouseHover = 32;

    /**
     * The hardware key down event type (value is 33).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     */
    public static const int HardKeyDown = 33;

    /**
     * The hardware key up event type (value is 34).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     */
    public static const int HardKeyUp = 34;

    /**
     * The menu detect event type (value is 35).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @since 3.0
     */
    public static const int MenuDetect = 35;

    /**
     * The set data event type (value is 36).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @see dwt.widgets.Table
     * @see dwt.widgets.Tree
     *
     * @since 3.0
     */
    public static const int SetData = 36;

    /**
     * The mouse wheel event type (value is 37).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @since 3.1
     */
    public static const int MouseWheel = 37;

    /**
     * The settings changed event type (value is 39).
     * <p>
     * The settings changed event is sent when an operating system
     * property, such as a system font or color, has been changed.
     * The event occurs after the property has been changed, but
     * before any widget is redrawn.  Applications that cache operating
     * system properties can use this event to update their caches.
     * A specific property change can be detected by querying the
     * new value of a property and comparing it with the equivalent
     * cached value.  The operating system automatically redraws and
     * lays out all widgets after this event is sent.
     * </p>
     *
     * @see dwt.widgets.Display#addListener
     * @see dwt.widgets.Event
     *
     * @since 3.2
     */
    public static const int Settings = 39;

    /**
     * The erase item event type (value is 40).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @since 3.2
     */
    public static const int EraseItem = 40;

    /**
     * The measure item event type (value is 41).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @since 3.2
     */
    public static const int MeasureItem = 41;

    /**
     * The paint item event type (value is 42).
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @since 3.2
     */
    public static const int PaintItem = 42;

    /**
     * The IME composition event type (value is 43).
     * <p>
     * The IME composition event is sent to allow
     * custom text editors to implement in-line
     * editing of international text.
     * </p>
     *
     * The detail field indicates the action to be taken:
     * <p><ul>
     * <li>{@link DWT#COMPOSITION_CHANGED}</li>
     * <li>{@link DWT#COMPOSITION_OFFSET}</li>
     * <li>{@link DWT#COMPOSITION_SELECTION}</li>
     * </ul></p>
     *
     * @see dwt.widgets.Widget#addListener
     * @see dwt.widgets.Display#addFilter
     * @see dwt.widgets.Event
     *
     * @since 3.4
     */
    public static const int ImeComposition = 43;

    /* Event Details */

    /**
     * The IME composition event detail that indicates
     * a change in the IME composition. The text field
     * of the event is the new composition text.
     * The start and end indicate the offsets where the
     * composition text should be inserted.
     * The styles and ranges are stored in the IME
     * object (value is 1).
     *
     * @see DWT#ImeComposition
     *
     * @since 3.4
     */
    public static const int COMPOSITION_CHANGED = 1;

    /**
     * The IME composition event detail that indicates
     * that the IME needs the offset for a given location.
     * The x and y fields of the event are used by the
     * application to determine the offset.
     *
     * The index field of the event should be set to the
     * text offset at that location. The count field should
     * be set to indicate whether the location is closer to
     * the leading edge (0) or the trailing edge (1) (value is 2).
     *
     * @see DWT#ImeComposition
     * @see dwt.graphics.TextLayout#getOffset(int, int, int[])
     *
     * @since 3.4
     */
    public static const int COMPOSITION_OFFSET = 2;

    /**
     * The IME composition event detail that indicates
     * that IME needs the selected text and its start
     * and end offsets (value is 3).
     *
     * @see DWT#ImeComposition
     *
     * @since 3.4
     */
    public static const int COMPOSITION_SELECTION = 3;

    /**
     * Indicates that a user-interface component is being dragged,
     * for example dragging the thumb of a scroll bar (value is 1).
     */
    public static const int DRAG = 1;

    /**
     * Event detail field that indicates a user-interface component
     * state is selected (value is 1&lt;&lt;1).
     *
     * @since 3.2
     */
    public static const int SELECTED = 1 << 1;

    /**
     * Event detail field that indicates a user-interface component
     * state is focused (value is 1&lt;&lt;2).
     *
     * @since 3.2
     */
    public static const int FOCUSED = 1 << 2;

    /**
     * Event detail field that indicates a user-interface component
     * draws the background (value is 1&lt;&lt;3).
     *
     * @since 3.2
     */
    public static const int BACKGROUND = 1 << 3;

    /**
     * Event detail field that indicates a user-interface component
     * draws the foreground (value is 1&lt;&lt;4).
     *
     * @since 3.2
     */
    public static const int FOREGROUND = 1 << 4;

    /**
     * Event detail field that indicates a user-interface component
     * state is hot (value is 1&lt;&lt;5).
     *
     * @since 3.3
     */
    public static const int HOT = 1 << 5;

    /* This code is intentionally commented */
    //public static const int PRESSED = 1 << 3;
    //public static const int ACTIVE = 1 << 4;
    //public static const int DISABLED = 1 << 5;
    //public static const int HOT = 1 << 6;
    //public static const int DEFAULTED = 1 << 7;

    /**
     * Traversal event detail field value indicating that no
     * traversal action should be taken
     * (value is 0).
     */
    public static const int TRAVERSE_NONE = 0;

    /**
     * Traversal event detail field value indicating that the
     * key which designates that a dialog should be cancelled was
     * pressed; typically, this is the ESC key
     * (value is 1&lt;&lt;1).
     */
    public static const int TRAVERSE_ESCAPE = 1 << 1;

    /**
     * Traversal event detail field value indicating that the
     * key which activates the default button in a dialog was
     * pressed; typically, this is the ENTER key
     * (value is 1&lt;&lt;2).
     */
    public static const int TRAVERSE_RETURN = 1 << 2;

    /**
     * Traversal event detail field value indicating that the
     * key which designates that focus should be given to the
     * previous tab group was pressed; typically, this is the
     * SHIFT-TAB key sequence
     * (value is 1&lt;&lt;3).
     */
    public static const int TRAVERSE_TAB_PREVIOUS = 1 << 3;

    /**
     * Traversal event detail field value indicating that the
     * key which designates that focus should be given to the
     * next tab group was pressed; typically, this is the
     * TAB key
     * (value is 1&lt;&lt;4).
     */
    public static const int TRAVERSE_TAB_NEXT = 1 << 4;

    /**
     * Traversal event detail field value indicating that the
     * key which designates that focus should be given to the
     * previous tab item was pressed; typically, this is either
     * the LEFT-ARROW or UP-ARROW keys
     * (value is 1&lt;&lt;5).
     */
    public static const int TRAVERSE_ARROW_PREVIOUS = 1 << 5;

    /**
     * Traversal event detail field value indicating that the
     * key which designates that focus should be given to the
     * previous tab item was pressed; typically, this is either
     * the RIGHT-ARROW or DOWN-ARROW keys
     * (value is 1&lt;&lt;6).
     */
    public static const int TRAVERSE_ARROW_NEXT = 1 << 6;

    /**
     * Traversal event detail field value indicating that a
     * mnemonic key sequence was pressed
     * (value is 1&lt;&lt;7).
     */
    public static const int TRAVERSE_MNEMONIC = 1 << 7;

    /**
     * Traversal event detail field value indicating that the
     * key which designates that the previous page of a multi-page
     * window should be shown was pressed; typically, this
     * is the CTRL-PAGEUP key sequence
     * (value is 1&lt;&lt;8).
     */
    public static const int TRAVERSE_PAGE_PREVIOUS = 1 << 8;

    /**
     * Traversal event detail field value indicating that the
     * key which designates that the next page of a multi-page
     * window should be shown was pressed; typically, this
     * is the CTRL-PAGEDOWN key sequence
     * (value is 1&lt;&lt;9).
     */
    public static const int TRAVERSE_PAGE_NEXT = 1 << 9;

    /**
     * A constant known to be zero (0), typically used in operations
     * which take bit flags to indicate that "no bits are set".
     */
    public static const int NONE = 0;

    /**
     * A constant known to be zero (0), used in operations which
     * take pointers to indicate a null argument.
     */
    public static const int NULL = 0;

    /**
     * Indicates that a default should be used (value is -1).
     */
    public static const int DEFAULT = -1;

    /**
     * Indicates that a property is off (value is 0).
     *
     * @since 3.1
     */
    public st