-/*******************************************************************************\r
- * Copyright (c) 2007, 2010 Association for Decentralized Information Management\r
- * in Industry THTH ry.\r
- * All rights reserved. This program and the accompanying materials\r
- * are made available under the terms of the Eclipse Public License v1.0\r
- * which accompanies this distribution, and is available at\r
- * http://www.eclipse.org/legal/epl-v10.html\r
- *\r
- * Contributors:\r
- * VTT Technical Research Centre of Finland - initial API and implementation\r
- *******************************************************************************/\r
-package org.simantics.diagram.symbollibrary;\r
-\r
-import org.eclipse.core.runtime.IAdaptable;\r
-import org.simantics.db.procedure.Listener;\r
-import org.simantics.g2d.element.ElementClass;\r
-import org.simantics.g2d.element.handler.StaticSymbol;\r
-import org.simantics.utils.datastructures.cache.ProvisionException;\r
-import org.simantics.utils.datastructures.hints.IHintContext.Key;\r
-import org.simantics.utils.datastructures.hints.IHintContext.KeyOf;\r
-import org.simantics.utils.datastructures.hints.IHintObservable;\r
-\r
-/**\r
- * Represents a single symbol group element.\r
- * \r
- * <p>\r
- * Implementations must override equals/hashCode.\r
- * </p>\r
- * \r
- * @author Tuukka Lehtonen\r
- */\r
-public interface ISymbolItem extends IAdaptable {\r
-\r
- /**\r
- * @return get the symbol group which this symbol item is a part of\r
- */\r
- ISymbolGroup getGroup();\r
-\r
- /**\r
- * @return the name of this symbol item to be shown to the user\r
- */\r
- String getName();\r
-\r
- /**\r
- * @return a more verbose description of the item, for tooltips etc.\r
- */\r
- String getDescription();\r
-\r
- /**\r
- * @param hints external hints for element class loading or\r
- * <code>null</code> if no hints need to be provided\r
- * @return an {@link ElementClass} that must contain at least a\r
- * {@link StaticSymbol} handler\r
- * @throws ProvisionException if the {@link ElementClass} cannot be\r
- * retrieved for some reason\r
- */\r
- ElementClass getElementClass(IHintObservable hints) throws ProvisionException;\r
-\r
- /**\r
- * Pass a database listener in {@link #getElementClass(IHintObservable)}\r
- * hint observable argument using this key to start listening to the changes\r
- * in the element class result.\r
- */\r
- public static final Key KEY_ELEMENT_CLASS_LISTENER = new KeyOf(Listener.class, "ELEMENT_CLASS_LISTENER");\r
-\r
-}\r
+/*******************************************************************************
+ * Copyright (c) 2007, 2010 Association for Decentralized Information Management
+ * in Industry THTH ry.
+ * 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:
+ * VTT Technical Research Centre of Finland - initial API and implementation
+ *******************************************************************************/
+package org.simantics.diagram.symbollibrary;
+
+import org.eclipse.core.runtime.IAdaptable;
+import org.simantics.db.procedure.Listener;
+import org.simantics.g2d.element.ElementClass;
+import org.simantics.g2d.element.handler.StaticSymbol;
+import org.simantics.utils.datastructures.cache.ProvisionException;
+import org.simantics.utils.datastructures.hints.IHintContext.Key;
+import org.simantics.utils.datastructures.hints.IHintContext.KeyOf;
+import org.simantics.utils.datastructures.hints.IHintObservable;
+
+/**
+ * Represents a single symbol group element.
+ *
+ * <p>
+ * Implementations must override equals/hashCode.
+ * </p>
+ *
+ * @author Tuukka Lehtonen
+ */
+public interface ISymbolItem extends IAdaptable {
+
+ /**
+ * @return get the symbol group which this symbol item is a part of
+ */
+ ISymbolGroup getGroup();
+
+ /**
+ * @return the name of this symbol item to be shown to the user
+ */
+ String getName();
+
+ /**
+ * @return a more verbose description of the item, for tooltips etc.
+ */
+ String getDescription();
+
+ /**
+ * @param hints external hints for element class loading or
+ * <code>null</code> if no hints need to be provided
+ * @return an {@link ElementClass} that must contain at least a
+ * {@link StaticSymbol} handler
+ * @throws ProvisionException if the {@link ElementClass} cannot be
+ * retrieved for some reason
+ */
+ ElementClass getElementClass(IHintObservable hints) throws ProvisionException;
+
+ /**
+ * Pass a database listener in {@link #getElementClass(IHintObservable)}
+ * hint observable argument using this key to start listening to the changes
+ * in the element class result.
+ */
+ public static final Key KEY_ELEMENT_CLASS_LISTENER = new KeyOf(Listener.class, "ELEMENT_CLASS_LISTENER");
+
+}