/******************************************************************************* * Copyright (c) 2000, 2004 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.erlide.ui.dialogs.fields; import org.eclipse.swt.SWT; import org.eclipse.swt.events.SelectionEvent; import org.eclipse.swt.events.SelectionListener; import org.eclipse.swt.layout.GridData; import org.eclipse.swt.widgets.Button; import org.eclipse.swt.widgets.Composite; import org.eclipse.swt.widgets.Control; import org.erlide.ui.util.SWTUtil; /** * Dialog Field containing a single button such as a radio or checkbox button. */ public class SelectionButtonDialogField extends DialogField { private Button fButton; private boolean fIsSelected; private DialogField[] fAttachedDialogFields; private final int fButtonStyle; /** * Creates a selection button. Allowed button styles: SWT.RADIO, SWT.CHECK, * SWT.TOGGLE, SWT.PUSH */ public SelectionButtonDialogField(final int buttonStyle) { super(); fIsSelected = false; fAttachedDialogFields = null; fButtonStyle = buttonStyle; } /** * Attaches a field to the selection state of the selection button. The * attached field will be disabled if the selection button is not selected. */ public void attachDialogField(final DialogField dialogField) { attachDialogFields(new DialogField[] { dialogField }); } /** * Attaches fields to the selection state of the selection button. The * attached fields will be disabled if the selection button is not selected. */ public void attachDialogFields(final DialogField[] dialogFields) { fAttachedDialogFields = dialogFields; for (final DialogField element : dialogFields) { element.setEnabled(fIsSelected); } } /** * Returns <code>true</code> is teh gived field is attached to the selection * button. */ public boolean isAttached(final DialogField editor) { if (fAttachedDialogFields != null) { for (final DialogField element : fAttachedDialogFields) { if (element == editor) { return true; } } } return false; } // ------- layout helpers /* * @see DialogField#doFillIntoGrid */ @Override public Control[] doFillIntoGrid(final Composite parent, final int nColumns) { assertEnoughColumns(nColumns); final Button button = getSelectionButton(parent); final GridData gd = new GridData(); gd.horizontalSpan = nColumns; gd.horizontalAlignment = GridData.FILL; if (fButtonStyle == SWT.PUSH) { gd.heightHint = SWTUtil.getButtonHeightHint(button); gd.widthHint = SWTUtil.getButtonWidthHint(button); } button.setLayoutData(gd); return new Control[] { button }; } /* * @see DialogField#getNumberOfControls */ @Override public int getNumberOfControls() { return 1; } // ------- ui creation /** * Returns the selection button widget. When called the first time, the * widget will be created. * * @param group * The parent composite when called the first time, or * <code>null</code> after. */ public Button getSelectionButton(final Composite group) { if (fButton == null) { assertCompositeNotNull(group); fButton = new Button(group, fButtonStyle); fButton.setFont(group.getFont()); fButton.setText(fLabelText); fButton.setEnabled(isEnabled()); fButton.setSelection(fIsSelected); fButton.addSelectionListener(new SelectionListener() { @Override public void widgetDefaultSelected(final SelectionEvent e) { doWidgetSelected(e); } @Override public void widgetSelected(final SelectionEvent e) { doWidgetSelected(e); } }); } return fButton; } protected void doWidgetSelected(final SelectionEvent e) { if (isOkToUse(fButton)) { changeValue(fButton.getSelection()); } } private void changeValue(final boolean newState) { if (fIsSelected != newState) { fIsSelected = newState; if (fAttachedDialogFields != null) { boolean focusSet = false; for (final DialogField element : fAttachedDialogFields) { element.setEnabled(fIsSelected); if (fIsSelected && !focusSet) { focusSet = element.setFocus(); } } } dialogFieldChanged(); } else if (fButtonStyle == SWT.PUSH) { dialogFieldChanged(); } } // ------ model access /** * Returns the selection state of the button. */ public boolean isSelected() { return fIsSelected; } /** * Sets the selection state of the button. */ public void setSelection(final boolean selected) { changeValue(selected); if (isOkToUse(fButton)) { fButton.setSelection(selected); } } // ------ enable / disable management /* * @see DialogField#updateEnableState */ @Override protected void updateEnableState() { super.updateEnableState(); if (isOkToUse(fButton)) { fButton.setEnabled(isEnabled()); } } @Override public void refresh() { super.refresh(); if (isOkToUse(fButton)) { fButton.setSelection(fIsSelected); } } }