HyperlinkedComboAttribute.java

/*******************************************************************************
 *  Copyright (c) 2012 VMware, Inc.
 *  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:
 *      VMware, Inc. - initial API and implementation
 *******************************************************************************/
package org.springframework.ide.eclipse.config.ui.widgets;

import org.eclipse.swt.SWT;
import org.eclipse.swt.widgets.Composite;
import org.eclipse.ui.forms.events.HyperlinkAdapter;
import org.eclipse.ui.forms.events.HyperlinkEvent;
import org.eclipse.ui.forms.widgets.FormToolkit;
import org.eclipse.ui.forms.widgets.Hyperlink;

/**
 * An {@link AbstractAttributeWidget} that displays an attribute as a
 * hyperlinked label, followed by a combo box.
 * @author Leo Dos Santos
 * @see ComboAttribute
 * @since 2.1.0
 */
public abstract class HyperlinkedComboAttribute extends ComboAttribute implements IHyperlinkAttribute {

	/**
	 * A hyperlink displaying the label of the attribute, typically the
	 * attribute's name.
	 */
	protected Hyperlink label;

	/**
	 * Constructs a row of widgets to display and perform actions upon an XML
	 * attribute. The primary control of the widget set is a combo box.
	 * 
	 * @param client the parent composite
	 * @param toolkit the toolkit of the parent form
	 * @param attrName the name of the attribute displayed by the widget set
	 * @param values the set of values displayed by the combo box
	 */
	public HyperlinkedComboAttribute(Composite client, FormToolkit toolkit, String attrName, String[] values) {
		this(client, toolkit, attrName, values, false);
	}

	/**
	 * Constructs a row of widgets to display and perform actions upon an XML
	 * attribute. The primary control of the widget set is a combo box.
	 * 
	 * @param client the parent composite
	 * @param toolkit the toolkit of the parent form
	 * @param attrName the name of the attribute displayed by the widget set
	 * @param values the set of values displayed by the combo box
	 * @param required denotes whether this is a required field
	 */
	public HyperlinkedComboAttribute(Composite client, FormToolkit toolkit, String attrName, String[] values,
			boolean required) {
		super(client, toolkit, attrName, values, required);
	}

	@Override
	protected void createLabel() {
		if (required) {
			label = toolkit.createHyperlink(client, attr + "*:", SWT.NONE); //$NON-NLS-1$
		}
		else {
			label = toolkit.createHyperlink(client, attr + ":", SWT.NONE); //$NON-NLS-1$
		}
		label.addHyperlinkListener(new HyperlinkAdapter() {
			@Override
			public void linkActivated(HyperlinkEvent e) {
				openHyperlink();
			}
		});
	}

	public Hyperlink getHyperlinkControl() {
		return label;
	}

}