/******************************************************************************* * Copyright (c) 2000, 2006 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.photon.*; import org.eclipse.swt.*; import org.eclipse.swt.graphics.*; /** * Instances of this class provide an etched border * with an optional title. *

* Shadow styles are hints and may not be honoured * by the platform. To create a group with the * default shadow style for the platform, do not * specify a shadow style. *

*
Styles:
*
SHADOW_ETCHED_IN, SHADOW_ETCHED_OUT, SHADOW_IN, SHADOW_OUT, SHADOW_NONE
*
Events:
*
(none)
*
*

* Note: Only one of the above styles may be specified. *

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

*/ public class Group extends Composite { String text = ""; /** * 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 * @exception SWTException * * @see SWT#SHADOW_ETCHED_IN * @see SWT#SHADOW_ETCHED_OUT * @see SWT#SHADOW_IN * @see SWT#SHADOW_OUT * @see SWT#SHADOW_NONE * @see Widget#checkSubclass * @see Widget#getStyle */ public Group (Composite parent, int style) { super (parent, checkStyle (style)); } static int checkStyle (int style) { style |= SWT.NO_FOCUS; /* * 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); } public Point computeSize (int wHint, int hHint, boolean changed) { checkWidget(); Point titleSize = getTitleSize(); Point size; if (layout != null) { changed |= (state & LAYOUT_CHANGED) != 0; size = layout.computeSize (this, wHint, hHint, changed); state &= ~LAYOUT_CHANGED; } else { size = minimumSize (); } int width = size.x; int height = size.y; if (width == 0) width = DEFAULT_WIDTH; if (height == 0) height = DEFAULT_HEIGHT; if (wHint != SWT.DEFAULT) width = wHint; if (hHint != SWT.DEFAULT) height = hHint; Rectangle trim = computeTrim (0, 0, width, height); width = Math.max (trim.width, titleSize.x + 6); height = trim.height + titleSize.y; return new Point (width, height); } protected void checkSubclass () { if (!isValidSubclass ()) error (SWT.ERROR_INVALID_SUBCLASS); } void createHandle (int index) { state |= HANDLE; int clazz = display.PtContainer; int parentHandle = parent.parentingHandle (); int [] args = { OS.Pt_ARG_RESIZE_FLAGS, 0, OS.Pt_RESIZE_XY_BITS, }; handle = OS.PtCreateWidget (clazz, parentHandle, args.length / 3, args); if (handle == 0) error (SWT.ERROR_NO_HANDLES); } byte [] defaultFont () { return display.GROUP_FONT; } /** * Returns the receiver's text, which is the string that the * is used as the title. If the text has not previously * been set, returns an empty string. * * @return the text * * @exception SWTException */ public String getText () { checkWidget(); return text; } Point getTitleSize() { int width = 0, height = 0; int [] args = { OS.Pt_ARG_TITLE, 0, 0, OS.Pt_ARG_TITLE_FONT, 0, 0, OS.Pt_ARG_CONTAINER_FLAGS, 0, 0, }; OS.PtGetResources (handle, args.length / 3, args); if ((OS.Pt_ARG_CONTAINER_FLAGS & OS.Pt_SHOW_TITLE) != 0) { PhRect_t rect = new PhRect_t(); int str = args [1]; if (str != 0) { int length = OS.strlen (str); if (length > 0) { OS.PfExtentText(rect, null, args [4], str, length); } } int inset = 4; width = inset + rect.lr_x - rect.ul_x + 1; height = inset + rect.lr_y - rect.ul_y + 1; } return new Point(width, height); } /** * Sets the receiver's text, which is the string that will * be displayed as the receiver's title, to the argument, * which may not be null. The string may include the mnemonic character. *

* Mnemonics are indicated by an '&' that causes the next * character to be the mnemonic. When the user presses a * key sequence that matches the mnemonic, focus is assigned * to the first child of the group. On most platforms, the * mnemonic appears underlined but may be emphasised in a * platform specific manner. The mnemonic indicator character * '&' can be escaped by doubling it in the string, causing * a single '&' to be displayed. *

* @param string the new text * * @exception IllegalArgumentException * @exception SWTException */ public void setText (String string) { checkWidget(); if (string == null) error (SWT.ERROR_NULL_ARGUMENT); text = string; int flags = OS.Pt_SHOW_TITLE | OS.Pt_ETCH_TITLE_AREA; char [] text = new char [string.length ()]; string.getChars (0, text.length, text, 0); fixMnemonic (text); byte [] buffer = Converter.wcsToMbcs (null, text, true); int ptr = OS.malloc (buffer.length); OS.memmove (ptr, buffer, buffer.length); int [] args = { OS.Pt_ARG_TITLE, ptr, 0, OS.Pt_ARG_CONTAINER_FLAGS, string.length () == 0 ? 0 : flags, flags, }; OS.PtSetResources (handle, args.length / 3, args); OS.free (ptr); } int widgetClass () { return OS.PtContainer (); } }