All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.eclipse.swt.widgets.ToolBar Maven / Gradle / Ivy

Go to download

SWT is an open source widget toolkit for Java designed to provide efficient, portable access to the user-interface facilities of the operating systems on which it is implemented.

The newest version!
/*******************************************************************************
 * Copyright (c) 2000, 2013 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.win32.*;
import org.eclipse.swt.*;
import org.eclipse.swt.graphics.*;

/**
 * Instances of this class support the layout of selectable
 * tool bar items.
 * 

* The item children that may be added to instances of this class * must be of type ToolItem. *

* Note that although this class is a subclass of Composite, * it does not make sense to add Control children to it, * or set a layout on it. *

*

*
Styles:
*
FLAT, WRAP, RIGHT, HORIZONTAL, VERTICAL, SHADOW_OUT
*
Events:
*
(none)
*
*

* Note: Only one of the styles HORIZONTAL and VERTICAL may be specified. *

* IMPORTANT: This class is not intended to be subclassed. *

* * @see ToolBar, ToolItem snippets * @see SWT Example: ControlExample * @see Sample code and further information * @noextend This class is not intended to be subclassed by clients. */ public class ToolBar extends Composite { int lastFocusId, lastArrowId, lastHotId; ToolItem [] items; ToolItem [] tabItemList; boolean ignoreResize, ignoreMouse; ImageList imageList, disabledImageList, hotImageList; static final int /*long*/ ToolBarProc; static final TCHAR ToolBarClass = new TCHAR (0, OS.TOOLBARCLASSNAME, true); static { WNDCLASS lpWndClass = new WNDCLASS (); OS.GetClassInfo (0, ToolBarClass, lpWndClass); ToolBarProc = lpWndClass.lpfnWndProc; } /* * From the Windows SDK for TB_SETBUTTONSIZE: * * "If an application does not explicitly * set the button size, the size defaults * to 24 by 22 pixels". */ static final int DEFAULT_WIDTH = 24; static final int DEFAULT_HEIGHT = 22; /** * Constructs a new instance of this class given its parent * and a style value describing its behavior and appearance. *

* The style value is either one of the style constants defined in * class SWT which is applicable to instances of this * class, or must be built by bitwise OR'ing together * (that is, using the int "|" operator) two or more * of those SWT style constants. The class description * lists the style constants that are applicable to the class. * Style bits are also inherited from superclasses. *

* * @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
    *
  • ERROR_NULL_ARGUMENT - if the parent is null
  • *
* @exception SWTException
    *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent
  • *
  • ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass
  • *
* * @see SWT#FLAT * @see SWT#WRAP * @see SWT#RIGHT * @see SWT#HORIZONTAL * @see SWT#SHADOW_OUT * @see SWT#VERTICAL * @see Widget#checkSubclass() * @see Widget#getStyle() */ public ToolBar (Composite parent, int style) { super (parent, checkStyle (style)); /* * Ensure that either of HORIZONTAL or VERTICAL is set. * NOTE: HORIZONTAL and VERTICAL have the same values * as H_SCROLL and V_SCROLL so it is necessary to first * clear these bits to avoid scroll bars and then reset * the bits using the original style supplied by the * programmer. * * NOTE: The CCS_VERT style cannot be applied when the * widget is created because of this conflict. */ if ((style & SWT.VERTICAL) != 0) { this.style |= SWT.VERTICAL; int bits = OS.GetWindowLong (handle, OS.GWL_STYLE); /* * Feature in Windows. When a tool bar has the style * TBSTYLE_LIST and has a drop down item, Window leaves * too much padding around the button. This affects * every button in the tool bar and makes the preferred * height too big. The fix is to set the TBSTYLE_LIST * when the tool bar contains both text and images. * * NOTE: Tool bars with CCS_VERT must have TBSTYLE_LIST * set before any item is added or the tool bar does * not lay out properly. The work around does not run * in this case. */ if (OS.COMCTL32_MAJOR >= 6 && OS.IsAppThemed ()) { if ((style & SWT.RIGHT) != 0) bits |= OS.TBSTYLE_LIST; } OS.SetWindowLong (handle, OS.GWL_STYLE, bits | OS.CCS_VERT); } else { this.style |= SWT.HORIZONTAL; } } int /*long*/ callWindowProc (int /*long*/ hwnd, int msg, int /*long*/ wParam, int /*long*/ lParam) { if (handle == 0) return 0; /* * Bug in Windows. For some reason, during the processing * of WM_SYSCHAR, the tool bar window proc does not call the * default window proc causing mnemonics for the menu bar * to be ignored. The fix is to always call the default * window proc for WM_SYSCHAR. */ if (msg == OS.WM_SYSCHAR) { return OS.DefWindowProc (hwnd, msg, wParam, lParam); } return OS.CallWindowProc (ToolBarProc, hwnd, msg, wParam, lParam); } static int checkStyle (int style) { /* * On Windows, only flat tool bars can be traversed. */ if ((style & SWT.FLAT) == 0) style |= SWT.NO_FOCUS; /* * A vertical tool bar cannot wrap because TB_SETROWS * fails when the toolbar has TBSTYLE_WRAPABLE. */ if ((style & SWT.VERTICAL) != 0) style &= ~SWT.WRAP; /* * Even though it is legal to create this widget * with scroll bars, they serve no useful purpose * because they do not automatically scroll the * widget's client area. The fix is to clear * the SWT style. */ return style & ~(SWT.H_SCROLL | SWT.V_SCROLL); } void checkBuffered () { super.checkBuffered (); if (OS.COMCTL32_MAJOR >= 6) style |= SWT.DOUBLE_BUFFERED; } protected void checkSubclass () { if (!isValidSubclass ()) error (SWT.ERROR_INVALID_SUBCLASS); } public Point computeSize (int wHint, int hHint, boolean changed) { checkWidget (); int width = 0, height = 0; if ((style & SWT.VERTICAL) != 0) { RECT rect = new RECT (); TBBUTTON lpButton = new TBBUTTON (); int count = (int)/*64*/OS.SendMessage (handle, OS.TB_BUTTONCOUNT, 0, 0); for (int i=0; i= 0) { ToolItem item = items [index]; if (item.isTabGroup ()) return item; index--; } return super.computeTabGroup (); } Widget [] computeTabList () { ToolItem [] items = _getItems (); if (tabItemList == null) { int i = 0; while (i < items.length && items [i].control == null) i++; if (i == items.length) return super.computeTabList (); } Widget result [] = {}; if (!isTabGroup () || !isEnabled () || !isVisible ()) return result; ToolItem [] list = tabList != null ? _getTabItemList () : items; for (int i=0; i= 6) bits |= OS.TBSTYLE_EX_DOUBLEBUFFER; OS.SendMessage (handle, OS.TB_SETEXTENDEDSTYLE, 0, bits); } void createItem (ToolItem item, int index) { int count = (int)/*64*/OS.SendMessage (handle, OS.TB_BUTTONCOUNT, 0, 0); if (!(0 <= index && index <= count)) error (SWT.ERROR_INVALID_RANGE); int id = 0; while (id < items.length && items [id] != null) id++; if (id == items.length) { ToolItem [] newItems = new ToolItem [items.length + 4]; System.arraycopy (items, 0, newItems, 0, items.length); items = newItems; } int bits = item.widgetStyle (); TBBUTTON lpButton = new TBBUTTON (); lpButton.idCommand = id; lpButton.fsStyle = (byte) bits; lpButton.fsState = (byte) OS.TBSTATE_ENABLED; /* * Bug in Windows. Despite the fact that the image list * index has never been set for the item, Windows always * assumes that the image index for the item is valid. * When an item is inserted, the image index is zero. * Therefore, when the first image is inserted and is * assigned image index zero, every item draws with this * image. The fix is to set the image index to none * when the item is created. This is not necessary in * the case when the item has the BTNS_SEP style because * separators cannot show images. */ if ((bits & OS.BTNS_SEP) == 0) lpButton.iBitmap = OS.I_IMAGENONE; if (OS.SendMessage (handle, OS.TB_INSERTBUTTON, index, lpButton) == 0) { error (SWT.ERROR_ITEM_NOT_ADDED); } items [item.id = id] = item; if ((style & SWT.VERTICAL) != 0) setRowCount (count + 1); layoutItems (); } void createWidget () { super.createWidget (); items = new ToolItem [4]; lastFocusId = lastArrowId = lastHotId = -1; } int defaultBackground () { if (OS.IsWinCE) return OS.GetSysColor (OS.COLOR_BTNFACE); return super.defaultBackground (); } void destroyItem (ToolItem item) { TBBUTTONINFO info = new TBBUTTONINFO (); info.cbSize = TBBUTTONINFO.sizeof; info.dwMask = OS.TBIF_IMAGE | OS.TBIF_STYLE; int index = (int)/*64*/OS.SendMessage (handle, OS.TB_GETBUTTONINFO, item.id, info); /* * Feature in Windows. For some reason, a tool item that has * the style BTNS_SEP does not return I_IMAGENONE when queried * for an image index, despite the fact that no attempt has been * made to assign an image to the item. As a result, operations * on an image list that use the wrong index cause random results. * The fix is to ensure that the tool item is not a separator * before using the image index. Since separators cannot have * an image and one is never assigned, this is not a problem. */ if ((info.fsStyle & OS.BTNS_SEP) == 0 && info.iImage != OS.I_IMAGENONE) { if (imageList != null) imageList.put (info.iImage, null); if (hotImageList != null) hotImageList.put (info.iImage, null); if (disabledImageList != null) disabledImageList.put (info.iImage, null); } OS.SendMessage (handle, OS.TB_DELETEBUTTON, index, 0); if (item.id == lastFocusId) lastFocusId = -1; if (item.id == lastArrowId) lastArrowId = -1; if (item.id == lastHotId) lastHotId = -1; items [item.id] = null; item.id = -1; int count = (int)/*64*/OS.SendMessage (handle, OS.TB_BUTTONCOUNT, 0, 0); if (count == 0) { if (imageList != null) { OS.SendMessage (handle, OS.TB_SETIMAGELIST, 0, 0); display.releaseToolImageList (imageList); } if (hotImageList != null) { OS.SendMessage (handle, OS.TB_SETHOTIMAGELIST, 0, 0); display.releaseToolHotImageList (hotImageList); } if (disabledImageList != null) { OS.SendMessage (handle, OS.TB_SETDISABLEDIMAGELIST, 0, 0); display.releaseToolDisabledImageList (disabledImageList); } imageList = hotImageList = disabledImageList = null; items = new ToolItem [4]; } if ((style & SWT.VERTICAL) != 0) setRowCount (count - 1); layoutItems (); } void enableWidget (boolean enabled) { super.enableWidget (enabled); /* * Bug in Windows. When a tool item with the style * BTNS_CHECK or BTNS_CHECKGROUP is selected and then * disabled, the item does not draw using the disabled * image. The fix is to use the disabled image in all * image lists for the item. * * Feature in Windows. When a tool bar is disabled, * the text draws disabled but the images do not. * The fix is to use the disabled image in all image * lists for all items. */ for (int i=0; i *
  • ERROR_INVALID_RANGE - if the index is not between 0 and the number of elements in the list minus 1 (inclusive)
  • * * @exception SWTException
      *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • *
    */ public ToolItem getItem (int index) { checkWidget (); int count = (int)/*64*/OS.SendMessage (handle, OS.TB_BUTTONCOUNT, 0, 0); if (!(0 <= index && index < count)) error (SWT.ERROR_INVALID_RANGE); TBBUTTON lpButton = new TBBUTTON (); int /*long*/ result = OS.SendMessage (handle, OS.TB_GETBUTTON, index, lpButton); if (result == 0) error (SWT.ERROR_CANNOT_GET_ITEM); return items [lpButton.idCommand]; } /** * Returns the item at the given point in the receiver * or null if no such item exists. The point is in the * coordinate system of the receiver. * * @param point the point used to locate the item * @return the item at the given point * * @exception IllegalArgumentException
      *
    • ERROR_NULL_ARGUMENT - if the point is null
    • *
    * @exception SWTException
      *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • *
    */ public ToolItem getItem (Point point) { checkWidget (); if (point == null) error (SWT.ERROR_NULL_ARGUMENT); ToolItem [] items = getItems (); for (int i=0; i *
  • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
  • *
  • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
  • * */ public int getItemCount () { checkWidget (); return (int)/*64*/OS.SendMessage (handle, OS.TB_BUTTONCOUNT, 0, 0); } /** * Returns an array of ToolItems which are the items * in the receiver. *

    * Note: This is not the actual structure used by the receiver * to maintain its list of items, so modifying the array will * not affect the receiver. *

    * * @return the items in the receiver * * @exception SWTException
      *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • *
    */ public ToolItem [] getItems () { checkWidget (); return _getItems (); } ToolItem [] _getItems () { int count = (int)/*64*/OS.SendMessage (handle, OS.TB_BUTTONCOUNT, 0, 0); TBBUTTON lpButton = new TBBUTTON (); ToolItem [] result = new ToolItem [count]; for (int i=0; iWRAP
    style, the * number of rows can be greater than one. Otherwise, * the number of rows is always one. * * @return the number of items * * @exception SWTException
      *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • *
    */ public int getRowCount () { checkWidget (); if ((style & SWT.VERTICAL) != 0) { return (int)/*64*/OS.SendMessage (handle, OS.TB_BUTTONCOUNT, 0, 0); } return (int)/*64*/OS.SendMessage (handle, OS.TB_GETROWS, 0, 0); } ToolItem [] _getTabItemList () { if (tabItemList == null) return tabItemList; int count = 0; for (int i=0; i *
  • ERROR_NULL_ARGUMENT - if the tool item is null
  • *
  • ERROR_INVALID_ARGUMENT - if the tool item has been disposed
  • * * @exception SWTException
      *
    • ERROR_WIDGET_DISPOSED - if the receiver has been disposed
    • *
    • ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
    • *
    */ public int indexOf (ToolItem item) { checkWidget (); if (item == null) error (SWT.ERROR_NULL_ARGUMENT); if (item.isDisposed()) error(SWT.ERROR_INVALID_ARGUMENT); return (int)/*64*/OS.SendMessage (handle, OS.TB_COMMANDTOINDEX, item.id, 0); } void layoutItems () { /* * Feature in Windows. When a tool bar has the style * TBSTYLE_LIST and has a drop down item, Window leaves * too much padding around the button. This affects * every button in the tool bar and makes the preferred * height too big. The fix is to set the TBSTYLE_LIST * when the tool bar contains both text and images. * * NOTE: Tool bars with CCS_VERT must have TBSTYLE_LIST * set before any item is added or the tool bar does * not lay out properly. The work around does not run * in this case. */ if (OS.COMCTL32_MAJOR >= 6 && OS.IsAppThemed ()) { if ((style & SWT.RIGHT) != 0 && (style & SWT.VERTICAL) == 0) { boolean hasText = false, hasImage = false; for (int i=0; i 1) { TBBUTTONINFO info = new TBBUTTONINFO (); info.cbSize = TBBUTTONINFO.sizeof; info.dwMask = OS.TBIF_SIZE; int /*long*/ size = OS.SendMessage (handle, OS.TB_GETBUTTONSIZE, 0, 0); info.cx = (short) OS.LOWORD (size); int index = 0; while (index < items.length) { ToolItem item = items [index]; if (item != null && (item.style & SWT.DROP_DOWN) != 0) break; index++; } if (index < items.length) { int /*long*/ padding = OS.SendMessage (handle, OS.TB_GETPADDING, 0, 0); info.cx += OS.LOWORD (padding) * 2; } for (int i=0; i 0) { info.cx = item.cx; OS.SendMessage (handle, OS.TB_SETBUTTONINFO, item.id, info); } } } } for (int i=0; i= 6 && OS.IsAppThemed ()) { boolean hasText = false, hasImage = false; for (int i=0; i 0) { items[i].updateTextDirection(style & SWT.FLIP_TEXT_DIRECTION); } return true; } return false; } String toolTipText (NMTTDISPINFO hdr) { if ((hdr.uFlags & OS.TTF_IDISHWND) != 0) { return null; } /* * Bug in Windows. On Windows XP, when TB_SETHOTITEM is * used to set the hot item, the tool bar control attempts * to display the tool tip, even when the cursor is not in * the hot item. The fix is to detect this case and fail to * provide the string, causing no tool tip to be displayed. */ if (!hasCursor ()) return ""; //$NON-NLS-1$ int index = (int)/*64*/hdr.idFrom; int /*long*/ hwndToolTip = OS.SendMessage (handle, OS.TB_GETTOOLTIPS, 0, 0); if (hwndToolTip == hdr.hwndFrom) { /* * Bug in Windows. For some reason the reading order * in NMTTDISPINFO is sometimes set incorrectly. The * reading order seems to change every time the mouse * enters the control from the top edge. The fix is * to explicitly set TTF_RTLREADING. */ int flags = SWT.RIGHT_TO_LEFT | SWT.FLIP_TEXT_DIRECTION; if ((style & flags) != 0 && (style & flags) != flags) { hdr.uFlags |= OS.TTF_RTLREADING; } else { hdr.uFlags &= ~OS.TTF_RTLREADING; } if (toolTipText != null) return ""; //$NON-NLS-1$ if (0 <= index && index < items.length) { ToolItem item = items [index]; if (item != null) { /* * Bug in Windows. When the arrow keys are used to change * the hot item, for some reason, Windows displays the tool * tip for the hot item in at (0, 0) on the screen rather * than next to the current hot item. This fix is to disallow * tool tips while the user is traversing with the arrow keys. */ if (lastArrowId != -1) return ""; return item.toolTipText; } } } return super.toolTipText (hdr); } void updateOrientation () { super.updateOrientation (); if (imageList != null) { Point size = imageList.getImageSize (); ImageList newImageList = display.getImageListToolBar (style & SWT.RIGHT_TO_LEFT, size.x, size.y); ImageList newHotImageList = display.getImageListToolBarHot (style & SWT.RIGHT_TO_LEFT, size.x, size.y); ImageList newDisabledImageList = display.getImageListToolBarDisabled (style & SWT.RIGHT_TO_LEFT, size.x, size.y); TBBUTTONINFO info = new TBBUTTONINFO (); info.cbSize = TBBUTTONINFO.sizeof; info.dwMask = OS.TBIF_IMAGE; int count = (int)/*64*/OS.SendMessage (handle, OS.TB_BUTTONCOUNT, 0, 0); for (int i=0; i= 6 && OS.IsAppThemed ()) bits |= OS.TBSTYLE_TRANSPARENT; if ((style & SWT.SHADOW_OUT) == 0) bits |= OS.CCS_NODIVIDER; if ((style & SWT.WRAP) != 0) bits |= OS.TBSTYLE_WRAPABLE; if ((style & SWT.FLAT) != 0) bits |= OS.TBSTYLE_FLAT; /* * Feature in Windows. When a tool bar has the style * TBSTYLE_LIST and has a drop down item, Window leaves * too much padding around the button. This affects * every button in the tool bar and makes the preferred * height too big. The fix is to set the TBSTYLE_LIST * when the tool bar contains both text and images. * * NOTE: Tool bars with CCS_VERT must have TBSTYLE_LIST * set before any item is added or the tool bar does * not lay out properly. The work around does not run * in this case. */ if (OS.COMCTL32_MAJOR < 6 || !OS.IsAppThemed ()) { if ((style & SWT.RIGHT) != 0) bits |= OS.TBSTYLE_LIST; } return bits; } TCHAR windowClass () { return ToolBarClass; } int /*long*/ windowProc () { return ToolBarProc; } LRESULT WM_CAPTURECHANGED (int /*long*/ wParam, int /*long*/ lParam) { LRESULT result = super.WM_CAPTURECHANGED (wParam, lParam); if (result != null) return result; /* * Bug in Windows. When the tool bar loses capture while an * item is pressed, the item remains pressed. The fix is * unpress all items using TB_SETSTATE and TBSTATE_PRESSED. */ for (int i=0; i




    © 2015 - 2024 Weber Informatics LLC | Privacy Policy