diff options
author | Artur Signell <artur@vaadin.com> | 2016-08-18 09:31:40 +0300 |
---|---|---|
committer | Artur Signell <artur@vaadin.com> | 2016-08-18 09:31:40 +0300 |
commit | eeffa805a212ebb25c4af18db1e927b23a3ad66a (patch) | |
tree | 3bfdb4ef4b8e9b6e9e45c77c90b4f31eba1af94e /client | |
parent | 6d54d78944f6c3278eed3bb5e7ee19687ee5714e (diff) | |
download | vaadin-framework-eeffa805a212ebb25c4af18db1e927b23a3ad66a.tar.gz vaadin-framework-eeffa805a212ebb25c4af18db1e927b23a3ad66a.zip |
Remove trailing whitespace from code and javadoc
Change-Id: I4c852b7f9928e190572876690d5bef1234494a5d
Diffstat (limited to 'client')
490 files changed, 4645 insertions, 4645 deletions
diff --git a/client/src/main/java/com/vaadin/client/AnimationUtil.java b/client/src/main/java/com/vaadin/client/AnimationUtil.java index 816a5f9e28..4f4bc71f86 100644 --- a/client/src/main/java/com/vaadin/client/AnimationUtil.java +++ b/client/src/main/java/com/vaadin/client/AnimationUtil.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -22,7 +22,7 @@ import com.google.gwt.dom.client.Style; /** * Utility methods for working with CSS transitions and animations. - * + * * @author Vaadin Ltd * @since 7.3 */ @@ -30,9 +30,9 @@ public class AnimationUtil { /** * For internal use only. May be removed or replaced in the future. - * + * * Set the animation-duration CSS property. - * + * * @param elem * the element whose animation-duration to set * @param duration @@ -45,9 +45,9 @@ public class AnimationUtil { /** * For internal use only. May be removed or replaced in the future. - * + * * Set the animation-delay CSS property. - * + * * @param elem * the element whose animation-delay to set * @param delay @@ -65,15 +65,15 @@ public class AnimationUtil { var callbackFunc = $entry(function(e) { listener.@com.vaadin.client.AnimationUtil.AnimationEndListener::onAnimationEnd(Lcom/google/gwt/dom/client/NativeEvent;)(e); }); - + elem.addEventListener(@com.vaadin.client.AnimationUtil::ANIMATION_END_EVENT_NAME, callbackFunc, false); - + // Store function reference for later removal if(!elem._vaadin_animationend_callbacks) { elem._vaadin_animationend_callbacks = []; } elem._vaadin_animationend_callbacks.push(callbackFunc); - + return callbackFunc; }-*/; @@ -111,7 +111,7 @@ public class AnimationUtil { return event.mozAnimationName; else if(event.oAnimationName) return event.oAnimationName; - + return ""; }-*/; @@ -119,22 +119,22 @@ public class AnimationUtil { public static native String getAnimationName(ComputedStyle cstyle) /*-{ var cs = cstyle.@com.vaadin.client.ComputedStyle::computedStyle; - + if(!cs.getPropertyValue) return ""; - + if(cs.getPropertyValue("-webkit-animation-name")) return cs.getPropertyValue("-webkit-animation-name"); - + else if(cs.getPropertyValue("animation-name")) return cs.getPropertyValue("animation-name"); - + else if(cs.getPropertyValue("-moz-animation-name")) return cs.getPropertyValue("-moz-animation-name"); - + else if(cs.getPropertyValue("-o-animation-name")) return cs.getPropertyValue("-o-animation-name"); - + return ""; }-*/; @@ -149,7 +149,7 @@ public class AnimationUtil { 'MozAnimation': 'animationend', 'WebkitAnimation': 'webkitAnimationEnd' } - + for(var a in anims){ if( el.style[a] !== undefined ){ return anims[a]; @@ -168,7 +168,7 @@ public class AnimationUtil { 'mozAnimation', 'webkitAnimation' ] - + for(var i=0; i < anims.length; i++) { if( el.style[anims[i]] !== undefined ){ return anims[i]; diff --git a/client/src/main/java/com/vaadin/client/ApplicationConfiguration.java b/client/src/main/java/com/vaadin/client/ApplicationConfiguration.java index 81cea63313..6adb5968e7 100644 --- a/client/src/main/java/com/vaadin/client/ApplicationConfiguration.java +++ b/client/src/main/java/com/vaadin/client/ApplicationConfiguration.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -62,7 +62,7 @@ public class ApplicationConfiguration implements EntryPoint { /** * Helper class for reading configuration options from the bootstap * javascript - * + * * @since 7.0 */ private static class JsoConfiguration extends JavaScriptObject { @@ -74,7 +74,7 @@ public class ApplicationConfiguration implements EntryPoint { * Reads a configuration parameter as a string. Please note that the * javascript value of the parameter should also be a string, or else an * undefined exception may be thrown. - * + * * @param name * name of the configuration parameter * @return value of the configuration parameter, or <code>null</code> if @@ -94,7 +94,7 @@ public class ApplicationConfiguration implements EntryPoint { * Reads a configuration parameter as a boolean object. Please note that * the javascript value of the parameter should also be a boolean, or * else an undefined exception may be thrown. - * + * * @param name * name of the configuration parameter * @return boolean value of the configuration paramter, or @@ -115,7 +115,7 @@ public class ApplicationConfiguration implements EntryPoint { * Reads a configuration parameter as an integer object. Please note * that the javascript value of the parameter should also be an integer, * or else an undefined exception may be thrown. - * + * * @param name * name of the configuration parameter * @return integer value of the configuration paramter, or @@ -138,7 +138,7 @@ public class ApplicationConfiguration implements EntryPoint { * an object with appropriate fields, or else an undefined exception may * be thrown when calling this method or when calling methods on the * returned object. - * + * * @param name * name of the configuration parameter * @return error message with the given name, or <code>null</code> if no @@ -152,7 +152,7 @@ public class ApplicationConfiguration implements EntryPoint { /** * Returns a native javascript object containing version information * from the server. - * + * * @return a javascript object with the version information */ private native JavaScriptObject getVersionInfoJSObject() @@ -162,9 +162,9 @@ public class ApplicationConfiguration implements EntryPoint { /** * Gets the version of the Vaadin framework used on the server. - * + * * @return a string with the version - * + * * @see com.vaadin.server.VaadinServlet#VERSION */ private native String getVaadinVersion() @@ -174,9 +174,9 @@ public class ApplicationConfiguration implements EntryPoint { /** * Gets the version of the Atmosphere framework. - * + * * @return a string with the version - * + * * @see org.atmosphere.util#getRawVersion() */ private native String getAtmosphereVersion() @@ -186,7 +186,7 @@ public class ApplicationConfiguration implements EntryPoint { /** * Gets the JS version used in the Atmosphere framework. - * + * * @return a string with the version */ private native String getAtmosphereJSVersion() @@ -206,7 +206,7 @@ public class ApplicationConfiguration implements EntryPoint { /** * Wraps a native javascript object containing fields for an error message - * + * * @since 7.0 */ public static final class ErrorMessage extends JavaScriptObject { @@ -268,9 +268,9 @@ public class ApplicationConfiguration implements EntryPoint { * Checks whether path info in requests to the server-side service should be * in a request parameter (named <code>v-resourcePath</code>) or appended to * the end of the service URL. - * + * * @see #getServiceUrl() - * + * * @return <code>true</code> if path info should be a request parameter; * <code>false</code> if the path info goes after the service URL */ @@ -282,7 +282,7 @@ public class ApplicationConfiguration implements EntryPoint { * Return the name of the parameter used to to send data to the service url. * This method should only be called if {@link #useServiceUrlPathParam()} is * true. - * + * * @since 7.1.6 * @return The parameter name, by default <code>v-resourcePath</code> */ @@ -300,9 +300,9 @@ public class ApplicationConfiguration implements EntryPoint { * {@link #useServiceUrlPathParam()} return <code>true</code>, the requested * path info should be in the <code>v-resourcePath</code> query parameter; * else the path info should be appended to the end of the URL. - * + * * @see #useServiceUrlPathParam() - * + * * @return the URL to the server-side service as a string */ public String getServiceUrl() { @@ -321,7 +321,7 @@ public class ApplicationConfiguration implements EntryPoint { /** * Gets the URL of the VAADIN directory on the server. - * + * * @return the URL of the VAADIN directory */ public String getVaadinDirUrl() { @@ -335,7 +335,7 @@ public class ApplicationConfiguration implements EntryPoint { /** * Gets the initial UIDL from the DOM, if it was provided during the init * process. - * + * * @return */ public String getUIDL() { @@ -355,7 +355,7 @@ public class ApplicationConfiguration implements EntryPoint { * instance. The UI id should be included in every request originating from * this instance in order to associate the request with the right UI * instance on the server. - * + * * @return the UI id */ public int getUIId() { @@ -432,7 +432,7 @@ public class ApplicationConfiguration implements EntryPoint { /** * Starts the application with a given id by reading the configuration * options stored by the bootstrap javascript. - * + * * @param applicationId * id of the application to load, this is also the id of the html * element into which the application should be rendered. @@ -463,7 +463,7 @@ public class ApplicationConfiguration implements EntryPoint { /** * Gets the configuration object for a specific application from the * bootstrap javascript. - * + * * @param appId * the id of the application to get configuration data for * @return a native javascript object containing the configuration data @@ -486,9 +486,9 @@ public class ApplicationConfiguration implements EntryPoint { /** * Return Atmosphere version. - * + * * @since 7.4 - * + * * @return Atmosphere version. */ public String getAtmosphereVersion() { @@ -497,9 +497,9 @@ public class ApplicationConfiguration implements EntryPoint { /** * Return Atmosphere JS version. - * + * * @since 7.4 - * + * * @return Atmosphere JS version. */ public String getAtmosphereJSVersion() { @@ -565,7 +565,7 @@ public class ApplicationConfiguration implements EntryPoint { * Returns all tags for given class. Tags are used in * {@link ApplicationConfiguration} to keep track of different classes and * their hierarchy - * + * * @since 7.2 * @param classname * name of class which tags we want @@ -796,7 +796,7 @@ public class ApplicationConfiguration implements EntryPoint { * Registers that callback that the bootstrap javascript uses to start * applications once the widgetset is loaded and all required information is * available - * + * * @param widgetsetName * the name of this widgetset */ @@ -811,9 +811,9 @@ public class ApplicationConfiguration implements EntryPoint { * adding ?debug parameter to URI. Please note that debug mode is always * disabled if production mode is enabled, but disabling production mode * does not automatically enable debug mode. - * + * * @see #isProductionMode() - * + * * @return true if client side is currently been debugged */ public static boolean isDebugMode() { @@ -825,7 +825,7 @@ public class ApplicationConfiguration implements EntryPoint { * Checks if production mode is enabled. When production mode is enabled, * client-side logging is disabled. There may also be other performance * optimizations. - * + * * @since 7.1.2 * @return <code>true</code> if production mode is enabled; otherwise * <code>false</code>. @@ -845,7 +845,7 @@ public class ApplicationConfiguration implements EntryPoint { /** * Checks whether debug logging should be quiet - * + * * @return <code>true</code> if debug logging should be quiet */ public static boolean isQuietDebugMode() { @@ -857,7 +857,7 @@ public class ApplicationConfiguration implements EntryPoint { /** * Checks whether the widget set version has been sent to the server. It is * sent in the first UIDL request. - * + * * @return <code>true</code> if browser information has already been sent */ public boolean isWidgetsetVersionSent() { diff --git a/client/src/main/java/com/vaadin/client/ApplicationConnection.java b/client/src/main/java/com/vaadin/client/ApplicationConnection.java index f8c75948eb..bdf34d229c 100644 --- a/client/src/main/java/com/vaadin/client/ApplicationConnection.java +++ b/client/src/main/java/com/vaadin/client/ApplicationConnection.java @@ -69,14 +69,14 @@ import com.vaadin.shared.util.SharedUtil; * This is the client side communication "engine", managing client-server * communication with its server side counterpart * com.vaadin.server.VaadinService. - * + * * Client-side connectors receive updates from the corresponding server-side * connector (typically component) as state updates or RPC calls. The connector * has the possibility to communicate back with its server side counter part * through RPC calls. - * + * * TODO document better - * + * * Entry point classes (widgetsets) define <code>onModuleLoad()</code>. */ public class ApplicationConnection implements HasHandlers { @@ -100,12 +100,12 @@ public class ApplicationConnection implements HasHandlers { * A string that, if found in a non-JSON response to a UIDL request, will * cause the browser to refresh the page. If followed by a colon, optional * whitespace, and a URI, causes the browser to synchronously load the URI. - * + * * <p> * This allows, for instance, a servlet filter to redirect the application * to a custom login page when the session expires. For example: * </p> - * + * * <pre> * if (sessionExpired) { * response.setHeader("Content-Type", "text/html"); @@ -233,12 +233,12 @@ public class ApplicationConnection implements HasHandlers { /** * Event triggered when a application is stopped by calling * {@link ApplicationConnection#setApplicationRunning(false)}. - * + * * To listen for the event add a {@link ApplicationStoppedHandler} by * invoking * {@link ApplicationConnection#addHandler(ApplicationConnection.ApplicationStoppedEvent.Type, ApplicationStoppedHandler)} * to the {@link ApplicationConnection} - * + * * @since 7.1.8 * @author Vaadin Ltd */ @@ -265,7 +265,7 @@ public class ApplicationConnection implements HasHandlers { /** * Called when a communication error has occurred. Returning * <code>true</code> from this method suppresses error handling. - * + * * @param details * A string describing the error. * @param statusCode @@ -280,7 +280,7 @@ public class ApplicationConnection implements HasHandlers { * A listener for listening to application stopped events. The listener can * be added to a {@link ApplicationConnection} by invoking * {@link ApplicationConnection#addHandler(ApplicationStoppedEvent.Type, ApplicationStoppedHandler)} - * + * * @since 7.1.8 * @author Vaadin Ltd */ @@ -290,7 +290,7 @@ public class ApplicationConnection implements HasHandlers { * Triggered when the {@link ApplicationConnection} marks a previously * running application as stopped by invoking * {@link ApplicationConnection#setApplicationRunning(false)} - * + * * @param event * the event triggered by the {@link ApplicationConnection} */ @@ -427,7 +427,7 @@ public class ApplicationConnection implements HasHandlers { * called once this application has started (first response received) or * failed to start. This ensures that the applications are started in order, * to avoid session-id problems. - * + * */ public void start() { String jsonText = configuration.getUIDL(); @@ -459,7 +459,7 @@ public class ApplicationConnection implements HasHandlers { /** * Checks if there is some work to be done on the client side - * + * * @return true if the client has some work to be done, false otherwise */ private boolean isActive() { @@ -482,7 +482,7 @@ public class ApplicationConnection implements HasHandlers { return vi; } } - + client.getProfilingData = $entry(function() { var smh = ap.@com.vaadin.client.ApplicationConnection::getMessageHandler()(); var pd = [ @@ -497,7 +497,7 @@ public class ApplicationConnection implements HasHandlers { pd[pd.length] = smh.@com.vaadin.client.communication.MessageHandler::bootstrapTime; return pd; }); - + client.getElementByPath = $entry(function(id) { return componentLocator.@com.vaadin.client.componentlocator.ComponentLocator::getElementByPath(Ljava/lang/String;)(id); }); @@ -514,7 +514,7 @@ public class ApplicationConnection implements HasHandlers { return componentLocator.@com.vaadin.client.componentlocator.ComponentLocator::getPathForElement(Lcom/google/gwt/dom/client/Element;)(element); }); client.initializing = false; - + $wnd.vaadin.clients[TTAppId] = client; }-*/; @@ -534,7 +534,7 @@ public class ApplicationConnection implements HasHandlers { * <li><code>vaadin.postRequestHooks</code> is a map of functions which gets * called after each XHR made by vaadin application. Note, that it is * attaching js functions responsibility to create the variable like this: - * + * * <code><pre> * if(!vaadin.postRequestHooks) {vaadin.postRequestHooks = new Object();} * postRequestHooks.myHook = function(appId) { @@ -545,7 +545,7 @@ public class ApplicationConnection implements HasHandlers { * </pre></code> First parameter passed to these functions is the identifier * of Vaadin application that made the request. * </ul> - * + * * TODO make this multi-app aware */ private native void initializeClientHooks() @@ -576,7 +576,7 @@ public class ApplicationConnection implements HasHandlers { /** * Requests an analyze of layouts, to find inconsistencies. Exclusively used * for debugging during development. - * + * * @deprecated as of 7.1. Replaced by {@link UIConnector#analyzeLayouts()} */ @Deprecated @@ -588,7 +588,7 @@ public class ApplicationConnection implements HasHandlers { * Sends a request to the server to print details to console that will help * the developer to locate the corresponding server-side connector in the * source code. - * + * * @param serverConnector * @deprecated as of 7.1. Replaced by * {@link UIConnector#showServerDebugInfo(ServerConnector)} @@ -635,7 +635,7 @@ public class ApplicationConnection implements HasHandlers { /** * Checks whether or not the CSS is loaded. By default checks the size of * the loading indicator element. - * + * * @return */ protected boolean isCSSLoaded() { @@ -645,12 +645,12 @@ public class ApplicationConnection implements HasHandlers { /** * Shows the communication error notification. - * + * * @param details * Optional details. * @param statusCode * The status code returned for the request - * + * */ public void showCommunicationError(String details, int statusCode) { getLogger().severe("Communication error: " + details); @@ -659,7 +659,7 @@ public class ApplicationConnection implements HasHandlers { /** * Shows the authentication error notification. - * + * * @param details * Optional details. */ @@ -670,7 +670,7 @@ public class ApplicationConnection implements HasHandlers { /** * Shows the session expiration notification. - * + * * @param details * Optional details. */ @@ -681,7 +681,7 @@ public class ApplicationConnection implements HasHandlers { /** * Shows an error notification. - * + * * @param details * Optional details. * @param message @@ -729,7 +729,7 @@ public class ApplicationConnection implements HasHandlers { * <p> * Used by the native "client.isActive" function. * </p> - * + * * @return true if deferred commands are (potentially) being executed, false * otherwise */ @@ -744,7 +744,7 @@ public class ApplicationConnection implements HasHandlers { /** * Returns the loading indicator used by this ApplicationConnection - * + * * @return The loading indicator for this ApplicationConnection */ public VLoadingIndicator getLoadingIndicator() { @@ -753,7 +753,7 @@ public class ApplicationConnection implements HasHandlers { /** * Determines whether or not the loading indicator is showing. - * + * * @return true if the loading indicator is visible * @deprecated As of 7.1. Use {@link #getLoadingIndicator()} and * {@link VLoadingIndicator#isVisible()}.isVisible() instead. @@ -862,7 +862,7 @@ public class ApplicationConnection implements HasHandlers { * is true, the update is sent as soon as possible. If immediate is false, * the update will be sent along with the next immediate update. * </p> - * + * * @param paintableId * the id of the paintable that owns the variable * @param variableName @@ -884,7 +884,7 @@ public class ApplicationConnection implements HasHandlers { * is true, the update is sent as soon as possible. If immediate is false, * the update will be sent along with the next immediate update. * </p> - * + * * @param paintableId * the id of the paintable that owns the variable * @param variableName @@ -907,7 +907,7 @@ public class ApplicationConnection implements HasHandlers { * is true, the update is sent as soon as possible. If immediate is false, * the update will be sent along with the next immediate update. * </p> - * + * * @param paintableId * the id of the paintable that owns the variable * @param variableName @@ -930,7 +930,7 @@ public class ApplicationConnection implements HasHandlers { * is true, the update is sent as soon as possible. If immediate is false, * the update will be sent along with the next immediate update. * </p> - * + * * @param paintableId * the id of the paintable that owns the variable * @param variableName @@ -953,7 +953,7 @@ public class ApplicationConnection implements HasHandlers { * is true, the update is sent as soon as possible. If immediate is false, * the update will be sent along with the next immediate update. * </p> - * + * * @param paintableId * the id of the paintable that owns the variable * @param variableName @@ -976,7 +976,7 @@ public class ApplicationConnection implements HasHandlers { * is true, the update is sent as soon as possible. If immediate is false, * the update will be sent along with the next immediate update. * </p> - * + * * @param paintableId * the id of the paintable that owns the variable * @param variableName @@ -999,7 +999,7 @@ public class ApplicationConnection implements HasHandlers { * is true, the update is sent as soon as possible. If immediate is false, * the update will be sent along with the next immediate update. * </p> - * + * * @param paintableId * the id of the paintable that owns the variable * @param variableName @@ -1022,7 +1022,7 @@ public class ApplicationConnection implements HasHandlers { * is true, the update is sent as soon as possible. If immediate is false, * the update will be sent along with the next immediate update. * </p> - * + * * @param paintableId * the id of the paintable that owns the variable * @param variableName @@ -1045,7 +1045,7 @@ public class ApplicationConnection implements HasHandlers { * the update will be sent along with the next immediate update. * <p> * A null array is sent as an empty array. - * + * * @param paintableId * the id of the paintable that owns the variable * @param variableName @@ -1068,7 +1068,7 @@ public class ApplicationConnection implements HasHandlers { * the update will be sent along with the next immediate update. * <p> * A null array is sent as an empty array. - * + * * @param paintableId * the id of the paintable that owns the variable * @param variableName @@ -1085,7 +1085,7 @@ public class ApplicationConnection implements HasHandlers { /** * Does absolutely nothing. Replaced by {@link LayoutManager}. - * + * * @param container * @deprecated As of 7.0, serves no purpose */ @@ -1107,7 +1107,7 @@ public class ApplicationConnection implements HasHandlers { /** * Returns false - * + * * @param paintable * @return false, always * @deprecated As of 7.0, serves no purpose @@ -1119,7 +1119,7 @@ public class ApplicationConnection implements HasHandlers { /** * Returns false - * + * * @param paintable * @return false, always * @deprecated As of 7.0, serves no purpose @@ -1140,16 +1140,16 @@ public class ApplicationConnection implements HasHandlers { /** * Get either an existing ComponentConnector or create a new * ComponentConnector with the given type and id. - * + * * If a ComponentConnector with the given id already exists, returns it. * Otherwise creates and registers a new ComponentConnector of the given * type. - * + * * @param connectorId * Id of the paintable * @param connectorType * Type of the connector, as passed from the server side - * + * * @return Either an existing ComponentConnector or a new ComponentConnector * of the given type */ @@ -1162,15 +1162,15 @@ public class ApplicationConnection implements HasHandlers { /** * Creates a new ServerConnector with the given type and id. - * + * * Creates and registers a new ServerConnector of the given type. Should * never be called with the connector id of an existing connector. - * + * * @param connectorId * Id of the new connector * @param connectorType * Type of the connector, as passed from the server side - * + * * @return A new ServerConnector of the given type */ private ServerConnector createAndRegisterConnector(String connectorId, @@ -1190,7 +1190,7 @@ public class ApplicationConnection implements HasHandlers { /** * Gets a resource that has been pre-loaded via UIDL, such as custom * layouts. - * + * * @param name * identifier of the resource to get * @return the resource @@ -1202,7 +1202,7 @@ public class ApplicationConnection implements HasHandlers { /** * Sets a resource that has been pre-loaded via UIDL, such as custom * layouts. - * + * * @since 7.6 * @param name * identifier of the resource to Set @@ -1215,7 +1215,7 @@ public class ApplicationConnection implements HasHandlers { /** * Singleton method to get instance of app's context menu. - * + * * @return VContextMenu object */ public VContextMenu getContextMenu() { @@ -1230,7 +1230,7 @@ public class ApplicationConnection implements HasHandlers { /** * Gets an {@link Icon} instance corresponding to a URI. - * + * * @since 7.2 * @param uri * @return Icon object @@ -1252,7 +1252,7 @@ public class ApplicationConnection implements HasHandlers { * Translates custom protocols in UIDL URI's to be recognizable by browser. * All uri's from UIDL should be routed via this method before giving them * to browser due URI's in UIDL may contain custom protocols like theme://. - * + * * @param uidlUri * Vaadin URI from uidl * @return translated URI ready for browser @@ -1264,7 +1264,7 @@ public class ApplicationConnection implements HasHandlers { /** * Gets the URI for the current theme. Can be used to reference theme * resources. - * + * * @return URI to the current theme */ public String getThemeUri() { @@ -1281,7 +1281,7 @@ public class ApplicationConnection implements HasHandlers { /** * Use to notify that the given component's caption has changed; layouts may * have to be recalculated. - * + * * @param component * the Paintable whose caption has changed * @deprecated As of 7.0.2, has not had any effect for a long time @@ -1293,7 +1293,7 @@ public class ApplicationConnection implements HasHandlers { /** * Gets the main view - * + * * @return the main view */ public UIConnector getUIConnector() { @@ -1302,7 +1302,7 @@ public class ApplicationConnection implements HasHandlers { /** * Gets the {@link ApplicationConfiguration} for the current application. - * + * * @see ApplicationConfiguration * @return the configuration for this application */ @@ -1315,7 +1315,7 @@ public class ApplicationConnection implements HasHandlers { * list of events which has server side listeners is updated automatically * before the component is updated so the value is correct if called from * updatedFromUIDL. - * + * * @param connector * The connector to register event listeners for * @param eventIdentifier @@ -1334,7 +1334,7 @@ public class ApplicationConnection implements HasHandlers { /** * Adds the get parameters to the uri and returns the new uri that contains * the parameters. - * + * * @param uri * The uri to which the parameters should be added. * @param extraParams @@ -1364,7 +1364,7 @@ public class ApplicationConnection implements HasHandlers { /** * Get VTooltip instance related to application connection - * + * * @return VTooltip instance */ public VTooltip getVTooltip() { @@ -1376,7 +1376,7 @@ public class ApplicationConnection implements HasHandlers { * this method is now handled by the state change event handler in * AbstractComponentConnector. The only function this method has is to * return true if the UIDL is a "cached" update. - * + * * @param component * @param uidl * @param manageCaption @@ -1427,7 +1427,7 @@ public class ApplicationConnection implements HasHandlers { * Schedules a heartbeat request to occur after the configured heartbeat * interval elapses if the interval is a positive number. Otherwise, does * nothing. - * + * * @deprecated as of 7.2, use {@link Heartbeat#schedule()} instead */ @Deprecated @@ -1441,7 +1441,7 @@ public class ApplicationConnection implements HasHandlers { * Heartbeat requests are used to inform the server that the client-side is * still alive. If the client page is closed or the connection lost, the * server will eventually close the inactive UI. - * + * * @deprecated as of 7.2, use {@link Heartbeat#send()} instead */ @Deprecated @@ -1464,7 +1464,7 @@ public class ApplicationConnection implements HasHandlers { /** * Sets the delegate that is called whenever a communication error occurrs. - * + * * @param delegate * the delegate. */ @@ -1504,7 +1504,7 @@ public class ApplicationConnection implements HasHandlers { /** * Checks if the application is in the {@link ApplicationState#RUNNING} * state. - * + * * @since 7.6 * @return true if the application is in the running state, false otherwise */ @@ -1536,7 +1536,7 @@ public class ApplicationConnection implements HasHandlers { /** * Gets the active connector for focused element in browser. - * + * * @return Connector for focused element or null. */ private ComponentConnector getActiveConnector() { @@ -1564,7 +1564,7 @@ public class ApplicationConnection implements HasHandlers { * "initializing" to "running" to "stopped". There is no way for an * application to go back to a previous state, i.e. a stopped application * can never be re-started - * + * * @since 7.6 * @return the current state of this application */ @@ -1574,7 +1574,7 @@ public class ApplicationConnection implements HasHandlers { /** * Gets the server RPC queue for this application - * + * * @since 7.6 * @return the server RPC queue */ @@ -1584,7 +1584,7 @@ public class ApplicationConnection implements HasHandlers { /** * Gets the communication error handler for this application - * + * * @since 7.6 * @return the server RPC queue */ @@ -1594,7 +1594,7 @@ public class ApplicationConnection implements HasHandlers { /** * Gets the (server to client) message handler for this application - * + * * @since 7.6 * @return the message handler */ @@ -1604,7 +1604,7 @@ public class ApplicationConnection implements HasHandlers { /** * Gets the server rpc manager for this application - * + * * @since 7.6 * @return the server rpc manager */ @@ -1614,7 +1614,7 @@ public class ApplicationConnection implements HasHandlers { /** * Gets the (client to server) message sender for this application - * + * * @since 7.6 * @return the message sender */ diff --git a/client/src/main/java/com/vaadin/client/BrowserInfo.java b/client/src/main/java/com/vaadin/client/BrowserInfo.java index 0074054392..f037fba175 100644 --- a/client/src/main/java/com/vaadin/client/BrowserInfo.java +++ b/client/src/main/java/com/vaadin/client/BrowserInfo.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,10 +21,10 @@ import com.vaadin.shared.VBrowserDetails; /** * Class used to query information about web browser. - * + * * Browser details are detected only once and those are stored in this singleton * class. - * + * */ public class BrowserInfo { @@ -60,7 +60,7 @@ public class BrowserInfo { /** * Singleton method to get BrowserInfo object. - * + * * @return instance of BrowserInfo object */ public static BrowserInfo get() { @@ -122,19 +122,19 @@ public class BrowserInfo { * Returns a string representing the browser in use, for use in CSS * classnames. The classnames will be space separated abbreviations, * optionally with a version appended. - * + * * Abbreviations: Firefox: ff Internet Explorer: ie Safari: sa Opera: op - * + * * Browsers that CSS-wise behave like each other will get the same * abbreviation (this usually depends on the rendering engine). - * + * * This is quite simple at the moment, more heuristics will be added when * needed. - * + * * Examples: Internet Explorer 6: ".v-ie .v-ie6 .v-ie60", Firefox 3.0.4: * ".v-ff .v-ff3 .v-ff30", Opera 9.60: ".v-op .v-op9 .v-op960", Opera 10.10: * ".v-op .v-op10 .v-op1010" - * + * * @return */ public String getCSSClass() { @@ -284,7 +284,7 @@ public class BrowserInfo { /** * Returns the Gecko version if the browser is Gecko based. The Gecko * version for Firefox 2 is 1.8 and 1.9 for Firefox 3. - * + * * @return The Gecko version or -1 if the browser is not Gecko based */ public float getGeckoVersion() { @@ -298,7 +298,7 @@ public class BrowserInfo { /** * Returns the WebKit version if the browser is WebKit based. The WebKit * version returned is the major version e.g., 523. - * + * * @return The WebKit version or -1 if the browser is not WebKit based */ public float getWebkitVersion() { @@ -362,7 +362,7 @@ public class BrowserInfo { /** * Indicates whether the browser might require juggling to properly update * sizes inside elements with overflow: auto. - * + * * @return <code>true</code> if the browser requires the workaround, * otherwise <code>false</code> */ @@ -379,7 +379,7 @@ public class BrowserInfo { * <p> * See https://bugs.webkit.org/show_bug.cgi?id=123958 and * http://code.google.com/p/chromium/issues/detail?id=316549 - * + * * @since 7.1.8 * @return <code>true</code> if the browser requires the workaround, * otherwise <code>false</code> @@ -391,7 +391,7 @@ public class BrowserInfo { /** * Checks if the browser is run on iOS - * + * * @return true if the browser is run on iOS, false otherwise */ public boolean isIOS() { @@ -400,7 +400,7 @@ public class BrowserInfo { /** * Checks if the browser is run on iOS 6. - * + * * @since 7.1.1 * @return true if the browser is run on iOS 6, false otherwise */ @@ -410,7 +410,7 @@ public class BrowserInfo { /** * Checks if the browser is run on Android - * + * * @return true if the browser is run on Android, false otherwise */ public boolean isAndroid() { @@ -420,7 +420,7 @@ public class BrowserInfo { /** * Checks if the browser is capable of handling scrolling natively or if a * touch scroll helper is needed for scrolling. - * + * * @return true if browser needs a touch scroll helper, false if the browser * can handle scrolling natively */ @@ -448,7 +448,7 @@ public class BrowserInfo { /** * Tests if this is an Android devices with a broken scrollTop * implementation - * + * * @return true if scrollTop cannot be trusted on this device, false * otherwise */ @@ -477,7 +477,7 @@ public class BrowserInfo { * Note that Internet Explorer 8 and newer will return the document mode so * IE8 rendering as IE7 will return 7. * </p> - * + * * @return The major version of the browser. */ public int getBrowserMajorVersion() { @@ -486,9 +486,9 @@ public class BrowserInfo { /** * Returns the browser minor version e.g., 5 for Firefox 3.5. - * + * * @see #getBrowserMajorVersion() - * + * * @return The minor version of the browser, or -1 if not known/parsed. */ public int getBrowserMinorVersion() { @@ -498,7 +498,7 @@ public class BrowserInfo { /** * Checks if the browser version is newer or equal to the given major+minor * version. - * + * * @param majorVersion * The major version to check for * @param minorVersion diff --git a/client/src/main/java/com/vaadin/client/CSSRule.java b/client/src/main/java/com/vaadin/client/CSSRule.java index d57eacf275..2e75b6a58e 100644 --- a/client/src/main/java/com/vaadin/client/CSSRule.java +++ b/client/src/main/java/com/vaadin/client/CSSRule.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -26,7 +26,7 @@ public class CSSRule { private JavaScriptObject rules = null; /** - * + * * @param selector * the CSS selector to search for in the stylesheets * @param deep @@ -63,11 +63,11 @@ public class CSSRule { /*-{ if(!$doc.styleSheets) return null; - + selector = selector.toLowerCase(); - + var allMatches = []; - + // IE handles imported sheet differently if(deep && sheet.imports && sheet.imports.length > 0) { for(var i=0; i < sheet.imports.length; i++) { @@ -76,13 +76,13 @@ public class CSSRule { allMatches.concat(imports); } } - + var theRules = new Array(); if (sheet.cssRules) theRules = sheet.cssRules else if (sheet.rules) theRules = sheet.rules - + var j = theRules.length; for(var i=0; i<j; i++) { var r = theRules[i]; @@ -102,13 +102,13 @@ public class CSSRule { allMatches = allMatches.concat(imports); } } - + return allMatches; }-*/; /** * Returns a specific property value from this CSS rule. - * + * * @param propertyName * camelCase CSS property name * @return the value of the property as a String diff --git a/client/src/main/java/com/vaadin/client/ComponentConnector.java b/client/src/main/java/com/vaadin/client/ComponentConnector.java index d0c943d553..f70f3cfc62 100644 --- a/client/src/main/java/com/vaadin/client/ComponentConnector.java +++ b/client/src/main/java/com/vaadin/client/ComponentConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,7 +24,7 @@ import com.vaadin.shared.AbstractComponentState; * An interface used by client-side widgets or paintable parts to receive * updates from the corresponding server-side components in the form of * {@link UIDL}. - * + * * Updates can be sent back to the server using the * {@link ApplicationConnection#updateVariable()} methods. */ @@ -32,7 +32,7 @@ public interface ComponentConnector extends ServerConnector { /* * (non-Javadoc) - * + * * @see com.vaadin.client.VPaintable#getState() */ @Override @@ -49,7 +49,7 @@ public interface ComponentConnector extends ServerConnector { * Returns <code>true</code> if the width of this paintable is currently * undefined. If the width is undefined, the actual width of the paintable * is defined by its contents. - * + * * @return <code>true</code> if the width is undefined, else * <code>false</code> */ @@ -59,7 +59,7 @@ public interface ComponentConnector extends ServerConnector { * Returns <code>true</code> if the height of this paintable is currently * undefined. If the height is undefined, the actual height of the paintable * is defined by its contents. - * + * * @return <code>true</code> if the height is undefined, else * <code>false</code> */ @@ -69,7 +69,7 @@ public interface ComponentConnector extends ServerConnector { * Returns <code>true</code> if the width of this paintable is currently * relative. If the width is relative, the actual width of the paintable is * a percentage of the size allocated to it by its parent. - * + * * @return <code>true</code> if the width is undefined, else * <code>false</code> */ @@ -79,7 +79,7 @@ public interface ComponentConnector extends ServerConnector { * Returns <code>true</code> if the height of this paintable is currently * relative. If the height is relative, the actual height of the paintable * is a percentage of the size allocated to it by its parent. - * + * * @return <code>true</code> if the width is undefined, else * <code>false</code> */ @@ -87,7 +87,7 @@ public interface ComponentConnector extends ServerConnector { /** * Checks if the connector is read only. - * + * * @deprecated This belongs in AbstractFieldConnector, see #8514 * @return true */ @@ -97,13 +97,13 @@ public interface ComponentConnector extends ServerConnector { /** * Return true if parent handles caption, false if the paintable handles the * caption itself. - * + * * <p> * This should always return true and all components should let the parent * handle the caption and use other attributes for internal texts in the * component * </p> - * + * * @return true if caption handling is delegated to the parent, false if * parent should not be allowed to render caption */ @@ -111,7 +111,7 @@ public interface ComponentConnector extends ServerConnector { /** * Sets the enabled state of the widget associated to this connector. - * + * * @param widgetEnabled * true if the widget should be enabled, false otherwise */ @@ -124,7 +124,7 @@ public interface ComponentConnector extends ServerConnector { * overridden to return <code>true</code> in all situations where this * method might return a non-empty result. * </p> - * + * * @param element * The element to lookup a tooltip for * @return The tooltip for the element or null if no tooltip is defined for @@ -140,7 +140,7 @@ public interface ComponentConnector extends ServerConnector { * This is only done to optimize performance, so in cases where the status * is not known, it's safer to return <code>true</code> so that there will * be a tooltip handler even though it might not be needed in all cases. - * + * * @return <code>true</code> if some part of the component might have a * tooltip, otherwise <code>false</code> */ diff --git a/client/src/main/java/com/vaadin/client/ComponentDetail.java b/client/src/main/java/com/vaadin/client/ComponentDetail.java index 9e5e2a82a8..a6a1878407 100644 --- a/client/src/main/java/com/vaadin/client/ComponentDetail.java +++ b/client/src/main/java/com/vaadin/client/ComponentDetail.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -30,7 +30,7 @@ class ComponentDetail { /** * Returns a TooltipInfo assosiated with Component. If element is given, * returns an additional TooltipInfo. - * + * * @param key * @return the tooltipInfo */ diff --git a/client/src/main/java/com/vaadin/client/ComponentDetailMap.java b/client/src/main/java/com/vaadin/client/ComponentDetailMap.java index c99ebd2738..498e28c28b 100644 --- a/client/src/main/java/com/vaadin/client/ComponentDetailMap.java +++ b/client/src/main/java/com/vaadin/client/ComponentDetailMap.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ComputedStyle.java b/client/src/main/java/com/vaadin/client/ComputedStyle.java index 4844b00a75..f887dbb7d1 100644 --- a/client/src/main/java/com/vaadin/client/ComputedStyle.java +++ b/client/src/main/java/com/vaadin/client/ComputedStyle.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -29,7 +29,7 @@ public class ComputedStyle { * <p> * Note that this method is expensive. Wherever possible, reuse the returned * object. - * + * * @param elem * the element * @return the computed style @@ -44,18 +44,18 @@ public class ComputedStyle { if(elem.nodeType != 1) { return {}; } - + if($wnd.document.defaultView && $wnd.document.defaultView.getComputedStyle) { return $wnd.document.defaultView.getComputedStyle(elem, null); } - + if(elem.currentStyle) { return elem.currentStyle; } }-*/; /** - * + * * @param name * name of the CSS property in camelCase * @return the value of the property, normalized for across browsers (each @@ -65,7 +65,7 @@ public class ComputedStyle { /*-{ var cs = this.@com.vaadin.client.ComputedStyle::computedStyle; var elem = this.@com.vaadin.client.ComputedStyle::elem; - + // Border values need to be checked separately. The width might have a // meaningful value even if the border style is "none". In that case the // value should be 0. @@ -78,45 +78,45 @@ public class ComputedStyle { if(borderStyle == "none") return "0px"; } - + if(cs.getPropertyValue) { - + // Convert name to dashed format name = name.replace(/([A-Z])/g, "-$1").toLowerCase(); var ret = cs.getPropertyValue(name); - + } else { - + var ret = cs[name]; var style = elem.style; - + // From the awesome hack by Dean Edwards // http://erik.eae.net/archives/2007/07/27/18.54.15/#comment-102291 - + // If we're not dealing with a regular pixel number // but a number that has a weird ending, we need to convert it to pixels if ( !/^\d+(px)?$/i.test( ret ) && /^\d/.test( ret ) ) { // Remember the original values var left = style.left, rsLeft = elem.runtimeStyle.left; - + // Put in the new values to get a computed value out elem.runtimeStyle.left = cs.left; style.left = ret || 0; ret = style.pixelLeft + "px"; - + // Revert the changed values style.left = left; elem.runtimeStyle.left = rsLeft; } - + } - + // Normalize margin values. This is not totally valid, but in most cases // it is what the user wants to know. if(name.indexOf("margin") > -1 && ret == "auto") { return "0px"; } - + // Some browsers return undefined width and height values as "auto", so // we need to retrieve those ourselves. if (name == "width" && ret == "auto") { @@ -124,16 +124,16 @@ public class ComputedStyle { } else if (name == "height" && ret == "auto") { ret = elem.clientHeight + "px"; } - + return ret; - + }-*/; /** * Retrieves the given computed property as an integer - * + * * Returns 0 if the property cannot be converted to an integer - * + * * @param name * the property to retrieve * @return the integer value of the property or 0 @@ -148,9 +148,9 @@ public class ComputedStyle { /** * Retrieves the given computed property as a double - * + * * Returns NaN if the property cannot be converted to a double - * + * * @since 7.5.1 * @param name * the property to retrieve @@ -205,7 +205,7 @@ public class ComputedStyle { /** * Returns the current width from the DOM. - * + * * @since 7.5.1 * @return the computed width */ @@ -215,7 +215,7 @@ public class ComputedStyle { /** * Returns the current height from the DOM. - * + * * @since 7.5.1 * @return the computed height */ @@ -225,13 +225,13 @@ public class ComputedStyle { /** * Takes a String value e.g. "12px" and parses that to Integer 12. - * + * * @param String * a value starting with a number * @return Integer the value from the string before any non-numeric * characters. If the value cannot be parsed to a number, returns * <code>null</code>. - * + * * @deprecated Since 7.1.4, the method {@link #parseIntNative(String)} is * used internally and this method does not belong in the public * API of {@link ComputedStyle}. {@link #parseInt(String)} might @@ -250,10 +250,10 @@ public class ComputedStyle { /** * Takes a String value e.g. "12px" and parses that to int 12. - * + * * <p> * This method returns 0 for <code>NaN</code>. - * + * * @param String * a value starting with a number * @return int the value from the string before any non-numeric characters. @@ -270,7 +270,7 @@ public class ComputedStyle { /** * Takes a String value e.g. "12.3px" and parses that to a double, 12.3. - * + * * @param String * a value starting with a number * @return the value from the string before any non-numeric characters or @@ -283,7 +283,7 @@ public class ComputedStyle { /** * Returns the sum of the top and bottom border width - * + * * @since 7.5.3 * @return the sum of the top and bottom border */ @@ -296,7 +296,7 @@ public class ComputedStyle { /** * Returns the sum of the left and right border width - * + * * @since 7.5.3 * @return the sum of the left and right border */ @@ -309,7 +309,7 @@ public class ComputedStyle { /** * Returns the sum of the top and bottom padding - * + * * @since 7.5.3 * @return the sum of the top and bottom padding */ @@ -322,7 +322,7 @@ public class ComputedStyle { /** * Returns the sum of the top and bottom padding - * + * * @since 7.5.3 * @return the sum of the left and right padding */ @@ -335,7 +335,7 @@ public class ComputedStyle { /** * Returns the sum of the top and bottom margin - * + * * @since 7.5.6 * @return the sum of the top and bottom margin */ @@ -348,7 +348,7 @@ public class ComputedStyle { /** * Returns the sum of the top and bottom margin - * + * * @since 7.5.6 * @return the sum of the left and right margin */ diff --git a/client/src/main/java/com/vaadin/client/ConnectorHierarchyChangeEvent.java b/client/src/main/java/com/vaadin/client/ConnectorHierarchyChangeEvent.java index 3da7703cbd..a46b191aa1 100644 --- a/client/src/main/java/com/vaadin/client/ConnectorHierarchyChangeEvent.java +++ b/client/src/main/java/com/vaadin/client/ConnectorHierarchyChangeEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -29,10 +29,10 @@ import com.vaadin.client.ui.AbstractHasComponentsConnector; * hierarchy. A {@link ConnectorHierarchyChangedEvent} is fired when an update * from the server has been fully processed and all hierarchy updates have been * completed. - * + * * @author Vaadin Ltd * @since 7.0.0 - * + * */ public class ConnectorHierarchyChangeEvent extends AbstractServerConnectorEvent<ConnectorHierarchyChangeHandler> { @@ -49,7 +49,7 @@ public class ConnectorHierarchyChangeEvent /** * Returns a collection of the old children for the connector. This was the * state before the update was received from the server. - * + * * @return A collection of old child connectors. Never returns null. */ public List<ComponentConnector> getOldChildren() { @@ -58,7 +58,7 @@ public class ConnectorHierarchyChangeEvent /** * Sets the collection of the old children for the connector. - * + * * @param oldChildren * The old child connectors. Must not be null. */ @@ -68,7 +68,7 @@ public class ConnectorHierarchyChangeEvent /** * Returns the {@link HasComponentsConnector} for which this event occurred. - * + * * @return The {@link HasComponentsConnector} whose child collection has * changed. Never returns null. */ @@ -112,7 +112,7 @@ public class ConnectorHierarchyChangeEvent * parent connector might not yet have detached a child widget and that * the widget of a removed child might already have been attached by its * new parent. - * + * * @param connectorHierarchyChangeEvent * the event with information about the hierarchy change */ diff --git a/client/src/main/java/com/vaadin/client/ConnectorMap.java b/client/src/main/java/com/vaadin/client/ConnectorMap.java index 2b95a1efaa..d6506db673 100644 --- a/client/src/main/java/com/vaadin/client/ConnectorMap.java +++ b/client/src/main/java/com/vaadin/client/ConnectorMap.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -37,7 +37,7 @@ public class ConnectorMap { /** * Returns a {@link ServerConnector} by its id - * + * * @param id * The connector id * @return A connector or null if a connector with the given id has not been @@ -54,7 +54,7 @@ public class ConnectorMap { /** * Returns a {@link ComponentConnector} element by its root element. - * + * * @param element * Root element of the {@link ComponentConnector} * @return A connector or null if a connector with the given id has not been @@ -82,7 +82,7 @@ public class ConnectorMap { /** * FIXME: What does this even do and why? - * + * * @param pid * @return */ @@ -92,7 +92,7 @@ public class ConnectorMap { /** * Checks if a connector with the given id has been registered. - * + * * @param connectorId * The id to check for * @return true if a connector has been registered with the given id, false @@ -111,7 +111,7 @@ public class ConnectorMap { /** * Retrieves the connector whose widget matches the parameter. - * + * * @param widget * The widget * @return A connector with {@literal widget} as its root widget or null if @@ -145,7 +145,7 @@ public class ConnectorMap { * Gets the connector id using a DOM element - the element should be the * root element for a connector, otherwise no id will be found. Use * {@link #getConnectorId(ServerConnector)} instead whenever possible. - * + * * @see #getConnectorId(ServerConnector) * @param el * element of the connector whose id is desired @@ -159,7 +159,7 @@ public class ConnectorMap { /** * Gets the main element for the connector with the given id. The reverse of * {@link #getConnectorId(Element)}. - * + * * @param connectorId * the id of the widget whose element is desired * @return the element for the connector corresponding to the id @@ -178,7 +178,7 @@ public class ConnectorMap { * This method does not remove the connector from the DOM, but marks the * connector so that ApplicationConnection may clean up its references to * it. Removing the widget from DOM is component containers responsibility. - * + * * @param connector * the connector to remove */ @@ -209,9 +209,9 @@ public class ConnectorMap { /** * Gets all registered {@link ComponentConnector} instances - * + * * @return An array of all registered {@link ComponentConnector} instances - * + * * @deprecated As of 7.0.1, use {@link #getComponentConnectorsAsJsArray()} * for better performance. */ @@ -260,7 +260,7 @@ public class ConnectorMap { /** * @return - * + * * @deprecated As of 7.0.1, use {@link #getConnectorsAsJsArray()} for * improved performance. */ @@ -291,7 +291,7 @@ public class ConnectorMap { /** * Tests if the widget is the root widget of a {@link ComponentConnector}. - * + * * @param widget * The widget to test * @return true if the widget is the root widget of a diff --git a/client/src/main/java/com/vaadin/client/ContainerResizedListener.java b/client/src/main/java/com/vaadin/client/ContainerResizedListener.java index 702542f0ac..2cacc78b38 100644 --- a/client/src/main/java/com/vaadin/client/ContainerResizedListener.java +++ b/client/src/main/java/com/vaadin/client/ContainerResizedListener.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ package com.vaadin.client; /** * ContainerResizedListener interface is useful for Widgets that support * relative sizes and who need some additional sizing logic. - * + * * @deprecated As of 7.0, serves no purpose. Use {@link LayoutManager} and its * methods instead. */ @@ -31,9 +31,9 @@ public interface ContainerResizedListener { * function on its ancestors that implement NeedsLayout in case their * container has resized. runAnchestorsLayout(HasWidgets parent) function * from Util class may be a good helper for this. - * + * * @deprecated As of 7.0, this method is never called by the framework. - * + * */ @Deprecated public void iLayout(); diff --git a/client/src/main/java/com/vaadin/client/DateTimeService.java b/client/src/main/java/com/vaadin/client/DateTimeService.java index 2d6b8aaaa0..af7e861edb 100644 --- a/client/src/main/java/com/vaadin/client/DateTimeService.java +++ b/client/src/main/java/com/vaadin/client/DateTimeService.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -27,9 +27,9 @@ import com.vaadin.shared.ui.datefield.Resolution; /** * This class provides date/time parsing services to all components on the * client side. - * + * * @author Vaadin Ltd. - * + * */ @SuppressWarnings("deprecation") public class DateTimeService { @@ -48,7 +48,7 @@ public class DateTimeService { /** * Creates a new date time service with a given locale. - * + * * @param locale * e.g. fi, en etc. * @throws LocaleNotLoadedException @@ -261,7 +261,7 @@ public class DateTimeService { /** * Returns the ISO-8601 week number of the given date. - * + * * @param date * The date for which the week number should be resolved * @return The ISO-8601 week number for {@literal date} @@ -299,11 +299,11 @@ public class DateTimeService { * it to the month name since DateTimeFormat.format always uses the current * locale and will replace the month name wrong if current locale is * different from the locale set for the DateField. - * + * * MMMM is converted into long month name, MMM is converted into short month * name. '' are added around the name to avoid that DateTimeFormat parses * the month name as a pattern. - * + * * @param date * The date to convert * @param formatStr @@ -417,7 +417,7 @@ public class DateTimeService { /** * Replaces month names in the entered date with the name in the current * browser locale. - * + * * @param enteredDate * Date string e.g. "5 May 2010" * @param formatString @@ -457,7 +457,7 @@ public class DateTimeService { /** * Parses the given date string using the given format string and the locale * set in this DateTimeService instance. - * + * * @param dateString * Date string e.g. "1 February 2010" * @param formatString @@ -467,7 +467,7 @@ public class DateTimeService { * @return A Date object representing the dateString. Never returns null. * @throws IllegalArgumentException * if the parsing fails - * + * */ public Date parseDate(String dateString, String formatString, boolean lenient) throws IllegalArgumentException { diff --git a/client/src/main/java/com/vaadin/client/DeferredWorker.java b/client/src/main/java/com/vaadin/client/DeferredWorker.java index cc22cda2a2..c0dd1a8dec 100644 --- a/client/src/main/java/com/vaadin/client/DeferredWorker.java +++ b/client/src/main/java/com/vaadin/client/DeferredWorker.java @@ -20,7 +20,7 @@ package com.vaadin.client; * there is work scheduled to be executed in the near future and that the * framework should wait for this work to complete before assuming the UI has * reached a steady state. - * + * * @since 7.3 * @author Vaadin Ltd */ @@ -28,7 +28,7 @@ public interface DeferredWorker { /** * Checks whether there are operations pending for this widget or connector * that must be executed before reaching a steady state. - * + * * @returns <code>true</code> iff there are operations pending which must be * executed before reaching a steady state */ diff --git a/client/src/main/java/com/vaadin/client/DirectionalManagedLayout.java b/client/src/main/java/com/vaadin/client/DirectionalManagedLayout.java index eab9811082..803410f5e0 100644 --- a/client/src/main/java/com/vaadin/client/DirectionalManagedLayout.java +++ b/client/src/main/java/com/vaadin/client/DirectionalManagedLayout.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/EventHelper.java b/client/src/main/java/com/vaadin/client/EventHelper.java index 94fbddf309..978e6d5769 100644 --- a/client/src/main/java/com/vaadin/client/EventHelper.java +++ b/client/src/main/java/com/vaadin/client/EventHelper.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -37,9 +37,9 @@ import com.google.gwt.user.client.ui.Widget; * registration (possibly the same as given, should be store for next update. * <p> * Pseudocode what helpers do: - * + * * <pre> - * + * * if paintable has event listener in UIDL * if registration is null * register paintable as as handler for event @@ -48,8 +48,8 @@ import com.google.gwt.user.client.ui.Widget; * if registration is not null * remove the handler from paintable * return null - * - * + * + * * </pre> */ public class EventHelper { @@ -57,7 +57,7 @@ public class EventHelper { /** * Adds or removes a focus handler depending on if the connector has focus * listeners on the server side or not. - * + * * @param connector * The connector to update. Must implement focusHandler. * @param handlerRegistration @@ -75,7 +75,7 @@ public class EventHelper { /** * Adds or removes a focus handler depending on if the connector has focus * listeners on the server side or not. - * + * * @param connector * The connector to update. Must implement focusHandler. * @param handlerRegistration @@ -96,7 +96,7 @@ public class EventHelper { /** * Adds or removes a blur handler depending on if the connector has blur * listeners on the server side or not. - * + * * @param connector * The connector to update. Must implement BlurHandler. * @param handlerRegistration @@ -114,7 +114,7 @@ public class EventHelper { /** * Adds or removes a blur handler depending on if the connector has blur * listeners on the server side or not. - * + * * @param connector * The connector to update. Must implement BlurHandler. * @param handlerRegistration @@ -122,7 +122,7 @@ public class EventHelper { * registered previously * @param widget * The widget which emits blur events - * + * * @return a new registration handler that can be used to unregister the * handler later */ diff --git a/client/src/main/java/com/vaadin/client/FastStringMap.java b/client/src/main/java/com/vaadin/client/FastStringMap.java index ba3d07025b..c0a6dceb32 100644 --- a/client/src/main/java/com/vaadin/client/FastStringMap.java +++ b/client/src/main/java/com/vaadin/client/FastStringMap.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/FastStringSet.java b/client/src/main/java/com/vaadin/client/FastStringSet.java index 756bd374dc..ee659cf14f 100644 --- a/client/src/main/java/com/vaadin/client/FastStringSet.java +++ b/client/src/main/java/com/vaadin/client/FastStringSet.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/Focusable.java b/client/src/main/java/com/vaadin/client/Focusable.java index 05b32a7b05..129289ccd0 100644 --- a/client/src/main/java/com/vaadin/client/Focusable.java +++ b/client/src/main/java/com/vaadin/client/Focusable.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ package com.vaadin.client; * GWT's HasFocus is way too overkill for just receiving focus in simple * components. Vaadin uses this interface in addition to GWT's HasFocus to pass * focus requests from server to actual ui widgets in browsers. - * + * * So in to make your server side focusable component receive focus on client * side it must either implement this or HasFocus interface. */ diff --git a/client/src/main/java/com/vaadin/client/HasChildMeasurementHintConnector.java b/client/src/main/java/com/vaadin/client/HasChildMeasurementHintConnector.java index 41aea1e57e..2e8a2fd5cd 100644 --- a/client/src/main/java/com/vaadin/client/HasChildMeasurementHintConnector.java +++ b/client/src/main/java/com/vaadin/client/HasChildMeasurementHintConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.vaadin.client.ui.layout.ElementResizeListener; /** * Connector with layout measuring hint. Used to improve granularity of control * over child component measurements. - * + * * @since 7.6 * @author Vaadin Ltd */ @@ -56,7 +56,7 @@ public interface HasChildMeasurementHintConnector /** * Sets the child measurement hint for this component. - * + * * @param hint * the value to set */ @@ -64,7 +64,7 @@ public interface HasChildMeasurementHintConnector /** * Returns the current child measurement hint value. - * + * * @return a ChildLayoutMeasureMode value */ ChildMeasurementHint getChildMeasurementHint(); diff --git a/client/src/main/java/com/vaadin/client/HasComponentsConnector.java b/client/src/main/java/com/vaadin/client/HasComponentsConnector.java index 19b93edd61..f44ccf5431 100644 --- a/client/src/main/java/com/vaadin/client/HasComponentsConnector.java +++ b/client/src/main/java/com/vaadin/client/HasComponentsConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -31,14 +31,14 @@ public interface HasComponentsConnector extends ServerConnector { /** * Update child components caption, description and error message. - * + * * <p> * Each component is responsible for maintaining its caption, description * and error message. In most cases components doesn't want to do that and * those elements reside outside of the component. Because of this layouts * must provide service for it's childen to show those elements for them. * </p> - * + * * @param connector * Child component for which service is requested. */ @@ -53,7 +53,7 @@ public interface HasComponentsConnector extends ServerConnector { * Note that the method {@link ServerConnector#getChildren()} can return a * larger list of children including both the child components and any * extensions registered for the connector. - * + * * @return A collection of child components for this connector. An empty * collection if there are no children. Never returns null. */ @@ -73,7 +73,7 @@ public interface HasComponentsConnector extends ServerConnector { * {@link ServerConnector#setChildren(List)} and contains only child * components. Both methods are called separately by the framework if the * connector implements {@link HasComponentsConnector}. - * + * * @param children * The new child connectors (components only) */ @@ -82,7 +82,7 @@ public interface HasComponentsConnector extends ServerConnector { /** * Adds a handler that is called whenever the child hierarchy of this * connector has been updated by the server. - * + * * @param handler * The handler that should be added. * @return A handler registration reference that can be used to unregister diff --git a/client/src/main/java/com/vaadin/client/JavaScriptConnectorHelper.java b/client/src/main/java/com/vaadin/client/JavaScriptConnectorHelper.java index eee180ad89..b37557cb05 100644 --- a/client/src/main/java/com/vaadin/client/JavaScriptConnectorHelper.java +++ b/client/src/main/java/com/vaadin/client/JavaScriptConnectorHelper.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -83,7 +83,7 @@ public class JavaScriptConnectorHelper { * javascript is usually initalized the first time a state change event is * received, but it might in some cases be necessary to make this happen * earlier. - * + * * @since 7.4.0 */ public void ensureJavascriptInited() { @@ -408,7 +408,7 @@ public class JavaScriptConnectorHelper { delete state[key]; } } - + for(var key in input) { if (input.hasOwnProperty(key)) { state[key] = input[key]; diff --git a/client/src/main/java/com/vaadin/client/JavaScriptExtension.java b/client/src/main/java/com/vaadin/client/JavaScriptExtension.java index 9c60d38a5a..c74715eb18 100644 --- a/client/src/main/java/com/vaadin/client/JavaScriptExtension.java +++ b/client/src/main/java/com/vaadin/client/JavaScriptExtension.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/JsArrayObject.java b/client/src/main/java/com/vaadin/client/JsArrayObject.java index b6dcf3789d..acbc43ac6b 100644 --- a/client/src/main/java/com/vaadin/client/JsArrayObject.java +++ b/client/src/main/java/com/vaadin/client/JsArrayObject.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/LayoutManager.java b/client/src/main/java/com/vaadin/client/LayoutManager.java index 10a77379f1..8938fd81fb 100644 --- a/client/src/main/java/com/vaadin/client/LayoutManager.java +++ b/client/src/main/java/com/vaadin/client/LayoutManager.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -87,7 +87,7 @@ public class LayoutManager { /** * Returns the application connection for this layout manager. - * + * * @return connection */ protected ApplicationConnection getConnection() { @@ -97,7 +97,7 @@ public class LayoutManager { /** * Gets the layout manager associated with the given * {@link ApplicationConnection}. - * + * * @param connection * the application connection to get a layout manager for * @return the layout manager associated with the provided application @@ -112,7 +112,7 @@ public class LayoutManager { * This causes this layout manager to measure the element in the beginning * of every layout phase and call the appropriate layout method of the * managed layout if the size of the element has changed. - * + * * @param owner * the ManagedLayout that depends on an element * @param element @@ -164,7 +164,7 @@ public class LayoutManager { /** * Assigns a measured size to an element. Method defined as protected to * allow separate implementation for IE8. - * + * * @param element * the dom element to attach the measured size to * @param measuredSize @@ -184,7 +184,7 @@ public class LayoutManager { /** * Gets the measured size for an element. Method defined as protected to * allow separate implementation for IE8. - * + * * @param element * The element to get measured size for * @param defaultSize @@ -209,9 +209,9 @@ public class LayoutManager { /** * Registers that a ManagedLayout is no longer depending on the size of an * Element. - * + * * @see #registerDependency(ManagedLayout, Element) - * + * * @param owner * the ManagedLayout no longer depends on an element * @param element @@ -884,7 +884,7 @@ public class LayoutManager { * to explicitly cause some layout to be considered in an ongoing layout * phase, you should use {@link #setNeedsMeasure(ComponentConnector)} * instead. - * + * * @param layout * the managed layout that should be layouted */ @@ -906,7 +906,7 @@ public class LayoutManager { * to explicitly cause some layout to be considered in an ongoing layout * phase, you should use {@link #setNeedsMeasure(ComponentConnector)} * instead. - * + * * @param layout * the managed layout that should be layouted */ @@ -931,7 +931,7 @@ public class LayoutManager { * to explicitly cause some layout to be considered in an ongoing layout * phase, you should use {@link #setNeedsMeasure(ComponentConnector)} * instead. - * + * * @param layout * the managed layout that should be layouted */ @@ -953,13 +953,13 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * -1 is returned if the element has not been measured. If 0 is returned, it * might indicate that the element is not attached to the DOM. * <p> * The value returned by this method is always rounded up. To get the exact * outer width, use {@link #getOuterHeightDouble(Element)} - * + * * @param element * the element to get the measured size for * @return the measured outer height (including margins, paddings and @@ -982,10 +982,10 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * -1 is returned if the element has not been measured. If 0 is returned, it * might indicate that the element is not attached to the DOM. - * + * * @since 7.5.1 * @param element * the element to get the measured size for @@ -1008,13 +1008,13 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * -1 is returned if the element has not been measured. If 0 is returned, it * might indicate that the element is not attached to the DOM. * <p> * The value returned by this method is always rounded up. To get the exact * outer width, use {@link #getOuterWidthDouble(Element)} - * + * * @since 7.5.1 * @param element * the element to get the measured size for @@ -1038,10 +1038,10 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * -1 is returned if the element has not been measured. If 0 is returned, it * might indicate that the element is not attached to the DOM. - * + * * @param element * the element to get the measured size for * @return the measured outer width (including margins, paddings and @@ -1063,13 +1063,13 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * -1 is returned if the element has not been measured. If 0 is returned, it * might indicate that the element is not attached to the DOM. * <p> * The value returned by this method is always rounded up. To get the exact * outer width, use {@link #getInnerHeightDouble(Element)} - * + * * @param element * the element to get the measured size for * @return the measured inner height (excluding margins, paddings and @@ -1092,10 +1092,10 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * -1 is returned if the element has not been measured. If 0 is returned, it * might indicate that the element is not attached to the DOM. - * + * * @since 7.5.1 * @param element * the element to get the measured size for @@ -1118,13 +1118,13 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * -1 is returned if the element has not been measured. If 0 is returned, it * might indicate that the element is not attached to the DOM. * <p> * The value returned by this method is always rounded up. To get the exact * outer width, use {@link #getOuterHeightDouble(Element)} - * + * * @param element * the element to get the measured size for * @return the measured inner width (excluding margins, paddings and @@ -1147,10 +1147,10 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * -1 is returned if the element has not been measured. If 0 is returned, it * might indicate that the element is not attached to the DOM. - * + * * @since 7.5.1 * @param element * the element to get the measured size for @@ -1173,11 +1173,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured border height (top border + bottom border) of the @@ -1199,11 +1199,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured padding height (top padding + bottom padding) of the @@ -1225,11 +1225,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured border width (left border + right border) of the @@ -1250,11 +1250,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured top border of the element in pixels. @@ -1274,11 +1274,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured left border of the element in pixels. @@ -1298,11 +1298,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured bottom border of the element in pixels. @@ -1322,11 +1322,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured right border of the element in pixels. @@ -1347,11 +1347,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured padding width (left padding + right padding) of the @@ -1372,11 +1372,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured top padding of the element in pixels. @@ -1396,11 +1396,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured left padding of the element in pixels. @@ -1420,11 +1420,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured bottom padding of the element in pixels. @@ -1444,11 +1444,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured right padding of the element in pixels. @@ -1468,11 +1468,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured top margin of the element in pixels. @@ -1492,11 +1492,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured right margin of the element in pixels. @@ -1516,11 +1516,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured bottom margin of the element in pixels. @@ -1540,11 +1540,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured size for * @return the measured left margin of the element in pixels. @@ -1564,11 +1564,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured margin for * @return the measured top+bottom margin of the element in pixels. @@ -1586,11 +1586,11 @@ public class LayoutManager { * <li>Elements for which at least one ManagedLayout has registered a * dependency * </ul> - * + * * A negative number is returned if the element has not been measured. If 0 * is returned, it might indicate that the element is not attached to the * DOM. - * + * * @param element * the element to get the measured margin for * @return the measured left+right margin of the element in pixels. @@ -1605,7 +1605,7 @@ public class LayoutManager { * informing the LayoutManager about what size a component will have, the * layout propagation can continue directly without first measuring the * potentially resized elements. - * + * * @param component * the component for which the size is reported * @param outerHeight @@ -1635,7 +1635,7 @@ public class LayoutManager { * LayoutManager about what size a component will have, the layout * propagation can continue directly without first measuring the potentially * resized elements. - * + * * @param component * the relatively sized component for which the size is reported * @param assignedHeight @@ -1659,7 +1659,7 @@ public class LayoutManager { * LayoutManager about what size a component will have, the layout * propagation can continue directly without first measuring the potentially * resized elements. - * + * * @param component * the relatively sized component for which the size is reported * @param assignedWidth @@ -1687,7 +1687,7 @@ public class LayoutManager { * informing the LayoutManager about what size a component will have, the * layout propagation can continue directly without first measuring the * potentially resized elements. - * + * * @param component * the component for which the size is reported * @param outerWidth @@ -1715,7 +1715,7 @@ public class LayoutManager { * element changes. Adding a listener to an element also ensures that all * sizes for that element will be available starting from the next layout * phase. - * + * * @param element * the element that should be checked for size changes * @param listener @@ -1738,7 +1738,7 @@ public class LayoutManager { * Removes an element resize listener from the provided element. This might * cause this LayoutManager to stop tracking the size of the element if no * other sources are interested in the size. - * + * * @param element * the element to which the element resize listener was * previously added @@ -1777,7 +1777,7 @@ public class LayoutManager { * {@link #setNeedsMeasureRecursively(ComponentConnector)} instead. * <p> * If there is no upcoming layout phase, a new layout phase is scheduled. - * + * * @param component * the component whose size might have changed. */ @@ -1800,7 +1800,7 @@ public class LayoutManager { * {@link #setNeedsMeasure(ComponentConnector)} instead. * <p> * If there is no upcoming layout phase, a new layout phase is scheduled. - * + * * @since 7.2 * @param component * the component at the root of the component hierarchy to @@ -1834,7 +1834,7 @@ public class LayoutManager { /** * Checks if there is something waiting for a layout to take place. - * + * * @since 7.5.6 * @return true if there are connectors waiting for measurement or layout, * false otherwise diff --git a/client/src/main/java/com/vaadin/client/LayoutManagerIE8.java b/client/src/main/java/com/vaadin/client/LayoutManagerIE8.java index 479155d0e6..603ac03337 100644 --- a/client/src/main/java/com/vaadin/client/LayoutManagerIE8.java +++ b/client/src/main/java/com/vaadin/client/LayoutManagerIE8.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -29,10 +29,10 @@ import com.google.gwt.user.client.ui.RootPanel; * element in IE8 seems to make the browser think the element has changed in a * way that requires a reflow. To work around that, the MeasureData is instead * stored in Map for IE8. - * + * * This implementation is injected for IE8 by a replace-with definition in the * GWT module. - * + * * @author Vaadin Ltd * @since 7.0.0 */ diff --git a/client/src/main/java/com/vaadin/client/LocaleNotLoadedException.java b/client/src/main/java/com/vaadin/client/LocaleNotLoadedException.java index 6f59e786e4..6d2cbf28ae 100644 --- a/client/src/main/java/com/vaadin/client/LocaleNotLoadedException.java +++ b/client/src/main/java/com/vaadin/client/LocaleNotLoadedException.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/LocaleService.java b/client/src/main/java/com/vaadin/client/LocaleService.java index dcd1c9ea4e..490101285b 100644 --- a/client/src/main/java/com/vaadin/client/LocaleService.java +++ b/client/src/main/java/com/vaadin/client/LocaleService.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -27,9 +27,9 @@ import com.vaadin.shared.ui.ui.UIState.LocaleData; /** * Date / time etc. localisation service for all widgets. Caches all loaded * locales as JSONObjects. - * + * * @author Vaadin Ltd. - * + * */ public class LocaleService { diff --git a/client/src/main/java/com/vaadin/client/MeasuredSize.java b/client/src/main/java/com/vaadin/client/MeasuredSize.java index f358517afa..7f95d1826a 100644 --- a/client/src/main/java/com/vaadin/client/MeasuredSize.java +++ b/client/src/main/java/com/vaadin/client/MeasuredSize.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/MouseEventDetailsBuilder.java b/client/src/main/java/com/vaadin/client/MouseEventDetailsBuilder.java index 11ebe3925c..62b96ee712 100644 --- a/client/src/main/java/com/vaadin/client/MouseEventDetailsBuilder.java +++ b/client/src/main/java/com/vaadin/client/MouseEventDetailsBuilder.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,16 +24,16 @@ import com.vaadin.shared.MouseEventDetails.MouseButton; /** * Helper class for constructing a MouseEventDetails object from a * {@link NativeEvent}. - * + * * @author Vaadin Ltd * @since 7.0.0 - * + * */ public class MouseEventDetailsBuilder { /** * Construct a {@link MouseEventDetails} object from the given event - * + * * @param evt * The event to use as a source for the details * @return a MouseEventDetails containing information from the event @@ -44,7 +44,7 @@ public class MouseEventDetailsBuilder { /** * Construct a {@link MouseEventDetails} object from the given event - * + * * @param evt * The event to use as a source for the details * @param relativeToElement diff --git a/client/src/main/java/com/vaadin/client/Paintable.java b/client/src/main/java/com/vaadin/client/Paintable.java index 34f2d0714f..1e3ca24dca 100644 --- a/client/src/main/java/com/vaadin/client/Paintable.java +++ b/client/src/main/java/com/vaadin/client/Paintable.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ package com.vaadin.client; * An interface used by client-side widgets or paintable parts to receive * updates from the corresponding server-side components in the form of * {@link UIDL}. - * + * * Updates can be sent back to the server using the * {@link ApplicationConnection#updateVariable()} methods. */ diff --git a/client/src/main/java/com/vaadin/client/Profiler.java b/client/src/main/java/com/vaadin/client/Profiler.java index 3d48d1c616..b5123bbaa7 100644 --- a/client/src/main/java/com/vaadin/client/Profiler.java +++ b/client/src/main/java/com/vaadin/client/Profiler.java @@ -69,7 +69,7 @@ public class Profiler { * Interface for getting data from the {@link Profiler}. * <p> * <b>Warning!</b> This interface is most likely to change in the future - * + * * @since 7.1 * @author Vaadin Ltd */ @@ -98,7 +98,7 @@ public class Profiler { /** * Create a new node with the given name. - * + * * @param name */ public Node(String name) { @@ -107,7 +107,7 @@ public class Profiler { /** * Gets the name of the node - * + * * @return the name of the node */ public String getName() { @@ -117,7 +117,7 @@ public class Profiler { /** * Creates a new child node or retrieves and existing child and updates * its total time and hit count. - * + * * @param name * the name of the child * @param timestamp @@ -138,7 +138,7 @@ public class Profiler { /** * Gets the total time spent in this node, including time spent in sub * nodes - * + * * @return the total time spent, in milliseconds */ public double getTimeSpent() { @@ -148,7 +148,7 @@ public class Profiler { /** * Gets the minimum time spent for one invocation of this node, * including time spent in sub nodes - * + * * @return the time spent for the fastest invocation, in milliseconds */ public double getMinTimeSpent() { @@ -158,7 +158,7 @@ public class Profiler { /** * Gets the maximum time spent for one invocation of this node, * including time spent in sub nodes - * + * * @return the time spent for the slowest invocation, in milliseconds */ public double getMaxTimeSpent() { @@ -167,7 +167,7 @@ public class Profiler { /** * Gets the number of times this node has been entered - * + * * @return the number of times the node has been entered */ public int getCount() { @@ -177,7 +177,7 @@ public class Profiler { /** * Gets the total time spent in this node, excluding time spent in sub * nodes - * + * * @return the total time spent, in milliseconds */ public double getOwnTime() { @@ -190,7 +190,7 @@ public class Profiler { /** * Gets the child nodes of this node - * + * * @return a collection of child nodes */ public Collection<Node> getChildren() { @@ -389,7 +389,7 @@ public class Profiler { * Returns time relative to the particular page load time. The value should * not be used directly but rather difference between two values returned by * this method should be used to compare measurements. - * + * * @since 7.6 */ public static double getRelativeTimeMillis() { diff --git a/client/src/main/java/com/vaadin/client/RenderInformation.java b/client/src/main/java/com/vaadin/client/RenderInformation.java index 8fd3fc7e0b..dbc08dc8d2 100644 --- a/client/src/main/java/com/vaadin/client/RenderInformation.java +++ b/client/src/main/java/com/vaadin/client/RenderInformation.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,9 +20,9 @@ import com.google.gwt.user.client.DOM; /** * Contains size information about a rendered container and its content area. - * + * * @author Artur Signell - * + * */ public class RenderInformation { @@ -48,9 +48,9 @@ public class RenderInformation { /** * Update the size of the widget. - * + * * @param widget - * + * * @return true if the size has changed since last update * @deprecated As of 7.2, call and override {@link #updateSize(Element)} * instead @@ -69,11 +69,11 @@ public class RenderInformation { /** * Update the size of the widget. - * + * * @param widget - * + * * @return true if the size has changed since last update - * + * * @since 7.2 */ public boolean updateSize(Element element) { diff --git a/client/src/main/java/com/vaadin/client/RenderSpace.java b/client/src/main/java/com/vaadin/client/RenderSpace.java index dff774aa6f..cceb9102ab 100644 --- a/client/src/main/java/com/vaadin/client/RenderSpace.java +++ b/client/src/main/java/com/vaadin/client/RenderSpace.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ResourceLoader.java b/client/src/main/java/com/vaadin/client/ResourceLoader.java index b7c845c292..6bf0e7a4e8 100644 --- a/client/src/main/java/com/vaadin/client/ResourceLoader.java +++ b/client/src/main/java/com/vaadin/client/ResourceLoader.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -37,11 +37,11 @@ import com.google.gwt.user.client.Timer; /** * ResourceLoader lets you dynamically include external scripts and styles on * the page and lets you know when the resource has been loaded. - * + * * You can also preload resources, allowing them to get cached by the browser * without being evaluated. This enables downloading multiple resources at once * while still controlling in which order e.g. scripts are executed. - * + * * @author Vaadin Ltd * @since 7.0.0 */ @@ -56,7 +56,7 @@ public class ResourceLoader { /** * Creates a new event. - * + * * @param loader * the resource loader that has loaded the resource * @param resourceUrl @@ -74,7 +74,7 @@ public class ResourceLoader { /** * Gets the resource loader that has fired this event - * + * * @return the resource loader */ public ResourceLoader getResourceLoader() { @@ -83,7 +83,7 @@ public class ResourceLoader { /** * Gets the absolute url of the loaded resource. - * + * * @return the absolute url of the loaded resource */ public String getResourceUrl() { @@ -93,9 +93,9 @@ public class ResourceLoader { /** * Returns true if the resource has been preloaded, false if it's fully * loaded - * + * * @see ResourceLoader#preloadResource(String, ResourceLoadListener) - * + * * @return true if the resource has been preloaded, false if it's fully * loaded */ @@ -112,9 +112,9 @@ public class ResourceLoader { * Notifies this ResourceLoadListener that a resource has been loaded. * Some browsers do not support any way of detecting load errors. In * these cases, onLoad will be called regardless of the status. - * + * * @see ResourceLoadEvent - * + * * @param event * a resource load event with information about the loaded * resource @@ -127,9 +127,9 @@ public class ResourceLoader { * server did not respond. Some browsers do not support any way of * detecting load errors. In these cases, onLoad will be called * regardless of the status. - * + * * @see ResourceLoadEvent - * + * * @param event * a resource load event with information about the resource * that could not be loaded. @@ -183,7 +183,7 @@ public class ResourceLoader { /** * Returns the default ResourceLoader - * + * * @return the default ResourceLoader */ public static ResourceLoader get() { @@ -195,8 +195,8 @@ public class ResourceLoader { * this method when the script is currently loading or already loaded * doesn't cause the script to be loaded again, but the listener will still * be notified when appropriate. - * - * + * + * * @param scriptUrl * the url of the script to load * @param resourceLoadListener @@ -213,8 +213,8 @@ public class ResourceLoader { * this method when the script is currently loading or already loaded * doesn't cause the script to be loaded again, but the listener will still * be notified when appropriate. - * - * + * + * * @param scriptUrl * url of script to load * @param resourceLoadListener @@ -278,7 +278,7 @@ public class ResourceLoader { /** * The current browser supports script.async='false' for maintaining * execution order for dynamically-added scripts. - * + * * @return Browser supports script.async='false' * @since 7.2.4 */ @@ -292,12 +292,12 @@ public class ResourceLoader { * preloaded, it will be present in the browser's cache (provided the HTTP * headers allow caching), making a subsequent load operation complete * without having to wait for the resource to be downloaded again. - * + * * Calling this method when the resource is currently loading, currently * preloading, already preloaded or already loaded doesn't cause the * resource to be preloaded again, but the listener will still be notified * when appropriate. - * + * * @param url * the url of the resource to preload * @param resourceLoadListener @@ -378,7 +378,7 @@ public class ResourceLoader { * Adds an onload listener to the given element, which should be a link or a * script tag. The listener is called whenever loading is complete or an * error occurred. - * + * * @since 7.3 * @param element * the element to attach a listener to @@ -414,7 +414,7 @@ public class ResourceLoader { * Calling this method when the stylesheet is currently loading or already * loaded doesn't cause the stylesheet to be loaded again, but the listener * will still be notified when appropriate. - * + * * @param stylesheetUrl * the url of the stylesheet to load * @param resourceLoadListener @@ -533,12 +533,12 @@ public class ResourceLoader { if (rules === undefined) { rules = sheet.rules; } - + if (rules === null) { // Style sheet loaded, but can't access length because of XSS -> assume there's something there return 1; } - + // Return length so we can distinguish 0 (probably 404 error) from normal case. return rules.length; } catch (err) { diff --git a/client/src/main/java/com/vaadin/client/ServerConnector.java b/client/src/main/java/com/vaadin/client/ServerConnector.java index 795474bfcd..29994961d5 100644 --- a/client/src/main/java/com/vaadin/client/ServerConnector.java +++ b/client/src/main/java/com/vaadin/client/ServerConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -29,7 +29,7 @@ import com.vaadin.shared.communication.SharedState; * Interface implemented by all client side classes that can be communicate with * the server. Classes implementing this interface are initialized by the * framework when needed and have the ability to communicate with the server. - * + * * @author Vaadin Ltd * @since 7.0.0 */ @@ -37,7 +37,7 @@ public interface ServerConnector extends Connector { /** * Gets ApplicationConnection instance that created this connector. - * + * * @return The ApplicationConnection as set by * {@link #doInit(String, ApplicationConnection)} */ @@ -47,13 +47,13 @@ public interface ServerConnector extends Connector { * Tests whether the connector is enabled or not. This method checks that * the connector is enabled in context, i.e. if the parent connector is * disabled, this method must return false. - * + * * @return true if the connector is enabled, false otherwise */ public boolean isEnabled(); /** - * + * * Called once by the framework to initialize the connector. * <p> * Note that the shared state is not yet available at this point nor any @@ -64,9 +64,9 @@ public interface ServerConnector extends Connector { /** * For internal use by the framework: returns the registered RPC * implementations for an RPC interface identifier. - * + * * TODO interface identifier type or format may change - * + * * @param rpcInterfaceId * RPC interface identifier: fully qualified interface type name * @return RPC interface implementations registered for an RPC interface, @@ -78,7 +78,7 @@ public interface ServerConnector extends Connector { /** * Adds a handler that is called whenever any part of the state has been * updated by the server. - * + * * @param handler * The handler that should be added. * @return A handler registration reference that can be used to unregister @@ -90,7 +90,7 @@ public interface ServerConnector extends Connector { /** * Removes a handler that is called whenever any part of the state has been * updated by the server. - * + * * @param handler * The handler that should be removed. */ @@ -99,7 +99,7 @@ public interface ServerConnector extends Connector { /** * Adds a handler that is called whenever the given part of the state has * been updated by the server. - * + * * @param propertyName * the name of the property for which the handler should be * called @@ -114,7 +114,7 @@ public interface ServerConnector extends Connector { /** * Removes a handler that is called whenever any part of the state has been * updated by the server. - * + * * @param propertyName * the name of the property for which the handler should be * called @@ -126,7 +126,7 @@ public interface ServerConnector extends Connector { /** * Sends the given event to all registered handlers. - * + * * @param event * The event to send. */ @@ -140,7 +140,7 @@ public interface ServerConnector extends Connector { /** * Returns the parent of this connector. Can be null for only the root * connector. - * + * * @return The parent of this connector, as set by * {@link #setParent(ServerConnector)}. */ @@ -155,7 +155,7 @@ public interface ServerConnector extends Connector { * Note that calling this method does not fire a * {@link ConnectorHierarchyChangeEvent}. The event is fired only when the * whole hierarchy has been updated. - * + * * @param parent * The new parent of the connector */ @@ -172,7 +172,7 @@ public interface ServerConnector extends Connector { * {@link HasComponentsConnector#setChildComponents(List)} and takes both * extensions and child components. Both methods are called separately by * the framework if the connector can have child components. - * + * * @param children * The new child connectors (extensions and/or components) */ @@ -185,7 +185,7 @@ public interface ServerConnector extends Connector { * Note that the method {@link HasComponentsConnector#getChildComponents()} * can be used to obtain the subset of child connectors that correspond to * components and not extensions. - * + * * @return A collection of child connectors (components or extensions) for * this connector. An empty collection if there are no children. * Never returns null. @@ -194,12 +194,12 @@ public interface ServerConnector extends Connector { /** * Gets the current shared state of the connector. - * + * * Note that state is considered an internal part of the connector. You * should not rely on the state object outside of the connector who owns it. * If you depend on the state of other connectors you should use their * public API instead of their state object directly. - * + * * @since 7.0. * @return state The shared state object. Can be any sub type of * {@link SharedState}. Never null. @@ -209,7 +209,7 @@ public interface ServerConnector extends Connector { /** * Checks if an event listener has been registered on the server side for * the given event identifier. - * + * * @param eventIdentifier * The identifier for the event * @return true if a listener has been registered on the server side, false diff --git a/client/src/main/java/com/vaadin/client/SimpleTree.java b/client/src/main/java/com/vaadin/client/SimpleTree.java index cd7d73683c..76d8cc6cdb 100644 --- a/client/src/main/java/com/vaadin/client/SimpleTree.java +++ b/client/src/main/java/com/vaadin/client/SimpleTree.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -38,7 +38,7 @@ import com.google.gwt.user.client.ui.Widget; /** * @author Vaadin Ltd - * + * * @deprecated as of 7.1. This class was mainly used by the old debug console * but is retained for now for backwards compatibility. */ @@ -147,7 +147,7 @@ public class SimpleTree extends ComplexPanel implements HasDoubleClickHandlers { /** * {@inheritDoc} - * + * * @deprecated As of 7.2, call and override {@link #add(Widget, Element)} * instead. */ @@ -162,7 +162,7 @@ public class SimpleTree extends ComplexPanel implements HasDoubleClickHandlers { /** * {@inheritDoc} - * + * * @since 7.2 */ @Override diff --git a/client/src/main/java/com/vaadin/client/StyleConstants.java b/client/src/main/java/com/vaadin/client/StyleConstants.java index fad88f1359..fe04fc7c46 100644 --- a/client/src/main/java/com/vaadin/client/StyleConstants.java +++ b/client/src/main/java/com/vaadin/client/StyleConstants.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/SuperDevMode.java b/client/src/main/java/com/vaadin/client/SuperDevMode.java index cc7e107555..e6f9295c3c 100644 --- a/client/src/main/java/com/vaadin/client/SuperDevMode.java +++ b/client/src/main/java/com/vaadin/client/SuperDevMode.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -30,10 +30,10 @@ import com.vaadin.client.ui.VNotification.HideEvent; /** * Class that enables SuperDevMode using a ?superdevmode parameter in the url. - * + * * @author Vaadin Ltd * @since 7.0 - * + * */ public class SuperDevMode { @@ -125,13 +125,13 @@ public class SuperDevMode { private native static String getRecompileParameters(String moduleName) /*-{ var prop_map = $wnd.__gwt_activeModules[moduleName].bindings(); - + // convert map to URL parameter string var props = []; for (var key in prop_map) { props.push(encodeURIComponent(key) + '=' + encodeURIComponent(prop_map[key])) } - + return props.join('&') + '&'; }-*/; @@ -177,7 +177,7 @@ public class SuperDevMode { /** * The URL of the code server. The default URL (http://localhost:9876/) will * be used if this is empty or null. - * + * * @param serverUrl * The url of the code server or null to use the default * @return true if recompile started, false if we are running in @@ -225,12 +225,12 @@ public class SuperDevMode { var mod = $wnd.__gwt_activeModules[moduleName]; if (!mod) return false; - + if (mod.superdevmode) { // Running in super dev mode already, it is supported return true; } - + return !!mod.canRedirect; }-*/; @@ -241,7 +241,7 @@ public class SuperDevMode { * method returns true. The application will be restarted once compilation * is done and then this method will return false. * </p> - * + * * @return true if a recompile operation has started and the page will be * reloaded once it is done, false if no recompilation will be done. */ diff --git a/client/src/main/java/com/vaadin/client/TooltipInfo.java b/client/src/main/java/com/vaadin/client/TooltipInfo.java index 970f155af5..6e3e063be2 100644 --- a/client/src/main/java/com/vaadin/client/TooltipInfo.java +++ b/client/src/main/java/com/vaadin/client/TooltipInfo.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -71,7 +71,7 @@ public class TooltipInfo { /** * Checks is a message has been defined for the tooltip. - * + * * @return true if title or error message is present, false if both are * empty */ diff --git a/client/src/main/java/com/vaadin/client/UIDL.java b/client/src/main/java/com/vaadin/client/UIDL.java index 1b9ee9ffce..4b1bd3c401 100644 --- a/client/src/main/java/com/vaadin/client/UIDL.java +++ b/client/src/main/java/com/vaadin/client/UIDL.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -52,7 +52,7 @@ public final class UIDL extends JavaScriptObject { * Shorthand for getting the attribute named "id", which for Paintables is * the essential paintableId which binds the server side component to the * client side widget. - * + * * @return the value of the id attribute, if available */ public String getId() { @@ -69,7 +69,7 @@ public final class UIDL extends JavaScriptObject { * internally and is not needed within * {@link ComponentConnector#updateFromUIDL(UIDL, ApplicationConnection) * updateFromUIDL()}. - * + * * @return the name for this section */ public native String getTag() @@ -94,7 +94,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the named attribute as a String. - * + * * @param name * the name of the attribute to get * @return the attribute value @@ -105,7 +105,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the names of the attributes available. - * + * * @return the names of available attributes */ public Set<String> getAttributeNames() { @@ -116,7 +116,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the names of variables available. - * + * * @return the names of available variables */ public Set<String> getVariableNames() { @@ -130,7 +130,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the named attribute as an int. - * + * * @param name * the name of the attribute to get * @return the attribute value @@ -141,7 +141,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the named attribute as a long. - * + * * @param name * the name of the attribute to get * @return the attribute value @@ -152,7 +152,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the named attribute as a float. - * + * * @param name * the name of the attribute to get * @return the attribute value @@ -163,7 +163,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the named attribute as a double. - * + * * @param name * the name of the attribute to get * @return the attribute value @@ -174,7 +174,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the named attribute as a boolean. - * + * * @param name * the name of the attribute to get * @return the attribute value @@ -185,7 +185,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the named attribute as a Map of named values (key/value pairs). - * + * * @param name * the name of the attribute to get * @return the attribute Map @@ -196,7 +196,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the named attribute as an array of Strings. - * + * * @param name * the name of the attribute to get * @return the attribute value @@ -207,7 +207,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the named attribute as an int array. - * + * * @param name * the name of the attribute to get * @return the attribute value @@ -218,7 +218,7 @@ public final class UIDL extends JavaScriptObject { /** * Get attributes value as string whatever the type is - * + * * @param name * @return string presentation of attribute */ @@ -234,7 +234,7 @@ public final class UIDL extends JavaScriptObject { /** * Indicates whether or not the named attribute is available. - * + * * @param name * the name of the attribute to check * @return true if the attribute is available, false otherwise @@ -245,7 +245,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the UIDL for the child at the given index. - * + * * @param i * the index of the child to get * @return the UIDL of the child if it exists @@ -257,7 +257,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the child at the given index as a String. - * + * * @param i * the index of the child to get * @return the String representation of the child if it exists @@ -286,7 +286,7 @@ public final class UIDL extends JavaScriptObject { * if <code>getTag()</code> returns "color", one would update the widgets * color to reflect the value of the "color" section. * </p> - * + * * @return an iterator for iterating over UIDL children */ public Iterator<Object> getChildIterator() { @@ -359,7 +359,7 @@ public final class UIDL extends JavaScriptObject { /** * Checks if the named variable is available. - * + * * @param name * the name of the variable desired * @return true if the variable exists, false otherwise @@ -370,7 +370,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the value of the named variable. - * + * * @param name * the name of the variable * @return the value of the variable @@ -381,7 +381,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the value of the named variable. - * + * * @param name * the name of the variable * @return the value of the variable @@ -392,7 +392,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the value of the named variable. - * + * * @param name * the name of the variable * @return the value of the variable @@ -403,7 +403,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the value of the named variable. - * + * * @param name * the name of the variable * @return the value of the variable @@ -414,7 +414,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the value of the named variable. - * + * * @param name * the name of the variable * @return the value of the variable @@ -425,7 +425,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the value of the named variable. - * + * * @param name * the name of the variable * @return the value of the variable @@ -436,7 +436,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the value of the named variable. - * + * * @param name * the name of the variable * @return the value of the variable @@ -447,7 +447,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the value of the named String[] variable as a Set of Strings. - * + * * @param name * the name of the variable * @return the value of the variable @@ -463,7 +463,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the value of the named variable. - * + * * @param name * the name of the variable * @return the value of the variable @@ -499,7 +499,7 @@ public final class UIDL extends JavaScriptObject { /** * Returns the number of children. - * + * * @return the number of children */ public native int getChildCount() @@ -514,7 +514,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the Paintable with the id found in the named attributes's value. - * + * * @param name * the name of the attribute * @return the Paintable referenced by the attribute, if it exists @@ -527,7 +527,7 @@ public final class UIDL extends JavaScriptObject { /** * Gets the Paintable with the id found in the named variable's value. - * + * * @param name * the name of the variable * @return the Paintable referenced by the variable, if it exists @@ -541,7 +541,7 @@ public final class UIDL extends JavaScriptObject { /** * Returns the child UIDL by its name. If several child nodes exist with the * given name, the first child UIDL will be returned. - * + * * @param tagName * @return the child UIDL or null if child wit given name was not found */ diff --git a/client/src/main/java/com/vaadin/client/Util.java b/client/src/main/java/com/vaadin/client/Util.java index b53dbd071b..6eb529f6d8 100644 --- a/client/src/main/java/com/vaadin/client/Util.java +++ b/client/src/main/java/com/vaadin/client/Util.java @@ -52,9 +52,9 @@ public class Util { /** * Helper method for debugging purposes. - * + * * Stops execution on firefox browsers on a breakpoint. - * + * * @deprecated As of 7.4.0, use {@link WidgetUtil#browserDebugger()} * instead. */ @@ -67,10 +67,10 @@ public class Util { * Helper method for a bug fix #14041. For mozilla getKeyCode return 0 for * space bar (because space is considered as char). If return 0 use * getCharCode. - * + * * @deprecated As of 7.4.0, use {@link WidgetUtil#getKeyCode(KeyEvent)} * instead. - * + * * @param event * @return return key code * @since 7.2.4 @@ -81,15 +81,15 @@ public class Util { } /** - * + * * Returns the topmost element of from given coordinates. - * + * * TODO fix crossplat issues clientX vs pageX. See quircksmode. Not critical * for vaadin as we scroll div istead of page. - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#getElementFromPoint(int, int)} instead. - * + * * @param x * @param y * @return the element at given coordinates @@ -104,18 +104,18 @@ public class Util { * This helper method can be called if components size have been changed * outside rendering phase. It notifies components parent about the size * change so it can react. - * + * * When using this method, developer should consider if size changes could * be notified lazily. If lazy flag is true, method will save widget and * wait for a moment until it notifies parents in chunks. This may vastly * optimize layout in various situation. Example: if component have a lot of * images their onload events may fire "layout phase" many times in a short * period. - * + * * @param widget * @param lazy * run componentSizeUpdated lazyly - * + * * @deprecated As of 7.0, use * {@link LayoutManager#setNeedsMeasure(ComponentConnector)} * instead @@ -159,10 +159,10 @@ public class Util { /** * Converts html entities to text. - * + * * @deprecated As of 7.4.0, use {@link WidgetUtil#escapeHTML(String)} * instead. - * + * * @param html * @return escaped string presentation of given html */ @@ -173,10 +173,10 @@ public class Util { /** * Escapes the string so it is safe to write inside an HTML attribute. - * + * * @deprecated As of 7.4.0, use {@link WidgetUtil#escapeAttribute(String)} * instead. - * + * * @param attribute * The string to escape * @return An escaped version of <literal>attribute</literal>. @@ -188,12 +188,12 @@ public class Util { /** * Clones given element as in JavaScript. - * + * * Deprecate this if there appears similar method into GWT someday. - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#cloneNode(Element, boolean)} instead. - * + * * @param element * @param deep * clone child tree also @@ -341,11 +341,11 @@ public class Util { /** * Defers the execution of {@link #runWebkitOverflowAutoFix(Element)} - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#runWebkitOverflowAutoFixDeferred(Element)} * instead. - * + * * @since 7.2.6 * @param elem * with overflow auto @@ -357,12 +357,12 @@ public class Util { /** * Run workaround for webkits overflow auto issue. - * + * * See: our bug #2138 and https://bugs.webkit.org/show_bug.cgi?id=21462 - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#runWebkitOverflowAutoFix(Element)} instead. - * + * * @param elem * with overflow auto */ @@ -376,7 +376,7 @@ public class Util { * dimension is not specified as relative it will return -1. If the shared * state does not contain width or height specifications this will return * null. - * + * * @param state * @return */ @@ -411,7 +411,7 @@ public class Util { * Checks if a and b are equals using {@link #equals(Object)}. Handles null * values as well. Does not ensure that objects are of the same type. * Assumes that the first object's equals method handle equals properly. - * + * * @param a * The first value to compare * @param b @@ -432,10 +432,10 @@ public class Util { /** * Gets the border-box width for the given element, i.e. element width + * border + padding. Always rounds up to nearest integer. - * + * * @deprecated As of 7.4.0, use {@link WidgetUtil#getRequiredWidth(Element)} * instead. - * + * * @param element * The element to check * @return The border-box width for the element @@ -449,10 +449,10 @@ public class Util { /** * Gets the border-box height for the given element, i.e. element height + * border + padding. Always rounds up to nearest integer. - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#getRequiredHeight(Element)} instead. - * + * * @param element * The element to check * @return The border-box height for the element @@ -527,10 +527,10 @@ public class Util { /** * Detects what is currently the overflow style attribute in given element. - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#mayHaveScrollBars(Element)} instead. - * + * * @param pe * the element to detect * @return true if auto or scroll @@ -547,9 +547,9 @@ public class Util { * also returned if "element" is part of its caption. If * <literal>element</literal> is not part of any child component, null is * returned. - * + * * This method returns the deepest nested VPaintableWidget. - * + * * @param client * A reference to ApplicationConnection * @param parent @@ -608,9 +608,9 @@ public class Util { /** * Will (attempt) to focus the given DOM Element. - * + * * @deprecated As of 7.4.0, use {@link WidgetUtil#focus(Element)} instead. - * + * * @param el * the element to focus */ @@ -622,7 +622,7 @@ public class Util { /** * Helper method to find the nearest parent paintable instance by traversing * the DOM upwards from given element. - * + * * @param element * the element to start from */ @@ -640,10 +640,10 @@ public class Util { /** * Helper method to find first instance of given Widget type found by * traversing DOM upwards from given element. - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#findWidget(Element, Class)} instead. - * + * * @param element * the element where to start seeking of Widget * @param class1 @@ -657,10 +657,10 @@ public class Util { /** * Force webkit to redraw an element - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#forceWebkitRedraw(Element)} instead. - * + * * @param element * The element that should be redrawn */ @@ -673,10 +673,10 @@ public class Util { * Performs a hack to trigger a re-layout in the IE8. This is usually * necessary in cases where IE8 "forgets" to update child elements when they * resize. - * + * * @deprecated As of 7.4.0, use {@link WidgetUtil#forceIE8Redraw(Element)} * instead. - * + * * @param e * The element to perform the hack on */ @@ -689,10 +689,10 @@ public class Util { * Performs a hack to trigger a re-layout in the IE browser. This is usually * necessary in cases where IE "forgets" to update child elements when they * resize. - * + * * @deprecated As of 7.4.0, use {@link WidgetUtil#forceIERedraw(Element)} * instead. - * + * * @since 7.3 * @param e * The element to perform the hack on @@ -705,12 +705,12 @@ public class Util { /** * Detaches and re-attaches the element from its parent. The element is * reattached at the same position in the DOM as it was before. - * + * * Does nothing if the element is not attached to the DOM. - * + * * @deprecated As of 7.4.0, use {@link WidgetUtil#detachAttach(Element)} * instead. - * + * * @param element * The element to detach and re-attach */ @@ -730,10 +730,10 @@ public class Util { /** * Returns the index of the childElement within its parent. - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#getChildElementIndex(Element)} instead. - * + * * @param subElement * @return */ @@ -760,7 +760,7 @@ public class Util { /** * Produces a string representation of a method invocation, suitable for * debug output - * + * * @since 7.5 * @param invocation * @return @@ -819,11 +819,11 @@ public class Util { * Temporarily sets the {@code styleProperty} to {@code tempValue} and then * resets it to its current value. Used mainly to work around rendering * issues in IE (and possibly in other browsers) - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#setStyleTemporarily(Element, String, String)} * instead. - * + * * @param element * The target element * @param styleProperty @@ -841,10 +841,10 @@ public class Util { * A helper method to return the client position from an event. Returns * position from either first changed touch (if touch event) or from the * event itself. - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#getTouchOrMouseClientX(Event)} instead. - * + * * @param event * @return */ @@ -857,10 +857,10 @@ public class Util { * Find the element corresponding to the coordinates in the passed mouse * event. Please note that this is not always the same as the target of the * event e.g. if event capture is used. - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#getElementUnderMouse(NativeEvent)} instead. - * + * * @param event * the mouse event to get coordinates from * @return the element at the coordinates of the event @@ -875,10 +875,10 @@ public class Util { * A helper method to return the client position from an event. Returns * position from either first changed touch (if touch event) or from the * event itself. - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#getTouchOrMouseClientY(Event)} instead. - * + * * @param event * @return */ @@ -891,7 +891,7 @@ public class Util { * @deprecated As of 7.4.0, use * {@link WidgetUtil#getTouchOrMouseClientY(NativeEvent)} * instead. - * + * * @see #getTouchOrMouseClientY(Event) * @param currentGwtEvent * @return @@ -905,9 +905,9 @@ public class Util { * @deprecated As of 7.4.0, use * {@link WidgetUtil#getTouchOrMouseClientX(NativeEvent)} * instead. - * + * * @see #getTouchOrMouseClientX(Event) - * + * * @param event * @return */ @@ -947,10 +947,10 @@ public class Util { /** * Gets the currently focused element. - * + * * @deprecated As of 7.4.0, use {@link WidgetUtil#getFocusedElement()} * instead. - * + * * @return The active element or null if no active element could be found. */ @Deprecated @@ -960,7 +960,7 @@ public class Util { /** * Gets the currently focused element for Internet Explorer. - * + * * @return The currently focused element * @deprecated Use #getFocusedElement instead */ @@ -971,12 +971,12 @@ public class Util { /** * Gets currently focused element and checks if it's editable - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#isFocusedElementEditable()} instead. - * + * * @since 7.4 - * + * * @return true if focused element is editable */ @Deprecated @@ -989,10 +989,10 @@ public class Util { * this method checks that this widget nor any of its parents is hidden. Can * be e.g used to check whether component should react to some events or * not. - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#isAttachedAndDisplayed(Widget)} instead. - * + * * @param widget * @return true if attached and displayed */ @@ -1004,10 +1004,10 @@ public class Util { /** * Scrolls an element into view vertically only. Modified version of * Element.scrollIntoView. - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#scrollIntoViewVertically(Element)} instead. - * + * * @param elem * The element to scroll into view */ @@ -1019,11 +1019,11 @@ public class Util { /** * Checks if the given event is either a touch event or caused by the left * mouse button - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#isTouchEventOrLeftMouseButton(Event)} * instead. - * + * * @param event * @return true if the event is a touch event or caused by the left mouse * button, false otherwise @@ -1035,7 +1035,7 @@ public class Util { /** * Performs a shallow comparison of the collections. - * + * * @param collection1 * The first collection * @param collection2 @@ -1080,10 +1080,10 @@ public class Util { /** * Resolve a relative URL to an absolute URL based on the current document's * location. - * + * * @deprecated As of 7.4.0, use {@link WidgetUtil#getAbsoluteUrl(String)} * instead. - * + * * @param url * a string with the relative URL to resolve * @return the corresponding absolute URL as a string @@ -1095,16 +1095,16 @@ public class Util { /** * Sets the selection range of an input element. - * + * * We need this JSNI function to set selection range so that we can use the * optional direction attribute to set the anchor to the end and the focus * to the start. This makes Firefox work the same way as other browsers * (#13477) - * + * * @deprecated As of 7.4.0, use * {@link WidgetUtil#setSelectionRange(Element, int, int, String)} * instead. - * + * * @param elem * the html input element. * @param pos @@ -1115,7 +1115,7 @@ public class Util { * a string indicating the direction in which the selection was * performed. This may be "forward" or "backward", or "none" if * the direction is unknown or irrelevant. - * + * * @since 7.3 */ @Deprecated @@ -1128,7 +1128,7 @@ public class Util { * Converts a native {@link JavaScriptObject} into a {@link JsonValue}. This * is a no-op in GWT code compiled to javascript, but needs some special * handling to work when run in JVM. - * + * * @param jso * the java script object to represent as json * @return the json representation @@ -1145,7 +1145,7 @@ public class Util { * Converts a {@link JsonValue} into a native {@link JavaScriptObject}. This * is a no-op in GWT code compiled to javascript, but needs some special * handling to work when run in JVM. - * + * * @param jsonValue * the json value * @return a native javascript object representation of the json value @@ -1160,7 +1160,7 @@ public class Util { /** * Convert a {@link JavaScriptObject} into a string representation. - * + * * @param json * a JavaScript object to be converted to a string * @return JSON in string representation @@ -1172,7 +1172,7 @@ public class Util { /** * Parse a string containing JSON into a {@link JavaScriptObject}. - * + * * @param <T> * the overlay type to expect from the parse * @param jsonAsString @@ -1186,7 +1186,7 @@ public class Util { /** * Round {@code num} up to {@code exp} decimal positions. - * + * * @since 7.6 */ public static native double round(double num, int exp) @@ -1226,7 +1226,7 @@ public class Util { * appropriate mode set. * * This version of the method tries to recursively locate such a parent. - * + * * For internal use only. May be removed or replaced in the future. */ public static boolean shouldSkipMeasurementOfConnector( diff --git a/client/src/main/java/com/vaadin/client/VCaption.java b/client/src/main/java/com/vaadin/client/VCaption.java index 51945907ae..1d79bd57cc 100644 --- a/client/src/main/java/com/vaadin/client/VCaption.java +++ b/client/src/main/java/com/vaadin/client/VCaption.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -67,9 +67,9 @@ public class VCaption extends HTML { /** * Creates a caption that is not linked to a {@link ComponentConnector}. - * + * * When using this constructor, {@link #getOwner()} returns null. - * + * * @param client * ApplicationConnection * @deprecated all captions should be associated with a paintable widget and @@ -88,7 +88,7 @@ public class VCaption extends HTML { /** * Creates a caption for a {@link ComponentConnector}. - * + * * @param component * owner of caption, not null * @param client @@ -130,10 +130,10 @@ public class VCaption extends HTML { /** * Updates the caption from UIDL. - * + * * This method may only be called when the caption has an owner - otherwise, * use {@link #updateCaptionWithoutOwner(UIDL, String, boolean, boolean)}. - * + * * @return true if the position where the caption should be placed has * changed */ @@ -477,7 +477,7 @@ public class VCaption extends HTML { /** * Checks whether anything in a given state change might cause the caption * to change. - * + * * @param event * the state change event to check * @return <code>true</code> if the caption might have changed; otherwise @@ -499,7 +499,7 @@ public class VCaption extends HTML { /** * Returns Paintable for which this Caption belongs to. - * + * * @return owner Widget */ public ComponentConnector getOwner() { @@ -664,7 +664,7 @@ public class VCaption extends HTML { /** * Sets the tooltip that should be shown for the caption - * + * * @param tooltipInfo * The tooltip that should be shown or null if no tooltip should * be shown @@ -675,7 +675,7 @@ public class VCaption extends HTML { /** * Returns the tooltip that should be shown for the caption - * + * * @return The tooltip to show or null if no tooltip should be shown */ public TooltipInfo getTooltipInfo() { @@ -704,7 +704,7 @@ public class VCaption extends HTML { * Sets whether the caption is rendered as HTML. * <p> * Default is false - * + * * @param captionAsHtml * true if the captions are rendered as HTML, false if rendered * as plain text @@ -717,7 +717,7 @@ public class VCaption extends HTML { * Checks whether captions are rendered as HTML. * <p> * Default is false - * + * * @return true if the captions are rendered as HTML, false if rendered as * plain text */ @@ -731,7 +731,7 @@ public class VCaption extends HTML { * <p> * Uses {@link AbstractComponentState#captionAsHtml} to determine whether to * set the caption as html or plain text - * + * * @since 7.4 * @param captionElement * the target element @@ -753,7 +753,7 @@ public class VCaption extends HTML { * <p> * Uses {@link AbstractComponentState#captionAsHtml} to determine whether to * set the caption as html or plain text - * + * * @since 7.4 * @param widget * the target widget diff --git a/client/src/main/java/com/vaadin/client/VCaptionWrapper.java b/client/src/main/java/com/vaadin/client/VCaptionWrapper.java index 382126f409..b9d2edc538 100644 --- a/client/src/main/java/com/vaadin/client/VCaptionWrapper.java +++ b/client/src/main/java/com/vaadin/client/VCaptionWrapper.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -26,7 +26,7 @@ public class VCaptionWrapper extends FlowPanel { /** * Creates a new caption wrapper panel. - * + * * @param toBeWrapped * paintable that the caption is associated with, not null * @param client diff --git a/client/src/main/java/com/vaadin/client/VConsole.java b/client/src/main/java/com/vaadin/client/VConsole.java index c01711c5b3..ababfc2121 100644 --- a/client/src/main/java/com/vaadin/client/VConsole.java +++ b/client/src/main/java/com/vaadin/client/VConsole.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -23,7 +23,7 @@ import com.vaadin.client.debug.internal.VDebugWindow; /** * A helper class to do some client side logging. - * + * * @deprecated as of 7.1, use {@link Logger} from java.util.logging instead. */ @Deprecated @@ -32,7 +32,7 @@ public class VConsole { /** * Used by ApplicationConfiguration to initialize VConsole. - * + * * @param console */ static void setImplementation(VDebugWindow console) { diff --git a/client/src/main/java/com/vaadin/client/VErrorMessage.java b/client/src/main/java/com/vaadin/client/VErrorMessage.java index 41967b9983..fa7fe1a51a 100644 --- a/client/src/main/java/com/vaadin/client/VErrorMessage.java +++ b/client/src/main/java/com/vaadin/client/VErrorMessage.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -38,7 +38,7 @@ public class VErrorMessage extends FlowPanel { * The owner must be set if the {@link VErrorMessage} is created * 'stand-alone' (not within a {@link VOverlay}), or theming might not work * properly. - * + * * @see VOverlay#setOwner(Widget) * @param owner * the owner (creator Widget) @@ -59,7 +59,7 @@ public class VErrorMessage extends FlowPanel { /** * Shows this error message next to given element. - * + * * @param indicatorElement * @deprecated As of 7.2, call and override {@link #showAt(Element)} instead */ @@ -84,9 +84,9 @@ public class VErrorMessage extends FlowPanel { /** * Shows this error message next to given element. - * + * * @param indicatorElement - * + * * @since 7.2 */ public void showAt(Element indicatorElement) { diff --git a/client/src/main/java/com/vaadin/client/VLoadingIndicator.java b/client/src/main/java/com/vaadin/client/VLoadingIndicator.java index 7c7edeb04f..0ba0edd984 100644 --- a/client/src/main/java/com/vaadin/client/VLoadingIndicator.java +++ b/client/src/main/java/com/vaadin/client/VLoadingIndicator.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -28,7 +28,7 @@ import com.google.gwt.user.client.Timer; * {@link #trigger()} is called the indicator moves to its "triggered" state and * then transitions from one state to the next when the timeouts specified using * the set*StateDelay methods occur. - * + * * @author Vaadin Ltd * @since 7.1 */ @@ -72,7 +72,7 @@ public class VLoadingIndicator { /** * Returns the delay (in ms) which must pass before the loading indicator * moves into the "first" state and is shown to the user - * + * * @return The delay (in ms) until moving into the "first" state. Counted * from when {@link #trigger()} is called. */ @@ -83,7 +83,7 @@ public class VLoadingIndicator { /** * Sets the delay (in ms) which must pass before the loading indicator moves * into the "first" state and is shown to the user - * + * * @param firstDelay * The delay (in ms) until moving into the "first" state. Counted * from when {@link #trigger()} is called. @@ -95,7 +95,7 @@ public class VLoadingIndicator { /** * Returns the delay (in ms) which must pass before the loading indicator * moves to its "second" state. - * + * * @return The delay (in ms) until the loading indicator moves into its * "second" state. Counted from when {@link #trigger()} is called. */ @@ -106,7 +106,7 @@ public class VLoadingIndicator { /** * Sets the delay (in ms) which must pass before the loading indicator moves * to its "second" state. - * + * * @param secondDelay * The delay (in ms) until the loading indicator moves into its * "second" state. Counted from when {@link #trigger()} is @@ -119,7 +119,7 @@ public class VLoadingIndicator { /** * Returns the delay (in ms) which must pass before the loading indicator * moves to its "third" state. - * + * * @return The delay (in ms) until the loading indicator moves into its * "third" state. Counted from when {@link #trigger()} is called. */ @@ -130,7 +130,7 @@ public class VLoadingIndicator { /** * Sets the delay (in ms) which must pass before the loading indicator moves * to its "third" state. - * + * * @param thirdDelay * The delay (in ms) from the event until changing the loading * indicator into its "third" state. Counted from when @@ -156,7 +156,7 @@ public class VLoadingIndicator { /** * Triggers displaying of this loading indicator unless it's already visible * or scheduled to be shown after a delay. - * + * * @since 7.4 */ public void ensureTriggered() { @@ -191,7 +191,7 @@ public class VLoadingIndicator { /** * Returns the {@link ApplicationConnection} which uses this loading * indicator - * + * * @return The ApplicationConnection for this loading indicator */ public ApplicationConnection getConnection() { @@ -201,7 +201,7 @@ public class VLoadingIndicator { /** * Sets the {@link ApplicationConnection} which uses this loading indicator. * Only used internally. - * + * * @param connection * The ApplicationConnection for this loading indicator */ @@ -223,7 +223,7 @@ public class VLoadingIndicator { /** * Returns whether or not the loading indicator is showing. - * + * * @return true if the loading indicator is visible, false otherwise */ public boolean isVisible() { @@ -237,7 +237,7 @@ public class VLoadingIndicator { /** * Returns the root element of the loading indicator - * + * * @return The loading indicator DOM element */ public com.google.gwt.user.client.Element getElement() { diff --git a/client/src/main/java/com/vaadin/client/VSchedulerImpl.java b/client/src/main/java/com/vaadin/client/VSchedulerImpl.java index 2c0657eb59..68078b4de7 100644 --- a/client/src/main/java/com/vaadin/client/VSchedulerImpl.java +++ b/client/src/main/java/com/vaadin/client/VSchedulerImpl.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/VTooltip.java b/client/src/main/java/com/vaadin/client/VTooltip.java index 454b5a8276..09d3ab5d65 100644 --- a/client/src/main/java/com/vaadin/client/VTooltip.java +++ b/client/src/main/java/com/vaadin/client/VTooltip.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -79,7 +79,7 @@ public class VTooltip extends VOverlay { * Used to show tooltips; usually used via the singleton in * {@link ApplicationConnection}. NOTE that #setOwner(Widget)} should be * called after instantiating. - * + * * @see ApplicationConnection#getVTooltip() */ public VTooltip() { @@ -107,7 +107,7 @@ public class VTooltip extends VOverlay { /** * Show the tooltip with the provided info for assistive devices. - * + * * @param info * with the content of the tooltip */ @@ -119,7 +119,7 @@ public class VTooltip extends VOverlay { /** * Initialize the tooltip overlay for assistive devices. - * + * * @param info * with the content of the tooltip * @since 7.2.4 @@ -147,12 +147,12 @@ public class VTooltip extends VOverlay { * element we need to clear style width of its parent DIV from old * value (in some strange cases this width=[tooltip MAX_WIDTH] after * tooltip text has been already updated to new shortly value: - * + * * <div class="popupContent"> <div style="width:500px;"> <div * class="v-errormessage" aria-hidden="true" style="display: none;"> * <div class="gwt-HTML"> </div> </div> <div * class="v-tooltip-text">This is a short tooltip</div> </div> - * + * * and it leads to error during calculation offsetWidth (it is * native GWT method getSubPixelOffsetWidth()) of description * element") @@ -168,7 +168,7 @@ public class VTooltip extends VOverlay { /** * Show a popup containing the currentTooltipInfo - * + * */ private void showTooltip() { if (currentTooltipInfo.hasMessage()) { @@ -212,7 +212,7 @@ public class VTooltip extends VOverlay { * Return the final X-coordinate of the tooltip based on cursor * position, size of the tooltip, size of the page and necessary * margins. - * + * * @param offsetWidth * @return The final X-coordinate */ @@ -285,10 +285,10 @@ public class VTooltip extends VOverlay { * Return the final Y-coordinate of the tooltip based on cursor * position, size of the tooltip, size of the page and necessary * margins. - * + * * @param offsetHeight * @return The final y-coordinate - * + * */ private int getFinalY(int offsetHeight) { int y = 0; @@ -381,7 +381,7 @@ public class VTooltip extends VOverlay { * and attached to the DOM well in advance. For this reason both isShowing * and isVisible return false positives. We can't override either of them as * external code may depend on this behavior. - * + * * @return boolean */ public boolean isTooltipOpen() { @@ -507,7 +507,7 @@ public class VTooltip extends VOverlay { /** * Locate the tooltip for given element - * + * * @param element * Element used in search * @return TooltipInfo if connector and tooltip found, null if not @@ -547,7 +547,7 @@ public class VTooltip extends VOverlay { /** * Handle hide event - * + * */ private void handleHideEvent() { hideTooltip(); @@ -570,7 +570,7 @@ public class VTooltip extends VOverlay { /** * Displays Tooltip when page is navigated with the keyboard. - * + * * Tooltip is not visible. This makes it possible for assistive devices * to recognize the tooltip. */ @@ -581,7 +581,7 @@ public class VTooltip extends VOverlay { /** * Hides Tooltip when the page is navigated with the keyboard. - * + * * Removes the Tooltip from page to make sure assistive devices don't * recognize it by accident. */ @@ -685,7 +685,7 @@ public class VTooltip extends VOverlay { /** * Connects DOM handlers to widget that are needed for tooltip presentation. - * + * * @param widget * Widget which DOM handlers are connected */ @@ -702,7 +702,7 @@ public class VTooltip extends VOverlay { /** * Returns the unique id of the tooltip element. - * + * * @return String containing the unique id of the tooltip, which always has * a value */ @@ -723,7 +723,7 @@ public class VTooltip extends VOverlay { * Returns the time (in ms) the tooltip should be displayed after an event * that will cause it to be closed (e.g. mouse click outside the component, * key down). - * + * * @return The close timeout (in ms) */ public int getCloseTimeout() { @@ -734,7 +734,7 @@ public class VTooltip extends VOverlay { * Sets the time (in ms) the tooltip should be displayed after an event that * will cause it to be closed (e.g. mouse click outside the component, key * down). - * + * * @param closeTimeout * The close timeout (in ms) */ @@ -747,7 +747,7 @@ public class VTooltip extends VOverlay { * be used instead of {@link #getOpenDelay()}. The quick open delay is used * when the tooltip has very recently been shown, is currently hidden but * about to be shown again. - * + * * @return The quick open timeout (in ms) */ public int getQuickOpenTimeout() { @@ -759,7 +759,7 @@ public class VTooltip extends VOverlay { * should be used instead of {@link #getOpenDelay()}. The quick open delay * is used when the tooltip has very recently been shown, is currently * hidden but about to be shown again. - * + * * @param quickOpenTimeout * The quick open timeout (in ms) */ @@ -771,7 +771,7 @@ public class VTooltip extends VOverlay { * Returns the time (in ms) that should elapse before a tooltip will be * shown, in the situation when a tooltip has very recently been shown * (within {@link #getQuickOpenDelay()} ms). - * + * * @return The quick open delay (in ms) */ public int getQuickOpenDelay() { @@ -782,7 +782,7 @@ public class VTooltip extends VOverlay { * Sets the time (in ms) that should elapse before a tooltip will be shown, * in the situation when a tooltip has very recently been shown (within * {@link #getQuickOpenDelay()} ms). - * + * * @param quickOpenDelay * The quick open delay (in ms) */ @@ -795,7 +795,7 @@ public class VTooltip extends VOverlay { * tooltip showing has occurred (e.g. mouse over) before the tooltip is * shown. If a tooltip has recently been shown, then * {@link #getQuickOpenDelay()} is used instead of this. - * + * * @return The open delay (in ms) */ public int getOpenDelay() { @@ -807,7 +807,7 @@ public class VTooltip extends VOverlay { * tooltip showing has occurred (e.g. mouse over) before the tooltip is * shown. If a tooltip has recently been shown, then * {@link #getQuickOpenDelay()} is used instead of this. - * + * * @param openDelay * The open delay (in ms) */ @@ -817,7 +817,7 @@ public class VTooltip extends VOverlay { /** * Sets the maximum width of the tooltip popup. - * + * * @param maxWidth * The maximum width the tooltip popup (in pixels) */ @@ -827,7 +827,7 @@ public class VTooltip extends VOverlay { /** * Returns the maximum width of the tooltip popup. - * + * * @return The maximum width the tooltip popup (in pixels) */ public int getMaxWidth() { diff --git a/client/src/main/java/com/vaadin/client/VUIDLBrowser.java b/client/src/main/java/com/vaadin/client/VUIDLBrowser.java index a091596ab8..c0b313dcb7 100644 --- a/client/src/main/java/com/vaadin/client/VUIDLBrowser.java +++ b/client/src/main/java/com/vaadin/client/VUIDLBrowser.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -14,7 +14,7 @@ * the License. */ /** - * + * */ package com.vaadin.client; @@ -45,7 +45,7 @@ import elemental.json.JsonValue; /** * @author Vaadin Ltd - * + * * @deprecated as of 7.1. This class was mainly used by the old debug console * but is retained for now for backwards compatibility. */ diff --git a/client/src/main/java/com/vaadin/client/ValueMap.java b/client/src/main/java/com/vaadin/client/ValueMap.java index 460b6491d0..5df021e948 100644 --- a/client/src/main/java/com/vaadin/client/ValueMap.java +++ b/client/src/main/java/com/vaadin/client/ValueMap.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -14,7 +14,7 @@ * the License. */ /** - * + * */ package com.vaadin.client; diff --git a/client/src/main/java/com/vaadin/client/WidgetInstantiator.java b/client/src/main/java/com/vaadin/client/WidgetInstantiator.java index 727db967ef..a6de051577 100644 --- a/client/src/main/java/com/vaadin/client/WidgetInstantiator.java +++ b/client/src/main/java/com/vaadin/client/WidgetInstantiator.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/WidgetLoader.java b/client/src/main/java/com/vaadin/client/WidgetLoader.java index 9aaf8e89f9..5b049c9ea6 100644 --- a/client/src/main/java/com/vaadin/client/WidgetLoader.java +++ b/client/src/main/java/com/vaadin/client/WidgetLoader.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/WidgetMap.java b/client/src/main/java/com/vaadin/client/WidgetMap.java index ec053eb511..714561e5f7 100644 --- a/client/src/main/java/com/vaadin/client/WidgetMap.java +++ b/client/src/main/java/com/vaadin/client/WidgetMap.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import java.util.HashMap; /** * Abstract class mapping between {@link ComponentConnector} instances and their * instances. - * + * * A concrete implementation of this class is generated by WidgetMapGenerator or * one of its subclasses during widgetset compilation. */ @@ -30,7 +30,7 @@ abstract class WidgetMap { /** * Create a new instance of a connector based on its type. - * + * * @param classType * {@link ComponentConnector} class to instantiate * @return new instance of the connector @@ -43,7 +43,7 @@ abstract class WidgetMap { /** * Return the connector class to use for a fully qualified server side * component class name. - * + * * @param fullyqualifiedName * fully qualified name of the server side component class * @return component connector class to use @@ -54,7 +54,7 @@ abstract class WidgetMap { /** * Return the connector classes to load after the initial widgetset load and * start. - * + * * @return component connector class to load after the initial widgetset * loading */ @@ -64,7 +64,7 @@ abstract class WidgetMap { * Make sure the code for a (deferred or lazy) component connector type has * been loaded, triggering the load and waiting for its completion if * necessary. - * + * * @param classType * component connector class */ diff --git a/client/src/main/java/com/vaadin/client/WidgetSet.java b/client/src/main/java/com/vaadin/client/WidgetSet.java index eb92be0e8e..aa35a83822 100644 --- a/client/src/main/java/com/vaadin/client/WidgetSet.java +++ b/client/src/main/java/com/vaadin/client/WidgetSet.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -31,13 +31,13 @@ public class WidgetSet { /** * Create an uninitialized connector that best matches given UIDL. The * connector must implement {@link ServerConnector}. - * + * * @param tag * connector type tag for the connector to create * @param conf * the application configuration to use when creating the * connector - * + * * @return New uninitialized and unregistered connector that can paint given * UIDL. */ @@ -108,7 +108,7 @@ public class WidgetSet { * Due its nature, GWT does not support dynamic classloading. To bypass this * limitation, widgetset must have function that returns Class by its fully * qualified name. - * + * * @param tag * @param applicationConfiguration * @return diff --git a/client/src/main/java/com/vaadin/client/WidgetUtil.java b/client/src/main/java/com/vaadin/client/WidgetUtil.java index bfe7a10feb..d6d36c1cb1 100644 --- a/client/src/main/java/com/vaadin/client/WidgetUtil.java +++ b/client/src/main/java/com/vaadin/client/WidgetUtil.java @@ -54,9 +54,9 @@ public class WidgetUtil { /** * Helper method for debugging purposes. - * + * * Stops execution on firefox browsers on a breakpoint. - * + * */ public static native void browserDebugger() /*-{ @@ -67,7 +67,7 @@ public class WidgetUtil { /** * Redirects the browser to the given url or refreshes the page if url is * null - * + * * @since 7.6 * @param url * The url to redirect to or null to refresh @@ -85,7 +85,7 @@ public class WidgetUtil { * Helper method for a bug fix #14041. For mozilla getKeyCode return 0 for * space bar (because space is considered as char). If return 0 use * getCharCode. - * + * * @param event * @return return key code * @since 7.2.4 @@ -99,12 +99,12 @@ public class WidgetUtil { } /** - * + * * Returns the topmost element of from given coordinates. - * + * * TODO fix crossplat issues clientX vs pageX. See quircksmode. Not critical * for vaadin as we scroll div istead of page. - * + * * @param x * @param y * @return the element at given coordinates @@ -137,7 +137,7 @@ public class WidgetUtil { /** * Converts html entities to text. - * + * * @param html * @return escaped string presentation of given html */ @@ -155,7 +155,7 @@ public class WidgetUtil { /** * Escapes the string so it is safe to write inside an HTML attribute. - * + * * @param attribute * The string to escape * @return An escaped version of <literal>attribute</literal>. @@ -174,9 +174,9 @@ public class WidgetUtil { /** * Clones given element as in JavaScript. - * + * * Deprecate this if there appears similar method into GWT someday. - * + * * @param element * @param deep * clone child tree also @@ -427,7 +427,7 @@ public class WidgetUtil { /** * Defers the execution of {@link #runWebkitOverflowAutoFix(Element)} - * + * * @since 7.2.6 * @param elem * with overflow auto @@ -445,9 +445,9 @@ public class WidgetUtil { /** * Run workaround for webkits overflow auto issue. - * + * * See: our bug #2138 and https://bugs.webkit.org/show_bug.cgi?id=21462 - * + * * @param elem * with overflow auto */ @@ -537,7 +537,7 @@ public class WidgetUtil { /** * Gets the border-box width for the given element, i.e. element width + * border + padding. Always rounds up to nearest integer. - * + * * @param element * The element to check * @return The border-box width for the element @@ -563,7 +563,7 @@ public class WidgetUtil { /** * Gets the border-box width for the given element, i.e. element width + * border + padding. - * + * * @since 7.5.1 * @param element * The element to check @@ -588,7 +588,7 @@ public class WidgetUtil { /** * Gets the border-box height for the given element, i.e. element height + * border + padding. Always rounds up to nearest integer. - * + * * @param element * The element to check * @return The border-box height for the element @@ -614,7 +614,7 @@ public class WidgetUtil { /** * Gets the border-box height for the given element, i.e. element height + * border + padding. - * + * * @since 7.5.1 * @param element * The element to check @@ -644,7 +644,7 @@ public class WidgetUtil { * <p> * In case the browser doesn't support bounding rectangles, the returned * value is the offset width. - * + * * @param element * the element of which to calculate the width * @return the width of the element @@ -661,7 +661,7 @@ public class WidgetUtil { * <p> * In case the browser doesn't support bounding rectangles, the returned * value is the offset width. - * + * * @param element * the element of which to calculate the width * @return the subpixel-accurate width of the element @@ -723,7 +723,7 @@ public class WidgetUtil { * <p> * In case the browser doesn't support bounding rectangles, the returned * value is the offset height. - * + * * @param element * the element of which to calculate the height * @return the height of the element @@ -740,7 +740,7 @@ public class WidgetUtil { * <p> * In case the browser doesn't support bounding rectangles, the returned * value is the offset height. - * + * * @param element * the element of which to calculate the height * @return the subpixel-accurate height of the element @@ -769,7 +769,7 @@ public class WidgetUtil { /** * Detects what is currently the overflow style attribute in given element. - * + * * @param pe * the element to detect * @return true if auto or scroll @@ -792,7 +792,7 @@ public class WidgetUtil { * A simple helper method to detect "computed style" (aka style sheets + * element styles). Values returned differ a lot depending on browsers. * Always be very careful when using this. - * + * * @param el * the element from which the style property is detected * @param p @@ -803,7 +803,7 @@ public class WidgetUtil { com.google.gwt.dom.client.Element el, String p) /*-{ try { - + if (el.currentStyle) { // IE return el.currentStyle[p]; @@ -818,12 +818,12 @@ public class WidgetUtil { } catch (e) { return ""; } - + }-*/; /** * Will (attempt) to focus the given DOM Element. - * + * * @param el * the element to focus */ @@ -832,7 +832,7 @@ public class WidgetUtil { try { el.focus(); } catch (e) { - + } }-*/; @@ -846,7 +846,7 @@ public class WidgetUtil { * {@code C} or null, depending on whether the class parameter matches. This * may also be the case with other Composite-like classes that hijack the * event handling of their child widget(s). - * + * * @param element * the element where to start seeking of Widget * @param class1 @@ -883,7 +883,7 @@ public class WidgetUtil { /** * Force webkit to redraw an element - * + * * @param element * The element that should be redrawn */ @@ -901,7 +901,7 @@ public class WidgetUtil { * Performs a hack to trigger a re-layout in the IE8. This is usually * necessary in cases where IE8 "forgets" to update child elements when they * resize. - * + * * @param e * The element to perform the hack on */ @@ -915,7 +915,7 @@ public class WidgetUtil { * Performs a hack to trigger a re-layout in the IE browser. This is usually * necessary in cases where IE "forgets" to update child elements when they * resize. - * + * * @since 7.3 * @param e * The element to perform the hack on @@ -929,9 +929,9 @@ public class WidgetUtil { /** * Detaches and re-attaches the element from its parent. The element is * reattached at the same position in the DOM as it was before. - * + * * Does nothing if the element is not attached to the DOM. - * + * * @param element * The element to detach and re-attach */ @@ -966,7 +966,7 @@ public class WidgetUtil { /** * Returns the index of the childElement within its parent. - * + * * @param subElement * @return */ @@ -984,7 +984,7 @@ public class WidgetUtil { * Temporarily sets the {@code styleProperty} to {@code tempValue} and then * resets it to its current value. Used mainly to work around rendering * issues in IE (and possibly in other browsers) - * + * * @param element * The target element * @param styleProperty @@ -1010,7 +1010,7 @@ public class WidgetUtil { * A helper method to return the client position from an event. Returns * position from either first changed touch (if touch event) or from the * event itself. - * + * * @param event * @return */ @@ -1026,7 +1026,7 @@ public class WidgetUtil { * Find the element corresponding to the coordinates in the passed mouse * event. Please note that this is not always the same as the target of the * event e.g. if event capture is used. - * + * * @param event * the mouse event to get coordinates from * @return the element at the coordinates of the event @@ -1042,7 +1042,7 @@ public class WidgetUtil { * A helper method to return the client position from an event. Returns * position from either first changed touch (if touch event) or from the * event itself. - * + * * @param event * @return */ @@ -1055,7 +1055,7 @@ public class WidgetUtil { } /** - * + * * @see #getTouchOrMouseClientY(Event) * @param currentGwtEvent * @return @@ -1066,7 +1066,7 @@ public class WidgetUtil { /** * @see #getTouchOrMouseClientX(Event) - * + * * @param event * @return */ @@ -1134,7 +1134,7 @@ public class WidgetUtil { /** * Gets the currently focused element. - * + * * @return The active element or null if no active element could be found. */ public native static Element getFocusedElement() @@ -1142,15 +1142,15 @@ public class WidgetUtil { if ($wnd.document.activeElement) { return $wnd.document.activeElement; } - + return null; }-*/; /** * Gets currently focused element and checks if it's editable - * + * * @since 7.4 - * + * * @return true if focused element is editable */ public static boolean isFocusedElementEditable() { @@ -1172,7 +1172,7 @@ public class WidgetUtil { * this method checks that this widget nor any of its parents is hidden. Can * be e.g used to check whether component should react to some events or * not. - * + * * @param widget * @return true if attached and displayed */ @@ -1205,7 +1205,7 @@ public class WidgetUtil { /** * Scrolls an element into view vertically only. Modified version of * Element.scrollIntoView. - * + * * @param elem * The element to scroll into view */ @@ -1213,11 +1213,11 @@ public class WidgetUtil { /*-{ var top = elem.offsetTop; var height = elem.offsetHeight; - + if (elem.parentNode != elem.offsetParent) { top -= elem.parentNode.offsetTop; } - + var cur = elem.parentNode; while (cur && (cur.nodeType == 1)) { if (top < cur.scrollTop) { @@ -1226,12 +1226,12 @@ public class WidgetUtil { if (top + height > cur.scrollTop + cur.clientHeight) { cur.scrollTop = (top + height) - cur.clientHeight; } - + var offsetTop = cur.offsetTop; if (cur.parentNode != cur.offsetParent) { offsetTop -= cur.parentNode.offsetTop; } - + top += offsetTop - cur.scrollTop; cur = cur.parentNode; } @@ -1240,7 +1240,7 @@ public class WidgetUtil { /** * Checks if the given event is either a touch event or caused by the left * mouse button - * + * * @param event * @return true if the event is a touch event or caused by the left mouse * button, false otherwise @@ -1253,7 +1253,7 @@ public class WidgetUtil { /** * Resolve a relative URL to an absolute URL based on the current document's * location. - * + * * @param url * a string with the relative URL to resolve * @return the corresponding absolute URL as a string @@ -1282,12 +1282,12 @@ public class WidgetUtil { /** * Sets the selection range of an input element. - * + * * We need this JSNI function to set selection range so that we can use the * optional direction attribute to set the anchor to the end and the focus * to the start. This makes Firefox work the same way as other browsers * (#13477) - * + * * @param elem * the html input element. * @param pos @@ -1298,7 +1298,7 @@ public class WidgetUtil { * a string indicating the direction in which the selection was * performed. This may be "forward" or "backward", or "none" if * the direction is unknown or irrelevant. - * + * * @since 7.3 */ public native static void setSelectionRange(Element elem, int pos, @@ -1313,7 +1313,7 @@ public class WidgetUtil { /** * JavaScript hack to prevent text selection in various browsers. - * + * * @since 7.6 * @param e * element for enabling or disabling text selection @@ -1336,7 +1336,7 @@ public class WidgetUtil { /** * JavaScript hack to clear text selection in various browsers. - * + * * @since 7.6 */ public native static void clearTextSelection() @@ -1358,13 +1358,13 @@ public class WidgetUtil { /** * Compares two double values with the error margin of * {@link #PIXEL_EPSILON} (i.e. {@value #PIXEL_EPSILON}) - * + * * @param num1 * the first value for which to compare equality * @param num2 * the second value for which to compare equality * @since 7.4 - * + * * @return true if the values are considered equals; false otherwise */ public static boolean pixelValuesEqual(final double num1, @@ -1416,7 +1416,7 @@ public class WidgetUtil { * Wrap a css size value and its unit and translate back and forth to the * string representation.<br/> * Eg. 50%, 123px, ... - * + * * @since 7.2.6 * @author Vaadin Ltd */ @@ -1435,7 +1435,7 @@ public class WidgetUtil { /** * Gets the unit value by its type. - * + * * @param type * the type of the unit as found in the style. * @return the unit value. @@ -1452,7 +1452,7 @@ public class WidgetUtil { /** * Parse the size from string format to {@link CssSize}. - * + * * @param s * the size as string. * @return a {@link CssSize} object. @@ -1492,7 +1492,7 @@ public class WidgetUtil { /** * Creates a {@link CssSize} using a value and its measurement unit. - * + * * @param value * the value. * @param unit @@ -1520,7 +1520,7 @@ public class WidgetUtil { /** * Gets the value for this css size. - * + * * @return the value. */ public float getValue() { @@ -1529,7 +1529,7 @@ public class WidgetUtil { /** * Gets the measurement unit for this css size. - * + * * @return the unit. */ public Unit getUnit() { @@ -1553,7 +1553,7 @@ public class WidgetUtil { /** * Check whether the two sizes are equals. - * + * * @param cssSize1 * the first size to compare. * @param cssSize2 @@ -1576,7 +1576,7 @@ public class WidgetUtil { * <p> * The value is determined using computed style when available and * calculated otherwise. - * + * * @since 7.5.0 * @param element * the element to measure @@ -1591,7 +1591,7 @@ public class WidgetUtil { * <p> * The value is determined using computed style when available and * calculated otherwise. - * + * * @since 7.5.0 * @param element * the element to measure @@ -1608,7 +1608,7 @@ public class WidgetUtil { * <p> * The value is determined using computed style when available and * calculated otherwise. - * + * * @since 7.5.0 * @param element * the element to measure @@ -1624,7 +1624,7 @@ public class WidgetUtil { * <p> * The value is determined using computed style when available and * calculated otherwise. - * + * * @since 7.5.0 * @param element * the element to measure @@ -1639,7 +1639,7 @@ public class WidgetUtil { * <p> * The value is determined using computed style when available and * calculated otherwise. - * + * * @since 7.5.0 * @param element * the element to measure @@ -1654,7 +1654,7 @@ public class WidgetUtil { * <p> * The value is determined using computed style when available and * calculated otherwise. - * + * * @since 7.5.0 * @param element * the element to measure @@ -1688,20 +1688,20 @@ public class WidgetUtil { } var heightWithoutBorder = cloneElement.offsetHeight; parentElement.removeChild(cloneElement); - + return heightWithBorder - heightWithoutBorder; } }-*/; /** * Rounds the given size up to a value which the browser will accept. - * + * * Safari/WebKit uses 1/64th of a pixel to enable using integer math * (http://trac.webkit.org/wiki/LayoutUnit). - * + * * Firefox uses 1/60th of a pixel because it is divisible by three * (https://bugzilla.mozilla.org/show_bug.cgi?id=1070940) - * + * * @since 7.5.1 * @param size * the value to round @@ -1713,15 +1713,15 @@ public class WidgetUtil { /** * Rounds the given size down to a value which the browser will accept. - * + * * Safari/WebKit uses 1/64th of a pixel to enable using integer math * (http://trac.webkit.org/wiki/LayoutUnit). - * + * * Firefox uses 1/60th of a pixel because it is divisible by three * (https://bugzilla.mozilla.org/show_bug.cgi?id=1070940) - * + * * IE9+ uses 1/100th of a pixel - * + * * @since 7.5.1 * @param size * the value to round @@ -1754,7 +1754,7 @@ public class WidgetUtil { /** * Returns the factor used by browsers to round subpixel values - * + * * @since 7.5.1 * @return the factor N used by the browser when storing subpixels as X+Y/N */ diff --git a/client/src/main/java/com/vaadin/client/annotations/OnStateChange.java b/client/src/main/java/com/vaadin/client/annotations/OnStateChange.java index d15e32f493..c3d0424373 100644 --- a/client/src/main/java/com/vaadin/client/annotations/OnStateChange.java +++ b/client/src/main/java/com/vaadin/client/annotations/OnStateChange.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -33,7 +33,7 @@ import com.vaadin.client.communication.StateChangeEvent; * <p> * If there is no state variable with the provided name, the widgetset * compilation will fail. - * + * * @since 7.2 * @author Vaadin Ltd */ @@ -43,7 +43,7 @@ import com.vaadin.client.communication.StateChangeEvent; public @interface OnStateChange { /** * Defines a list of property names to listen for. - * + * * @return an array of property names, should contain at least one item */ public String[] value(); diff --git a/client/src/main/java/com/vaadin/client/communication/AbstractServerConnectorEvent.java b/client/src/main/java/com/vaadin/client/communication/AbstractServerConnectorEvent.java index 9f99a451e1..3d8dc58e96 100644 --- a/client/src/main/java/com/vaadin/client/communication/AbstractServerConnectorEvent.java +++ b/client/src/main/java/com/vaadin/client/communication/AbstractServerConnectorEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -36,7 +36,7 @@ public abstract class AbstractServerConnectorEvent<H extends EventHandler> /** * Sends this event to the given handler. - * + * * @param handler * The handler to dispatch. */ diff --git a/client/src/main/java/com/vaadin/client/communication/AtmospherePushConnection.java b/client/src/main/java/com/vaadin/client/communication/AtmospherePushConnection.java index dc09189be4..34e1c5ff30 100644 --- a/client/src/main/java/com/vaadin/client/communication/AtmospherePushConnection.java +++ b/client/src/main/java/com/vaadin/client/communication/AtmospherePushConnection.java @@ -42,7 +42,7 @@ import elemental.json.JsonObject; /** * The default {@link PushConnection} implementation that uses Atmosphere for * handling the communication channel. - * + * * @author Vaadin Ltd * @since 7.1 */ @@ -140,7 +140,7 @@ public class AtmospherePushConnection implements PushConnection { /* * (non-Javadoc) - * + * * @see * com.vaadin.client.communication.PushConnection#init(ApplicationConnection * , Map<String, String>, CommunicationErrorHandler) @@ -308,9 +308,9 @@ public class AtmospherePushConnection implements PushConnection { /** * Called whenever a server push connection is established (or * re-established). - * + * * @param response - * + * * @since 7.2 */ protected void onConnect(AtmosphereResponse response) { @@ -338,7 +338,7 @@ public class AtmospherePushConnection implements PushConnection { /* * (non-Javadoc) - * + * * @see com.vaadin.client.communication.PushConenction#disconnect() */ @Override @@ -392,7 +392,7 @@ public class AtmospherePushConnection implements PushConnection { /** * Called if the push connection fails. Atmosphere will automatically retry * the connection until successful. - * + * */ protected void onError(AtmosphereResponse response) { state = State.DISCONNECTED; @@ -526,7 +526,7 @@ public class AtmospherePushConnection implements PushConnection { JavaScriptObject config) /*-{ var self = this; - + config.url = uri; config.onOpen = $entry(function(response) { self.@com.vaadin.client.communication.AtmospherePushConnection::onOpen(*)(response); @@ -552,7 +552,7 @@ public class AtmospherePushConnection implements PushConnection { config.onClientTimeout = $entry(function(request) { self.@com.vaadin.client.communication.AtmospherePushConnection::onClientTimeout(*)(request); }); - + return $wnd.vaadinPush.atmosphere.subscribe(config); }-*/; diff --git a/client/src/main/java/com/vaadin/client/communication/ConnectionStateHandler.java b/client/src/main/java/com/vaadin/client/communication/ConnectionStateHandler.java index cc33dd0086..13c1e47ae7 100644 --- a/client/src/main/java/com/vaadin/client/communication/ConnectionStateHandler.java +++ b/client/src/main/java/com/vaadin/client/communication/ConnectionStateHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -25,11 +25,11 @@ import elemental.json.JsonObject; /** * Interface for handling problems and other events which occur during * communication with the server. - * + * * The handler is responsible for handling any problem in XHR, heartbeat and * push connections in a way it sees fit. The default implementation is * {@link DefaultConnectionStateHandler}. - * + * * @since 7.6 * @author Vaadin Ltd */ @@ -46,7 +46,7 @@ public interface ConnectionStateHandler { /** * Called when an exception occurs during a {@link Heartbeat} request - * + * * @param request * The heartbeat request * @param exception @@ -56,7 +56,7 @@ public interface ConnectionStateHandler { /** * Called when a heartbeat request returns a status code other than OK (200) - * + * * @param request * The heartbeat request * @param response @@ -74,7 +74,7 @@ public interface ConnectionStateHandler { * result in the push connection trying a fallback connection method, trying * to reconnect to the server or might just be an indication that the * connection was intentionally closed ("unsubscribe"), - * + * * @param pushConnection * The push connection which was closed * @param response @@ -86,10 +86,10 @@ public interface ConnectionStateHandler { /** * Called when a client side timeout occurs before a push connection to the * server completes. - * + * * The client side timeout causes a disconnection of the push connection and * no reconnect will be attempted after this method is called, - * + * * @param pushConnection * The push connection which timed out * @param response @@ -100,13 +100,13 @@ public interface ConnectionStateHandler { /** * Called when a fatal error fatal error occurs in the push connection. - * + * * The push connection will not try to recover from this situation itself * and typically the problem handler should not try to do automatic recovery * either. The cause can be e.g. maximum number of reconnection attempts * have been reached, neither the selected transport nor the fallback * transport can be used or similar. - * + * * @param pushConnection * The push connection where the error occurred * @param response @@ -117,7 +117,7 @@ public interface ConnectionStateHandler { /** * Called when the push connection has lost the connection to the server and * will proceed to try to re-establish the connection - * + * * @param pushConnection * The push connection which will be reconnected */ @@ -125,7 +125,7 @@ public interface ConnectionStateHandler { /** * Called when the push connection to the server has been established. - * + * * @param pushConnection * The push connection which was established */ @@ -133,7 +133,7 @@ public interface ConnectionStateHandler { /** * Called when the required push script could not be loaded - * + * * @param resourceUrl * The URL which was used for loading the script */ @@ -142,7 +142,7 @@ public interface ConnectionStateHandler { /** * Called when an exception occurs during an XmlHttpRequest request to the * server. - * + * * @param xhrConnectionError * An event containing what was being sent to the server and what * exception occurred @@ -152,7 +152,7 @@ public interface ConnectionStateHandler { /** * Called when invalid content (not JSON) was returned from the server as * the result of an XmlHttpRequest request - * + * * @param communicationProblemEvent * An event containing what was being sent to the server and what * was returned @@ -162,7 +162,7 @@ public interface ConnectionStateHandler { /** * Called when invalid status code (not 200) was returned by the server as * the result of an XmlHttpRequest. - * + * * @param communicationProblemEvent * An event containing what was being sent to the server and what * was returned @@ -177,7 +177,7 @@ public interface ConnectionStateHandler { /** * Called when a message is to be sent to the server through the push * channel but the push channel is not connected - * + * * @param payload * The payload to send to the server */ @@ -186,7 +186,7 @@ public interface ConnectionStateHandler { /** * Called when invalid content (not JSON) was pushed from the server through * the push connection - * + * * @param communicationProblemEvent * An event containing what was being sent to the server and what * was returned diff --git a/client/src/main/java/com/vaadin/client/communication/Date_Serializer.java b/client/src/main/java/com/vaadin/client/communication/Date_Serializer.java index 14eb6e4e3d..cec1799188 100644 --- a/client/src/main/java/com/vaadin/client/communication/Date_Serializer.java +++ b/client/src/main/java/com/vaadin/client/communication/Date_Serializer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -25,7 +25,7 @@ import elemental.json.JsonValue; /** * Client side serializer/deserializer for java.util.Date - * + * * @since 7.2 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/communication/DefaultConnectionStateHandler.java b/client/src/main/java/com/vaadin/client/communication/DefaultConnectionStateHandler.java index 080358086a..9a8348f29b 100644 --- a/client/src/main/java/com/vaadin/client/communication/DefaultConnectionStateHandler.java +++ b/client/src/main/java/com/vaadin/client/communication/DefaultConnectionStateHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -42,7 +42,7 @@ import elemental.json.JsonObject; * <p> * Handles permanent errors by showing a critical system notification to the * user - * + * * @since 7.6 * @author Vaadin Ltd */ @@ -78,7 +78,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { /** * Checks if this type is of higher priority than the given type - * + * * @param type * the type to compare to * @return true if this type has higher priority than the given type, @@ -116,7 +116,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { /** * Checks if we are currently trying to reconnect - * + * * @return true if we have noted a problem and are trying to re-establish * server connection, false otherwise */ @@ -130,7 +130,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { /** * Returns the connection this handler is connected to - * + * * @return the connection for this handler */ protected ApplicationConnection getConnection() { @@ -185,7 +185,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { * Called whenever an error occurs in communication which should be handled * by showing the reconnect dialog and retrying communication until * successful again - * + * * @param type * The type of failure detected * @param payload @@ -243,10 +243,10 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { /** * Called after a problem occurred. - * + * * This method is responsible for re-sending the payload to the server (if * not null) or re-send a heartbeat request at some point - * + * * @param payload * the payload that did not reach the server, null if the problem * was detected by a heartbeat @@ -274,7 +274,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { /** * Re-sends the payload to the server (if not null) or re-sends a heartbeat * request immediately - * + * * @param payload * the payload that did not reach the server, null if the problem * was detected by a heartbeat @@ -308,7 +308,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { /** * Called when we should give up trying to reconnect and let the user decide * how to continue - * + * */ protected void giveUp() { reconnectionCause = null; @@ -339,7 +339,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { /** * Checks if the reconnect dialog is visible to the user - * + * * @return true if the user can see the dialog, false otherwise */ protected boolean isDialogVisible() { @@ -371,7 +371,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { /** * Gets the text to show in the reconnect dialog after giving up (reconnect * limit reached) - * + * * @param reconnectAttempt * The number of the current reconnection attempt * @return The text to show in the reconnect dialog after giving up @@ -383,7 +383,7 @@ public class DefaultConnectionStateHandler implements ConnectionStateHandler { /** * Gets the text to show in the reconnect dialog - * + * * @param reconnectAttempt * The number of the current reconnection attempt * @return The text to show in the reconnect dialog diff --git a/client/src/main/java/com/vaadin/client/communication/DefaultReconnectDialog.java b/client/src/main/java/com/vaadin/client/communication/DefaultReconnectDialog.java index 7d311dc9e5..68a6814aef 100644 --- a/client/src/main/java/com/vaadin/client/communication/DefaultReconnectDialog.java +++ b/client/src/main/java/com/vaadin/client/communication/DefaultReconnectDialog.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -33,7 +33,7 @@ import com.vaadin.client.ui.VOverlay; /** * The default implementation of the reconnect dialog - * + * * @since 7.6 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/communication/DiffJSONSerializer.java b/client/src/main/java/com/vaadin/client/communication/DiffJSONSerializer.java index d433a8964c..64e296ab94 100644 --- a/client/src/main/java/com/vaadin/client/communication/DiffJSONSerializer.java +++ b/client/src/main/java/com/vaadin/client/communication/DiffJSONSerializer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -22,7 +22,7 @@ import elemental.json.JsonValue; public interface DiffJSONSerializer<T> extends JSONSerializer<T> { /** * Update the target object in place based on the passed JSON data. - * + * * @param target * @param jsonValue * @param connection diff --git a/client/src/main/java/com/vaadin/client/communication/HasJavaScriptConnectorHelper.java b/client/src/main/java/com/vaadin/client/communication/HasJavaScriptConnectorHelper.java index deb5900b89..b7b21014d0 100644 --- a/client/src/main/java/com/vaadin/client/communication/HasJavaScriptConnectorHelper.java +++ b/client/src/main/java/com/vaadin/client/communication/HasJavaScriptConnectorHelper.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/communication/Heartbeat.java b/client/src/main/java/com/vaadin/client/communication/Heartbeat.java index 3ed7510d8f..3ec39804bb 100644 --- a/client/src/main/java/com/vaadin/client/communication/Heartbeat.java +++ b/client/src/main/java/com/vaadin/client/communication/Heartbeat.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -31,7 +31,7 @@ import com.vaadin.shared.util.SharedUtil; /** * Handles sending of heartbeats to the server and reacting to the response - * + * * @since 7.2 * @author Vaadin Ltd */ @@ -54,7 +54,7 @@ public class Heartbeat { /** * Initializes the heartbeat for the given application connection - * + * * @param connection * the connection */ @@ -161,7 +161,7 @@ public class Heartbeat { /** * Changes the heartbeatInterval in runtime and applies it. - * + * * @param heartbeatInterval * new interval in seconds. */ diff --git a/client/src/main/java/com/vaadin/client/communication/JSONSerializer.java b/client/src/main/java/com/vaadin/client/communication/JSONSerializer.java index 59e0329ae1..922f2f90fe 100644 --- a/client/src/main/java/com/vaadin/client/communication/JSONSerializer.java +++ b/client/src/main/java/com/vaadin/client/communication/JSONSerializer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -34,7 +34,7 @@ import elemental.json.JsonValue; * <p> * This is the client side interface, see * com.vaadin.server.communication.JSONSerializer for the server side interface. - * + * * @since 7.0 */ public interface JSONSerializer<T> { @@ -43,14 +43,14 @@ public interface JSONSerializer<T> { * Creates and deserializes an object received from the server. Must be * compatible with {@link #serialize(Object, ApplicationConnection)} and * also with the server side JsonCodec.encode method. - * + * * @param type * the type to deserialize * @param jsonValue * JSON map from property name to property value * @param connection * the application connection providing the context - * + * * @return A deserialized object */ T deserialize(Type type, JsonValue jsonValue, @@ -60,7 +60,7 @@ public interface JSONSerializer<T> { * Serialize the given object into JSON. Must be compatible with * {@link #deserialize(Type, JsonValue, ApplicationConnection)} and also * with the server side JsonCodec.decodeCustomType method. - * + * * @param value * The object to serialize * @param connection diff --git a/client/src/main/java/com/vaadin/client/communication/JavaScriptMethodInvocation.java b/client/src/main/java/com/vaadin/client/communication/JavaScriptMethodInvocation.java index 43366902e2..af1d43bce4 100644 --- a/client/src/main/java/com/vaadin/client/communication/JavaScriptMethodInvocation.java +++ b/client/src/main/java/com/vaadin/client/communication/JavaScriptMethodInvocation.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.vaadin.shared.communication.MethodInvocation; /** * A {@link MethodInvocation} that originates from JavaScript. This means that * there might not be any type information available on the client. - * + * * @author Vaadin Ltd * @since 7.0.0 */ diff --git a/client/src/main/java/com/vaadin/client/communication/JsonDecoder.java b/client/src/main/java/com/vaadin/client/communication/JsonDecoder.java index 8c11cb76fd..f18d7dc2f8 100644 --- a/client/src/main/java/com/vaadin/client/communication/JsonDecoder.java +++ b/client/src/main/java/com/vaadin/client/communication/JsonDecoder.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/communication/JsonEncoder.java b/client/src/main/java/com/vaadin/client/communication/JsonEncoder.java index d04be4d57b..9316c5f6f7 100644 --- a/client/src/main/java/com/vaadin/client/communication/JsonEncoder.java +++ b/client/src/main/java/com/vaadin/client/communication/JsonEncoder.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -39,12 +39,12 @@ import elemental.json.JsonValue; /** * Encoder for converting RPC parameters and other values to JSON for transfer * between the client and the server. - * + * * Currently, basic data types as well as Map, String[] and Object[] are * supported, where maps and Object[] can contain other supported data types. - * + * * TODO extensible type support - * + * * @since 7.0 */ public class JsonEncoder { @@ -52,7 +52,7 @@ public class JsonEncoder { /** * Encode a value to a JSON representation for transport from the client to * the server. - * + * * @param value * value to convert * @param connection @@ -292,7 +292,7 @@ public class JsonEncoder { /** * Returns the transport type for the given value. Only returns a transport * type for internally handled values. - * + * * @param value * The value that should be transported * @return One of the JsonEncode.VTYPE_ constants or null if the value diff --git a/client/src/main/java/com/vaadin/client/communication/MessageHandler.java b/client/src/main/java/com/vaadin/client/communication/MessageHandler.java index 4a895d7f28..714af23683 100644 --- a/client/src/main/java/com/vaadin/client/communication/MessageHandler.java +++ b/client/src/main/java/com/vaadin/client/communication/MessageHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -79,7 +79,7 @@ import elemental.json.JsonObject; * A MessageHandler is responsible for handling all incoming messages (JSON) * from the server (state changes, RPCs and other updates) and ensuring that the * connectors are updated accordingly. - * + * * @since 7.6 * @author Vaadin Ltd */ @@ -156,7 +156,7 @@ public class MessageHandler { * has not yet been rendered (or that your browser is very fast). -1 means * that the browser does not support the performance.timing feature used to * get this measurement. - * + * * Note: also used for tracking whether the first UIDL has been handled */ private int bootstrapTime = 0; @@ -209,7 +209,7 @@ public class MessageHandler { /** * Sets the application connection this instance is connected to. Called * internally by the framework. - * + * * @param connection * the application connection this instance is connected to */ @@ -224,7 +224,7 @@ public class MessageHandler { /** * Handles a received UIDL JSON text, parsing it, and passing it on to the * appropriate handlers, while logging timing information. - * + * * @param jsonText * The JSON to handle */ @@ -743,13 +743,13 @@ public class MessageHandler { /** * Sends the state change events created while updating the state * information. - * + * * This must be called after hierarchy change listeners have been * called. At least caption updates for the parent are strange if * fired from state change listeners and thus calls the parent * BEFORE the parent is aware of the child (through a * ConnectorHierarchyChangedEvent) - * + * * @param pendingStateChangeEvents * The events to send */ @@ -1122,7 +1122,7 @@ public class MessageHandler { * Updates the connector hierarchy and returns a list of events that * should be fired after update of the hierarchy and the state is * done. - * + * * @param json * The JSON containing the hierarchy information * @return A collection of events that should be fired when update @@ -1203,7 +1203,7 @@ public class MessageHandler { /** * Updates the hierarchy for a connector - * + * * @param connectorId * the id of the connector to update * @param childConnectorIds @@ -1590,7 +1590,7 @@ public class MessageHandler { /** * This method can be used to postpone rendering of a response for a short * period of time (e.g. to avoid the rendering process during animation). - * + * * @param lock */ public void suspendReponseHandling(Object lock) { @@ -1599,7 +1599,7 @@ public class MessageHandler { /** * Resumes the rendering process once all locks have been removed. - * + * * @param lock */ public void resumeResponseHandling(Object lock) { @@ -1629,7 +1629,7 @@ public class MessageHandler { /** * Finds the next pending UIDL message and handles it (next pending is * decided based on the server id) - * + * * @return true if a message was handled, false otherwise */ private boolean handlePendingMessages() { @@ -1682,7 +1682,7 @@ public class MessageHandler { * server is received. * <p> * The initial id when no request has yet been processed is -1. - * + * * @return an id identifying the response */ public int getLastSeenServerSyncId() { @@ -1692,7 +1692,7 @@ public class MessageHandler { /** * Gets the token (aka double submit cookie) that the server uses to protect * against Cross Site Request Forgery attacks. - * + * * @return the CSRF token string */ public String getCsrfToken() { @@ -1704,7 +1704,7 @@ public class MessageHandler { * operations are not allowed when the internal state of the application * might be in an inconsistent state because some state changes have been * applied but others not. This includes running layotus. - * + * * @return <code>true</code> if the internal state might be inconsistent * because changes are being processed; <code>false</code> if the * state should be consistent @@ -1715,7 +1715,7 @@ public class MessageHandler { /** * Checks if the first UIDL has been handled - * + * * @return true if the initial UIDL has already been processed, false * otherwise */ @@ -1745,9 +1745,9 @@ public class MessageHandler { /** * Strips the JSON wrapping from the given json string with wrapping. - * + * * If the given string is not wrapped as expected, returns null - * + * * @since 7.6 * @param jsonWithWrapping * the JSON received from the server @@ -1769,7 +1769,7 @@ public class MessageHandler { /** * Unwraps and parses the given JSON, originating from the server - * + * * @param jsonText * the json from the server * @return A parsed ValueMap or null if the input could not be parsed (or @@ -1803,7 +1803,7 @@ public class MessageHandler { /** * Parse the given wrapped JSON, received from the server, to a ValueMap - * + * * @param wrappedJsonText * the json, wrapped as done by the server * @return a ValueMap, or null if the wrapping was incorrect or json could diff --git a/client/src/main/java/com/vaadin/client/communication/MessageSender.java b/client/src/main/java/com/vaadin/client/communication/MessageSender.java index f77f55f6ff..22e3e8d420 100644 --- a/client/src/main/java/com/vaadin/client/communication/MessageSender.java +++ b/client/src/main/java/com/vaadin/client/communication/MessageSender.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -40,7 +40,7 @@ import elemental.json.JsonValue; * <p> * Internally uses {@link XhrConnection} and/or {@link PushConnection} for * delivering messages, depending on the application configuration. - * + * * @since 7.6 * @author Vaadin Ltd */ @@ -94,7 +94,7 @@ public class MessageSender { /** * Sends all pending method invocations (server RPC and legacy variable * changes) to the server. - * + * */ private void doSendInvocationsToServer() { @@ -137,7 +137,7 @@ public class MessageSender { /** * Makes an UIDL request to the server. - * + * * @param reqInvocations * Data containing RPC invocations and all related information. * @param extraParams @@ -172,7 +172,7 @@ public class MessageSender { /** * Sends an asynchronous or synchronous UIDL request to the server using the * given URI. - * + * * @param uri * The URI to use for the request. May includes GET parameters * @param payload @@ -188,7 +188,7 @@ public class MessageSender { /** * Sets the status for the push connection. - * + * * @param enabled * <code>true</code> to enable the push connection; * <code>false</code> to disable the push connection. @@ -275,7 +275,7 @@ public class MessageSender { /** * Runs possibly registered client side post request hooks. This is expected * to be run after each uidl request made by Vaadin application. - * + * * @param appId */ public static native void runPostRequestHooks(String appId) @@ -295,7 +295,7 @@ public class MessageSender { /** * If on Liferay and logged in, ask the client side session management * JavaScript to extend the session duration. - * + * * Otherwise, Liferay client side JavaScript will explicitly expire the * session even though the server side considers the session to be active. * See ticket #8305 for more information. @@ -314,7 +314,7 @@ public class MessageSender { /** * Indicates whether or not there are currently active UIDL requests. Used * internally to sequence requests properly, seldom needed in Widgets. - * + * * @return true if there are active requests */ public boolean hasActiveRequest() { @@ -324,7 +324,7 @@ public class MessageSender { /** * Returns a human readable string representation of the method used to * communicate with the server. - * + * * @return A string representation of the current transport type */ public String getCommunicationMethodName() { @@ -366,7 +366,7 @@ public class MessageSender { /** * Used internally to update what the server expects - * + * * @param clientToServerMessageId * the new client id to set * @param force diff --git a/client/src/main/java/com/vaadin/client/communication/PushConnection.java b/client/src/main/java/com/vaadin/client/communication/PushConnection.java index f3595c732c..ae3e698dbc 100644 --- a/client/src/main/java/com/vaadin/client/communication/PushConnection.java +++ b/client/src/main/java/com/vaadin/client/communication/PushConnection.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -28,7 +28,7 @@ import elemental.json.JsonObject; * receive UIDL messages from the server (either asynchronously or as a response * to a UIDL request.) Delegates the UIDL handling to the * {@link ApplicationConnection}. - * + * * @author Vaadin Ltd * @since 7.1 */ @@ -36,7 +36,7 @@ public interface PushConnection { /** * Two-phase construction to allow using GWT.create(). - * + * * @param connection * The ApplicationConnection */ @@ -54,12 +54,12 @@ public interface PushConnection { * <p> * This method must not be called if the push connection is not * bidirectional (if {@link #isBidirectional()} returns false) - * + * * @param payload * the payload to push * @throws IllegalStateException * if this connection is not active - * + * * @see #isActive() */ public void push(JsonObject payload); @@ -68,7 +68,7 @@ public interface PushConnection { * Checks whether this push connection is in a state where it can push * messages to the server. A connection is active until * {@link #disconnect(Command)} has been called. - * + * * @return <code>true</code> if this connection can accept new messages; * <code>false</code> if this connection is disconnected or * disconnecting. @@ -85,7 +85,7 @@ public interface PushConnection { * After this method has been called, {@link #isActive()} returns * <code>false</code>. Calling this method for a connection that is no * longer active will throw an exception. - * + * * @param command * callback command invoked when the connection has been properly * disconnected @@ -97,7 +97,7 @@ public interface PushConnection { /** * Returns a human readable string representation of the transport type used * to communicate with the server. - * + * * @since 7.1 * @return A human readable string representation of the transport type */ @@ -107,10 +107,10 @@ public interface PushConnection { * Checks whether this push connection should be used for communication in * both directions or if an XHR should be used for client to server * communication. - * + * * A bidirectional push connection must be able to reliably inform about its * connection state. - * + * * @since 7.6 * @return true if the push connection should be used for messages in both * directions, false if it should only be used for server to client diff --git a/client/src/main/java/com/vaadin/client/communication/ReconnectDialog.java b/client/src/main/java/com/vaadin/client/communication/ReconnectDialog.java index 1e77eb63b8..146d6de39b 100644 --- a/client/src/main/java/com/vaadin/client/communication/ReconnectDialog.java +++ b/client/src/main/java/com/vaadin/client/communication/ReconnectDialog.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.vaadin.client.ApplicationConnection; /** * Interface which must be implemented by the reconnect dialog - * + * * @since 7.6 * @author Vaadin Ltd */ @@ -27,7 +27,7 @@ public interface ReconnectDialog { /** * Sets the main text shown in the dialog - * + * * @param text * the text to show */ @@ -36,7 +36,7 @@ public interface ReconnectDialog { /** * Sets the reconnecting state, which is true if we are trying to * re-establish a connection with the server. - * + * * @param reconnecting * true if we are trying to re-establish the server connection, * false if we have given up @@ -45,14 +45,14 @@ public interface ReconnectDialog { /** * Checks if the reconnect dialog is visible to the user - * + * * @return true if the user can see the dialog, false otherwise */ boolean isVisible(); /** * Shows the dialog to the user - * + * * @param connection * the application connection this is related to */ @@ -69,7 +69,7 @@ public interface ReconnectDialog { * not modal, the user can continue to use the application as normally and * all server events will be queued until connection has been * re-established. - * + * * @param modal * true to make the dialog modal, false to allow usage while * dialog is shown @@ -78,7 +78,7 @@ public interface ReconnectDialog { /** * Checks the modality of the dialog. - * + * * @see #setModal(boolean) * @return true if the dialog is modal, false otherwise */ diff --git a/client/src/main/java/com/vaadin/client/communication/RpcManager.java b/client/src/main/java/com/vaadin/client/communication/RpcManager.java index 578c9bd6a4..7252823355 100644 --- a/client/src/main/java/com/vaadin/client/communication/RpcManager.java +++ b/client/src/main/java/com/vaadin/client/communication/RpcManager.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -33,17 +33,17 @@ import elemental.json.JsonArray; /** * Client side RPC manager that can invoke methods based on RPC calls received * from the server. - * + * * A GWT generator is used to create an implementation of this class at * run-time. - * + * * @since 7.0 */ public class RpcManager { /** * Perform server to client RPC invocation. - * + * * @param invocation * method to invoke */ @@ -67,10 +67,10 @@ public class RpcManager { /** * Gets the method that an invocation targets. - * + * * @param invocation * the method invocation to get the method for - * + * * @since 7.4 * @return the method targeted by this invocation */ diff --git a/client/src/main/java/com/vaadin/client/communication/RpcProxy.java b/client/src/main/java/com/vaadin/client/communication/RpcProxy.java index 83de44afb4..8808a8a6ef 100644 --- a/client/src/main/java/com/vaadin/client/communication/RpcProxy.java +++ b/client/src/main/java/com/vaadin/client/communication/RpcProxy.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -25,7 +25,7 @@ import com.vaadin.shared.communication.ServerRpc; /** * Class for creating proxy instances for Client to Server RPC. - * + * * @since 7.0 */ public class RpcProxy { diff --git a/client/src/main/java/com/vaadin/client/communication/ServerRpcQueue.java b/client/src/main/java/com/vaadin/client/communication/ServerRpcQueue.java index 27bebe4347..2c3fe563c0 100644 --- a/client/src/main/java/com/vaadin/client/communication/ServerRpcQueue.java +++ b/client/src/main/java/com/vaadin/client/communication/ServerRpcQueue.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -38,7 +38,7 @@ import elemental.json.JsonValue; /** * Manages the queue of server invocations (RPC) which are waiting to be sent to * the server. - * + * * @since 7.6 * @author Vaadin Ltd */ @@ -83,7 +83,7 @@ public class ServerRpcQueue { /** * Removes any pending invocation of the given method from the queue - * + * * @param invocation * The invocation to remove */ @@ -100,7 +100,7 @@ public class ServerRpcQueue { /** * Adds an explicit RPC method invocation to the send queue. - * + * * @param invocation * RPC method invocation * @param delayed @@ -138,7 +138,7 @@ public class ServerRpcQueue { * Returns a collection of all queued method invocations * <p> * The returned collection must not be modified in any way - * + * * @return a collection of all queued method invocations */ public Collection<MethodInvocation> getAll() { @@ -157,7 +157,7 @@ public class ServerRpcQueue { /** * Returns the current size of the queue - * + * * @return the number of invocations in the queue */ public int size() { @@ -166,7 +166,7 @@ public class ServerRpcQueue { /** * Returns the server RPC queue for the given application - * + * * @param connection * the application connection which owns the queue * @return the server rpc queue for the given application @@ -177,7 +177,7 @@ public class ServerRpcQueue { /** * Checks if the queue is empty - * + * * @return true if the queue is empty, false otherwise */ public boolean isEmpty() { @@ -211,7 +211,7 @@ public class ServerRpcQueue { /** * Checks if a flush operation is pending - * + * * @return true if a flush is pending, false otherwise */ public boolean isFlushPending() { @@ -221,7 +221,7 @@ public class ServerRpcQueue { /** * Checks if a loading indicator should be shown when the RPCs have been * sent to the server and we are waiting for a response - * + * * @return true if a loading indicator should be shown, false otherwise */ public boolean showLoadingIndicator() { @@ -242,7 +242,7 @@ public class ServerRpcQueue { /** * Returns the current invocations as JSON - * + * * @return the current invocations in a JSON format ready to be sent to the * server */ @@ -300,7 +300,7 @@ public class ServerRpcQueue { /** * Checks if the connector with the given id is still ok to use (has not * been removed) - * + * * @param connectorId * the connector id to check * @return true if the connector exists, false otherwise @@ -313,7 +313,7 @@ public class ServerRpcQueue { /** * Checks if the given method invocation originates from Javascript - * + * * @param invocation * the invocation to check * @return true if the method invocation originates from javascript, false @@ -326,7 +326,7 @@ public class ServerRpcQueue { /** * Checks if the given method invocation represents a Vaadin 6 variable * change - * + * * @param invocation * the invocation to check * @return true if the method invocation is a legacy variable change, false diff --git a/client/src/main/java/com/vaadin/client/communication/StateChangeEvent.java b/client/src/main/java/com/vaadin/client/communication/StateChangeEvent.java index ba96d64518..136e285a86 100644 --- a/client/src/main/java/com/vaadin/client/communication/StateChangeEvent.java +++ b/client/src/main/java/com/vaadin/client/communication/StateChangeEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -65,7 +65,7 @@ public class StateChangeEvent /** * Creates a new state change event. - * + * * @param connector * the event whose state has changed * @param changedPropertiesSet @@ -89,7 +89,7 @@ public class StateChangeEvent /** * Creates a new state change event. - * + * * @param connector * the event whose state has changed * @param changedProperties @@ -107,7 +107,7 @@ public class StateChangeEvent /** * /** Creates a new state change event. - * + * * @param connector * the event whose state has changed * @param stateJson @@ -131,7 +131,7 @@ public class StateChangeEvent /** * Event handler that gets notified whenever any part of the state has been * updated by the server. - * + * * @author Vaadin Ltd * @version @VERSION@ * @since 7.0.0 @@ -139,7 +139,7 @@ public class StateChangeEvent public interface StateChangeHandler extends Serializable, EventHandler { /** * Notifies the event handler that the state has changed. - * + * * @param stateChangeEvent * the state change event with details about the change */ @@ -148,9 +148,9 @@ public class StateChangeEvent /** * Gets the properties that have changed. - * + * * @return a set of names of the changed properties - * + * * @deprecated As of 7.0.1, use {@link #hasPropertyChanged(String)} instead * for improved performance. */ @@ -167,9 +167,9 @@ public class StateChangeEvent /** * Gets the properties that have changed. - * + * * @return a set of names of the changed properties - * + * * @deprecated As of 7.0.1, use {@link #hasPropertyChanged(String)} instead * for improved performance. */ @@ -195,7 +195,7 @@ public class StateChangeEvent /** * Checks whether the give property has changed. - * + * * @param property * the name of the property to check * @return <code>true</code> if the property has changed, else @@ -226,7 +226,7 @@ public class StateChangeEvent /** * Checks whether the given property name (which might contains dots) is * defined in some JavaScript object. - * + * * @param property * the name of the property, might include dots to reference * inner objects @@ -257,7 +257,7 @@ public class StateChangeEvent /** * Recursively adds the names of all properties in the provided state type. - * + * * @param type * the type to process * @param changedProperties @@ -294,7 +294,7 @@ public class StateChangeEvent /** * Recursively adds the names of all fields in all objects in the provided * json object. - * + * * @param json * the json object to process * @param changedProperties @@ -319,7 +319,7 @@ public class StateChangeEvent /** * Checks if the state change event is the first one for the given * connector. - * + * * @since 7.1 * @return true if this is the first state change event for the connector, * false otherwise diff --git a/client/src/main/java/com/vaadin/client/communication/XhrConnection.java b/client/src/main/java/com/vaadin/client/communication/XhrConnection.java index 3e7a86d4ac..69c9be8b21 100644 --- a/client/src/main/java/com/vaadin/client/communication/XhrConnection.java +++ b/client/src/main/java/com/vaadin/client/communication/XhrConnection.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -45,7 +45,7 @@ import elemental.json.JsonObject; /** * Provides a connection to the /UIDL url on the server and knows how to send * messages to that end point - * + * * @since 7.6 * @author Vaadin Ltd */ @@ -119,7 +119,7 @@ public class XhrConnection { /** * Sets the payload which was sent to the server - * + * * @param payload * the payload which was sent to the server */ @@ -169,7 +169,7 @@ public class XhrConnection { /** * Sets the relative time (see {@link Profiler#getRelativeTimeMillis()}) * when the request was sent. - * + * * @param requestStartTime * the relative time when the request was sent */ @@ -181,7 +181,7 @@ public class XhrConnection { /** * Sends an asynchronous UIDL request to the server using the given URI. - * + * * @param payload * The URI to use for the request. May includes GET parameters * @throws RequestException @@ -227,7 +227,7 @@ public class XhrConnection { /** * Retrieves the URI to use when sending RPCs to the server - * + * * @return The URI to use for server messages. */ protected String getUri() { diff --git a/client/src/main/java/com/vaadin/client/communication/XhrConnectionError.java b/client/src/main/java/com/vaadin/client/communication/XhrConnectionError.java index 025f1d70e7..ff39e47f11 100644 --- a/client/src/main/java/com/vaadin/client/communication/XhrConnectionError.java +++ b/client/src/main/java/com/vaadin/client/communication/XhrConnectionError.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -23,7 +23,7 @@ import elemental.json.JsonObject; /** * XhrConnectionError provides detail about an error which occured during an XHR * request to the server - * + * * @since 7.6 * @author Vaadin Ltd */ @@ -36,7 +36,7 @@ public class XhrConnectionError { /** * Constructs an event from the given request, payload and exception - * + * * @param request * the request which failed * @param payload @@ -53,7 +53,7 @@ public class XhrConnectionError { /** * Constructs an event from the given request, response and payload - * + * * @param request * the request which failed * @param payload @@ -70,7 +70,7 @@ public class XhrConnectionError { /** * Returns the exception which caused the problem, if available - * + * * @return the exception which caused the problem, or null if not available */ public Throwable getException() { @@ -79,7 +79,7 @@ public class XhrConnectionError { /** * Returns the request for which the problem occurred - * + * * @return the request where the problem occurred */ public Request getRequest() { @@ -88,7 +88,7 @@ public class XhrConnectionError { /** * Returns the received response, if available - * + * * @return the received response, or null if not available */ public Response getResponse() { @@ -97,7 +97,7 @@ public class XhrConnectionError { /** * Returns the payload which was sent to the server - * + * * @return the payload which was sent, never null */ public JsonObject getPayload() { diff --git a/client/src/main/java/com/vaadin/client/componentlocator/ComponentLocator.java b/client/src/main/java/com/vaadin/client/componentlocator/ComponentLocator.java index 7b01fd8742..f7c821d0a2 100644 --- a/client/src/main/java/com/vaadin/client/componentlocator/ComponentLocator.java +++ b/client/src/main/java/com/vaadin/client/componentlocator/ComponentLocator.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -30,7 +30,7 @@ import com.vaadin.client.ApplicationConnection; * <p> * The main use for this class is locating components for automated testing * purposes. - * + * * @since 7.2, moved from {@link com.vaadin.client.ComponentLocator} */ public class ComponentLocator { @@ -45,7 +45,7 @@ public class ComponentLocator { /** * Construct a ComponentLocator for the given ApplicationConnection. - * + * * @param client * ApplicationConnection instance for the application. */ @@ -67,7 +67,7 @@ public class ComponentLocator { * element if the widget determines an action on the other element will give * the same result as the action on the target element. * </p> - * + * * @since 5.4 * @param targetElement * The element to generate a path for. @@ -99,7 +99,7 @@ public class ComponentLocator { * element if the widget determines an action on the other element will give * the same result as the action on the target element. * </p> - * + * * @since 7.2 * @param targetElement * The element to generate a path for. @@ -118,7 +118,7 @@ public class ComponentLocator { * element. The {@link #getPathForElement(Element)} method can be used for * the inverse operation, i.e. generating a string expression for a DOM * element. - * + * * @since 5.4 * @param path * The String locator which identifies the target element. @@ -140,7 +140,7 @@ public class ComponentLocator { /** * Locates elements using a String locator (path) which identifies DOM * elements. - * + * * @since 7.2 * @param path * The String locator which identifies target elements. @@ -166,9 +166,9 @@ public class ComponentLocator { /** * Locates elements using a String locator (path) which identifies DOM * elements. The path starts from the specified root element. - * + * * @see #getElementByPath(String) - * + * * @since 7.2 * @param path * The path of elements to be found @@ -198,11 +198,11 @@ public class ComponentLocator { /** * Locates an element using a String locator (path) which identifies a DOM * element. The path starts from the specified root element. - * + * * @see #getElementByPath(String) - * + * * @since 7.2 - * + * * @param path * The path of the element to be found * @param root @@ -228,7 +228,7 @@ public class ComponentLocator { * Returns the {@link ApplicationConnection} used by this locator. * <p> * This method is primarily for internal use by the framework. - * + * * @return the application connection */ public ApplicationConnection getClient() { @@ -237,7 +237,7 @@ public class ComponentLocator { /** * Check if a given selector is valid for LegacyLocatorStrategy. - * + * * @param path * Vaadin selector path * @return true if passes path validation with LegacyLocatorStrategy diff --git a/client/src/main/java/com/vaadin/client/componentlocator/LegacyLocatorStrategy.java b/client/src/main/java/com/vaadin/client/componentlocator/LegacyLocatorStrategy.java index 77d618aed4..9e36e18162 100644 --- a/client/src/main/java/com/vaadin/client/componentlocator/LegacyLocatorStrategy.java +++ b/client/src/main/java/com/vaadin/client/componentlocator/LegacyLocatorStrategy.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -51,7 +51,7 @@ import com.vaadin.shared.communication.SharedState; * The LegacyLocatorStrategy class handles the legacy locator syntax that was * introduced in version 5.4 of the framework. The legacy locator strategy is * always used if no other strategy claims responsibility for a locator string. - * + * * @since 7.2 * @author Vaadin Ltd */ @@ -269,7 +269,7 @@ public class LegacyLocatorStrategy implements LocatorStrategy { * Finds the first widget in the hierarchy (moving upwards) that implements * SubPartAware. Returns the SubPartAware implementor or null if none is * found. - * + * * @param w * The widget to start from. This is returned if it implements * SubPartAware. @@ -291,7 +291,7 @@ public class LegacyLocatorStrategy implements LocatorStrategy { * Returns the first widget found when going from {@code targetElement} * upwards in the DOM hierarchy, assuming that {@code ancestorWidget} is a * parent of {@code targetElement}. - * + * * @param targetElement * @param ancestorWidget * @return The widget whose root element is a parent of @@ -318,7 +318,7 @@ public class LegacyLocatorStrategy implements LocatorStrategy { /** * Locates an element based on a DOM path and a base element. - * + * * @param baseElement * The base element which the path is relative to * @param path @@ -377,7 +377,7 @@ public class LegacyLocatorStrategy implements LocatorStrategy { /** * Generates a String locator using domChild[x] parts for the element * relative to the baseElement. - * + * * @param element * The target element * @param baseElement @@ -424,7 +424,7 @@ public class LegacyLocatorStrategy implements LocatorStrategy { * <p/> * Returns null if no path can be determined for the widget or if the widget * is null. - * + * * @param w * The target widget * @return A String locator for the widget @@ -489,7 +489,7 @@ public class LegacyLocatorStrategy implements LocatorStrategy { /** * Locates the widget based on a String locator. - * + * * @param path * The String locator that identifies the widget. * @param baseWidget diff --git a/client/src/main/java/com/vaadin/client/componentlocator/LocatorStrategy.java b/client/src/main/java/com/vaadin/client/componentlocator/LocatorStrategy.java index 15a156a815..8aafdbaf0a 100644 --- a/client/src/main/java/com/vaadin/client/componentlocator/LocatorStrategy.java +++ b/client/src/main/java/com/vaadin/client/componentlocator/LocatorStrategy.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -25,7 +25,7 @@ import com.google.gwt.dom.client.Element; * an element in the DOM. A strategy can implement its own syntax for the * locator string, which may be completely different from any other strategy's * syntax. - * + * * @since 7.2 * @author Vaadin Ltd */ @@ -34,7 +34,7 @@ public interface LocatorStrategy { /** * Test the given input path for formatting errors. If a given path can not * be validated, the locator strategy will not be attempted. - * + * * @param path * a locator path expression * @return true, if the implementing class can process the given path, @@ -53,7 +53,7 @@ public interface LocatorStrategy { * element if the widget determines an action on the other element will give * the same result as the action on the target element. * </p> - * + * * @param targetElement * The element to generate a path for. * @return A String locator that identifies the target element or null if a @@ -66,7 +66,7 @@ public interface LocatorStrategy { * element. The {@link #getPathForElement(Element)} method can be used for * the inverse operation, i.e. generating a string expression for a DOM * element. - * + * * @param path * The String locator which identifies the target element. * @return The DOM element identified by {@code path} or null if the element @@ -77,9 +77,9 @@ public interface LocatorStrategy { /** * Locates an element using a String locator (path) which identifies a DOM * element. The path starts from the specified root element. - * + * * @see #getElementByPath(String) - * + * * @param path * The String locator which identifies the target element. * @param root @@ -92,9 +92,9 @@ public interface LocatorStrategy { /** * Locates all elements that match a String locator (path) which identifies * DOM elements. - * + * * This functionality is limited in {@link LegacyLocatorStrategy}. - * + * * @param path * The String locator which identifies target elements. * @return List that contains all matched elements. Empty list if none @@ -105,11 +105,11 @@ public interface LocatorStrategy { /** * Locates all elements that match a String locator (path) which identifies * DOM elements. The path starts from the specified root element. - * + * * This functionality is limited in {@link LegacyLocatorStrategy}. - * + * * @see #getElementsByPath(String) - * + * * @param path * The String locator which identifies target elements. * @param root diff --git a/client/src/main/java/com/vaadin/client/componentlocator/LocatorUtil.java b/client/src/main/java/com/vaadin/client/componentlocator/LocatorUtil.java index 7de0de3855..5a1203f664 100644 --- a/client/src/main/java/com/vaadin/client/componentlocator/LocatorUtil.java +++ b/client/src/main/java/com/vaadin/client/componentlocator/LocatorUtil.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.google.gwt.regexp.shared.RegExp; /** * Common String manipulator utilities used in VaadinFinderLocatorStrategy and * SelectorPredicates. - * + * * @since 7.2 * @author Vaadin Ltd */ @@ -29,7 +29,7 @@ public class LocatorUtil { /** * Find first occurrence of character that's not inside quotes starting from * specified index. - * + * * @param str * Full string for searching * @param find @@ -65,7 +65,7 @@ public class LocatorUtil { /** * Find first occurrence of character that's not inside quotes starting from * the beginning of string. - * + * * @param str * Full string for searching * @param find @@ -78,7 +78,7 @@ public class LocatorUtil { /** * Checks if path refers to vaadin UI element com.vaadin.ui.UI. - * + * * @param path * to vaadin element * @return true if path refers to UI element, false otherwise @@ -92,7 +92,7 @@ public class LocatorUtil { /** * Checks if path refers to vaadin Notification element * com.vaadin.ui.Notification. - * + * * @param path * to vaadin element * @return true if path refers to Notification element, false otherwise diff --git a/client/src/main/java/com/vaadin/client/componentlocator/SelectorPredicate.java b/client/src/main/java/com/vaadin/client/componentlocator/SelectorPredicate.java index 6c9a6af54b..7143bbf62b 100644 --- a/client/src/main/java/com/vaadin/client/componentlocator/SelectorPredicate.java +++ b/client/src/main/java/com/vaadin/client/componentlocator/SelectorPredicate.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -23,7 +23,7 @@ import java.util.List; * that VaadinFinderLocatorStrategy is finding. SelectorPredicates also provide * useful information of said components to debug window by giving means to * provide better variable naming. - * + * * @since 7.2 * @author Vaadin Ltd */ @@ -43,7 +43,7 @@ public class SelectorPredicate { /** * Generate a list of predicates from a single predicate string - * + * * @param str * a comma separated string of predicates * @return a List of Predicate objects @@ -108,7 +108,7 @@ public class SelectorPredicate { /** * Splits the predicate string to list of predicate strings. - * + * * @param predicateStr * Comma separated predicate strings * @return List of predicate strings @@ -134,7 +134,7 @@ public class SelectorPredicate { * VTextField[0] => 0 * VTextField[caption='foo'] => caption='foo' * </code> - * + * * @param pathFragment * The path fragment from which to extract the predicate string. * @return The predicate string for the path fragment or empty string if not @@ -153,7 +153,7 @@ public class SelectorPredicate { /** * Removes the surrounding quotes from a string if it is quoted. - * + * * @param str * the possibly quoted string * @return an unquoted version of str diff --git a/client/src/main/java/com/vaadin/client/componentlocator/VaadinFinderLocatorStrategy.java b/client/src/main/java/com/vaadin/client/componentlocator/VaadinFinderLocatorStrategy.java index 263031e13c..9356d5e34a 100644 --- a/client/src/main/java/com/vaadin/client/componentlocator/VaadinFinderLocatorStrategy.java +++ b/client/src/main/java/com/vaadin/client/componentlocator/VaadinFinderLocatorStrategy.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -40,7 +40,7 @@ import com.vaadin.client.ui.ui.UIConnector; * The VaadinFinder locator strategy implements an XPath-like syntax for * locating elements in Vaadin applications. This is used in the new * VaadinFinder API in TestBench 4. - * + * * Examples of the supported syntax: * <ul> * <li>Find the third text field in the DOM: {@code //VTextField[2]}</li> @@ -49,7 +49,7 @@ import com.vaadin.client.ui.ui.UIConnector; * <li>Find the first column on the third row of the "Accounts" table: * {@code //VScrollTable[caption="Accounts"]#row[2]/col[0]}</li> * </ul> - * + * * @since 7.2 * @author Vaadin Ltd */ @@ -130,7 +130,7 @@ public class VaadinFinderLocatorStrategy implements LocatorStrategy { * Search different queries for the best one. Use the fact that the lowest * possible index is with the last selector. Last selector is the full * search path containing the complete Component hierarchy. - * + * * @param selectors * List of selectors * @param target @@ -175,7 +175,7 @@ public class VaadinFinderLocatorStrategy implements LocatorStrategy { * Function to generate all possible search paths for given component list. * Function strips out all the com.vaadin.ui. prefixes from elements as this * functionality makes generating a query later on easier. - * + * * @param components * List of components * @return List of Vaadin selectors @@ -210,7 +210,7 @@ public class VaadinFinderLocatorStrategy implements LocatorStrategy { /** * Helper method to get the string-form value of a named property of a * component connector - * + * * @since 7.2 * @param c * any ComponentConnector instance @@ -233,7 +233,7 @@ public class VaadinFinderLocatorStrategy implements LocatorStrategy { * Generate a list representing the top-to-bottom connector hierarchy for * any given element. ConnectorPath element provides long- and short names, * as well as connector and widget root element references. - * + * * @since 7.2 * @param elem * any Element that is part of a widget hierarchy @@ -376,7 +376,7 @@ public class VaadinFinderLocatorStrategy implements LocatorStrategy { /** * Special case for finding notifications as they have no connectors and are * directly attached to {@link RootPanel}. - * + * * @param path * The path of the notification, should be * {@code "//VNotification"} optionally followed by an index in @@ -412,7 +412,7 @@ public class VaadinFinderLocatorStrategy implements LocatorStrategy { /** * Finds a list of elements by the specified path, starting traversal of the * connector hierarchy from the specified root. - * + * * @param path * the locator path * @param root @@ -458,7 +458,7 @@ public class VaadinFinderLocatorStrategy implements LocatorStrategy { * Recursively finds connectors for the elements identified by the provided * path by traversing the connector hierarchy starting from {@code parents} * connectors. - * + * * @param path * The path identifying elements. * @param parents @@ -492,7 +492,7 @@ public class VaadinFinderLocatorStrategy implements LocatorStrategy { * Go through a list of potentially matching components, modifying that list * until all elements that remain in that list match the complete list of * predicates. - * + * * @param potentialMatches * a list of component connectors. Will be changed. * @param predicates @@ -539,10 +539,10 @@ public class VaadinFinderLocatorStrategy implements LocatorStrategy { * Collects all connectors that match the widget class name of the path * fragment. If the {@code collectRecursively} parameter is true, a * depth-first search of the connector hierarchy is performed. - * + * * Searching depth-first ensure that we can return the matches in correct * order for selecting based on index predicates. - * + * * @param parent * The {@link ComponentConnector} to start the search from. * @param pathFragment @@ -596,7 +596,7 @@ public class VaadinFinderLocatorStrategy implements LocatorStrategy { * Determines whether a connector matches a path fragment. This is done by * comparing the path fragment to the name of the widget type of the * connector. - * + * * @param connector * The connector to compare. * @param widgetName @@ -657,7 +657,7 @@ public class VaadinFinderLocatorStrategy implements LocatorStrategy { /** * Extracts the name of the widget class from a path fragment - * + * * @param pathFragment * the path fragment * @return the name of the widget class. @@ -676,7 +676,7 @@ public class VaadinFinderLocatorStrategy implements LocatorStrategy { * two elements, where the first element is the first path fragment and the * second element is the rest of the path (all remaining path fragments * untouched). - * + * * @param path * The path to split. * @return An array of two elements: The first path fragment and the rest of @@ -708,7 +708,7 @@ public class VaadinFinderLocatorStrategy implements LocatorStrategy { /* * (non-Javadoc) - * + * * @see * com.vaadin.client.componentlocator.LocatorStrategy#validatePath(java. * lang.String) @@ -725,9 +725,9 @@ public class VaadinFinderLocatorStrategy implements LocatorStrategy { * Go through a list, removing all duplicate elements from it. This method * is used to avoid accumulation of duplicate entries in result lists * resulting from low-context recursion. - * + * * Preserves first entry in list, removes others. Preserves list order. - * + * * @return list passed as parameter, after modification */ private final <T> List<T> eliminateDuplicates(List<T> list) { diff --git a/client/src/main/java/com/vaadin/client/connectors/AbstractRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/AbstractRendererConnector.java index cc59ca5088..6d522ace5b 100644 --- a/client/src/main/java/com/vaadin/client/connectors/AbstractRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/AbstractRendererConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -36,10 +36,10 @@ import elemental.json.JsonValue; * state and information between the client and the server. This base class * itself only uses the basic {@link com.vaadin.shared.communication.SharedState * SharedState} and no RPC interfaces. - * + * * @param <T> * the presentation type of the renderer - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -67,13 +67,13 @@ public abstract class AbstractRendererConnector<T> * {@link com.google.gwt.core.client.GWT#create(Class) GWT.create(Class)} to * create a renderer based on the return type of the overridden method, but * only if {@link #createRenderer()} is not overridden as well: - * + * * <pre> * public MyRenderer getRenderer() { * return (MyRenderer) super.getRenderer(); * } * </pre> - * + * * @return the renderer bound to this connector */ public Renderer<T> getRenderer() { @@ -93,7 +93,7 @@ public abstract class AbstractRendererConnector<T> * {@link #getRenderer()}. If you do override the method, you can't call * <code>super.createRenderer()</code> since the metadata needed for that * implementation is not generated if there's an override of the method. - * + * * @return a new renderer to be used with this connector */ protected Renderer<T> createRenderer() { @@ -118,7 +118,7 @@ public abstract class AbstractRendererConnector<T> /** * Decodes the given JSON value into a value of type T so it can be passed * to the {@link #getRenderer() renderer}. - * + * * @param value * the value to decode * @return the decoded value of {@code value} @@ -142,7 +142,7 @@ public abstract class AbstractRendererConnector<T> * In case this renderer wants be able to identify a row in such a way that * the server also understands it, the row key is used for that. Rows are * identified by unified keys between the client and the server. - * + * * @param row * the row object * @return the row key for the given row @@ -163,7 +163,7 @@ public abstract class AbstractRendererConnector<T> * In case this renderer wants be able to identify a column in such a way * that the server also understands it, the column id is used for that. * Columns are identified by unified ids between the client and the server. - * + * * @param column * the column object * @return the column id for the given column diff --git a/client/src/main/java/com/vaadin/client/connectors/AbstractSelectionModelConnector.java b/client/src/main/java/com/vaadin/client/connectors/AbstractSelectionModelConnector.java index 45c8f3002d..1fb98224bd 100644 --- a/client/src/main/java/com/vaadin/client/connectors/AbstractSelectionModelConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/AbstractSelectionModelConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -27,7 +27,7 @@ import elemental.json.JsonObject; /** * Base class for all selection model connectors. - * + * * @since 7.6 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/connectors/ButtonRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/ButtonRendererConnector.java index caa571c355..b2c8a5f70d 100644 --- a/client/src/main/java/com/vaadin/client/connectors/ButtonRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/ButtonRendererConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,7 +24,7 @@ import elemental.json.JsonObject; /** * A connector for {@link ButtonRenderer}. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/connectors/ClickableRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/ClickableRendererConnector.java index 43874e767b..ec4333be81 100644 --- a/client/src/main/java/com/vaadin/client/connectors/ClickableRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/ClickableRendererConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -26,10 +26,10 @@ import elemental.json.JsonObject; /** * An abstract base class for {@link ClickableRenderer} connectors. - * + * * @param <T> * the presentation type of the renderer - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/connectors/DateRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/DateRendererConnector.java index c861df6369..4de1cca075 100644 --- a/client/src/main/java/com/vaadin/client/connectors/DateRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/DateRendererConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,7 +24,7 @@ import com.vaadin.shared.ui.Connect; * The server-side Renderer operates on dates, but the data is serialized as a * string, and displayed as-is on the client side. This is to be able to support * the server's locale. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/connectors/DetailComponentManagerConnector.java b/client/src/main/java/com/vaadin/client/connectors/DetailComponentManagerConnector.java index cf5b63d4ae..63822ca9b3 100644 --- a/client/src/main/java/com/vaadin/client/connectors/DetailComponentManagerConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/DetailComponentManagerConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -22,7 +22,7 @@ import com.vaadin.ui.Grid.DetailComponentManager; /** * Client-side connector for the DetailComponentManager of Grid. - * + * * @since 7.6.1 */ @Connect(DetailComponentManager.class) diff --git a/client/src/main/java/com/vaadin/client/connectors/GridConnector.java b/client/src/main/java/com/vaadin/client/connectors/GridConnector.java index 6045d31944..ddde546da9 100644 --- a/client/src/main/java/com/vaadin/client/connectors/GridConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/GridConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -106,7 +106,7 @@ import elemental.json.JsonValue; * The Grid is typed to JSONObject. The structure of the JSONObject is described * at {@link com.vaadin.shared.data.DataProviderRpc#setRowData(int, List) * DataProviderRpc.setRowData(int, List)}. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -175,7 +175,7 @@ public class GridConnector extends AbstractHasComponentsConnector /** * Sets a new renderer for this column object - * + * * @param rendererConnector * a renderer connector object */ @@ -350,7 +350,7 @@ public class GridConnector extends AbstractHasComponentsConnector * Used to handle the case where the editor calls us because it was * invoked by the server via RPC and not by the client. In that case, * the request can be simply synchronously completed. - * + * * @param request * the request object * @return true if the request was originally triggered by the server, @@ -526,7 +526,7 @@ public class GridConnector extends AbstractHasComponentsConnector /** * Fetches id from the row object that corresponds with the given * rowIndex. - * + * * @since 7.6.1 * @param rowIndex * the index of the row for which to fetch the id @@ -576,7 +576,7 @@ public class GridConnector extends AbstractHasComponentsConnector /** * Class for handling scrolling issues with open details. - * + * * @since 7.5.2 */ private class LazyDetailsScroller implements DeferredWorker { @@ -606,7 +606,7 @@ public class GridConnector extends AbstractHasComponentsConnector /** * Inform LazyDetailsScroller that a details row has opened on a row. - * + * * @param rowIndex * index of row with details now open */ @@ -1028,7 +1028,7 @@ public class GridConnector extends AbstractHasComponentsConnector /** * Updates a column from a state change event. - * + * * @param columnIndex * The index of the column to update */ @@ -1042,7 +1042,7 @@ public class GridConnector extends AbstractHasComponentsConnector /** * Adds a new column to the grid widget from a state change event - * + * * @param columnIndex * The index of the column, according to how it */ @@ -1061,7 +1061,7 @@ public class GridConnector extends AbstractHasComponentsConnector /** * Updates the column values from a state - * + * * @param column * The column to update * @param state @@ -1145,7 +1145,7 @@ public class GridConnector extends AbstractHasComponentsConnector /** * Gets the row key for a row object. - * + * * @param row * the row object * @return the key for the given row @@ -1159,7 +1159,7 @@ public class GridConnector extends AbstractHasComponentsConnector /* * (non-Javadoc) - * + * * @see * com.vaadin.client.HasComponentsConnector#updateCaption(com.vaadin.client * .ComponentConnector) @@ -1195,7 +1195,7 @@ public class GridConnector extends AbstractHasComponentsConnector /** * Gets the listener used by this connector for tracking when row detail * visibility changes. - * + * * @since 7.5.0 * @return the used details listener */ @@ -1278,7 +1278,7 @@ public class GridConnector extends AbstractHasComponentsConnector /** * Creates a concatenation of all columns errors for Editor. - * + * * @since 7.6 * @return displayed error string */ diff --git a/client/src/main/java/com/vaadin/client/connectors/ImageRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/ImageRendererConnector.java index f7690cb6fe..4961a52a3f 100644 --- a/client/src/main/java/com/vaadin/client/connectors/ImageRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/ImageRendererConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -28,7 +28,7 @@ import elemental.json.JsonValue; /** * A connector for {@link ImageRenderer}. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/connectors/JavaScriptRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/JavaScriptRendererConnector.java index 70d3da211a..503884b566 100644 --- a/client/src/main/java/com/vaadin/client/connectors/JavaScriptRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/JavaScriptRendererConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -38,7 +38,7 @@ import elemental.json.JsonValue; /** * Connector for server-side renderer implemented using JavaScript. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -70,7 +70,7 @@ public class JavaScriptRendererConnector // IE8 only supports defineProperty for DOM objects reference = $doc.createElement('div'); } - + var setProperty = function(name, getter, setter) { var descriptor = { get: getter @@ -80,25 +80,25 @@ public class JavaScriptRendererConnector } Object.defineProperty(reference, name, descriptor); }; - + setProperty("element", function() { return reference.target.@CellReference::getElement()(); }, null); - + setProperty("rowIndex", function() { return reference.target.@CellReference::getRowIndex()(); }, null); - + setProperty("columnIndex", function() { return reference.target.@CellReference::getColumnIndex()(); }, null); - + setProperty("colSpan", function() { return reference.target.@RendererCellReference::getColSpan()(); }, function(colSpan) { reference.target.@RendererCellReference::setColSpan(*)(colSpan); }); - + return reference; }-*/; diff --git a/client/src/main/java/com/vaadin/client/connectors/MultiSelectionModelConnector.java b/client/src/main/java/com/vaadin/client/connectors/MultiSelectionModelConnector.java index d7e1580b7b..748e9b1acf 100644 --- a/client/src/main/java/com/vaadin/client/connectors/MultiSelectionModelConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/MultiSelectionModelConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -52,7 +52,7 @@ import elemental.json.JsonObject; /** * Connector for server-side {@link MultiSelectionModel}. - * + * * @since 7.6 * @author Vaadin Ltd */ @@ -139,7 +139,7 @@ public class MultiSelectionModelConnector extends * Creates a selection column renderer. This method can be overridden to * use a custom renderer or use {@code null} to disable the selection * column. - * + * * @param grid * the grid for this selection model * @return selection column renderer or {@code null} if not needed @@ -176,7 +176,7 @@ public class MultiSelectionModelConnector extends /** * {@inheritDoc} - * + * * @return {@code false} if rows is empty, else {@code true} */ @Override @@ -186,7 +186,7 @@ public class MultiSelectionModelConnector extends /** * {@inheritDoc} - * + * * @return {@code false} if rows is empty, else {@code true} */ @Override @@ -196,7 +196,7 @@ public class MultiSelectionModelConnector extends /** * {@inheritDoc} - * + * * @return always {@code true} */ @Override @@ -220,7 +220,7 @@ public class MultiSelectionModelConnector extends /** * {@inheritDoc} - * + * * @return {@code false} if rows is empty, else {@code true} */ @Override @@ -248,7 +248,7 @@ public class MultiSelectionModelConnector extends * <p> * Note: If selection model is in batch select state, the row will be * pinned on select. - * + * * @param row * row handle * @param selected @@ -276,7 +276,7 @@ public class MultiSelectionModelConnector extends /** * {@inheritDoc} - * + * * @return {@code false} if rows is empty, else {@code true} */ @Override diff --git a/client/src/main/java/com/vaadin/client/connectors/NoSelectionModelConnector.java b/client/src/main/java/com/vaadin/client/connectors/NoSelectionModelConnector.java index e0c88f5fa1..b0d6e364b5 100644 --- a/client/src/main/java/com/vaadin/client/connectors/NoSelectionModelConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/NoSelectionModelConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -25,7 +25,7 @@ import elemental.json.JsonObject; /** * Connector for server-side {@link NoSelectionModel}. - * + * * @since 7.6 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/connectors/NumberRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/NumberRendererConnector.java index 98c4d64e9f..9b94b82e4c 100644 --- a/client/src/main/java/com/vaadin/client/connectors/NumberRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/NumberRendererConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,7 +24,7 @@ import com.vaadin.shared.ui.Connect; * The server-side Renderer operates on numbers, but the data is serialized as a * string, and displayed as-is on the client side. This is to be able to support * the server's locale. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/connectors/ProgressBarRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/ProgressBarRendererConnector.java index ea8215330b..7ab9923b57 100644 --- a/client/src/main/java/com/vaadin/client/connectors/ProgressBarRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/ProgressBarRendererConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.shared.ui.Connect; /** * A connector for {@link ProgressBarRenderer}. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/connectors/RpcDataSourceConnector.java b/client/src/main/java/com/vaadin/client/connectors/RpcDataSourceConnector.java index bd05ea0d34..a9837fa06b 100644 --- a/client/src/main/java/com/vaadin/client/connectors/RpcDataSourceConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/RpcDataSourceConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -38,7 +38,7 @@ import elemental.json.JsonObject; * currently implemented as an Extension hardcoded to support a specific * connector type. This will be changed once framework support for something * more flexible has been implemented. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -48,7 +48,7 @@ public class RpcDataSourceConnector extends AbstractExtensionConnector { /** * A callback interface to let {@link GridConnector} know that detail * visibilities might have changed. - * + * * @since 7.5.0 * @author Vaadin Ltd */ @@ -57,7 +57,7 @@ public class RpcDataSourceConnector extends AbstractExtensionConnector { /** * A request to verify (and correct) the visibility for a row, given * updated metadata. - * + * * @param rowIndex * the index of the row that should be checked * @param row @@ -122,7 +122,7 @@ public class RpcDataSourceConnector extends AbstractExtensionConnector { /* * If you're looking at this code because you want to learn how to * use AbstactRemoteDataSource, please look somewhere else instead. - * + * * We're not doing things in the conventional way with the callback * here since Vaadin doesn't directly support RPC with return * values. We're instead asking the server to push us some data, and @@ -141,7 +141,7 @@ public class RpcDataSourceConnector extends AbstractExtensionConnector { * and some of the visible rows are being requested. The RPC in * itself will not trigger the indicator since it might just fetch * some rows in the background to fill the cache. - * + * * The indicator will be hidden by the framework when the response * is received (unless another request is already on its way at that * point). @@ -160,7 +160,7 @@ public class RpcDataSourceConnector extends AbstractExtensionConnector { * We trigger the indicator already at this point since the actual * RPC will not be sent right away when waiting for the response to * a previous request. - * + * * Only triggering here would not be enough since the check that * sets isWaitingForData is deferred. We don't want to trigger the * loading indicator here if we don't know that there is actually a @@ -222,7 +222,7 @@ public class RpcDataSourceConnector extends AbstractExtensionConnector { /** * Updates row data based on row key. - * + * * @since 7.6 * @param row * new row object diff --git a/client/src/main/java/com/vaadin/client/connectors/SingleSelectionModelConnector.java b/client/src/main/java/com/vaadin/client/connectors/SingleSelectionModelConnector.java index 0825db4d2f..ea0d6171af 100644 --- a/client/src/main/java/com/vaadin/client/connectors/SingleSelectionModelConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/SingleSelectionModelConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -33,7 +33,7 @@ import elemental.json.JsonObject; /** * Connector for server-side {@link SingleSelectionModel}. - * + * * @since 7.6 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/connectors/TextRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/TextRendererConnector.java index baf317510d..b5ad8fd67d 100644 --- a/client/src/main/java/com/vaadin/client/connectors/TextRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/TextRendererConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.shared.ui.Connect; /** * A connector for {@link TextRenderer}. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/connectors/UnsafeHtmlRendererConnector.java b/client/src/main/java/com/vaadin/client/connectors/UnsafeHtmlRendererConnector.java index e30f8dac99..726e823fba 100644 --- a/client/src/main/java/com/vaadin/client/connectors/UnsafeHtmlRendererConnector.java +++ b/client/src/main/java/com/vaadin/client/connectors/UnsafeHtmlRendererConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.vaadin.shared.ui.Connect; /** * A connector for {@link UnsafeHtmlRenderer} - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/data/AbstractRemoteDataSource.java b/client/src/main/java/com/vaadin/client/data/AbstractRemoteDataSource.java index e0c8612846..34342ebce9 100644 --- a/client/src/main/java/com/vaadin/client/data/AbstractRemoteDataSource.java +++ b/client/src/main/java/com/vaadin/client/data/AbstractRemoteDataSource.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -32,7 +32,7 @@ import com.vaadin.shared.ui.grid.Range; * user. An implementation of this class should override * {@link #requestRows(int, int, RequestRowsCallback)} to trigger asynchronously * loading of data and then pass the loaded data into the provided callback. - * + * * @since 7.4 * @author Vaadin Ltd * @param <T> @@ -52,7 +52,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { /** * Creates a new callback - * + * * @param source * the data source for which the request is made * @param requestedRange @@ -70,7 +70,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { * Called by the * {@link AbstractRemoteDataSource#requestRows(int, int, RequestRowsCallback)} * implementation when data has been received. - * + * * @param rowData * a list of row objects starting at the requested offset * @param totalSize @@ -85,7 +85,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { /** * Gets the range of rows that was requested. - * + * * @return the requsted row range */ public Range getRequestedRange() { @@ -105,7 +105,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { /** * A method for the data source to update the row data. - * + * * @param row * the updated row object */ @@ -204,7 +204,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { /** * Pins a row with given handle. This function can be overridden to do * specific logic related to pinning rows. - * + * * @param handle * row handle to pin */ @@ -221,10 +221,10 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { /** * Unpins a previously pinned row with given handle. This function can be * overridden to do specific logic related to unpinning rows. - * + * * @param handle * row handle to unpin - * + * * @throws IllegalStateException * if given row handle has not been pinned before */ @@ -257,7 +257,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { /** * Gets the row index range that was requested by the previous call to * {@link #ensureAvailability(int, int)}. - * + * * @return the requested availability range */ public Range getRequestedAvailability() { @@ -304,7 +304,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { /** * Checks whether this data source is currently waiting for more rows to * become available. - * + * * @return <code>true</code> if waiting for data; otherwise * <code>false</code> */ @@ -338,7 +338,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { * <p> * NOTE: This method has been replaced. Override * {@link #onDropFromCache(int, Object)} instead of this method. - * + * * @since 7.5.0 * @param rowIndex * the index of the dropped row @@ -353,7 +353,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { * A hook that can be overridden to do something whenever a row has been * dropped from the cache. DataSource no longer has anything in the given * index. - * + * * @since 7.6 * @param rowIndex * the index of the dropped row @@ -376,7 +376,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { /** * Triggers fetching rows from the remote data source. The provided callback * should be informed when the requested rows have been received. - * + * * @param firstRowIndex * the index of the first row to fetch * @param numberOfRows @@ -397,7 +397,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { * <p> * <em>Note:</em> This method does not verify that the given row object * exists at all in this DataSource. - * + * * @param row * the row object * @return index of the row; or <code>-1</code> if row is not available @@ -423,7 +423,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { /** * Informs this data source that updated data has been sent from the server. - * + * * @param firstRowIndex * the index of the first received row * @param rowData @@ -495,7 +495,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { if (!partition[0].isEmpty() || !partition[2].isEmpty()) { /* * FIXME - * + * * Got data that we might need in a moment if the container is * updated before the widget settings. Support for this will be * implemented later on. @@ -529,7 +529,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { /** * Informs this data source that the server has removed data. - * + * * @param firstRowIndex * the index of the first removed row * @param count @@ -575,7 +575,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { /** * Informs this data source that new data has been inserted from the server. - * + * * @param firstRowIndex * the destination index of the new row data * @param count @@ -601,7 +601,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { * We need to invalidate the cache from the inserted row onwards, * since the cache wants to be a contiguous range. It doesn't * support holes. - * + * * If holes were supported, we could shift the higher part of * "cached" and leave a hole the size of "count" in the middle. */ @@ -638,7 +638,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { /** * Gets the current range of cached rows - * + * * @return the range of currently cached rows */ public Range getCachedRange() { @@ -651,7 +651,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { * <p> * The new strategy is immediately used to evaluate whether currently cached * rows should be discarded or new rows should be fetched. - * + * * @param cacheStrategy * a cache strategy implementation, not <code>null</code> */ @@ -730,7 +730,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { * <p> * A very usual and simple example what this could be, is an unique ID for * this object that would also be stored in a database. - * + * * @param row * the row object for which to get the key * @return a non-null object that uniquely and consistently represents the @@ -752,7 +752,7 @@ public abstract class AbstractRemoteDataSource<T> implements DataSource<T> { * If you have information about the structure of the change, use * {@link #insertRowData(int, int)} or {@link #removeRowData(int, int)} to * indicate where the inserted or removed rows are located. - * + * * @param newSize * the new size of the container */ diff --git a/client/src/main/java/com/vaadin/client/data/CacheStrategy.java b/client/src/main/java/com/vaadin/client/data/CacheStrategy.java index 37701bd785..6a0f4452d2 100644 --- a/client/src/main/java/com/vaadin/client/data/CacheStrategy.java +++ b/client/src/main/java/com/vaadin/client/data/CacheStrategy.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.vaadin.shared.ui.grid.Range; /** * Determines what data an {@link AbstractRemoteDataSource} should fetch and * keep cached. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -61,7 +61,7 @@ public interface CacheStrategy { /** * Gets the maximum number of extra items to cache in one direction. - * + * * @param pageSize * the current number of items used at once * @return maximum of items to cache @@ -70,7 +70,7 @@ public interface CacheStrategy { /** * Gets the the minimum number of extra items to cache in one direction. - * + * * @param pageSize * the current number of items used at once * @return minimum number of items to cache @@ -103,7 +103,7 @@ public interface CacheStrategy { * Creates a DefaultCacheStrategy with custom ratios for how much data * to cache. The ratios denote how many multiples of the currently used * page size are kept in the cache in each direction. - * + * * @param minimumRatio * the minimum number of pages to keep in the cache in each * direction @@ -135,7 +135,7 @@ public interface CacheStrategy { * A cache strategy implementation cannot use this information to keep track * of which items are in the cache since the data source might discard items * without notifying the cache strategy. - * + * * @param roundTripTime * the total number of milliseconds elapsed from requesting the * data until the response was passed to the data source @@ -148,14 +148,14 @@ public interface CacheStrategy { * Gets the minimum row range that should be cached. The data source will * fetch new data if the currently cached range does not fill the entire * minimum cache range. - * + * * @param displayedRange * the range of currently displayed rows * @param cachedRange * the range of currently cached rows * @param estimatedAvailableRange * the estimated range of rows available for the data source - * + * * @return the minimum range of rows that should be cached, should at least * include the displayed range and should not exceed the total * estimated available range @@ -166,14 +166,14 @@ public interface CacheStrategy { /** * Gets the maximum row range that should be cached. The data source will * discard cached rows that are outside the maximum range. - * + * * @param displayedRange * the range of currently displayed rows * @param cachedRange * the range of currently cached rows * @param estimatedAvailableRange * the estimated range of rows available for the data source - * + * * @return the maximum range of rows that should be cached, should at least * include the displayed range and should not exceed the total * estimated available range diff --git a/client/src/main/java/com/vaadin/client/data/DataChangeHandler.java b/client/src/main/java/com/vaadin/client/data/DataChangeHandler.java index 35f1eafea9..7e34cf9386 100644 --- a/client/src/main/java/com/vaadin/client/data/DataChangeHandler.java +++ b/client/src/main/java/com/vaadin/client/data/DataChangeHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ package com.vaadin.client.data; /** * Callback interface used by {@link DataSource} to inform its user about * updates to the data. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -29,7 +29,7 @@ public interface DataChangeHandler { * rows has changed or if rows have been moved around, * {@link #dataAdded(int, int)} or {@link #dataRemoved(int, int)} should * ideally be used instead. - * + * * @param firstRowIndex * the index of the first changed row * @param numberOfRows @@ -39,7 +39,7 @@ public interface DataChangeHandler { /** * Called when rows have been removed from the data source. - * + * * @param firstRowIndex * the index that the first removed row had prior to removal * @param numberOfRows @@ -49,7 +49,7 @@ public interface DataChangeHandler { /** * Called when the new rows have been added to the container. - * + * * @param firstRowIndex * the index of the first added row * @param numberOfRows @@ -60,7 +60,7 @@ public interface DataChangeHandler { /** * Called when rows requested with * {@link DataSource#ensureAvailability(int, int)} rows are available. - * + * * @param firstRowIndex * the index of the first available row * @param numberOfRows @@ -74,7 +74,7 @@ public interface DataChangeHandler { * This should be used in the cases where the data has changed in some * unverifiable way. I.e. "something happened". This will lead to a * re-rendering of the current Grid viewport - * + * * @param estimatedNewDataSize * the estimated size of the new data set */ diff --git a/client/src/main/java/com/vaadin/client/data/DataSource.java b/client/src/main/java/com/vaadin/client/data/DataSource.java index f3711c3c68..5e4cbc1b40 100644 --- a/client/src/main/java/com/vaadin/client/data/DataSource.java +++ b/client/src/main/java/com/vaadin/client/data/DataSource.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ package com.vaadin.client.data; * Source of data for widgets showing lazily loaded data based on indexable * items (e.g. rows) of a specified type. The data source is a lazy view into a * larger data set. - * + * * @since 7.4 * @author Vaadin Ltd * @param <T> @@ -32,7 +32,7 @@ public interface DataSource<T> { * A handle that contains information on whether a row should be * {@link #pin() pinned} or {@link #unpin() unpinned}, and also always the * most recent representation for that particular row. - * + * * @param <T> * the row type */ @@ -40,7 +40,7 @@ public interface DataSource<T> { /** * Gets the most recent representation for the row this handle * represents. - * + * * @return the most recent representation for the row this handle * represents * @throws IllegalStateException @@ -60,7 +60,7 @@ public interface DataSource<T> { * source is able to. Since the DataSource might create a new instance * of an object, object references aren't necessarily kept up-to-date. * This is a technical work-around for that. - * + * * @see #unpin() */ public abstract void pin(); @@ -76,7 +76,7 @@ public interface DataSource<T> { * source is able to. Since the DataSource might create a new instance * of an object, object references aren't necessarily kept up-to-date. * This is a technical work-around for that. - * + * * @throws IllegalStateException * if this row handle has not been pinned before * @see #pin() @@ -87,7 +87,7 @@ public interface DataSource<T> { * Informs the DataSource that the row data represented by this * RowHandle has been updated. DataChangeHandler for the DataSource * should be informed that parts of data have been updated. - * + * * @see DataChangeHandler#dataUpdated(int, int) */ public abstract void updateRow(); @@ -101,7 +101,7 @@ public interface DataSource<T> { * RowHandle to function. Because Java has no mechanism to force an * override of an existing method, we're defining a new method for that * instead. - * + * * @param rowHandle * the reference object with which to compare * @return {@code true} if this object is the same as the obj argument; @@ -118,7 +118,7 @@ public interface DataSource<T> { * RowHandle to function. Because Java has no mechanism to force an * override of an existing method, we're defining a new method for that * instead. - * + * * @return a hash code value for this object */ protected abstract int hashCodeExplicit(); @@ -145,7 +145,7 @@ public interface DataSource<T> { * <p> * After any possible lazy loading and updates are done, the change handler * is informed that new data is available. - * + * * @param firstRowIndex * the index of the first needed row * @param numberOfRows @@ -160,7 +160,7 @@ public interface DataSource<T> { * This method does not trigger loading of unavailable data. * {@link #ensureAvailability(int, int)} should be used to signal what data * will be needed. - * + * * @param rowIndex * the index of the row to retrieve data for * @return data for the row; or <code>null</code> if no data is available @@ -169,7 +169,7 @@ public interface DataSource<T> { /** * Returns the number of rows in the data source. - * + * * @return the current size of the data source */ public int size(); @@ -177,7 +177,7 @@ public interface DataSource<T> { /** * Sets a data change handler to inform when data is updated, added or * removed. - * + * * @param dataChangeHandler * the data change handler */ @@ -185,7 +185,7 @@ public interface DataSource<T> { /** * Gets a {@link RowHandle} of a row object in the cache. - * + * * @param row * the row object for which to retrieve a row handle * @return a non-<code>null</code> row handle of the given row object diff --git a/client/src/main/java/com/vaadin/client/debug/internal/AnalyzeLayoutsPanel.java b/client/src/main/java/com/vaadin/client/debug/internal/AnalyzeLayoutsPanel.java index 45652e0257..55c2ce5d75 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/AnalyzeLayoutsPanel.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/AnalyzeLayoutsPanel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -44,7 +44,7 @@ import com.vaadin.client.ValueMap; /** * Analyze layouts view panel of the debug window. - * + * * @since 7.1.4 */ public class AnalyzeLayoutsPanel extends FlowPanel { diff --git a/client/src/main/java/com/vaadin/client/debug/internal/ConnectorInfoPanel.java b/client/src/main/java/com/vaadin/client/debug/internal/ConnectorInfoPanel.java index 554d13317f..f41c99decf 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/ConnectorInfoPanel.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/ConnectorInfoPanel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -35,14 +35,14 @@ import com.vaadin.shared.communication.SharedState; /** * Connector information view panel of the debug window. - * + * * @since 7.1.4 */ public class ConnectorInfoPanel extends FlowPanel { /** * Update the panel to show information about a connector. - * + * * @param connector */ public void update(ServerConnector connector) { diff --git a/client/src/main/java/com/vaadin/client/debug/internal/DebugButton.java b/client/src/main/java/com/vaadin/client/debug/internal/DebugButton.java index 23777823c0..8a2bc96d24 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/DebugButton.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/DebugButton.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.google.gwt.user.client.ui.Button; * Simple extension of {@link Button} that is preconfigured with for use in * {@link VDebugWindow}. Uses icon-font for icons, and allows title to be * specified in the constructor. - * + * * @since 7.1 * @author Vaadin Ltd */ @@ -32,7 +32,7 @@ public class DebugButton extends Button { /** * Creates a {@link Button} with the given icon-font icon. The icon id will * be used in the <i>data-icon</i> attribute of an <i><i></i> -tag. - * + * * @param icon * Identifier for the desired icon in an icon-font */ @@ -44,7 +44,7 @@ public class DebugButton extends Button { public DebugButton(String caption) { this(null, null, caption); } - + public DebugButton(String caption, String title) { this(null, title, caption); } @@ -54,12 +54,12 @@ public class DebugButton extends Button { * Creates a {@link Button} with the given icon-font icon and title * (tooltip). The icon id will be used in the <i>data-icon</i> attribute of * an <i><i></i> -tag. - * + * * @param icon * Identifier for the desired icon in an icon-font * @param title * Button title (tooltip) - * + * */ public DebugButton(Icon icon, String title) { this(icon, title, null); @@ -69,7 +69,7 @@ public class DebugButton extends Button { * Creates a {@link Button} with the given icon-font icon, title (tooltip), * and caption. The icon id will be used in the <i>data-icon</i> attribute * of an <i><i></i> -tag. - * + * * @param icon * Identifier for the desired icon in an icon-font * @param title @@ -89,7 +89,7 @@ public class DebugButton extends Button { /** * Adds or removes a stylename, indicating whether or not the button is in * it's active state. - * + * * @param active */ public void setActive(boolean active) { @@ -99,7 +99,7 @@ public class DebugButton extends Button { /** * Indicates wheter the Button is currently in its active state or not - * + * * @return true if the Button is active, false otherwise */ public boolean isActive() { diff --git a/client/src/main/java/com/vaadin/client/debug/internal/ErrorNotificationHandler.java b/client/src/main/java/com/vaadin/client/debug/internal/ErrorNotificationHandler.java index adca5305ef..958985b397 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/ErrorNotificationHandler.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/ErrorNotificationHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -30,7 +30,7 @@ import com.vaadin.client.ui.VNotification; /** * Log message handler that shows big red notification for {@link Level#SEVERE} * messages that have a throwable. - * + * * @since 7.1 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/debug/internal/HierarchyPanel.java b/client/src/main/java/com/vaadin/client/debug/internal/HierarchyPanel.java index c5c134fc31..2b033f0f88 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/HierarchyPanel.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/HierarchyPanel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -39,7 +39,7 @@ import com.vaadin.client.Util; /** * Hierarchy view panel of the debug window. This class can be used in various * debug window sections to show the current connector hierarchy. - * + * * @since 7.1.4 */ public class HierarchyPanel extends FlowPanel { @@ -73,7 +73,7 @@ public class HierarchyPanel extends FlowPanel { /** * Adds the captions of all open (non-leaf) nodes in the hierarchy tree * recursively. - * + * * @param widget * the widget in which to search for open nodes (if SimpleTree) * @param openNodes @@ -163,7 +163,7 @@ public class HierarchyPanel extends FlowPanel { /** * Outputs debug information on the server - usually in the console of an * IDE, with a clickable reference to the relevant code location. - * + * * @since 7.1 * @param connector * show debug info for this connector diff --git a/client/src/main/java/com/vaadin/client/debug/internal/HierarchySection.java b/client/src/main/java/com/vaadin/client/debug/internal/HierarchySection.java index 3557497be4..cc3a6be4d5 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/HierarchySection.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/HierarchySection.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -39,7 +39,7 @@ import com.vaadin.client.WidgetUtil; /** * Provides functionality for examining the UI component hierarchy. - * + * * @since 7.1 * @author Vaadin Ltd */ @@ -77,14 +77,14 @@ public class HierarchySection implements Section { * Called when the user hovers over a connector, which is highlighted. * Also called when hovering outside the tree, e.g. over the debug * console, but in this case the connector is null - * + * * @param connector */ void onHover(ComponentConnector connector); /** * Called when the user clicks on a highlighted connector. - * + * * @param connector */ void onSelected(ComponentConnector connector); diff --git a/client/src/main/java/com/vaadin/client/debug/internal/Highlight.java b/client/src/main/java/com/vaadin/client/debug/internal/Highlight.java index 74f1cabf02..b24e19e05e 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/Highlight.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/Highlight.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -40,7 +40,7 @@ import com.vaadin.client.ui.VWindow; * disappear with the highlighted widget, and it is also fairly likely that * someone else calls {@link #hideAll()} eventually. * </p> - * + * * @since 7.1 * @author Vaadin Ltd */ @@ -59,7 +59,7 @@ public class Highlight { * Pass the returned {@link Element} to {@link #hide(Element)} to remove * this particular highlight. * </p> - * + * * @param connector * ComponentConnector * @return Highlight element @@ -75,9 +75,9 @@ public class Highlight { * Pass the returned {@link Element} to {@link #hide(Element)} to remove * this particular highlight. * </p> - * + * * @since 7.1 - * + * * @param connector * the server connector to highlight * @return Highlight element, or <code>null</code> if the connector isn't a @@ -99,7 +99,7 @@ public class Highlight { * Pass the returned {@link Element} to {@link #hide(Element)} to remove * this particular highlight. * </p> - * + * * @param connector * ComponentConnector * @param color @@ -120,7 +120,7 @@ public class Highlight { * Pass the returned {@link Element} to {@link #hide(Element)} to remove * this particular highlight. * </p> - * + * * @param widget * Widget to highlight * @return Highlight element @@ -135,7 +135,7 @@ public class Highlight { * Pass the returned {@link Element} to {@link #hide(Element)} to remove * this particular highlight. * </p> - * + * * @param widget * Widget to highlight * @param color @@ -155,7 +155,7 @@ public class Highlight { * Pass the returned {@link Element} to {@link #hide(Element)} to remove * this particular highlight. * </p> - * + * * @param element * Element to highlight * @return Highlight element @@ -170,7 +170,7 @@ public class Highlight { * Pass the returned highlight {@link Element} to {@link #hide(Element)} to * remove this particular highlight. * </p> - * + * * @param element * Element to highlight * @param color @@ -217,7 +217,7 @@ public class Highlight { /** * Hides the given highlight. - * + * * @param highlight * Highlight to hide */ diff --git a/client/src/main/java/com/vaadin/client/debug/internal/Icon.java b/client/src/main/java/com/vaadin/client/debug/internal/Icon.java index a30dc05fcb..8e56525c3a 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/Icon.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/Icon.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/debug/internal/InfoSection.java b/client/src/main/java/com/vaadin/client/debug/internal/InfoSection.java index 034d921a37..d3b882e342 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/InfoSection.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/InfoSection.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -34,7 +34,7 @@ import com.vaadin.shared.util.SharedUtil; /** * Information section of the debug window - * + * * @since 7.1 * @author Vaadin Ltd */ @@ -57,7 +57,7 @@ public class InfoSection implements Section { }; /** - * + * */ public InfoSection() { createContent(); @@ -95,7 +95,7 @@ public class InfoSection implements Section { /* * (non-Javadoc) - * + * * @see com.vaadin.client.debug.internal.Section#getTabButton() */ @Override @@ -105,7 +105,7 @@ public class InfoSection implements Section { /* * (non-Javadoc) - * + * * @see com.vaadin.client.debug.internal.Section#getControls() */ @Override @@ -115,7 +115,7 @@ public class InfoSection implements Section { /* * (non-Javadoc) - * + * * @see com.vaadin.client.debug.internal.Section#getContent() */ @Override @@ -125,7 +125,7 @@ public class InfoSection implements Section { /* * (non-Javadoc) - * + * * @see com.vaadin.client.debug.internal.Section#show() */ @Override @@ -135,7 +135,7 @@ public class InfoSection implements Section { /** * Updates the information for all running applications - * + * * @since 7.1 */ private void refresh() { @@ -154,7 +154,7 @@ public class InfoSection implements Section { /** * Updates the information for a single running application - * + * * @since 7.1 */ private void refresh(ApplicationConnection connection) { @@ -185,7 +185,7 @@ public class InfoSection implements Section { /** * Logs version information for client/server/theme. - * + * * @param applicationConfiguration * @since 7.1 */ @@ -225,7 +225,7 @@ public class InfoSection implements Section { /** * Checks if the target value equals one of the reference values - * + * * @param target * The value to compare * @param reference1 @@ -249,7 +249,7 @@ public class InfoSection implements Section { /** * Finds out the version of the current theme (i.e. the version of Vaadin * used to compile it) - * + * * @since 7.1 * @return The full version as a string */ @@ -279,7 +279,7 @@ public class InfoSection implements Section { /** * Removes all content - * + * * @since 7.1 */ private void clear() { @@ -288,7 +288,7 @@ public class InfoSection implements Section { /* * (non-Javadoc) - * + * * @see com.vaadin.client.debug.internal.Section#hide() */ @Override @@ -298,7 +298,7 @@ public class InfoSection implements Section { /* * (non-Javadoc) - * + * * @see com.vaadin.client.debug.internal.Section#meta(com.vaadin.client. * ApplicationConnection, com.vaadin.client.ValueMap) */ @@ -309,7 +309,7 @@ public class InfoSection implements Section { /* * (non-Javadoc) - * + * * @see com.vaadin.client.debug.internal.Section#uidl(com.vaadin.client. * ApplicationConnection, com.vaadin.client.ValueMap) */ diff --git a/client/src/main/java/com/vaadin/client/debug/internal/LogSection.java b/client/src/main/java/com/vaadin/client/debug/internal/LogSection.java index edbdf14ea3..f4881efb95 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/LogSection.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/LogSection.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -40,7 +40,7 @@ import com.vaadin.client.ValueMap; * <p> * Scroll lock state is persisted. * </p> - * + * * @since 7.1 * @author Vaadin Ltd */ @@ -189,7 +189,7 @@ public class LogSection implements Section { /** * Activates or deactivates scroll lock - * + * * @param locked */ void setScrollLock(boolean locked) { @@ -243,7 +243,7 @@ public class LogSection implements Section { /** * Sets the log row limit. - * + * * @param limit */ public void setLimit(int limit) { @@ -255,7 +255,7 @@ public class LogSection implements Section { /** * Gets the current log row limit. - * + * * @return */ public int getLimit() { @@ -320,7 +320,7 @@ public class LogSection implements Section { /** * Adds a row to the log, applies the log row limit by removing old rows if * needed, and scrolls new row into view if scroll lock is not active. - * + * * @param level * @param msg * @return diff --git a/client/src/main/java/com/vaadin/client/debug/internal/NetworkSection.java b/client/src/main/java/com/vaadin/client/debug/internal/NetworkSection.java index deb1271348..23d7883c05 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/NetworkSection.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/NetworkSection.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,9 +24,9 @@ import com.vaadin.client.ValueMap; /** * Displays network activity; requests and responses. - * + * * Currently only displays responses in a simple manner. - * + * * @since 7.1 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/debug/internal/OptimizedWidgetsetPanel.java b/client/src/main/java/com/vaadin/client/debug/internal/OptimizedWidgetsetPanel.java index 9edb8c662f..4654421361 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/OptimizedWidgetsetPanel.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/OptimizedWidgetsetPanel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -29,7 +29,7 @@ import com.vaadin.client.ui.UnknownComponentConnector; /** * Optimized widgetset view panel of the debug window. - * + * * @since 7.1.4 */ public class OptimizedWidgetsetPanel extends FlowPanel { diff --git a/client/src/main/java/com/vaadin/client/debug/internal/ProfilerSection.java b/client/src/main/java/com/vaadin/client/debug/internal/ProfilerSection.java index c75df09fcf..3c542dbe69 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/ProfilerSection.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/ProfilerSection.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -36,10 +36,10 @@ import com.vaadin.client.ValueMap; /** * Debug window section for investigating {@link Profiler} data. This section is * only visible if the profiler is enabled ({@link Profiler#isEnabled()}). - * + * * @since 7.1 * @author Vaadin Ltd - * + * * @see Profiler */ public class ProfilerSection implements Section { diff --git a/client/src/main/java/com/vaadin/client/debug/internal/Section.java b/client/src/main/java/com/vaadin/client/debug/internal/Section.java index 5d0fd66d4f..e9e0fbf08f 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/Section.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/Section.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.vaadin.client.ValueMap; /** * A Section is displayed as a tab in the {@link VDebugWindow}. - * + * * @since 7.1 * @author Vaadin Ltd */ @@ -38,7 +38,7 @@ public interface Section { * The button should preferably only have an icon (no caption), and should * have a longer description as title (tooltip). * </p> - * + * * @return section id */ public DebugButton getTabButton(); @@ -46,7 +46,7 @@ public interface Section { /** * Returns a widget that is placed on top of the Section content when the * Section (tab) is active in the {@link VDebugWindow}. - * + * * @return section controls */ public Widget getControls(); @@ -54,7 +54,7 @@ public interface Section { /** * Returns a widget that is the main content of the section, displayed when * the section is active in the {@link VDebugWindow}. - * + * * @return */ public Widget getContent(); diff --git a/client/src/main/java/com/vaadin/client/debug/internal/SelectConnectorListener.java b/client/src/main/java/com/vaadin/client/debug/internal/SelectConnectorListener.java index 46c8070b30..91d88a3874 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/SelectConnectorListener.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/SelectConnectorListener.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,14 +20,14 @@ import com.vaadin.client.ServerConnector; /** * Listener for the selection of a connector in the debug window. - * + * * @since 7.1.4 */ public interface SelectConnectorListener { /** * Listener method called when a connector has been selected. If a specific * element of the connector was selected, it is also given. - * + * * @param connector * selected connector * @param element diff --git a/client/src/main/java/com/vaadin/client/debug/internal/SelectorPath.java b/client/src/main/java/com/vaadin/client/debug/internal/SelectorPath.java index 3f21e46a96..68002abc85 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/SelectorPath.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/SelectorPath.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -31,7 +31,7 @@ import com.vaadin.client.componentlocator.SelectorPredicate; * This class should be considered internal to the framework and may change at * any time. * <p> - * + * * @since 7.1.x */ public class SelectorPath { @@ -67,7 +67,7 @@ public class SelectorPath { /** * Generate ElementQuery code for Java. Fallback to By.vaadin(path) if * dealing with LegacyLocator - * + * * @return String containing Java code for finding the element described by * path */ @@ -131,7 +131,7 @@ public class SelectorPath { /** * Finds out if the given query fragment has a defined id - * + * * @param fragment * Query fragment * @return true if has id @@ -148,7 +148,7 @@ public class SelectorPath { /** * Generates a recursive ElementQuery for given path fragment - * + * * @param fragment * Query fragment * @return ElementQuery java code as a String @@ -169,7 +169,7 @@ public class SelectorPath { /** * Returns the name of the component described by given query fragment - * + * * @param fragment * Query fragment * @return Class part of fragment @@ -180,7 +180,7 @@ public class SelectorPath { /** * Generates a legacy locator for SelectorPath. - * + * * @return String containing Java code for element search and assignment */ private String getLegacyLocatorQuery() { @@ -206,7 +206,7 @@ public class SelectorPath { /** * Get variable name with counter for given component name. - * + * * @param name * Component name * @return name followed by count @@ -222,7 +222,7 @@ public class SelectorPath { /** * Generate Java variable assignment from given selector fragment - * + * * @param pathFragment * Selector fragment * @return piece of java code @@ -248,7 +248,7 @@ public class SelectorPath { /** * Get variable name based on predicates. Fallback to elementType - * + * * @param predicates * Predicates related to element * @param elementType diff --git a/client/src/main/java/com/vaadin/client/debug/internal/TestBenchSection.java b/client/src/main/java/com/vaadin/client/debug/internal/TestBenchSection.java index 44c3373823..665c44325f 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/TestBenchSection.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/TestBenchSection.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -45,7 +45,7 @@ import com.vaadin.client.WidgetUtil; /** * Provides functionality for picking selectors for Vaadin TestBench. - * + * * @since 7.1.x * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/debug/internal/VDebugWindow.java b/client/src/main/java/com/vaadin/client/debug/internal/VDebugWindow.java index 5d7e1ba3ed..800e64f9f7 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/VDebugWindow.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/VDebugWindow.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -58,7 +58,7 @@ import com.vaadin.client.ui.VOverlay; /** * Debug window implementation. - * + * * @since 7.1 * @author Vaadin Ltd */ @@ -235,7 +235,7 @@ public final class VDebugWindow extends VOverlay { /** * Adds dummy handle elements to the bottom corners that might have * scrollbars that interfere with resizing on some platforms. - * + * * @since 7.1 */ private void addHandles() { @@ -252,7 +252,7 @@ public final class VDebugWindow extends VOverlay { /** * Gets the {@link #VDebugWindow()} singleton instance. - * + * * @return */ public static VDebugWindow get() { @@ -337,7 +337,7 @@ public final class VDebugWindow extends VOverlay { /** * Writes the given value to the given {@link Storage} using the given key * (automatically prefixed with {@value #STORAGE_PREFIX}). - * + * * @param storage * @param key * @param value @@ -351,7 +351,7 @@ public final class VDebugWindow extends VOverlay { * {@value #STORAGE_PREFIX}) as an int from the given {@link Storage}, * returning the given default value instead if not successful (e.g missing * item). - * + * * @param storage * @param key * @param def @@ -370,7 +370,7 @@ public final class VDebugWindow extends VOverlay { * {@value #STORAGE_PREFIX}) as a boolean from the given {@link Storage}, * returning the given default value instead if not successful (e.g missing * item). - * + * * @param storage * @param key * @param def @@ -389,7 +389,7 @@ public final class VDebugWindow extends VOverlay { * {@value #STORAGE_PREFIX}) as a String from the given {@link Storage}, * returning the given default value instead if not successful (e.g missing * item). - * + * * @param storage * @param key * @param def @@ -422,7 +422,7 @@ public final class VDebugWindow extends VOverlay { /** * Removes the item with the given key (automatically prefixed with * {@value #STORAGE_PREFIX}) from the given {@link Storage}. - * + * * @param storage * @param key */ @@ -433,10 +433,10 @@ public final class VDebugWindow extends VOverlay { /** * Applies the appropriate instance variables for width, height, x, y * depending on if the window is minimized or not. - * + * * If the value is negative, the window is positioned that amount of pixels * from the right/bottom instead of left/top. - * + * * Finally, the position is bounds-checked so that the window is not moved * off-screen (the adjusted values are not saved). */ @@ -528,7 +528,7 @@ public final class VDebugWindow extends VOverlay { * Adds the given {@link Section} as a tab in the {@link VDebugWindow} UI. * {@link Section#getTabButton()} is called to obtain a button which is used * tab. - * + * * @param section */ public void addSection(final Section section) { @@ -551,7 +551,7 @@ public final class VDebugWindow extends VOverlay { /** * Activates the given {@link Section} - * + * * @param section */ void activateSection(Section section) { @@ -597,7 +597,7 @@ public final class VDebugWindow extends VOverlay { /** * Sets whether or not the window is minimized. - * + * * @param minimized */ private void setMinimized(boolean minimized) { @@ -613,7 +613,7 @@ public final class VDebugWindow extends VOverlay { /** * Sets the font size in use. - * + * * @param size */ private void setFontSize(int size) { @@ -624,7 +624,7 @@ public final class VDebugWindow extends VOverlay { /** * Gets the font size currently in use. - * + * * @return */ private int getFontSize() { @@ -633,7 +633,7 @@ public final class VDebugWindow extends VOverlay { /** * Gets the milliseconds since application start. - * + * * @return */ static int getMillisSinceStart() { @@ -642,7 +642,7 @@ public final class VDebugWindow extends VOverlay { /** * Gets the milliseconds since last {@link #resetTimer()} call. - * + * * @return */ static int getMillisSinceReset() { @@ -651,7 +651,7 @@ public final class VDebugWindow extends VOverlay { /** * Resets the timer. - * + * * @return Milliseconds elapsed since the timer was last reset. */ static int resetTimer() { @@ -663,7 +663,7 @@ public final class VDebugWindow extends VOverlay { /** * Gets a nicely formatted string with timing information suitable for * display in tooltips. - * + * * @param sinceStart * @param sinceReset * @return @@ -679,7 +679,7 @@ public final class VDebugWindow extends VOverlay { /** * Formats the given milliseconds as hours, minutes, seconds and * milliseconds. - * + * * @param ms * @return */ @@ -733,7 +733,7 @@ public final class VDebugWindow extends VOverlay { /** * Called when the result from analyzeLayouts is received. - * + * * @param ac * @param meta */ @@ -748,7 +748,7 @@ public final class VDebugWindow extends VOverlay { /** * Called when a response is received - * + * * @param ac * @param uidl */ @@ -765,7 +765,7 @@ public final class VDebugWindow extends VOverlay { * Gets the container element for this window. The debug window is always * global to the document and not related to any * {@link ApplicationConnection} in particular. - * + * * @return The global overlay container element. */ @Override @@ -779,7 +779,7 @@ public final class VDebugWindow extends VOverlay { /** * Popup menu for {@link VDebugWindow}. - * + * * @since 7.1 * @author Vaadin Ltd */ @@ -909,7 +909,7 @@ public final class VDebugWindow extends VOverlay { /** * Handler for resizing and moving window, also updates cursor on mousemove. - * + * * @since 7.1 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/debug/internal/theme/DebugWindowStyles.java b/client/src/main/java/com/vaadin/client/debug/internal/theme/DebugWindowStyles.java index 249b24a938..61c35a8f4f 100644 --- a/client/src/main/java/com/vaadin/client/debug/internal/theme/DebugWindowStyles.java +++ b/client/src/main/java/com/vaadin/client/debug/internal/theme/DebugWindowStyles.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/event/InputEvent.java b/client/src/main/java/com/vaadin/client/event/InputEvent.java index 47faeb3d7a..0db9c1a106 100644 --- a/client/src/main/java/com/vaadin/client/event/InputEvent.java +++ b/client/src/main/java/com/vaadin/client/event/InputEvent.java @@ -36,7 +36,7 @@ public class InputEvent extends DomEvent<InputHandler> { /** * Gets the event type associated with InputEvent. - * + * * @return the handler type */ public static Type<InputHandler> getType() { diff --git a/client/src/main/java/com/vaadin/client/event/InputHandler.java b/client/src/main/java/com/vaadin/client/event/InputHandler.java index c492c7512f..1b894515b8 100644 --- a/client/src/main/java/com/vaadin/client/event/InputHandler.java +++ b/client/src/main/java/com/vaadin/client/event/InputHandler.java @@ -19,14 +19,14 @@ import com.google.gwt.event.shared.EventHandler; /** * Handler interface for {@link InputEvent}s. - * + * * @since 8.0 */ public interface InputHandler extends EventHandler { /** * Called when an {@link InputEvent} is fired. - * + * * @param event * the {@link InputEvent} that was fired. */ diff --git a/client/src/main/java/com/vaadin/client/event/PointerCancelEvent.java b/client/src/main/java/com/vaadin/client/event/PointerCancelEvent.java index 906a07b120..d8e44b7f00 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerCancelEvent.java +++ b/client/src/main/java/com/vaadin/client/event/PointerCancelEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.google.gwt.event.dom.client.DomEvent; /** * Represents a native PointerCancelEvent. - * + * * @since 7.2 */ public class PointerCancelEvent extends PointerEvent<PointerCancelHandler> { @@ -34,7 +34,7 @@ public class PointerCancelEvent extends PointerEvent<PointerCancelHandler> { /** * Gets the event type associated with pointer cancel events. - * + * * @return the handler type */ public static Type<PointerCancelHandler> getType() { diff --git a/client/src/main/java/com/vaadin/client/event/PointerCancelHandler.java b/client/src/main/java/com/vaadin/client/event/PointerCancelHandler.java index fa2210b73c..334a99a7f2 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerCancelHandler.java +++ b/client/src/main/java/com/vaadin/client/event/PointerCancelHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,14 +19,14 @@ import com.google.gwt.event.shared.EventHandler; /** * Handler interface for {@link PointerCancelEvent} events. - * + * * @since 7.2 */ public interface PointerCancelHandler extends EventHandler { /** * Called when PointerCancelEvent is fired. - * + * * @param event * the {@link PointerCancelEvent} that was fired */ diff --git a/client/src/main/java/com/vaadin/client/event/PointerDownEvent.java b/client/src/main/java/com/vaadin/client/event/PointerDownEvent.java index eeae9891f2..37809e6a39 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerDownEvent.java +++ b/client/src/main/java/com/vaadin/client/event/PointerDownEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.google.gwt.event.dom.client.DomEvent; /** * Represents a native PointerDownEvent. - * + * * @since 7.2 */ public class PointerDownEvent extends PointerEvent<PointerDownHandler> { @@ -33,7 +33,7 @@ public class PointerDownEvent extends PointerEvent<PointerDownHandler> { /** * Gets the event type associated with PointerDownEvent events. - * + * * @return the handler type */ public static Type<PointerDownHandler> getType() { diff --git a/client/src/main/java/com/vaadin/client/event/PointerDownHandler.java b/client/src/main/java/com/vaadin/client/event/PointerDownHandler.java index dfd9a358eb..e9ab0ff3e6 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerDownHandler.java +++ b/client/src/main/java/com/vaadin/client/event/PointerDownHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,14 +19,14 @@ import com.google.gwt.event.shared.EventHandler; /** * Handler interface for {@link PointerDownEvent} events. - * + * * @since 7.2 */ public interface PointerDownHandler extends EventHandler { /** * Called when PointerDownEvent is fired. - * + * * @param event * the {@link PointerDownEvent} that was fired */ diff --git a/client/src/main/java/com/vaadin/client/event/PointerEvent.java b/client/src/main/java/com/vaadin/client/event/PointerEvent.java index c544a286be..d91168ff53 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerEvent.java +++ b/client/src/main/java/com/vaadin/client/event/PointerEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,10 +21,10 @@ import com.google.gwt.event.shared.EventHandler; /** * Abstract class representing Pointer events. - * + * * @param <H> * handler type - * + * * @since 7.2 */ public abstract class PointerEvent<H extends EventHandler> @@ -46,7 +46,7 @@ public abstract class PointerEvent<H extends EventHandler> /** * Gets a unique identifier for the pointer that caused this event. The * identifiers of previously active but retired pointers may be recycled. - * + * * @return unique pointer id */ public final int getPointerId() { @@ -55,7 +55,7 @@ public abstract class PointerEvent<H extends EventHandler> /** * Gets the width of the contact geometry of the pointer in CSS pixels. - * + * * @return width in CSS pixels */ public final int getWidth() { @@ -64,7 +64,7 @@ public abstract class PointerEvent<H extends EventHandler> /** * Gets the height of the contact geometry of the pointer in CSS pixels. - * + * * @return height in CSS pixels. */ public final int getHeight() { @@ -74,7 +74,7 @@ public abstract class PointerEvent<H extends EventHandler> /** * Gets the pressure of the pointer input as a value in the range of [0, 1] * where 0 and 1 represent the minimum and maximum, respectively. - * + * * @return input pressure as a value between 0 and 1 */ public final double getPressure() { @@ -84,7 +84,7 @@ public abstract class PointerEvent<H extends EventHandler> /** * Gets the angle between the Y-Z plane and the plane containing both the * transducer and the Y axis. A positive tilt is to the right. - * + * * @return the tilt along the X axis as degrees in the range of [-90, 90], * or 0 if the device does not support tilt */ @@ -95,7 +95,7 @@ public abstract class PointerEvent<H extends EventHandler> /** * Gets the angle between the X-Z plane and the plane containing both the * transducer and the X axis. A positive tilt is towards the user. - * + * * @return the tilt along the Y axis as degrees in the range of [-90, 90], * or 0 if the device does not support tilt */ @@ -105,12 +105,12 @@ public abstract class PointerEvent<H extends EventHandler> /** * Gets the type of the pointer device that caused this event. - * + * * @see PointerEvent#TYPE_UNKNOWN * @see PointerEvent#TYPE_TOUCH * @see PointerEvent#TYPE_PEN * @see PointerEvent#TYPE_MOUSE - * + * * @return a String indicating the type of the pointer device */ public final String getPointerType() { @@ -119,7 +119,7 @@ public abstract class PointerEvent<H extends EventHandler> /** * Indicates whether the pointer is the primary pointer of this type. - * + * * @return true if the pointer is the primary pointer, otherwise false */ public final boolean isPrimary() { diff --git a/client/src/main/java/com/vaadin/client/event/PointerEventSupport.java b/client/src/main/java/com/vaadin/client/event/PointerEventSupport.java index 99d73745c5..70f13c80fa 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerEventSupport.java +++ b/client/src/main/java/com/vaadin/client/event/PointerEventSupport.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.vaadin.client.event.PointerEvent.EventType; /** * Main class for pointer event support. Contains functionality for determining * if pointer events are available or not. - * + * * @since 7.2 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/event/PointerEventSupportImpl.java b/client/src/main/java/com/vaadin/client/event/PointerEventSupportImpl.java index 7605104ade..1dcd65a159 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerEventSupportImpl.java +++ b/client/src/main/java/com/vaadin/client/event/PointerEventSupportImpl.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.event.PointerEvent.EventType; /** * Main pointer event support implementation class. Made for browser without * pointer event support. - * + * * @since 7.2 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplIE10.java b/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplIE10.java index 1b0e58c387..bb824c6b6c 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplIE10.java +++ b/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplIE10.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.vaadin.client.event.PointerEvent.EventType; /** * Pointer event support class for IE 10 ("ms" prefixed pointer events) - * + * * @since 7.2 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplModernIE.java b/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplModernIE.java index 57b822b24a..554a5ee2a8 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplModernIE.java +++ b/client/src/main/java/com/vaadin/client/event/PointerEventSupportImplModernIE.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.vaadin.client.event.PointerEvent.EventType; /** * Pointer event support class for IE 11+ (unprefixed pointer events) - * + * * @since 7.2 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/event/PointerMoveEvent.java b/client/src/main/java/com/vaadin/client/event/PointerMoveEvent.java index 6a4a81e17d..e109f02fc0 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerMoveEvent.java +++ b/client/src/main/java/com/vaadin/client/event/PointerMoveEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.google.gwt.event.dom.client.DomEvent; /** * Represents a native PointerMoveEvent event. - * + * * @since 7.2 */ public class PointerMoveEvent extends PointerEvent<PointerMoveHandler> { @@ -33,7 +33,7 @@ public class PointerMoveEvent extends PointerEvent<PointerMoveHandler> { /** * Gets the event type associated with PointerMoveEvent. - * + * * @return the handler type */ public static Type<PointerMoveHandler> getType() { diff --git a/client/src/main/java/com/vaadin/client/event/PointerMoveHandler.java b/client/src/main/java/com/vaadin/client/event/PointerMoveHandler.java index ad6a93da8d..4d966a0f27 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerMoveHandler.java +++ b/client/src/main/java/com/vaadin/client/event/PointerMoveHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,14 +19,14 @@ import com.google.gwt.event.shared.EventHandler; /** * Handler interface for {@link PointerMoveEvent} events. - * + * * @since 7.2 */ public interface PointerMoveHandler extends EventHandler { /** * Called when PointerMoveEvent is fired. - * + * * @param event * the {@link PointerMoveEvent} that was fired */ diff --git a/client/src/main/java/com/vaadin/client/event/PointerUpEvent.java b/client/src/main/java/com/vaadin/client/event/PointerUpEvent.java index 005902d7f7..5b848bbb6c 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerUpEvent.java +++ b/client/src/main/java/com/vaadin/client/event/PointerUpEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.google.gwt.event.dom.client.DomEvent; /** * Represents a native PointerUpEvent. - * + * * @since 7.2 */ public class PointerUpEvent extends PointerEvent<PointerUpHandler> { @@ -33,7 +33,7 @@ public class PointerUpEvent extends PointerEvent<PointerUpHandler> { /** * Gets the event type associated with PointerUpEvent. - * + * * @return the handler type */ public static Type<PointerUpHandler> getType() { diff --git a/client/src/main/java/com/vaadin/client/event/PointerUpHandler.java b/client/src/main/java/com/vaadin/client/event/PointerUpHandler.java index 587b249634..01db75cdb5 100644 --- a/client/src/main/java/com/vaadin/client/event/PointerUpHandler.java +++ b/client/src/main/java/com/vaadin/client/event/PointerUpHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,14 +19,14 @@ import com.google.gwt.event.shared.EventHandler; /** * Handler interface for {@link PointerUpEvent} events. - * + * * @since 7.2 */ public interface PointerUpHandler extends EventHandler { /** * Called when PointerUpEvent is fired. - * + * * @param event * the {@link PointerUpEvent} that was fired */ diff --git a/client/src/main/java/com/vaadin/client/extensions/AbstractExtensionConnector.java b/client/src/main/java/com/vaadin/client/extensions/AbstractExtensionConnector.java index 79eaa2f8b9..6bd91d932a 100644 --- a/client/src/main/java/com/vaadin/client/extensions/AbstractExtensionConnector.java +++ b/client/src/main/java/com/vaadin/client/extensions/AbstractExtensionConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -45,7 +45,7 @@ public abstract class AbstractExtensionConnector extends AbstractConnector { /** * Called when the extension is attached to its parent. This method is only * called once as an extension cannot be moved from one parent to another. - * + * * @param target * The connector this extension extends */ diff --git a/client/src/main/java/com/vaadin/client/extensions/BrowserWindowOpenerConnector.java b/client/src/main/java/com/vaadin/client/extensions/BrowserWindowOpenerConnector.java index ca17e84ea4..364718bcc6 100644 --- a/client/src/main/java/com/vaadin/client/extensions/BrowserWindowOpenerConnector.java +++ b/client/src/main/java/com/vaadin/client/extensions/BrowserWindowOpenerConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -32,7 +32,7 @@ import com.vaadin.shared.util.SharedUtil; /** * Client-side code for {@link BrowserWindowOpener} - * + * * @author Vaadin Ltd * @since 7.0.0 */ diff --git a/client/src/main/java/com/vaadin/client/extensions/FileDownloaderConnector.java b/client/src/main/java/com/vaadin/client/extensions/FileDownloaderConnector.java index bed6622a6c..431991e886 100644 --- a/client/src/main/java/com/vaadin/client/extensions/FileDownloaderConnector.java +++ b/client/src/main/java/com/vaadin/client/extensions/FileDownloaderConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/extensions/ResponsiveConnector.java b/client/src/main/java/com/vaadin/client/extensions/ResponsiveConnector.java index c5fafd1cd9..864a948a1e 100644 --- a/client/src/main/java/com/vaadin/client/extensions/ResponsiveConnector.java +++ b/client/src/main/java/com/vaadin/client/extensions/ResponsiveConnector.java @@ -4,9 +4,9 @@ * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -34,7 +34,7 @@ import com.vaadin.shared.util.SharedUtil; /** * The client side connector for the Responsive extension. - * + * * @author Vaadin Ltd * @since 7.2 */ @@ -99,7 +99,7 @@ public class ResponsiveConnector extends AbstractExtensionConnector /** * Construct the list of selectors that should be matched against in the * range selectors - * + * * @return The selectors in a comma delimited string. */ protected String constructSelectorsForTarget() { @@ -166,48 +166,48 @@ public class ResponsiveConnector extends AbstractExtensionConnector */ private static native void searchForBreakPointsNative() /*-{ - + // Initialize variables @com.vaadin.client.extensions.ResponsiveConnector::widthRangeCache = []; @com.vaadin.client.extensions.ResponsiveConnector::heightRangeCache = []; - + var widthRanges = @com.vaadin.client.extensions.ResponsiveConnector::widthRangeCache; var heightRanges = @com.vaadin.client.extensions.ResponsiveConnector::heightRangeCache; - + // Can't do squat if we can't parse stylesheets if(!$doc.styleSheets) return; - + var sheets = $doc.styleSheets; - + // Loop all stylesheets on the page and process them individually for(var i = 0, len = sheets.length; i < len; i++) { var sheet = sheets[i]; @com.vaadin.client.extensions.ResponsiveConnector::searchStylesheetForBreakPoints(Lcom/google/gwt/core/client/JavaScriptObject;)(sheet); } - + }-*/; /** * Process an individual stylesheet object. Any @import statements are * handled recursively. Regular rule declarations are searched for * 'width-range' and 'height-range' attribute selectors. - * + * * @param sheet */ private static native void searchStylesheetForBreakPoints( final JavaScriptObject sheet) /*-{ - + // Inline variables for easier reading var widthRanges = @com.vaadin.client.extensions.ResponsiveConnector::widthRangeCache; var heightRanges = @com.vaadin.client.extensions.ResponsiveConnector::heightRangeCache; - + // Get all the rulesets from the stylesheet var theRules = new Array(); var IEOrEdge = @com.vaadin.client.BrowserInfo::get()().@com.vaadin.client.BrowserInfo::isIE()() || @com.vaadin.client.BrowserInfo::get()().@com.vaadin.client.BrowserInfo::isEdge()(); var IE8 = @com.vaadin.client.BrowserInfo::get()().@com.vaadin.client.BrowserInfo::isIE8()(); - + try { if (sheet.cssRules) { theRules = sheet.cssRules @@ -220,7 +220,7 @@ public class ResponsiveConnector extends AbstractExtensionConnector ", probably because of cross domain issues: " + e); return; } - + // Special import handling for IE8 if (IE8) { try { @@ -232,18 +232,18 @@ public class ResponsiveConnector extends AbstractExtensionConnector @com.vaadin.client.extensions.ResponsiveConnector::error(Ljava/lang/String;)("Failed to handle imports of CSS style sheet: " + sheet.href); } } - + // Loop through the rulesets for(var i = 0, len = theRules.length; i < len; i++) { var rule = theRules[i]; - + if(rule.type == 3) { // @import rule, traverse recursively @com.vaadin.client.extensions.ResponsiveConnector::searchStylesheetForBreakPoints(Lcom/google/gwt/core/client/JavaScriptObject;)(rule.styleSheet); - + } else if(rule.type == 1 || !rule.type) { // Regular selector rule - + // Helper function var pushToCache = function(ranges, selector, min, max) { // Avoid adding duplicates @@ -259,64 +259,64 @@ public class ResponsiveConnector extends AbstractExtensionConnector ranges.push([selector, min, max]); } }; - + // Array of all of the separate selectors in this ruleset var haystack = rule.selectorText.split(","); - + // IE/Edge parses CSS like .class[attr="val"] into [attr="val"].class so we need to check for both var selectorRegEx = IEOrEdge ? /\[.*\]([\.|#]\S+)/ : /([\.|#]\S+?)\[.*\]/; - + // Loop all the selectors in this ruleset for(var k = 0, len2 = haystack.length; k < len2; k++) { - + // Split the haystack into parts. var widthRange = haystack[k].match(/\[width-range.*?\]/); var heightRange = haystack[k].match(/\[height-range.*?\]/); var selector = haystack[k].match(selectorRegEx); - + if (selector != null) { selector = selector[1]; - + // Check for width-ranges. if (widthRange != null) { var minMax = widthRange[0].match(/\[width-range~?=["|'](.*?)-(.*?)["|']\]/i); var min = minMax[1]; var max = minMax[2]; - + pushToCache(widthRanges, selector, min, max); } - + // Check for height-ranges. if (heightRange != null) { var minMax = heightRange[0].match(/\[height-range~?=["|'](.*?)-(.*?)["|']\]/i); var min = minMax[1]; var max = minMax[2]; - + pushToCache(heightRanges, selector, min, max); } } } } } - + }-*/; /** * Get all matching ranges from the cache for this particular instance. - * + * * @param selectors */ private native void getBreakPointsFor(final String selectors) /*-{ - + var selectors = selectors.split(","); - + var widthBreakpoints = this.@com.vaadin.client.extensions.ResponsiveConnector::widthBreakpoints = []; var heightBreakpoints = this.@com.vaadin.client.extensions.ResponsiveConnector::heightBreakpoints = []; - + var widthRanges = @com.vaadin.client.extensions.ResponsiveConnector::widthRangeCache; var heightRanges = @com.vaadin.client.extensions.ResponsiveConnector::heightRangeCache; - + for(var i = 0, len = widthRanges.length; i < len; i++) { var bp = widthRanges[i]; for(var j = 0, len2 = selectors.length; j < len2; j++) { @@ -324,7 +324,7 @@ public class ResponsiveConnector extends AbstractExtensionConnector widthBreakpoints.push(bp); } } - + for(var i = 0, len = heightRanges.length; i < len; i++) { var bp = heightRanges[i]; for(var j = 0, len2 = selectors.length; j < len2; j++) { @@ -332,10 +332,10 @@ public class ResponsiveConnector extends AbstractExtensionConnector heightBreakpoints.push(bp); } } - + // Only for debugging // console.log("Breakpoints for", selectors.join(","), widthBreakpoints, heightBreakpoints); - + }-*/; private String currentWidthRanges = ""; @@ -395,7 +395,7 @@ public class ResponsiveConnector extends AbstractExtensionConnector * Forces IE8 to reinterpret CSS rules. * {@link com.vaadin.client.WidgetUtil#forceIE8Redraw(com.google.gwt.dom.client.Element)} * doesn't work in this case. - * + * * @param element * the element to redraw */ @@ -408,24 +408,24 @@ public class ResponsiveConnector extends AbstractExtensionConnector private native String resolveBreakpoint(String which, int size) /*-{ - + // Default to "width" breakpoints var breakpoints = this.@com.vaadin.client.extensions.ResponsiveConnector::widthBreakpoints; - + // Use height breakpoints if we're measuring the height if(which == "height") breakpoints = this.@com.vaadin.client.extensions.ResponsiveConnector::heightBreakpoints; - + // Output string that goes into either the "width-range" or "height-range" attribute in the element var ranges = ""; - + // Loop the breakpoints for(var i = 0, len = breakpoints.length; i < len; i++) { var bp = breakpoints[i]; - + var min = parseInt(bp[1]); var max = parseInt(bp[2]); - + if(!isNaN(min) && !isNaN(max)) { if(min <= size && size <= max) { ranges += " " + bp[1] + "-" + bp[2]; @@ -440,10 +440,10 @@ public class ResponsiveConnector extends AbstractExtensionConnector } } } - + // Trim the output and return it return ranges.replace(/^\s+/, ""); - + }-*/; } diff --git a/client/src/main/java/com/vaadin/client/extensions/javascriptmanager/JavaScriptManagerConnector.java b/client/src/main/java/com/vaadin/client/extensions/javascriptmanager/JavaScriptManagerConnector.java index ece6d560e9..604081c5e5 100644 --- a/client/src/main/java/com/vaadin/client/extensions/javascriptmanager/JavaScriptManagerConnector.java +++ b/client/src/main/java/com/vaadin/client/extensions/javascriptmanager/JavaScriptManagerConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -71,7 +71,7 @@ public class JavaScriptManagerConnector extends AbstractExtensionConnector { var m = this; var target = $wnd; var parts = name.split('.'); - + for(var i = 0; i < parts.length - 1; i++) { var part = parts[i]; if (target[part] === undefined) { @@ -79,7 +79,7 @@ public class JavaScriptManagerConnector extends AbstractExtensionConnector { } target = target[part]; } - + target[parts[parts.length - 1]] = $entry(function() { //Must make a copy because arguments is an array-like object (not instanceof Array), causing suboptimal JSON encoding var args = Array.prototype.slice.call(arguments, 0); @@ -94,7 +94,7 @@ public class JavaScriptManagerConnector extends AbstractExtensionConnector { /*-{ var target = $wnd; var parts = name.split('.'); - + for(var i = 0; i < parts.length - 1; i++) { var part = parts[i]; if (target[part] === undefined) { @@ -104,7 +104,7 @@ public class JavaScriptManagerConnector extends AbstractExtensionConnector { } target = target[part]; } - + $wnd.console.log('removing',parts[parts.length - 1],'from',target); delete target[parts[parts.length - 1]]; }-*/; diff --git a/client/src/main/java/com/vaadin/client/legacy/ui/VLegacyTextField.java b/client/src/main/java/com/vaadin/client/legacy/ui/VLegacyTextField.java index 7c8520f658..fa1f496d40 100644 --- a/client/src/main/java/com/vaadin/client/legacy/ui/VLegacyTextField.java +++ b/client/src/main/java/com/vaadin/client/legacy/ui/VLegacyTextField.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -41,9 +41,9 @@ import com.vaadin.shared.legacy.ui.textfield.LegacyTextFieldConstants; /** * This class represents a basic text input field with one row. - * + * * @author Vaadin Ltd. - * + * */ @Deprecated public class VLegacyTextField extends TextBoxBase implements Field, @@ -342,7 +342,7 @@ public class VLegacyTextField extends TextBoxBase implements Field, * This method is responsible for updating the DOM or otherwise ensuring * that the given max length is enforced. Called when the max length for the * field has changed. - * + * * @param maxLength * The new max length */ @@ -377,7 +377,7 @@ public class VLegacyTextField extends TextBoxBase implements Field, * Called when the field value might have changed and/or the field was * blurred. These are combined so the blur event is sent in the same batch * as a possible value change event (these are often connected). - * + * * @param blurred * true if the field was blurred */ @@ -420,7 +420,7 @@ public class VLegacyTextField extends TextBoxBase implements Field, /** * Updates the cursor position variable if it has changed since the last * update. - * + * * @return true iff the value was updated */ protected boolean updateCursorPosition() { diff --git a/client/src/main/java/com/vaadin/client/metadata/AsyncBundleLoader.java b/client/src/main/java/com/vaadin/client/metadata/AsyncBundleLoader.java index 9b7f611281..174b5cb4a9 100644 --- a/client/src/main/java/com/vaadin/client/metadata/AsyncBundleLoader.java +++ b/client/src/main/java/com/vaadin/client/metadata/AsyncBundleLoader.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/metadata/BundleLoadCallback.java b/client/src/main/java/com/vaadin/client/metadata/BundleLoadCallback.java index 399ac87d4e..a3f6217142 100644 --- a/client/src/main/java/com/vaadin/client/metadata/BundleLoadCallback.java +++ b/client/src/main/java/com/vaadin/client/metadata/BundleLoadCallback.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/metadata/InvokationHandler.java b/client/src/main/java/com/vaadin/client/metadata/InvokationHandler.java index 4faf0a1484..74dfee9cbc 100644 --- a/client/src/main/java/com/vaadin/client/metadata/InvokationHandler.java +++ b/client/src/main/java/com/vaadin/client/metadata/InvokationHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/metadata/Invoker.java b/client/src/main/java/com/vaadin/client/metadata/Invoker.java index 6e263829c0..31440e9d1a 100644 --- a/client/src/main/java/com/vaadin/client/metadata/Invoker.java +++ b/client/src/main/java/com/vaadin/client/metadata/Invoker.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/metadata/JsniInvoker.java b/client/src/main/java/com/vaadin/client/metadata/JsniInvoker.java index d6a60c89f3..fe4f613650 100644 --- a/client/src/main/java/com/vaadin/client/metadata/JsniInvoker.java +++ b/client/src/main/java/com/vaadin/client/metadata/JsniInvoker.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.vaadin.client.JsArrayObject; /** * Special {@link Invoker} that uses JSNI to invoke methods with limited * visibility. - * + * * @since 7.2 * @author Vaadin Ltd */ @@ -39,7 +39,7 @@ public abstract class JsniInvoker implements Invoker { /** * Abstract method that will be generated to contain JSNI for invoking the * actual method. - * + * * @param target * the object upon which to invoke the method * @param params diff --git a/client/src/main/java/com/vaadin/client/metadata/Method.java b/client/src/main/java/com/vaadin/client/metadata/Method.java index 8757a9de20..dadbe90ba0 100644 --- a/client/src/main/java/com/vaadin/client/metadata/Method.java +++ b/client/src/main/java/com/vaadin/client/metadata/Method.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -48,7 +48,7 @@ public class Method { * returned string may change without notice and should not be used for any * other purpose than identification. The signature is currently based on * the declaring type's signature and the method's name. - * + * * @return the unique signature of this method */ public String getSignature() { @@ -59,9 +59,9 @@ public class Method { * Gets the string that is internally used when looking up generated support * code for this method. This is the same as {@link #getSignature()}, but * without any type parameters. - * + * * @return the string to use for looking up generated support code - * + * * @since 7.2 */ public String getLookupKey() { @@ -104,9 +104,9 @@ public class Method { /** * Checks whether this method is annotated with {@link NoLayout}. - * + * * @since 7.4 - * + * * @return <code>true</code> if this method has a NoLayout annotation; * otherwise <code>false</code> */ diff --git a/client/src/main/java/com/vaadin/client/metadata/NoDataException.java b/client/src/main/java/com/vaadin/client/metadata/NoDataException.java index 45ea67d017..415b9eb958 100644 --- a/client/src/main/java/com/vaadin/client/metadata/NoDataException.java +++ b/client/src/main/java/com/vaadin/client/metadata/NoDataException.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/metadata/OnStateChangeMethod.java b/client/src/main/java/com/vaadin/client/metadata/OnStateChangeMethod.java index fd325b53cb..bf3b0d2694 100644 --- a/client/src/main/java/com/vaadin/client/metadata/OnStateChangeMethod.java +++ b/client/src/main/java/com/vaadin/client/metadata/OnStateChangeMethod.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -26,7 +26,7 @@ import com.vaadin.client.communication.StateChangeEvent; /** * Encapsulates the data that the widgetset compiler generates for supporting a * connector method annotated with {@link OnStateChange} - * + * * @since 7.2 * @author Vaadin Ltd */ @@ -39,7 +39,7 @@ public class OnStateChangeMethod { /** * Creates a new instance based on a method name, a list of parameters names * and a list of properties to listen for. - * + * * @param methodName * the name of the method to call * @param properties @@ -55,7 +55,7 @@ public class OnStateChangeMethod { * <p> * If the declaring class is <code>null</code>, the method is found based on * the type of the connector that fired the state change event. - * + * * @param declaringClass * the class in which the target method is declared, or * <code>null</code> to use the class of the connector firing the @@ -78,7 +78,7 @@ public class OnStateChangeMethod { /** * Invokes the listener method for a state change. - * + * * @param stateChangeEvent * the state change event */ @@ -104,7 +104,7 @@ public class OnStateChangeMethod { /** * Gets the list of state property names to listen for. - * + * * @return the list of state property names to listen for */ public List<String> getProperties() { diff --git a/client/src/main/java/com/vaadin/client/metadata/Property.java b/client/src/main/java/com/vaadin/client/metadata/Property.java index abaaab8fed..a4ec8c56e4 100644 --- a/client/src/main/java/com/vaadin/client/metadata/Property.java +++ b/client/src/main/java/com/vaadin/client/metadata/Property.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -57,7 +57,7 @@ public class Property { * returned string may change without notice and should not be used for any * other purpose than identification. The signature is currently based on * the declaring type's signature and the property's name. - * + * * @return the unique signature of this property */ public String getSignature() { @@ -68,9 +68,9 @@ public class Property { * Gets the string that is internally used when looking up generated support * code for this method. This is the same as {@link #getSignature()}, but * without any type parameters. - * + * * @return the string to use for looking up generated support code - * + * * @since 7.2 */ public String getLookupKey() { @@ -107,7 +107,7 @@ public class Property { * Gets the property name formatted for displaying in a user interface. This * returns a string where e.g. "camelCase" has been converted to "Camel * case". - * + * * @return the name of this property, formatted for humans to read */ public String getDisplayName() { @@ -130,9 +130,9 @@ public class Property { /** * Checks whether this property is annotated with {@link NoLayout}. - * + * * @since 7.4 - * + * * @return <code>true</code> if this property has a NoLayout annotation; * otherwise <code>false</code> */ diff --git a/client/src/main/java/com/vaadin/client/metadata/ProxyHandler.java b/client/src/main/java/com/vaadin/client/metadata/ProxyHandler.java index 6fba8a8155..a9e9ada083 100644 --- a/client/src/main/java/com/vaadin/client/metadata/ProxyHandler.java +++ b/client/src/main/java/com/vaadin/client/metadata/ProxyHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/metadata/TypeData.java b/client/src/main/java/com/vaadin/client/metadata/TypeData.java index 9addc4ffb2..cadbb1262c 100644 --- a/client/src/main/java/com/vaadin/client/metadata/TypeData.java +++ b/client/src/main/java/com/vaadin/client/metadata/TypeData.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/metadata/TypeDataStore.java b/client/src/main/java/com/vaadin/client/metadata/TypeDataStore.java index c6f8a08695..a057f4aed2 100644 --- a/client/src/main/java/com/vaadin/client/metadata/TypeDataStore.java +++ b/client/src/main/java/com/vaadin/client/metadata/TypeDataStore.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -251,7 +251,7 @@ public class TypeDataStore { * @param type * @return * @throws NoDataException - * + * * @deprecated As of 7.0.1, use {@link #getPropertiesAsArray(Type)} instead * for improved performance */ @@ -339,7 +339,7 @@ public class TypeDataStore { * This method sets up prototypes chain for <code>baseClassName</code>. * Precondition is : <code>superClassName</code> had to be handled before * its child <code>baseClassName</code>. - * + * * It makes all properties defined in the <code>superClassName</code> * available for <code>baseClassName</code> as well. */ @@ -420,7 +420,7 @@ public class TypeDataStore { /** * Gets data for all methods annotated with {@link OnStateChange} in the * given connector type. - * + * * @since 7.2 * @param type * the connector type @@ -434,7 +434,7 @@ public class TypeDataStore { /** * Adds data about a method annotated with {@link OnStateChange} for the * given connector type. - * + * * @since 7.2 * @param clazz * the connector type @@ -464,12 +464,12 @@ public class TypeDataStore { /** * Checks whether the provided method is annotated with {@link NoLayout}. - * + * * @param method * the rpc method to check - * + * * @since 7.4 - * + * * @return <code>true</code> if the method has a NoLayout annotation; * otherwise <code>false</code> */ @@ -479,12 +479,12 @@ public class TypeDataStore { /** * Checks whether the provided property is annotated with {@link NoLayout}. - * + * * @param property * the property to check - * + * * @since 7.4 - * + * * @return <code>true</code> if the property has a NoLayout annotation; * otherwise <code>false</code> */ diff --git a/client/src/main/java/com/vaadin/client/renderers/ButtonRenderer.java b/client/src/main/java/com/vaadin/client/renderers/ButtonRenderer.java index b173aef60a..52fa2c7bdb 100644 --- a/client/src/main/java/com/vaadin/client/renderers/ButtonRenderer.java +++ b/client/src/main/java/com/vaadin/client/renderers/ButtonRenderer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -23,7 +23,7 @@ import com.vaadin.client.widget.grid.RendererCellReference; * A Renderer that displays buttons with textual captions. The values of the * corresponding column are used as the captions. Click handlers can be added to * the renderer, invoked when any of the rendered buttons is clicked. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/renderers/ClickableRenderer.java b/client/src/main/java/com/vaadin/client/renderers/ClickableRenderer.java index 91f02a019d..59caf4f150 100644 --- a/client/src/main/java/com/vaadin/client/renderers/ClickableRenderer.java +++ b/client/src/main/java/com/vaadin/client/renderers/ClickableRenderer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -40,12 +40,12 @@ import com.vaadin.shared.ui.grid.GridConstants.Section; * An abstract superclass for renderers that render clickable widgets. Click * handlers can be added to a renderer to listen to click events emitted by all * widgets rendered by the renderer. - * + * * @param <T> * the presentation (column) type * @param <W> * the widget type - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -54,17 +54,17 @@ public abstract class ClickableRenderer<T, W extends Widget> /** * A handler for {@link RendererClickEvent renderer click events}. - * + * * @param <R> * the row type of the containing Grid - * + * * @see {@link ButtonRenderer#addClickHandler(RendererClickHandler)} */ public interface RendererClickHandler<R> extends EventHandler { /** * Called when a rendered button is clicked. - * + * * @param event * the event representing the click */ @@ -74,7 +74,7 @@ public abstract class ClickableRenderer<T, W extends Widget> /** * An event fired when a widget rendered by a ClickableWidgetRenderer * subclass is clicked. - * + * * @param <R> * the row type of the containing Grid */ @@ -95,7 +95,7 @@ public abstract class ClickableRenderer<T, W extends Widget> /** * Returns the cell of the clicked button. - * + * * @return the cell */ public CellReference<R> getCell() { @@ -105,7 +105,7 @@ public abstract class ClickableRenderer<T, W extends Widget> /** * Returns the data object corresponding to the row of the clicked * button. - * + * * @return the row data object */ public R getRow() { @@ -138,7 +138,7 @@ public abstract class ClickableRenderer<T, W extends Widget> /** * Returns the cell the given element belongs to. - * + * * @param grid * the grid instance that is queried * @param e @@ -174,7 +174,7 @@ public abstract class ClickableRenderer<T, W extends Widget> * please refer to the note in * {@link WidgetUtil#findWidget(Element, Class) Util.findWidget} for * details. - * + * * @param e * the element whose parent grid to find * @return the parent grid or null if none found. @@ -209,7 +209,7 @@ public abstract class ClickableRenderer<T, W extends Widget> * <p> * Note that the row type of the click handler must match the row type of * the containing Grid. - * + * * @param handler * the click handler to be added */ diff --git a/client/src/main/java/com/vaadin/client/renderers/ComplexRenderer.java b/client/src/main/java/com/vaadin/client/renderers/ComplexRenderer.java index 262de79468..eeb0577737 100644 --- a/client/src/main/java/com/vaadin/client/renderers/ComplexRenderer.java +++ b/client/src/main/java/com/vaadin/client/renderers/ComplexRenderer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -32,11 +32,11 @@ import com.vaadin.client.widget.grid.RendererCellReference; * (override {@link #init(FlyweightCell)} and {@link #destroy(FlyweightCell) } * and event handling (see {@link #onBrowserEvent(Cell, NativeEvent)}, * {@link #getConsumedEvents()} and {@link #onActivate()}. - * + * * <p> * Also provides a helper method for hiding the cell contents by overriding * {@link #setContentVisible(FlyweightCell, boolean)} - * + * * @since 7.4.0 * @author Vaadin Ltd */ @@ -45,7 +45,7 @@ public abstract class ComplexRenderer<T> implements Renderer<T> { /** * Called at initialization stage. Perform any initialization here e.g. * attach handlers, attach widgets etc. - * + * * @param cell * The cell. Note that the cell is not to be stored outside of * the method as the cell instance will change. See @@ -59,7 +59,7 @@ public abstract class ComplexRenderer<T> implements Renderer<T> { * <p> * The row object in the cell reference will be <code>null</code> since the * row might no longer be present in the data source. - * + * * @param cell * The cell. Note that the cell is not to be stored outside of * the method as the cell instance will change. See @@ -73,9 +73,9 @@ public abstract class ComplexRenderer<T> implements Renderer<T> { * Returns the events that the renderer should consume. These are also the * events that the Grid will pass to * {@link #onBrowserEvent(Cell, NativeEvent)} when they occur. - * + * * @return a list of consumed events - * + * * @see com.google.gwt.dom.client.BrowserEvents */ public Collection<String> getConsumedEvents() { @@ -91,11 +91,11 @@ public abstract class ComplexRenderer<T> implements Renderer<T> { * <p> * Returns boolean telling if the event has been completely handled and * should not cause any other actions. - * + * * @param cell * Object containing information about the cell the event was * triggered on. - * + * * @param event * The original DOM event * @return true if event should not be handled by grid @@ -112,12 +112,12 @@ public abstract class ComplexRenderer<T> implements Renderer<T> { * Default implementation hides content by setting visibility: hidden to all * elements inside the cell. Text nodes are left as is - renderers that add * such to the root element need to implement explicit support hiding them. - * + * * @param cell * The cell * @param hasData * Has the cell content been loaded from the data source - * + * */ public void setContentVisible(RendererCellReference cell, boolean hasData) { Element cellElement = cell.getElement(); @@ -137,7 +137,7 @@ public abstract class ComplexRenderer<T> implements Renderer<T> { /** * Called when the cell is activated by pressing <code>enter</code>, double * clicking or performing a double tap on the cell. - * + * * @param cell * the activated cell * @return <code>true</code> if event was handled and should not be diff --git a/client/src/main/java/com/vaadin/client/renderers/DateRenderer.java b/client/src/main/java/com/vaadin/client/renderers/DateRenderer.java index c0a0d2a322..45f82ccff3 100644 --- a/client/src/main/java/com/vaadin/client/renderers/DateRenderer.java +++ b/client/src/main/java/com/vaadin/client/renderers/DateRenderer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,7 +24,7 @@ import com.vaadin.client.widget.grid.RendererCellReference; /** * A renderer for rendering dates into cells - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -57,7 +57,7 @@ public class DateRenderer implements Renderer<Date> { /** * Gets the format of how the date is formatted. - * + * * @return the format * @see <a href= * "http://www.gwtproject.org/javadoc/latest/com/google/gwt/i18n/shared/DateTimeFormat.html">GWT @@ -69,7 +69,7 @@ public class DateRenderer implements Renderer<Date> { /** * Sets the format used for formatting the dates. - * + * * @param format * the format to set * @see <a href= @@ -85,7 +85,7 @@ public class DateRenderer implements Renderer<Date> { /** * Returns the time zone of the date. - * + * * @return the time zone */ public TimeZone getTimeZone() { @@ -95,7 +95,7 @@ public class DateRenderer implements Renderer<Date> { /** * Sets the time zone of the the date. By default uses the time zone of the * browser. - * + * * @param timeZone * the timeZone to set */ diff --git a/client/src/main/java/com/vaadin/client/renderers/HtmlRenderer.java b/client/src/main/java/com/vaadin/client/renderers/HtmlRenderer.java index 13366f784f..fe0b96400d 100644 --- a/client/src/main/java/com/vaadin/client/renderers/HtmlRenderer.java +++ b/client/src/main/java/com/vaadin/client/renderers/HtmlRenderer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -26,7 +26,7 @@ import com.vaadin.client.widget.grid.RendererCellReference; * developer to ensure that the html string honors the {@link SafeHtml} * contract. For more information see * {@link SafeHtmlUtils#fromSafeConstant(String)}. - * + * * @since 7.4 * @author Vaadin Ltd * @see SafeHtmlUtils#fromSafeConstant(String) diff --git a/client/src/main/java/com/vaadin/client/renderers/ImageRenderer.java b/client/src/main/java/com/vaadin/client/renderers/ImageRenderer.java index d52bc1ba6d..bf27e1e822 100644 --- a/client/src/main/java/com/vaadin/client/renderers/ImageRenderer.java +++ b/client/src/main/java/com/vaadin/client/renderers/ImageRenderer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -23,7 +23,7 @@ import com.vaadin.client.widget.grid.RendererCellReference; * A renderer that renders an image into a cell. Click handlers can be added to * the renderer, invoked every time any of the images rendered by that rendered * is clicked. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/renderers/NumberRenderer.java b/client/src/main/java/com/vaadin/client/renderers/NumberRenderer.java index a040e8d1ce..5c8fe199d3 100644 --- a/client/src/main/java/com/vaadin/client/renderers/NumberRenderer.java +++ b/client/src/main/java/com/vaadin/client/renderers/NumberRenderer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -22,7 +22,7 @@ import com.vaadin.client.widget.grid.RendererCellReference; * Renders a number into a cell using a specific {@link NumberFormat}. By * default uses the default number format returned by * {@link NumberFormat#getDecimalFormat()}. - * + * * @since 7.4 * @author Vaadin Ltd * @param <T> @@ -42,7 +42,7 @@ public class NumberRenderer implements Renderer<Number> { /** * Gets the number format that the number should be formatted in. - * + * * @return the number format used to render the number */ public NumberFormat getFormat() { @@ -51,7 +51,7 @@ public class NumberRenderer implements Renderer<Number> { /** * Sets the number format to use for formatting the number. - * + * * @param format * the format to use * @throws IllegalArgumentException diff --git a/client/src/main/java/com/vaadin/client/renderers/ProgressBarRenderer.java b/client/src/main/java/com/vaadin/client/renderers/ProgressBarRenderer.java index 5b2c70d274..f945283542 100644 --- a/client/src/main/java/com/vaadin/client/renderers/ProgressBarRenderer.java +++ b/client/src/main/java/com/vaadin/client/renderers/ProgressBarRenderer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.vaadin.client.widget.grid.RendererCellReference; /** * A Renderer that represents a double value as a graphical progress bar. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/renderers/Renderer.java b/client/src/main/java/com/vaadin/client/renderers/Renderer.java index b2e9acd582..46b68b39de 100644 --- a/client/src/main/java/com/vaadin/client/renderers/Renderer.java +++ b/client/src/main/java/com/vaadin/client/renderers/Renderer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -25,10 +25,10 @@ import com.vaadin.client.widgets.Grid; * You can add a renderer to any column by overring the * {@link GridColumn#getRenderer()} method and returning your own renderer. You * can retrieve the cell element using {@link Cell#getElement()}. - * + * * @param <T> * The column type - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -42,11 +42,11 @@ public interface Renderer<T> { * It is recommended to set up the cell's DOM structure in * {@link ComplexRenderer#init(RendererCellReference)} and only make * incremental updates based on cell data in this method. - * + * * @param cell * The cell. Note that the cell is a flyweight and should not be * stored outside of the method as it will change. - * + * * @param data * The column data object */ diff --git a/client/src/main/java/com/vaadin/client/renderers/TextRenderer.java b/client/src/main/java/com/vaadin/client/renderers/TextRenderer.java index 3f704fd0b4..250eb35661 100644 --- a/client/src/main/java/com/vaadin/client/renderers/TextRenderer.java +++ b/client/src/main/java/com/vaadin/client/renderers/TextRenderer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.vaadin.client.widget.grid.RendererCellReference; /** * Renderer that renders text into a cell. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/renderers/WidgetRenderer.java b/client/src/main/java/com/vaadin/client/renderers/WidgetRenderer.java index 953662aa7f..8ad9d96bd6 100644 --- a/client/src/main/java/com/vaadin/client/renderers/WidgetRenderer.java +++ b/client/src/main/java/com/vaadin/client/renderers/WidgetRenderer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -22,7 +22,7 @@ import com.vaadin.client.widget.grid.RendererCellReference; /** * A renderer for rendering widgets into cells. - * + * * @since 7.4 * @author Vaadin Ltd * @param <T> @@ -41,7 +41,7 @@ public abstract class WidgetRenderer<T, W extends Widget> /** * Creates a widget to attach to a cell. The widgets will be attached to the * cell after the cell element has been attached to DOM. - * + * * @return widget to attach to a cell. All returned instances should be new * widget instances without a parent. */ @@ -65,7 +65,7 @@ public abstract class WidgetRenderer<T, W extends Widget> * minimum since it will be called continuously while the user is scrolling. * The renderer can use {@link Widget#setLayoutData(Object)} to store cell * data that might be needed in e.g. event listeners. - * + * * @param cell * The cell to render. Note that the cell is a flyweight and * should not be stored and used outside of this method as its @@ -80,7 +80,7 @@ public abstract class WidgetRenderer<T, W extends Widget> /** * Returns the widget contained inside the given cell element. Cannot be * called for cells that do not contain a widget. - * + * * @param e * the element inside which to find a widget * @return the widget inside the element @@ -95,7 +95,7 @@ public abstract class WidgetRenderer<T, W extends Widget> * Returns the widget contained inside the given cell element, or null if it * is not an instance of the given class. Cannot be called for cells that do * not contain a widget. - * + * * @param e * the element inside to find a widget * @param klass diff --git a/client/src/main/java/com/vaadin/client/ui/AbstractClickEventHandler.java b/client/src/main/java/com/vaadin/client/ui/AbstractClickEventHandler.java index e7409e0ba3..b4688f19ad 100644 --- a/client/src/main/java/com/vaadin/client/ui/AbstractClickEventHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/AbstractClickEventHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -128,7 +128,7 @@ public abstract class AbstractClickEventHandler implements MouseDownHandler, * <p> * By default registers the handler with the connector root widget. * </p> - * + * * @param <H> * @param handler * The handler to register @@ -143,7 +143,7 @@ public abstract class AbstractClickEventHandler implements MouseDownHandler, /** * Checks if there is a server side event listener registered for clicks - * + * * @return true if there is a server side event listener registered, false * otherwise */ @@ -200,7 +200,7 @@ public abstract class AbstractClickEventHandler implements MouseDownHandler, /** * Sends the click event based on the given native event. - * + * * @param event * The native event that caused this click event */ @@ -209,7 +209,7 @@ public abstract class AbstractClickEventHandler implements MouseDownHandler, /** * Called before firing a click event. Allows sub classes to decide if this * in an event that should cause an event or not. - * + * * @param event * The user event * @return true if the event should be fired, false otherwise @@ -235,7 +235,7 @@ public abstract class AbstractClickEventHandler implements MouseDownHandler, * Click event calculates and returns coordinates relative to the element * returned by this method. Default implementation uses the root element of * the widget. Override to provide a different relative element. - * + * * @return The Element used for calculating relative coordinates for a click * or null if no relative coordinates can be calculated. */ diff --git a/client/src/main/java/com/vaadin/client/ui/AbstractComponentConnector.java b/client/src/main/java/com/vaadin/client/ui/AbstractComponentConnector.java index 5879ac8208..75370114ac 100644 --- a/client/src/main/java/com/vaadin/client/ui/AbstractComponentConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/AbstractComponentConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -140,10 +140,10 @@ public abstract class AbstractComponentConnector extends AbstractConnector /** * The new default behaviour is for long taps to fire a contextclick event * if there's a contextclick listener attached to the component. - * + * * If you do not want this in your component, override this with a blank * method to get rid of said behaviour. - * + * * @since 7.6 */ protected void unregisterTouchHandlers() { @@ -164,13 +164,13 @@ public abstract class AbstractComponentConnector extends AbstractConnector /** * The new default behaviour is for long taps to fire a contextclick event * if there's a contextclick listener attached to the component. - * + * * If you do not want this in your component, override this with a blank * method to get rid of said behaviour. - * + * * Some Vaadin Components already handle the long tap as a context menu. * This method is unnecessary for those. - * + * * @since 7.6 */ protected void registerTouchHandlers() { @@ -290,7 +290,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector /** * If a long touch event timer is running, cancel it. - * + * * @since 7.6 */ private void cancelTouchTimer() { @@ -304,7 +304,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector /** * Cancel the timer recursively for parent components that have timers * running - * + * * @since 7.6 */ private void cancelParentTouchTimers() { @@ -326,7 +326,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector * This method sends the context menu event to the server-side. Can be * overridden to provide extra information through an alternative RPC * interface. - * + * * @since 7.6 * @param event */ @@ -351,7 +351,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector * can't call <code>super.createWidget()</code> since the metadata needed * for that implementation is not generated if there's an override of the * method. - * + * * @return a new widget instance to use for this component connector */ protected Widget createWidget() { @@ -374,7 +374,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector /** * Returns the widget associated with this paintable. The widget returned by * this method must not changed during the life time of the paintable. - * + * * @return The widget associated with this paintable */ @Override @@ -517,7 +517,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector /** * Updates the component size, invoking the {@link LayoutManager layout * manager} if necessary. - * + * * @param newWidth * The new width as a CSS string. Cannot be null. * @param newHeight @@ -568,7 +568,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector /** * Updates the DOM size of this connector's {@link #getWidget() widget}. - * + * * @since 7.1.15 * @param newWidth * The new width as a CSS string. Cannot be null. @@ -602,7 +602,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ComponentConnector#delegateCaptionHandling () */ @Override @@ -679,7 +679,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector * updated in another widget in addition to the one returned by the * {@link #getWidget()}. * </p> - * + * * @param styleName * the style name to be added or removed * @param add @@ -700,7 +700,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector * different. For example see * {@link com.vaadin.client.ui.datefield.DateFieldConnector#setWidgetStyleNameWithPrefix(String, String, boolean)} * </p> - * + * * @param styleName * the style name to be added or removed * @param add @@ -726,7 +726,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ComponentConnector#isReadOnly() */ @Override @@ -783,7 +783,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector /** * Gets the URI of the icon set for this component. - * + * * @return the URI of the icon, or <code>null</code> if no icon has been * defined. */ @@ -793,7 +793,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector /** * Gets the icon set for this component. - * + * * @return the icon, or <code>null</code> if no icon has been defined. */ protected Icon getIcon() { @@ -802,7 +802,7 @@ public abstract class AbstractComponentConnector extends AbstractConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ComponentConnector#flush() */ @Override diff --git a/client/src/main/java/com/vaadin/client/ui/AbstractComponentContainerConnector.java b/client/src/main/java/com/vaadin/client/ui/AbstractComponentContainerConnector.java index a7867effbd..4e8b2a087e 100644 --- a/client/src/main/java/com/vaadin/client/ui/AbstractComponentContainerConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/AbstractComponentContainerConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -17,7 +17,7 @@ package com.vaadin.client.ui; /** * Client side connector for subclasses of AbstractComponentConnector. - * + * * @since 7.0 */ public abstract class AbstractComponentContainerConnector diff --git a/client/src/main/java/com/vaadin/client/ui/AbstractConnector.java b/client/src/main/java/com/vaadin/client/ui/AbstractConnector.java index c6348e9de1..15a62b4817 100644 --- a/client/src/main/java/com/vaadin/client/ui/AbstractConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/AbstractConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -49,10 +49,10 @@ import com.vaadin.shared.communication.URLReference; /** * An abstract implementation of Connector. - * + * * @author Vaadin Ltd * @since 7.0.0 - * + * */ public abstract class AbstractConnector implements ServerConnector, StateChangeHandler { @@ -85,7 +85,7 @@ public abstract class AbstractConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.VPaintable#getConnection() */ @Override @@ -95,7 +95,7 @@ public abstract class AbstractConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.Connector#getId() */ @Override @@ -144,10 +144,10 @@ public abstract class AbstractConnector /** * Registers an implementation for a server to client RPC interface. - * + * * Multiple registrations can be made for a single interface, in which case * all of them receive corresponding RPC calls. - * + * * @param rpcInterface * RPC interface * @param implementation @@ -169,7 +169,7 @@ public abstract class AbstractConnector /** * Unregisters an implementation for a server to client RPC interface. - * + * * @param rpcInterface * RPC interface * @param implementation @@ -187,7 +187,7 @@ public abstract class AbstractConnector /** * Returns an RPC proxy object which can be used to invoke the RPC method on * the server. - * + * * @param <T> * The type of the ServerRpc interface * @param rpcInterface @@ -336,7 +336,7 @@ public abstract class AbstractConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ServerConnector#onUnregister() */ @Override @@ -350,9 +350,9 @@ public abstract class AbstractConnector /** * Returns the shared state object for this connector. - * + * * Override this method to define the shared state type for your connector. - * + * * @return the current shared state (never null) */ @Override @@ -371,7 +371,7 @@ public abstract class AbstractConnector * created state object must be compatible with the return type of * {@link #getState()}. The default implementation creates a state object * using GWT.create() using the defined return type of {@link #getState()}. - * + * * @return A new state object */ protected SharedState createState() { @@ -460,7 +460,7 @@ public abstract class AbstractConnector * {@link com.vaadin.terminal.AbstractClientConnector#setResource(String, com.vaadin.terminal.Resource)} * with the same key. <code>null</code> is returned if no corresponding * resource is found. - * + * * @param key * a string identifying the resource. * @return the resource URL as a string, or <code>null</code> if no @@ -477,7 +477,7 @@ public abstract class AbstractConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ServerConnector#hasEventListener(java.lang.String) */ @Override @@ -489,7 +489,7 @@ public abstract class AbstractConnector /** * Force the connector to recheck its state variables as the variables or * their meaning might have changed. - * + * * @since 7.3 */ public void forceStateChange() { diff --git a/client/src/main/java/com/vaadin/client/ui/AbstractFieldConnector.java b/client/src/main/java/com/vaadin/client/ui/AbstractFieldConnector.java index f54ff85a13..a093f2f3ef 100644 --- a/client/src/main/java/com/vaadin/client/ui/AbstractFieldConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/AbstractFieldConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -37,10 +37,10 @@ public abstract class AbstractFieldConnector /** * Checks whether the required indicator should be shown for the field. - * + * * Required indicators are hidden if the field or its data source is * read-only. - * + * * @return true if required indicator should be shown */ public boolean isRequired() { diff --git a/client/src/main/java/com/vaadin/client/ui/AbstractHasComponentsConnector.java b/client/src/main/java/com/vaadin/client/ui/AbstractHasComponentsConnector.java index c340c8ae31..50ecd7a014 100644 --- a/client/src/main/java/com/vaadin/client/ui/AbstractHasComponentsConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/AbstractHasComponentsConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -39,7 +39,7 @@ public abstract class AbstractHasComponentsConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.HasComponentsConnector#getChildren() */ @Override @@ -53,7 +53,7 @@ public abstract class AbstractHasComponentsConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.HasComponentsConnector#setChildren * (java.util.Collection) */ diff --git a/client/src/main/java/com/vaadin/client/ui/AbstractLayoutConnector.java b/client/src/main/java/com/vaadin/client/ui/AbstractLayoutConnector.java index 32157dce9e..b18acdf9bb 100644 --- a/client/src/main/java/com/vaadin/client/ui/AbstractLayoutConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/AbstractLayoutConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/AbstractSingleComponentContainerConnector.java b/client/src/main/java/com/vaadin/client/ui/AbstractSingleComponentContainerConnector.java index ff633b0728..9c93d91177 100644 --- a/client/src/main/java/com/vaadin/client/ui/AbstractSingleComponentContainerConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/AbstractSingleComponentContainerConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -22,7 +22,7 @@ import com.vaadin.client.ComponentConnector; /** * Client side connector for subclasses of AbstractSingleComponentConnector. - * + * * @since 7.0 */ public abstract class AbstractSingleComponentContainerConnector @@ -30,7 +30,7 @@ public abstract class AbstractSingleComponentContainerConnector /** * Returns the content (only/first child) of the container. - * + * * @return child connector or null if none (e.g. invisible or not set on * server) */ @@ -45,7 +45,7 @@ public abstract class AbstractSingleComponentContainerConnector /** * Returns the widget (if any) of the content of the container. - * + * * @return widget of the only/first connector of the container, null if no * content or if there is no widget for the connector */ diff --git a/client/src/main/java/com/vaadin/client/ui/Action.java b/client/src/main/java/com/vaadin/client/ui/Action.java index d7593740d6..6dc7d95d74 100644 --- a/client/src/main/java/com/vaadin/client/ui/Action.java +++ b/client/src/main/java/com/vaadin/client/ui/Action.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ package com.vaadin.client.ui; import com.google.gwt.user.client.Command; /** - * + * */ public abstract class Action implements Command { @@ -72,7 +72,7 @@ public abstract class Action implements Command { /* * (non-Javadoc) - * + * * @see java.lang.Object#toString() */ @Override diff --git a/client/src/main/java/com/vaadin/client/ui/ActionOwner.java b/client/src/main/java/com/vaadin/client/ui/ActionOwner.java index 73c3675438..d775a8ca5e 100644 --- a/client/src/main/java/com/vaadin/client/ui/ActionOwner.java +++ b/client/src/main/java/com/vaadin/client/ui/ActionOwner.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/CalendarEntry.java b/client/src/main/java/com/vaadin/client/ui/CalendarEntry.java index 8050f0aab1..e40903009a 100644 --- a/client/src/main/java/com/vaadin/client/ui/CalendarEntry.java +++ b/client/src/main/java/com/vaadin/client/ui/CalendarEntry.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/ClickEventHandler.java b/client/src/main/java/com/vaadin/client/ui/ClickEventHandler.java index 7947e0560c..0a24bb5122 100644 --- a/client/src/main/java/com/vaadin/client/ui/ClickEventHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/ClickEventHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -35,7 +35,7 @@ public abstract class ClickEventHandler extends AbstractClickEventHandler { /** * Sends the click event based on the given native event. Delegates actual * sending to {@link #fireClick(MouseEventDetails)}. - * + * * @param event * The native event that caused this click event */ @@ -49,10 +49,10 @@ public abstract class ClickEventHandler extends AbstractClickEventHandler { /** * Sends the click event to the server. Must be implemented by sub classes, * typically by calling an RPC method. - * + * * @param event * The event that caused this click to be fired - * + * * @param mouseDetails * The mouse details for the event */ diff --git a/client/src/main/java/com/vaadin/client/ui/ConnectorFocusAndBlurHandler.java b/client/src/main/java/com/vaadin/client/ui/ConnectorFocusAndBlurHandler.java index ede1cfa3ae..fd7c4d1f53 100644 --- a/client/src/main/java/com/vaadin/client/ui/ConnectorFocusAndBlurHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/ConnectorFocusAndBlurHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -31,7 +31,7 @@ import com.vaadin.shared.communication.FieldRpc.FocusAndBlurServerRpc; * A handler for focus and blur events which uses {@link FocusAndBlurServerRpc} * to transmit received events to the server. Events are only handled if there * is a corresponding listener on the server side. - * + * * @since 7.6 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/ui/Field.java b/client/src/main/java/com/vaadin/client/ui/Field.java index 99bfe107b3..8a5e8e96b8 100644 --- a/client/src/main/java/com/vaadin/client/ui/Field.java +++ b/client/src/main/java/com/vaadin/client/ui/Field.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -14,14 +14,14 @@ * the License. */ /** - * + * */ package com.vaadin.client.ui; /** * This interface indicates that the component is a Field (serverside), and * wants (for instance) to automatically get the v-modified classname. - * + * */ public interface Field { diff --git a/client/src/main/java/com/vaadin/client/ui/FocusElementPanel.java b/client/src/main/java/com/vaadin/client/ui/FocusElementPanel.java index d0ddca0935..3aa087f7d1 100644 --- a/client/src/main/java/com/vaadin/client/ui/FocusElementPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/FocusElementPanel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/FocusUtil.java b/client/src/main/java/com/vaadin/client/ui/FocusUtil.java index 98520f249a..27a1015d77 100644 --- a/client/src/main/java/com/vaadin/client/ui/FocusUtil.java +++ b/client/src/main/java/com/vaadin/client/ui/FocusUtil.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,17 +21,17 @@ import com.google.gwt.user.client.ui.Widget; /** * A helper class used to make it easier for {@link Widget}s to implement * {@link Focusable}. - * + * * @author Vaadin Ltd * @version @VERSION@ * @since 7.0.3 - * + * */ public class FocusUtil { /** * Sets the access key property - * + * * @param focusable * The widget for which we want to set the access key. * @param key @@ -46,7 +46,7 @@ public class FocusUtil { /** * Explicitly focus/unfocus the given widget. Only one widget can have focus * at a time, and the widget that does will receive all keyboard events. - * + * * @param focusable * the widget to focus/unfocus * @param focused @@ -68,7 +68,7 @@ public class FocusUtil { * the same tab index, each such widget will receive focus in an arbitrary * order. Setting the tab index to <code>-1</code> will cause the widget to * be removed from the tab order. - * + * * @param focusable * The widget * @param tabIndex @@ -83,10 +83,10 @@ public class FocusUtil { /** * Gets the widget's position in the tab index. - * + * * @param focusable * The widget - * + * * @return the widget's tab index */ public static int getTabIndex(Widget focusable) { diff --git a/client/src/main/java/com/vaadin/client/ui/FocusableFlexTable.java b/client/src/main/java/com/vaadin/client/ui/FocusableFlexTable.java index 8deec2babb..13628e1413 100644 --- a/client/src/main/java/com/vaadin/client/ui/FocusableFlexTable.java +++ b/client/src/main/java/com/vaadin/client/ui/FocusableFlexTable.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -49,7 +49,7 @@ public class FocusableFlexTable extends FlexTable implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasFocusHandlers#addFocusHandler(com. * google.gwt.event.dom.client.FocusHandler) @@ -61,7 +61,7 @@ public class FocusableFlexTable extends FlexTable implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasBlurHandlers#addBlurHandler(com.google * .gwt.event.dom.client.BlurHandler) @@ -73,7 +73,7 @@ public class FocusableFlexTable extends FlexTable implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasKeyDownHandlers#addKeyDownHandler( * com.google.gwt.event.dom.client.KeyDownHandler) @@ -85,7 +85,7 @@ public class FocusableFlexTable extends FlexTable implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasKeyPressHandlers#addKeyPressHandler * (com.google.gwt.event.dom.client.KeyPressHandler) @@ -97,7 +97,7 @@ public class FocusableFlexTable extends FlexTable implements HasFocusHandlers, /** * Sets the keyboard focus to the panel - * + * * @param focus * Should the panel have keyboard focus. If true the keyboard * focus will be moved to the @@ -112,7 +112,7 @@ public class FocusableFlexTable extends FlexTable implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see com.vaadin.client.Focusable#focus() */ @Override diff --git a/client/src/main/java/com/vaadin/client/ui/FocusableFlowPanel.java b/client/src/main/java/com/vaadin/client/ui/FocusableFlowPanel.java index 77a26361ef..f2d84cf590 100644 --- a/client/src/main/java/com/vaadin/client/ui/FocusableFlowPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/FocusableFlowPanel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -46,7 +46,7 @@ public class FocusableFlowPanel extends FlowPanel implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasFocusHandlers#addFocusHandler(com. * google.gwt.event.dom.client.FocusHandler) @@ -58,7 +58,7 @@ public class FocusableFlowPanel extends FlowPanel implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasBlurHandlers#addBlurHandler(com.google * .gwt.event.dom.client.BlurHandler) @@ -70,7 +70,7 @@ public class FocusableFlowPanel extends FlowPanel implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasKeyDownHandlers#addKeyDownHandler( * com.google.gwt.event.dom.client.KeyDownHandler) @@ -82,7 +82,7 @@ public class FocusableFlowPanel extends FlowPanel implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasKeyPressHandlers#addKeyPressHandler * (com.google.gwt.event.dom.client.KeyPressHandler) @@ -94,7 +94,7 @@ public class FocusableFlowPanel extends FlowPanel implements HasFocusHandlers, /** * Sets/Removes the keyboard focus to the panel. - * + * * @param focus * If set to true then the focus is moved to the panel, if set to * false the focus is removed diff --git a/client/src/main/java/com/vaadin/client/ui/FocusableScrollPanel.java b/client/src/main/java/com/vaadin/client/ui/FocusableScrollPanel.java index 3815372923..e49e7692c1 100644 --- a/client/src/main/java/com/vaadin/client/ui/FocusableScrollPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/FocusableScrollPanel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -37,7 +37,7 @@ import com.vaadin.client.BrowserInfo; /** * A scrollhandlers similar to {@link ScrollPanel}. - * + * */ public class FocusableScrollPanel extends SimpleFocusablePanel implements HasScrollHandlers, ScrollHandler { @@ -131,7 +131,7 @@ public class FocusableScrollPanel extends SimpleFocusablePanel /** * Gets the horizontal scroll position. - * + * * @return the horizontal scroll position, in pixels */ public int getHorizontalScrollPosition() { @@ -140,7 +140,7 @@ public class FocusableScrollPanel extends SimpleFocusablePanel /** * Gets the vertical scroll position. - * + * * @return the vertical scroll position, in pixels */ public int getScrollPosition() { @@ -153,7 +153,7 @@ public class FocusableScrollPanel extends SimpleFocusablePanel /** * Sets the horizontal scroll position. - * + * * @param position * the new horizontal scroll position, in pixels */ @@ -163,7 +163,7 @@ public class FocusableScrollPanel extends SimpleFocusablePanel /** * Sets the vertical scroll position. - * + * * @param position * the new vertical scroll position, in pixels */ diff --git a/client/src/main/java/com/vaadin/client/ui/FontIcon.java b/client/src/main/java/com/vaadin/client/ui/FontIcon.java index aa7a0d3b2b..d5a1e9579a 100644 --- a/client/src/main/java/com/vaadin/client/ui/FontIcon.java +++ b/client/src/main/java/com/vaadin/client/ui/FontIcon.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -27,7 +27,7 @@ import com.vaadin.shared.ApplicationConstants; * (identified by font-family, {@link #getFontFamily()}, * {@link #setFontFamily(String)}). * </p> - * + * * @since 7.2 * @author Vaadin Ltd */ @@ -53,7 +53,7 @@ public class FontIcon extends Icon { /** * Not implemeted for {@link FontIcon} yet. - * + * * @see com.vaadin.client.ui.Icon#setAlternateText(java.lang.String) */ @Override @@ -67,7 +67,7 @@ public class FontIcon extends Icon { * Sets the font-family from which this icon comes. Use * {@link #setCodepoint(int)} to specify a particular icon (character) * within the font. - * + * * @param fontFamily * font-family name */ @@ -85,7 +85,7 @@ public class FontIcon extends Icon { * Gets the font-family from which this icon comes. Use * {@link #getCodepoint()} to find out which particular icon (character) * within the font this is. - * + * * @return font-family name */ public String getFontFamily() { @@ -95,7 +95,7 @@ public class FontIcon extends Icon { /** * Sets the codepoint indicating which particular icon (character) within * the font-family this is. - * + * * @param codepoint */ protected void setCodepoint(int codepoint) { @@ -106,7 +106,7 @@ public class FontIcon extends Icon { /** * Gets the codepoint indicating which particular icon (character) within * the font-family this is. - * + * * @return */ public int getCodepoint() { @@ -115,7 +115,7 @@ public class FontIcon extends Icon { /** * Get the font-family based stylename used to apply the font-family. - * + * * @since 7.2 * @return stylename used to apply font-family */ @@ -129,7 +129,7 @@ public class FontIcon extends Icon { /** * Checks whether or not the given uri is a font icon uri. Does not check * whether or not the font icon is available and can be rendered. - * + * * @since 7.2 * @param uri * @return true if it's a fonticon uri diff --git a/client/src/main/java/com/vaadin/client/ui/Icon.java b/client/src/main/java/com/vaadin/client/ui/Icon.java index 277fc2dd5d..f3cc3f3785 100644 --- a/client/src/main/java/com/vaadin/client/ui/Icon.java +++ b/client/src/main/java/com/vaadin/client/ui/Icon.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.ApplicationConnection; /** * An abstract representation of an icon. - * + * * @since 7.2 * @author Vaadin Ltd */ @@ -35,7 +35,7 @@ public abstract class Icon extends UIObject { * This might be a URL referencing a image (e.g {@link ImageIcon}) or a * custom URI (e.g {@link FontIcon}). * </p> - * + * * @param uri * the URI for this icon */ @@ -43,14 +43,14 @@ public abstract class Icon extends UIObject { /** * Gets the current URI for this icon. - * + * * @return URI in use */ public abstract String getUri(); /** * Sets the alternate text for the icon. - * + * * @param alternateText * with the alternate text. */ diff --git a/client/src/main/java/com/vaadin/client/ui/ImageIcon.java b/client/src/main/java/com/vaadin/client/ui/ImageIcon.java index 7174c73637..b3e2166142 100644 --- a/client/src/main/java/com/vaadin/client/ui/ImageIcon.java +++ b/client/src/main/java/com/vaadin/client/ui/ImageIcon.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -28,7 +28,7 @@ import com.vaadin.client.BrowserInfo; * The image is loaded from the given URL ( {@link #setUri(String)}) and * displayed in full. * </p> - * + * * @author Vaadin Ltd */ public class ImageIcon extends Icon { diff --git a/client/src/main/java/com/vaadin/client/ui/JavaScriptComponentConnector.java b/client/src/main/java/com/vaadin/client/ui/JavaScriptComponentConnector.java index a3a03b597b..c6be984759 100644 --- a/client/src/main/java/com/vaadin/client/ui/JavaScriptComponentConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/JavaScriptComponentConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/JavaScriptWidget.java b/client/src/main/java/com/vaadin/client/ui/JavaScriptWidget.java index da9192dace..7691888e76 100644 --- a/client/src/main/java/com/vaadin/client/ui/JavaScriptWidget.java +++ b/client/src/main/java/com/vaadin/client/ui/JavaScriptWidget.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/JsniMousewheelHandler.java b/client/src/main/java/com/vaadin/client/ui/JsniMousewheelHandler.java index 82ea768871..58ad36855a 100644 --- a/client/src/main/java/com/vaadin/client/ui/JsniMousewheelHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/JsniMousewheelHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,9 +24,9 @@ import com.vaadin.client.widgets.Escalator; /** * A mousewheel handling class to get around the limits of * {@link Event#ONMOUSEWHEEL}. - * + * * For internal use only. May be removed or replaced in the future. - * + * * @see Escalator.JsniWorkaround */ abstract class JsniMousewheelHandler { @@ -34,7 +34,7 @@ abstract class JsniMousewheelHandler { /** * A JavaScript function that handles the mousewheel DOM event, and passes * it on to Java code. - * + * * @see #createMousewheelListenerFunction(Widget) */ protected final JavaScriptObject mousewheelListenerFunction; @@ -46,7 +46,7 @@ abstract class JsniMousewheelHandler { /** * A method that constructs the JavaScript function that will be stored into * {@link #mousewheelListenerFunction}. - * + * * @param widget * a reference to the current instance of {@link Widget} */ diff --git a/client/src/main/java/com/vaadin/client/ui/LayoutClickEventHandler.java b/client/src/main/java/com/vaadin/client/ui/LayoutClickEventHandler.java index ca23890310..d5b731ca13 100644 --- a/client/src/main/java/com/vaadin/client/ui/LayoutClickEventHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/LayoutClickEventHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/LegacyConnector.java b/client/src/main/java/com/vaadin/client/ui/LegacyConnector.java index 35a82cff53..891f7f6a1d 100644 --- a/client/src/main/java/com/vaadin/client/ui/LegacyConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/LegacyConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/ManagedLayout.java b/client/src/main/java/com/vaadin/client/ui/ManagedLayout.java index e7266d99b5..ab17e4023b 100644 --- a/client/src/main/java/com/vaadin/client/ui/ManagedLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/ManagedLayout.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/MediaBaseConnector.java b/client/src/main/java/com/vaadin/client/ui/MediaBaseConnector.java index fdd9610517..c2300de671 100644 --- a/client/src/main/java/com/vaadin/client/ui/MediaBaseConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/MediaBaseConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/PostLayoutListener.java b/client/src/main/java/com/vaadin/client/ui/PostLayoutListener.java index bbeb6f1255..ed108d91a8 100644 --- a/client/src/main/java/com/vaadin/client/ui/PostLayoutListener.java +++ b/client/src/main/java/com/vaadin/client/ui/PostLayoutListener.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -23,7 +23,7 @@ import com.vaadin.client.LayoutManager; * to know whenever a layout phase has ended. At the end of each layout phase, * {@link LayoutManager} invokes the {@link #postLayout()} method for all * registered component connectors implementing this interface. - * + * * @since 7.0 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/ui/SimpleFocusablePanel.java b/client/src/main/java/com/vaadin/client/ui/SimpleFocusablePanel.java index 0cc5ff6ef5..6d989988a7 100644 --- a/client/src/main/java/com/vaadin/client/ui/SimpleFocusablePanel.java +++ b/client/src/main/java/com/vaadin/client/ui/SimpleFocusablePanel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/SimpleManagedLayout.java b/client/src/main/java/com/vaadin/client/ui/SimpleManagedLayout.java index e61e2799c4..4a4990e132 100644 --- a/client/src/main/java/com/vaadin/client/ui/SimpleManagedLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/SimpleManagedLayout.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/SubPartAware.java b/client/src/main/java/com/vaadin/client/ui/SubPartAware.java index 7a40eea20e..4e8b861d01 100644 --- a/client/src/main/java/com/vaadin/client/ui/SubPartAware.java +++ b/client/src/main/java/com/vaadin/client/ui/SubPartAware.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.google.gwt.user.client.ui.Widget; /** * Interface implemented by {@link Widget}s which can provide identifiers for at * least one element inside the component. - * + * */ public interface SubPartAware { @@ -28,7 +28,7 @@ public interface SubPartAware { * Locates an element inside a component using the identifier provided in * {@code subPart}. The {@code subPart} identifier is component specific and * may be any string of characters, numbers, space characters and brackets. - * + * * @param subPart * The identifier for the element inside the component * @return The element identified by subPart or null if the element could @@ -49,7 +49,7 @@ public interface SubPartAware { * identifier for the root element even though a DIV inside the button was * passed as {@code subElement} because interactions with the DIV and the * root button element produce the same result. - * + * * @param subElement * The element the identifier string should uniquely identify * @return An identifier that uniquely identifies {@code subElement} or null diff --git a/client/src/main/java/com/vaadin/client/ui/TouchScrollDelegate.java b/client/src/main/java/com/vaadin/client/ui/TouchScrollDelegate.java index c6a63cbd6b..7ef673ad68 100644 --- a/client/src/main/java/com/vaadin/client/ui/TouchScrollDelegate.java +++ b/client/src/main/java/com/vaadin/client/ui/TouchScrollDelegate.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -57,26 +57,26 @@ import com.vaadin.client.VConsole; * Scroll event should only happen when the "touch scrolling actually ends". * Later we might also tune this so that a scroll event happens if user stalls * her finger long enought. - * + * * TODO static getter for active touch scroll delegate. Components might need to * prevent scrolling in some cases. Consider Table with drag and drop, or drag * and drop in scrollable area. Optimal implementation might be to start the * drag and drop only if user keeps finger down for a moment, otherwise do the * scroll. In this case, the draggable component would need to cancel scrolling * in a timer after touchstart event and take over from there. - * + * * TODO support scrolling horizontally - * + * * TODO cancel if user add second finger to the screen (user expects a gesture). - * + * * TODO "scrollbars", see e.g. iscroll.js - * + * * TODO write an email to sjobs √§t apple dot com and beg for this feature to be * built into webkit. Seriously, we should try to lobbying this to webkit folks. * This sure ain't our business to implement this with javascript. - * + * * TODO collect all general touch related constant to better place. - * + * * @author Matti Tahvonen, Vaadin Ltd */ public class TouchScrollDelegate implements NativePreviewHandler { @@ -129,12 +129,12 @@ public class TouchScrollDelegate implements NativePreviewHandler { /** * Attaches the scroll handler to the widget. This method must be called * before calling any other methods in this class. - * + * * @param widget * The widget that contains scrollable elements * @param scrollables * The elements of the widget that should be scrollable. - * + * * @deprecated Use {@link GWT#create(Class)} and * {@link #init(Widget, Element...)} instead of this * constructor to enable overriding. @@ -148,7 +148,7 @@ public class TouchScrollDelegate implements NativePreviewHandler { /** * Attaches the scroll handler to the widget. This method must be called * once before calling any other method in this class. - * + * * @param widget * The widget that contains scrollable elements * @param scrollables @@ -202,7 +202,7 @@ public class TouchScrollDelegate implements NativePreviewHandler { /** * Registers the given elements as scrollable, removing previously * registered scrollables from this handler. - * + * * @param scrollables * The elements that should be scrollable */ @@ -223,7 +223,7 @@ public class TouchScrollDelegate implements NativePreviewHandler { * scrolling of the device should be used. By default, relies on * {@link BrowserInfo#requiresTouchScrollDelegate()}, override to change * the behavior. - * + * * @return true if a Javascript delegate should be used for scrolling, * false to use the native scrolling of the device */ @@ -242,7 +242,7 @@ public class TouchScrollDelegate implements NativePreviewHandler { /** * Makes the given elements scrollable, either natively or by using a * TouchScrollDelegate, depending on platform capabilities. - * + * * @param widget * The widget that contains scrollable elements * @param scrollables @@ -270,7 +270,7 @@ public class TouchScrollDelegate implements NativePreviewHandler { /** * Has user moved the touch. - * + * * @return */ public boolean isMoved() { @@ -399,7 +399,7 @@ public class TouchScrollDelegate implements NativePreviewHandler { /** * Detects if a touch happens on a predefined element and the element has * something to scroll. - * + * * @param touch * @return */ @@ -480,7 +480,7 @@ public class TouchScrollDelegate implements NativePreviewHandler { private Animation momentum; /** - * + * * @param event * @return */ @@ -610,7 +610,7 @@ public class TouchScrollDelegate implements NativePreviewHandler { /** * Note positive scrolltop moves layer up, positive translate moves layer * down. - * + * * @param duration */ private void translateTo(int duration, final int fromY, final int finalY) { @@ -713,7 +713,7 @@ public class TouchScrollDelegate implements NativePreviewHandler { /** * long calcucation are not very efficient in GWT, so this helper method * returns timestamp in double. - * + * * @return */ public static double getTimeStamp() { diff --git a/client/src/main/java/com/vaadin/client/ui/TreeAction.java b/client/src/main/java/com/vaadin/client/ui/TreeAction.java index f190ab62d2..222c0f8108 100644 --- a/client/src/main/java/com/vaadin/client/ui/TreeAction.java +++ b/client/src/main/java/com/vaadin/client/ui/TreeAction.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -38,9 +38,9 @@ public class TreeAction extends Action { * Sends message to server that this action has been fired. Messages are * "standard" Vaadin messages whose value is comma separated pair of * targetKey (row, treeNod ...) and actions id. - * + * * Variablename is always "action". - * + * * Actions are always sent immediatedly to server. */ @Override diff --git a/client/src/main/java/com/vaadin/client/ui/UnknownComponentConnector.java b/client/src/main/java/com/vaadin/client/ui/UnknownComponentConnector.java index 2a631d62e3..bb06aa3507 100644 --- a/client/src/main/java/com/vaadin/client/ui/UnknownComponentConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/UnknownComponentConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VAbsoluteLayout.java b/client/src/main/java/com/vaadin/client/ui/VAbsoluteLayout.java index e85b6583b2..880463dfa3 100644 --- a/client/src/main/java/com/vaadin/client/ui/VAbsoluteLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/VAbsoluteLayout.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -53,7 +53,7 @@ public class VAbsoluteLayout extends ComplexPanel { /* * (non-Javadoc) - * + * * @see * com.google.gwt.user.client.ui.Panel#add(com.google.gwt.user.client.ui * .Widget) @@ -67,7 +67,7 @@ public class VAbsoluteLayout extends ComplexPanel { /* * (non-Javadoc) - * + * * @see * com.google.gwt.user.client.ui.ComplexPanel#remove(com.google.gwt.user * .client.ui.Widget) @@ -84,7 +84,7 @@ public class VAbsoluteLayout extends ComplexPanel { /** * Does this layout contain a widget - * + * * @param widget * The widget to check * @return Returns true if the widget is in this layout, false if not @@ -95,7 +95,7 @@ public class VAbsoluteLayout extends ComplexPanel { /* * (non-Javadoc) - * + * * @see com.google.gwt.user.client.ui.ComplexPanel#getWidget(int) */ @Override @@ -115,7 +115,7 @@ public class VAbsoluteLayout extends ComplexPanel { /* * (non-Javadoc) - * + * * @see com.google.gwt.user.client.ui.ComplexPanel#getWidgetCount() */ @Override @@ -131,7 +131,7 @@ public class VAbsoluteLayout extends ComplexPanel { /* * (non-Javadoc) - * + * * @see * com.google.gwt.user.client.ui.ComplexPanel#getWidgetIndex(com.google. * gwt.user.client.ui.Widget) @@ -153,7 +153,7 @@ public class VAbsoluteLayout extends ComplexPanel { /** * Sets a caption for a contained widget - * + * * @param child * The child widget to set the caption for * @param caption @@ -178,7 +178,7 @@ public class VAbsoluteLayout extends ComplexPanel { /** * Set the position of the widget in the layout. The position is a CSS * property string using properties such as top,left,right,top - * + * * @param child * The child widget to set the position for * @param position @@ -193,7 +193,7 @@ public class VAbsoluteLayout extends ComplexPanel { /** * Get the caption for a widget - * + * * @param child * The child widget to get the caption of */ @@ -207,7 +207,7 @@ public class VAbsoluteLayout extends ComplexPanel { /** * Get the pixel width of an slot in the layout - * + * * @param child * The widget in the layout. * @return Returns the size in pixels, or 0 if child is not in the layout @@ -222,7 +222,7 @@ public class VAbsoluteLayout extends ComplexPanel { /** * Get the pixel height of an slot in the layout - * + * * @param child * The widget in the layout * @return Returns the size in pixels, or 0 if the child is not in the @@ -238,7 +238,7 @@ public class VAbsoluteLayout extends ComplexPanel { /** * Get the wrapper for a widget - * + * * @param child * The child to get the wrapper for * @return @@ -257,7 +257,7 @@ public class VAbsoluteLayout extends ComplexPanel { /* * (non-Javadoc) - * + * * @see * com.google.gwt.user.client.ui.UIObject#setStylePrimaryName(java.lang. * String) @@ -269,7 +269,7 @@ public class VAbsoluteLayout extends ComplexPanel { /* * (non-Javadoc) - * + * * @see * com.google.gwt.user.client.ui.UIObject#setStyleName(java.lang.String) */ @@ -282,7 +282,7 @@ public class VAbsoluteLayout extends ComplexPanel { /** * Updates all style names contained in the layout - * + * * @param primaryStyleName * The style name to use as primary */ @@ -347,7 +347,7 @@ public class VAbsoluteLayout extends ComplexPanel { /** * Sets style names for the wrapper wrapping the widget in the layout. The * style names will be prefixed with v-absolutelayout-wrapper. - * + * * @param widget * The widget which wrapper we want to add the stylenames to * @param stylenames @@ -379,7 +379,7 @@ public class VAbsoluteLayout extends ComplexPanel { /** * Constructor - * + * * @param child * The child to wrap */ @@ -396,7 +396,7 @@ public class VAbsoluteLayout extends ComplexPanel { /** * Set the caption for the wrapper - * + * * @param caption * The caption for the wrapper */ @@ -421,7 +421,7 @@ public class VAbsoluteLayout extends ComplexPanel { /** * Set the position for the wrapper in the layout - * + * * @param position * The position string */ @@ -483,7 +483,7 @@ public class VAbsoluteLayout extends ComplexPanel { /** * Sets the style names of the wrapper. Will be prefixed with the * v-absolutelayout-wrapper prefix - * + * * @param stylenames * The wrapper style names */ diff --git a/client/src/main/java/com/vaadin/client/ui/VAbstractSplitPanel.java b/client/src/main/java/com/vaadin/client/ui/VAbstractSplitPanel.java index 81cd4f7b09..06a773e0eb 100644 --- a/client/src/main/java/com/vaadin/client/ui/VAbstractSplitPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/VAbstractSplitPanel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -252,7 +252,7 @@ public abstract class VAbstractSplitPanel extends ComplexPanel { /** * Converts given split position string (in pixels or percentage) to a * floating point pixel value. - * + * * @param pos * @return */ @@ -272,7 +272,7 @@ public abstract class VAbstractSplitPanel extends ComplexPanel { /** * Converts given split position string (in pixels or percentage) to a float * percentage value. - * + * * @param pos * @return */ @@ -298,9 +298,9 @@ public abstract class VAbstractSplitPanel extends ComplexPanel { /** * Returns the given position clamped to the range between current minimum * and maximum positions. - * + * * TODO Should this be in the connector? - * + * * @param pos * Position of the splitter as a CSS string, either pixels or a * percentage. @@ -323,7 +323,7 @@ public abstract class VAbstractSplitPanel extends ComplexPanel { /** * Converts given string to the same units as the split position is. - * + * * @param pos * position to be converted * @return converted position string @@ -606,21 +606,21 @@ public abstract class VAbstractSplitPanel extends ComplexPanel { /** * Called when starting drag resize - * + * * @since 7.5.1 */ abstract protected void startResize(); /** * Called when stopping drag resize - * + * * @since 7.5.1 */ abstract protected void stopResize(); /** * Gets the first container - * + * * @since 7.5.1 * @return the firstContainer */ @@ -630,7 +630,7 @@ public abstract class VAbstractSplitPanel extends ComplexPanel { /** * Gets the second container - * + * * @since 7.5.1 * @return the secondContainer */ @@ -785,7 +785,7 @@ public abstract class VAbstractSplitPanel extends ComplexPanel { /** * A dragging curtain is required in Gecko and Webkit. - * + * * @return true if the browser requires a dragging curtain */ private boolean isDraggingCurtainRequired() { diff --git a/client/src/main/java/com/vaadin/client/ui/VAccordion.java b/client/src/main/java/com/vaadin/client/ui/VAccordion.java index 74de41d513..0e202c3153 100644 --- a/client/src/main/java/com/vaadin/client/ui/VAccordion.java +++ b/client/src/main/java/com/vaadin/client/ui/VAccordion.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -210,7 +210,7 @@ public class VAccordion extends VTabsheetBase { /** * Returns caption width including padding - * + * * @return */ public int getCaptionWidth() { @@ -333,10 +333,10 @@ public class VAccordion extends VTabsheetBase { /** * Updates the content of the open tab of the accordion. - * + * * This method is mostly for internal use and may change in future * versions. - * + * * @since 7.2 * @param newWidget * new content @@ -374,7 +374,7 @@ public class VAccordion extends VTabsheetBase { /** * Updates a tabs stylename from the child UIDL - * + * * @param uidl * The child uidl of the tab */ diff --git a/client/src/main/java/com/vaadin/client/ui/VAudio.java b/client/src/main/java/com/vaadin/client/ui/VAudio.java index 109e4d65b0..f77a74fd06 100644 --- a/client/src/main/java/com/vaadin/client/ui/VAudio.java +++ b/client/src/main/java/com/vaadin/client/ui/VAudio.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VBrowserFrame.java b/client/src/main/java/com/vaadin/client/ui/VBrowserFrame.java index 2c4011e87d..d6ecda6425 100644 --- a/client/src/main/java/com/vaadin/client/ui/VBrowserFrame.java +++ b/client/src/main/java/com/vaadin/client/ui/VBrowserFrame.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -40,7 +40,7 @@ public class VBrowserFrame extends Widget { /** * Always creates new iframe inside widget. Will replace previous iframe. - * + * * @return */ protected IFrameElement createIFrameElement(String src) { @@ -109,7 +109,7 @@ public class VBrowserFrame extends Widget { /** * Set the source (the "src" attribute) of iframe. Will replace old iframe * with new. - * + * * @param source * Source of iframe. */ diff --git a/client/src/main/java/com/vaadin/client/ui/VButton.java b/client/src/main/java/com/vaadin/client/ui/VButton.java index cb6f2aa61b..e3d8908c9d 100644 --- a/client/src/main/java/com/vaadin/client/ui/VButton.java +++ b/client/src/main/java/com/vaadin/client/ui/VButton.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -138,14 +138,14 @@ public class VButton extends FocusWidget implements ClickHandler { @Override /* * Copy-pasted from GWT CustomButton, some minor modifications done: - * + * * -for IE/Opera added CLASSNAME_PRESSED - * + * * -event.preventDefault() removed from ONMOUSEDOWN (Firefox won't apply * :active styles if it is present) - * + * * -Tooltip event handling added - * + * * -onload event handler added (for icon handling) */ public void onBrowserEvent(Event event) { @@ -332,7 +332,7 @@ public class VButton extends FocusWidget implements ClickHandler { /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.ClickHandler#onClick(com.google.gwt.event * .dom.client.ClickEvent) @@ -384,7 +384,7 @@ public class VButton extends FocusWidget implements ClickHandler { /** * Sets whether this button is enabled. - * + * * @param enabled * <code>true</code> to enable the button, <code>false</code> to * disable it @@ -437,24 +437,24 @@ public class VButton extends FocusWidget implements ClickHandler { var convertToPixel = function(elem, value) { // From the awesome hack by Dean Edwards // http://erik.eae.net/archives/2007/07/27/18.54.15/#comment-102291 - + // Remember the original values var left = elem.style.left, rsLeft = elem.runtimeStyle.left; - + // Put in the new values to get a computed value out elem.runtimeStyle.left = elem.currentStyle.left; elem.style.left = value || 0; var ret = elem.style.pixelLeft; - + // Revert the changed values elem.style.left = left; elem.runtimeStyle.left = rsLeft; - + return ret; } var ret = 0; - + var sides = ["Right","Left"]; for(var i=0; i<2; i++) { var side = sides[i]; @@ -468,7 +468,7 @@ public class VButton extends FocusWidget implements ClickHandler { ret += parseInt(value.substr(0, value.length-2)); } } - + // Padding ------------------------------------------------------- value = elem.currentStyle["padding"+side]; if ( !/^\d+(px)?$/i.test( value ) && /^\d/.test( value ) ) { @@ -477,7 +477,7 @@ public class VButton extends FocusWidget implements ClickHandler { ret += parseInt(value.substr(0, value.length-2)); } } - + return ret; }-*/; diff --git a/client/src/main/java/com/vaadin/client/ui/VCalendar.java b/client/src/main/java/com/vaadin/client/ui/VCalendar.java index cc4b7aa520..2c600d2bb9 100644 --- a/client/src/main/java/com/vaadin/client/ui/VCalendar.java +++ b/client/src/main/java/com/vaadin/client/ui/VCalendar.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -45,7 +45,7 @@ import com.vaadin.shared.ui.calendar.DateConstants; /** * Client side implementation for Calendar - * + * * @since 7.1 * @author Vaadin Ltd. */ @@ -106,7 +106,7 @@ public class VCalendar extends Composite implements VHasDropHandler { public interface DateClickListener { /** * Triggered when a date was clicked - * + * * @param date * The date and time that was clicked */ @@ -119,7 +119,7 @@ public class VCalendar extends Composite implements VHasDropHandler { public interface WeekClickListener { /** * Called when a week number was selected. - * + * * @param event * The format of the vent string is "<year>w<week>" */ @@ -156,9 +156,9 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Called when a user selected a new event by highlighting an area of * the calendar. - * + * * FIXME Fix the value nonsense. - * + * * @param value * The format of the value string is * "<year>:<start-minutes>:<end-minutes>" if called from the @@ -174,7 +174,7 @@ public class VCalendar extends Composite implements VHasDropHandler { public interface EventClickListener { /** * Called when an event was clicked - * + * * @param event * The event that was clicked */ @@ -189,7 +189,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Triggered when an event was dragged to a new position and the start * and end dates was changed - * + * * @param event * The event that was moved */ @@ -203,7 +203,7 @@ public class VCalendar extends Composite implements VHasDropHandler { public interface EventResizeListener { /** * Triggers when the time limits for the event was changed. - * + * * @param event * The event that was changed. The new time limits have been * updated in the event before calling this method @@ -217,7 +217,7 @@ public class VCalendar extends Composite implements VHasDropHandler { public interface ScrollListener { /** * Triggered when the calendar is scrolled - * + * * @param scrollPosition * The scroll position in pixels as returned by * {@link ScrollPanel#getScrollPosition()} @@ -231,10 +231,10 @@ public class VCalendar extends Composite implements VHasDropHandler { public interface MouseEventListener { /** * Triggered when a user wants an context menu - * + * * @param event * The context menu event - * + * * @param widget * The widget that the context menu should be added to */ @@ -253,7 +253,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Hack for IE to not select text when dragging. - * + * * @param e * The element to apply the hack on */ @@ -262,7 +262,7 @@ public class VCalendar extends Composite implements VHasDropHandler { e.onselectstart = function() { return false; } - + e.ondragstart = function() { return false; } @@ -292,13 +292,13 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Adds events to the month grid - * + * * @param events * The events to add * @param drawImmediately * Should the grid be rendered immediately. (currently not in * use) - * + * */ public void updateEventsToMonthGrid(Collection<CalendarEvent> events, boolean drawImmediately) { @@ -426,10 +426,10 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Remove a month event from the view - * + * * @param target * The event to remove - * + * * @param repaintImmediately * Should we repaint after the event was removed? */ @@ -452,7 +452,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Updates an event in the month grid - * + * * @param changedEvent * The event that has changed */ @@ -464,7 +464,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Sort the event by how long they are - * + * * @param events * The events to sort * @return An array where the events has been sorted @@ -492,7 +492,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Re-render the week grid - * + * * @param daysCount * The amount of days to include in the week * @param days @@ -544,11 +544,11 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Updates the events in the Month view - * + * * @param daysCount * How many days there are * @param daysUidl - * + * * @param today * Todays date */ @@ -698,7 +698,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Get the date format used to format dates only (excludes time) - * + * * @return */ public DateTimeFormat getDateFormat() { @@ -707,7 +707,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Get the time format used to format time only (excludes date) - * + * * @return */ public DateTimeFormat getTimeFormat() { @@ -720,7 +720,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Get the date and time format to format the dates (includes both date and * time) - * + * * @return */ public DateTimeFormat getDateTimeFormat() { @@ -729,7 +729,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Is the calendar either disabled or readonly - * + * * @return */ public boolean isDisabledOrReadOnly() { @@ -745,7 +745,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Is the component disabled - * + * * @param disabled * True if disabled */ @@ -762,7 +762,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Is the component read-only - * + * * @param readOnly * True if component is readonly */ @@ -772,7 +772,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Get the month grid component - * + * * @return */ public MonthGrid getMonthGrid() { @@ -781,7 +781,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Get he week grid component - * + * * @return */ public WeekGrid getWeekGrid() { @@ -791,7 +791,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Calculates correct size for all cells (size / amount of cells ) and * distributes any overflow over all the cells. - * + * * @param totalSize * the total amount of size reserved for all cells * @param numberOfCells @@ -829,7 +829,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Returns a comparator which can compare calendar events. - * + * * @return */ public static Comparator<CalendarEvent> getEventComparator() { @@ -875,10 +875,10 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Is the date at midnight - * + * * @param date * The date to check - * + * * @return */ @SuppressWarnings("deprecation") @@ -889,7 +889,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Are the dates equal (uses second resolution) - * + * * @param date1 * The first the to compare * @param date2 @@ -907,7 +907,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Is the calendar event zero seconds long and is occurring at midnight - * + * * @param event * The event to check * @return @@ -919,7 +919,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Should the 24h time format be used - * + * * @param format * True if the 24h format should be used else the 12h format is * used @@ -937,7 +937,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the names of the week days - * + * * @param names * The names of the days (Monday, Thursday,...) */ @@ -955,7 +955,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the names of the months - * + * * @param names * The names of the months (January, February,...) */ @@ -973,7 +973,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the number when a week starts - * + * * @param dayNumber * The number of the day */ @@ -991,7 +991,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the number when a week ends - * + * * @param dayNumber * The number of the day */ @@ -1009,7 +1009,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the number when a week starts - * + * * @param dayNumber * The number of the day */ @@ -1027,7 +1027,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the number when a week ends - * + * * @param dayNumber * The number of the day */ @@ -1045,7 +1045,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Re-renders the whole week view - * + * * @param scroll * The amount of pixels to scroll the week view * @param today @@ -1095,7 +1095,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Re-renders the whole month view - * + * * @param firstDayOfWeek * The first day of the week * @param today @@ -1156,7 +1156,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Sets the listener for listening to event clicks - * + * * @param listener * The listener to use */ @@ -1166,7 +1166,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Gets the listener for listening to event clicks - * + * * @return */ public DateClickListener getDateClickListener() { @@ -1177,7 +1177,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the listener which listens to forward events from the calendar - * + * * @param listener * The listener to use */ @@ -1187,7 +1187,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Get the listener which listens to forward events from the calendar - * + * * @return */ public ForwardListener getForwardListener() { @@ -1198,7 +1198,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the listener which listens to backward events from the calendar - * + * * @param listener * The listener to use */ @@ -1208,7 +1208,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the listener which listens to backward events from the calendar - * + * * @return */ public BackwardListener getBackwardListener() { @@ -1219,7 +1219,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the listener that listens to user clicking on the week numbers - * + * * @param listener * The listener to use */ @@ -1229,7 +1229,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Get the listener that listens to user clicking on the week numbers - * + * * @return */ public WeekClickListener getWeekClickListener() { @@ -1241,7 +1241,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the listener that listens to the user highlighting a region in the * calendar - * + * * @param listener * The listener to use */ @@ -1252,7 +1252,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Get the listener that listens to the user highlighting a region in the * calendar - * + * * @return */ public RangeSelectListener getRangeSelectListener() { @@ -1270,7 +1270,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the listener that listens to the user clicking on the events - * + * * @param listener * The listener to use */ @@ -1282,7 +1282,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Get the listener that listens to when event is dragged to a new location - * + * * @return */ public EventMovedListener getEventMovedListener() { @@ -1291,7 +1291,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the listener that listens to when event is dragged to a new location - * + * * @param eventMovedListener * The listener to use */ @@ -1303,7 +1303,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Get the listener that listens to when the calendar widget is scrolled - * + * * @return */ public ScrollListener getScrollListener() { @@ -1312,7 +1312,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the listener that listens to when the calendar widget is scrolled - * + * * @param scrollListener * The listener to use */ @@ -1325,7 +1325,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Get the listener that listens to when an events time limits are being * adjusted - * + * * @return */ public EventResizeListener getEventResizeListener() { @@ -1335,7 +1335,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the listener that listens to when an events time limits are being * adjusted - * + * * @param eventResizeListener * The listener to use */ @@ -1350,7 +1350,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Get the listener that listen to mouse events - * + * * @return */ public MouseEventListener getMouseEventListener() { @@ -1359,7 +1359,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the listener that listen to mouse events - * + * * @param mouseEventListener * The listener to use */ @@ -1376,7 +1376,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set selecting a range allowed - * + * * @param rangeSelectAllowed * Should selecting a range be allowed */ @@ -1386,7 +1386,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Is moving a range allowed - * + * * @return */ public boolean isRangeMoveAllowed() { @@ -1395,7 +1395,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Is moving a range allowed - * + * * @param rangeMoveAllowed * Is it allowed */ @@ -1412,7 +1412,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Is resizing an event allowed - * + * * @param eventResizeAllowed * True if allowed false if not */ @@ -1429,7 +1429,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Is moving an event allowed - * + * * @param eventMoveAllowed * True if moving is allowed, false if not */ @@ -1455,7 +1455,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.dd.VHasDropHandler#getDropHandler() */ @Override @@ -1465,7 +1465,7 @@ public class VCalendar extends Composite implements VHasDropHandler { /** * Set the drop handler - * + * * @param dropHandler * The drophandler to use */ @@ -1481,7 +1481,7 @@ public class VCalendar extends Composite implements VHasDropHandler { * false, the caption is rendered in the browser as plain text. * <p> * The default is false, i.e. to render that caption as plain text. - * + * * @param captionAsHtml * true if the captions are rendered as HTML, false if rendered * as plain text @@ -1494,7 +1494,7 @@ public class VCalendar extends Composite implements VHasDropHandler { * Checks whether event captions are rendered as HTML * <p> * The default is false, i.e. to render that caption as plain text. - * + * * @return true if the captions are rendered as HTML, false if rendered as * plain text */ diff --git a/client/src/main/java/com/vaadin/client/ui/VCalendarPanel.java b/client/src/main/java/com/vaadin/client/ui/VCalendarPanel.java index bb87492c9d..4b3ebff766 100644 --- a/client/src/main/java/com/vaadin/client/ui/VCalendarPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/VCalendarPanel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -132,7 +132,7 @@ public class VCalendarPanel extends FocusableFlexTable implements private ClickHandler dayClickHandler = new ClickHandler() { /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.ClickHandler#onClick(com.google.gwt * .event.dom.client.ClickEvent) @@ -231,7 +231,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Sets the focus to given date in the current view. Used when moving in the * calendar with the keyboard. - * + * * @param date * A Date representing the day of month to be focused. Must be * one of the days currently visible. @@ -267,11 +267,11 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Sets the selection highlight to a given day in the current view - * + * * @param date * A Date representing the day of month to be selected. Must be * one of the days currently visible. - * + * */ private void selectDate(Date date) { if (selectedDay != null) { @@ -397,7 +397,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Builds the top buttons and current month and year header. - * + * * @param needsMonth * Should the month buttons be visible? */ @@ -522,7 +522,7 @@ public class VCalendarPanel extends FocusableFlexTable implements * Returns whether ISO 8601 week numbers should be shown in the value * selector or not. ISO 8601 defines that a week always starts with a Monday * so the week numbers are only shown if this is the case. - * + * * @return true if week number should be shown, false otherwise */ public boolean isShowISOWeekNumbers() { @@ -535,7 +535,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Checks inclusively whether a date is inside a range of dates or not. - * + * * @param date * @return */ @@ -552,7 +552,7 @@ public class VCalendarPanel extends FocusableFlexTable implements * day-basis. If the resolution is set to YEAR, only years are compared. So * even if the range is set to one millisecond in next year, also next year * will be included. - * + * * @param date * @param minResolution * @return @@ -589,7 +589,7 @@ public class VCalendarPanel extends FocusableFlexTable implements * day-basis. If the resolution is set to YEAR, only years are compared. So * even if the range is set to one millisecond in next year, also next year * will be included. - * + * * @param date * @param minResolution * @return @@ -773,7 +773,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Do we need the time selector - * + * * @return True if it is required */ private boolean isTimeSelectorNeeded() { @@ -790,9 +790,9 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * For internal use only. May be removed or replaced in the future. - * + * * Updates the calendar and text field with the selected dates. - * + * * @param updateDate * The value false prevents setting the selected date of the * calendar based on focusedDate. That can be used when only the @@ -1051,12 +1051,12 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Handles a user click on the component - * + * * @param sender * The component that was clicked * @param updateVariable * Should the value field be updated - * + * */ private void processClickEvent(Widget sender) { if (!isEnabled() || isReadonly()) { @@ -1075,7 +1075,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.KeyDownHandler#onKeyDown(com.google.gwt * .event.dom.client.KeyDownEvent) @@ -1087,7 +1087,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.KeyPressHandler#onKeyPress(com.google * .gwt.event.dom.client.KeyPressEvent) @@ -1100,7 +1100,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Handles the keypress from both the onKeyPress event and the onKeyDown * event - * + * * @param event * The keydown/keypress event */ @@ -1161,7 +1161,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Handles the keyboard navigation when the resolution is set to years. - * + * * @param keycode * The keycode to process * @param ctrl @@ -1219,7 +1219,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Handle the keyboard navigation when the resolution is set to MONTH - * + * * @param keycode * The keycode to handle * @param ctrl @@ -1275,7 +1275,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Handle keyboard navigation what the resolution is set to DAY - * + * * @param keycode * The keycode to handle * @param ctrl @@ -1381,7 +1381,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Handles the keyboard navigation - * + * * @param keycode * The key code that was pressed * @param ctrl @@ -1419,7 +1419,7 @@ public class VCalendarPanel extends FocusableFlexTable implements * Returns the reset key which will reset the calendar to the previous * selection. By default this is backspace but it can be overriden to change * the key to whatever you want. - * + * * @return */ protected int getResetKey() { @@ -1430,7 +1430,7 @@ public class VCalendarPanel extends FocusableFlexTable implements * Returns the select key which selects the value. By default this is the * enter key but it can be changed to whatever you like by overriding this * method. - * + * * @return */ protected int getSelectKey() { @@ -1441,7 +1441,7 @@ public class VCalendarPanel extends FocusableFlexTable implements * Returns the key that closes the popup window if this is a VPopopCalendar. * Else this does nothing. By default this is the Escape key but you can * change the key to whatever you want by overriding this method. - * + * * @return */ protected int getCloseKey() { @@ -1452,7 +1452,7 @@ public class VCalendarPanel extends FocusableFlexTable implements * The key that selects the next day in the calendar. By default this is the * right arrow key but by overriding this method it can be changed to * whatever you like. - * + * * @return */ protected int getForwardKey() { @@ -1463,7 +1463,7 @@ public class VCalendarPanel extends FocusableFlexTable implements * The key that selects the previous day in the calendar. By default this is * the left arrow key but by overriding this method it can be changed to * whatever you like. - * + * * @return */ protected int getBackwardKey() { @@ -1474,7 +1474,7 @@ public class VCalendarPanel extends FocusableFlexTable implements * The key that selects the next week in the calendar. By default this is * the down arrow key but by overriding this method it can be changed to * whatever you like. - * + * * @return */ protected int getNextKey() { @@ -1485,7 +1485,7 @@ public class VCalendarPanel extends FocusableFlexTable implements * The key that selects the previous week in the calendar. By default this * is the up arrow key but by overriding this method it can be changed to * whatever you like. - * + * * @return */ protected int getPreviousKey() { @@ -1494,7 +1494,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.MouseOutHandler#onMouseOut(com.google * .gwt.event.dom.client.MouseOutEvent) @@ -1508,7 +1508,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.MouseDownHandler#onMouseDown(com.google * .gwt.event.dom.client.MouseDownEvent) @@ -1542,7 +1542,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.MouseUpHandler#onMouseUp(com.google.gwt * .event.dom.client.MouseUpEvent) @@ -1556,7 +1556,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Adjusts a date to fit inside the range, only if outside - * + * * @param date */ private Date adjustDateToFitInsideRange(Date date) { @@ -1570,7 +1570,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Sets the data of the Panel. - * + * * @param currentDate * The date to set */ @@ -1647,7 +1647,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * TimeSelector is a widget consisting of list boxes that modifie the Date * object that is given for. - * + * */ public class VTime extends FlowPanel implements ChangeHandler { @@ -1679,7 +1679,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Constructs the ListBoxes and updates their value - * + * * @param redraw * Should new instances of the listboxes be created */ @@ -1860,7 +1860,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /* * (non-Javadoc) VT - * + * * @see * com.google.gwt.event.dom.client.ChangeHandler#onChange(com.google.gwt * .event.dom.client.ChangeEvent) @@ -1944,7 +1944,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * If true should be returned if the panel will not be used after this * event. - * + * * @param event * @return */ @@ -1958,7 +1958,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * A focus out listener is triggered when the panel loosed focus. This can * happen either after a user clicks outside the panel or tabs out. - * + * * @param listener * The listener to trigger */ @@ -1969,7 +1969,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * The submit listener is called when the user selects a value from the * calender either by clicking the day or selects it by keyboard. - * + * * @param submitListener * The listener to trigger */ @@ -1980,7 +1980,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * The given FocusChangeListener is notified when the focused date changes * by user either clicking on a new date or by using the keyboard. - * + * * @param listener * The FocusChangeListener to be notified */ @@ -1990,7 +1990,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * The time change listener is triggered when the user changes the time. - * + * * @param listener */ public void setTimeChangeListener(TimeChangeListener listener) { @@ -1999,7 +1999,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Returns the submit listener that listens to selection made from the panel - * + * * @return The listener or NULL if no listener has been set */ public SubmitListener getSubmitListener() { @@ -2008,7 +2008,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.BlurHandler#onBlur(com.google.gwt.event * .dom.client.BlurEvent) @@ -2023,7 +2023,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.FocusHandler#onFocus(com.google.gwt.event * .dom.client.FocusEvent) @@ -2104,7 +2104,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Checks if subElement is inside the widget DOM hierarchy. - * + * * @param w * @param subElement * @return true if {@code w} is a parent of subElement, false otherwise. @@ -2228,7 +2228,7 @@ public class VCalendarPanel extends FocusableFlexTable implements * Sets the start range for this component. The start range is inclusive, * and it depends on the current resolution, what is considered inside the * range. - * + * * @param startDate * - the allowed range's start date */ @@ -2247,7 +2247,7 @@ public class VCalendarPanel extends FocusableFlexTable implements /** * Sets the end range for this component. The end range is inclusive, and it * depends on the current resolution, what is considered inside the range. - * + * * @param endDate * - the allowed range's end date */ diff --git a/client/src/main/java/com/vaadin/client/ui/VCheckBox.java b/client/src/main/java/com/vaadin/client/ui/VCheckBox.java index 55db9ad523..34f1b4f38f 100644 --- a/client/src/main/java/com/vaadin/client/ui/VCheckBox.java +++ b/client/src/main/java/com/vaadin/client/ui/VCheckBox.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -88,7 +88,7 @@ public class VCheckBox extends com.google.gwt.user.client.ui.CheckBox /** * Gives access to the input element. - * + * * @return Element of the CheckBox itself */ private Element getCheckBoxElement() { diff --git a/client/src/main/java/com/vaadin/client/ui/VColorPicker.java b/client/src/main/java/com/vaadin/client/ui/VColorPicker.java index b55c125418..c7197aa493 100644 --- a/client/src/main/java/com/vaadin/client/ui/VColorPicker.java +++ b/client/src/main/java/com/vaadin/client/ui/VColorPicker.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.google.gwt.user.client.ui.HTML; /** * Client side implementation for ColorPicker. - * + * * @since 7.0.0 */ public class VColorPicker extends VButton implements ClickHandler { @@ -41,7 +41,7 @@ public class VColorPicker extends VButton implements ClickHandler { /** * Set the color of the component, e.g. #ffffff - * + * * @param color */ public void setColor(String color) { @@ -50,7 +50,7 @@ public class VColorPicker extends VButton implements ClickHandler { /** * Mark the popup opened/closed. - * + * * @param open */ public void setOpen(boolean open) { @@ -59,7 +59,7 @@ public class VColorPicker extends VButton implements ClickHandler { /** * Check the popup's marked state. - * + * * @return true if the popup has been marked being open, false otherwise. */ public boolean isOpen() { diff --git a/client/src/main/java/com/vaadin/client/ui/VColorPickerArea.java b/client/src/main/java/com/vaadin/client/ui/VColorPickerArea.java index c2940ea4d5..6e82ac2998 100644 --- a/client/src/main/java/com/vaadin/client/ui/VColorPickerArea.java +++ b/client/src/main/java/com/vaadin/client/ui/VColorPickerArea.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -28,7 +28,7 @@ import com.google.gwt.user.client.ui.Widget; /** * Client side implementation for ColorPickerArea. - * + * * @since 7.0.0 */ public class VColorPickerArea extends Widget @@ -65,7 +65,7 @@ public class VColorPickerArea extends Widget /** * Adds a click handler to the widget and sinks the click event. - * + * * @param handler * @return HandlerRegistration used to remove the handler */ @@ -96,7 +96,7 @@ public class VColorPickerArea extends Widget /** * Mark the popup opened/closed. - * + * * @param open */ public void setOpen(boolean open) { @@ -105,7 +105,7 @@ public class VColorPickerArea extends Widget /** * Check the popup's marked state. - * + * * @return true if the popup has been marked being open, false otherwise. */ public boolean isOpen() { @@ -114,9 +114,9 @@ public class VColorPickerArea extends Widget /** * Sets the caption's content to the given text. - * + * * @param text - * + * * @see Label#setText(String) */ @Override @@ -126,7 +126,7 @@ public class VColorPickerArea extends Widget /** * Gets the caption's contents as text. - * + * * @return the caption's text */ @Override @@ -136,7 +136,7 @@ public class VColorPickerArea extends Widget /** * Sets the caption's content to the given HTML. - * + * * @param html */ @Override @@ -146,7 +146,7 @@ public class VColorPickerArea extends Widget /** * Gets the caption's contents as HTML. - * + * * @return the caption's HTML */ @Override @@ -156,7 +156,7 @@ public class VColorPickerArea extends Widget /** * Sets the color for the area. - * + * * @param color */ public void setColor(String color) { diff --git a/client/src/main/java/com/vaadin/client/ui/VContextMenu.java b/client/src/main/java/com/vaadin/client/ui/VContextMenu.java index 2411eafabb..553e972532 100644 --- a/client/src/main/java/com/vaadin/client/ui/VContextMenu.java +++ b/client/src/main/java/com/vaadin/client/ui/VContextMenu.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -76,7 +76,7 @@ public class VContextMenu extends VOverlay implements SubPartAware { /** * This method should be used only by Client object as only one per client * should exists. Request an instance via client.getContextMenu(); - * + * * @param cli * to be set as an owner of menu */ @@ -108,7 +108,7 @@ public class VContextMenu extends VOverlay implements SubPartAware { /** * Sets the element from which to build menu - * + * * @param ao */ public void setActionOwner(ActionOwner ao) { @@ -117,7 +117,7 @@ public class VContextMenu extends VOverlay implements SubPartAware { /** * Shows context menu at given location IF it contain at least one item. - * + * * @param left * @param top */ @@ -224,7 +224,7 @@ public class VContextMenu extends VOverlay implements SubPartAware { * (!DOM.isOrHasChild(getElement(), to)) { DOM.setElementProperty( * super.getSelectedItem().getElement(), "className", * super.getSelectedItem().getStylePrimaryName()); } } - * + * * super.onBrowserEvent(event); } */ @@ -322,7 +322,7 @@ public class VContextMenu extends VOverlay implements SubPartAware { /** * Hides context menu if it is currently shown by given action owner. - * + * * @param actionOwner */ public void ensureHidden(ActionOwner actionOwner) { diff --git a/client/src/main/java/com/vaadin/client/ui/VCssLayout.java b/client/src/main/java/com/vaadin/client/ui/VCssLayout.java index d7d9eefef9..9e262f64cf 100644 --- a/client/src/main/java/com/vaadin/client/ui/VCssLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/VCssLayout.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VCustomComponent.java b/client/src/main/java/com/vaadin/client/ui/VCustomComponent.java index 6aa21b08d2..7184af58d5 100644 --- a/client/src/main/java/com/vaadin/client/ui/VCustomComponent.java +++ b/client/src/main/java/com/vaadin/client/ui/VCustomComponent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VCustomLayout.java b/client/src/main/java/com/vaadin/client/ui/VCustomLayout.java index 3a1b56bb2d..33ac090aae 100644 --- a/client/src/main/java/com/vaadin/client/ui/VCustomLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/VCustomLayout.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -41,9 +41,9 @@ import com.vaadin.client.WidgetUtil; /** * Custom Layout implements complex layout defined with HTML template. - * + * * @author Vaadin Ltd - * + * */ public class VCustomLayout extends ComplexPanel { @@ -106,14 +106,14 @@ public class VCustomLayout extends ComplexPanel { /** * Sets widget to given location. - * + * * If location already contains a widget it will be removed. - * + * * @param widget * Widget to be set into location. * @param location * location name where widget will be added - * + * * @throws IllegalArgumentException * if no such location is found in the layout. */ @@ -249,11 +249,11 @@ public class VCustomLayout extends ComplexPanel { /** * Extract body part and script tags from raw html-template. - * + * * Saves contents of all script-tags to private property: scripts. Returns * contents of the body part for the html without script-tags. Also replaces * all _UID_ tags with an unique id-string. - * + * * @param html * Original HTML-template received from server * @return html that is used to create the HTMLPanel. @@ -414,7 +414,7 @@ public class VCustomLayout extends ComplexPanel { * functions are to be run. * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param el * @return true if layout function exists and was run successfully, else * false. diff --git a/client/src/main/java/com/vaadin/client/ui/VDateField.java b/client/src/main/java/com/vaadin/client/ui/VDateField.java index b4084847dd..3922219c7b 100644 --- a/client/src/main/java/com/vaadin/client/ui/VDateField.java +++ b/client/src/main/java/com/vaadin/client/ui/VDateField.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -188,7 +188,7 @@ public class VDateField extends FlowPanel implements Field, HasEnabled { * Returns whether ISO 8601 week numbers should be shown in the date * selector or not. ISO 8601 defines that a week always starts with a Monday * so the week numbers are only shown if this is the case. - * + * * @return true if week number should be shown, false otherwise */ public boolean isShowISOWeekNumbers() { @@ -205,7 +205,7 @@ public class VDateField extends FlowPanel implements Field, HasEnabled { * the current date. * <p> * For internal use only. May be removed or replaced in the future. - * + * * @return A copy of the current date */ public Date getDate() { @@ -219,7 +219,7 @@ public class VDateField extends FlowPanel implements Field, HasEnabled { /** * Sets the current date for this VDateField. - * + * * @param date * The new date to use */ diff --git a/client/src/main/java/com/vaadin/client/ui/VDateFieldCalendar.java b/client/src/main/java/com/vaadin/client/ui/VDateFieldCalendar.java index 0947cebccf..8f1b86a28f 100644 --- a/client/src/main/java/com/vaadin/client/ui/VDateFieldCalendar.java +++ b/client/src/main/java/com/vaadin/client/ui/VDateFieldCalendar.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VDragAndDropWrapper.java b/client/src/main/java/com/vaadin/client/ui/VDragAndDropWrapper.java index 779a3fbf0b..e025d88740 100644 --- a/client/src/main/java/com/vaadin/client/ui/VDragAndDropWrapper.java +++ b/client/src/main/java/com/vaadin/client/ui/VDragAndDropWrapper.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -60,11 +60,11 @@ import com.vaadin.shared.ui.dd.HorizontalDropLocation; import com.vaadin.shared.ui.dd.VerticalDropLocation; /** - * + * * Must have features pending: - * + * * drop details: locations + sizes in document hierarchy up to wrapper - * + * */ public class VDragAndDropWrapper extends VCustomComponent implements VHasDropHandler { @@ -136,7 +136,7 @@ public class VDragAndDropWrapper extends VCustomComponent /** * Starts a drag and drop operation from mousedown or touchstart event if * required conditions are met. - * + * * @param event * @return true if the event was handled as a drag start event */ @@ -466,11 +466,11 @@ public class VDragAndDropWrapper extends VCustomComponent public final native void postFile(VHtml5File file) /*-{ - + this.setRequestHeader('Content-Type', 'multipart/form-data'); // Seems like IE10 will loose the file if we don't keep a reference to it... this.fileBeingUploaded = file; - + this.send(file); }-*/; @@ -617,7 +617,7 @@ public class VDragAndDropWrapper extends VCustomComponent /** * Prototype code, memory leak risk. - * + * * @param el * @deprecated As of 7.2, call or override {@link #hookHtml5Events(Element)} * instead @@ -626,19 +626,19 @@ public class VDragAndDropWrapper extends VCustomComponent protected native void hookHtml5Events(com.google.gwt.user.client.Element el) /*-{ var me = this; - + el.addEventListener("dragenter", $entry(function(ev) { return me.@com.vaadin.client.ui.VDragAndDropWrapper::html5DragEnter(Lcom/vaadin/client/ui/dd/VHtml5DragEvent;)(ev); }), false); - + el.addEventListener("dragleave", $entry(function(ev) { return me.@com.vaadin.client.ui.VDragAndDropWrapper::html5DragLeave(Lcom/vaadin/client/ui/dd/VHtml5DragEvent;)(ev); }), false); - + el.addEventListener("dragover", $entry(function(ev) { return me.@com.vaadin.client.ui.VDragAndDropWrapper::html5DragOver(Lcom/vaadin/client/ui/dd/VHtml5DragEvent;)(ev); }), false); - + el.addEventListener("drop", $entry(function(ev) { return me.@com.vaadin.client.ui.VDragAndDropWrapper::html5DragDrop(Lcom/vaadin/client/ui/dd/VHtml5DragEvent;)(ev); }), false); @@ -646,9 +646,9 @@ public class VDragAndDropWrapper extends VCustomComponent /** * Prototype code, memory leak risk. - * + * * @param el - * + * * @since 7.2 */ protected void hookHtml5Events(Element el) { @@ -712,7 +712,7 @@ public class VDragAndDropWrapper extends VCustomComponent /** * Set the widget that will be used as the drag image when using * DragStartMode {@link COMPONENT_OTHER} . - * + * * @param widget */ public void setDragAndDropWidget(Widget widget) { @@ -731,7 +731,7 @@ public class VDragAndDropWrapper extends VCustomComponent * Internal client side interface used by the connector and the widget for * the drag and drop wrapper to signal the completion of an HTML5 file * upload. - * + * * @since 7.6.4 */ public interface UploadHandler { diff --git a/client/src/main/java/com/vaadin/client/ui/VDragAndDropWrapperIE.java b/client/src/main/java/com/vaadin/client/ui/VDragAndDropWrapperIE.java index f9085dd7e4..4ddaad25a5 100644 --- a/client/src/main/java/com/vaadin/client/ui/VDragAndDropWrapperIE.java +++ b/client/src/main/java/com/vaadin/client/ui/VDragAndDropWrapperIE.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -53,7 +53,7 @@ public class VDragAndDropWrapperIE extends VDragAndDropWrapper { com.google.gwt.user.client.Element el) /*-{ var me = this; - + el.attachEvent("ondragstart", $entry(function(ev) { return me.@com.vaadin.client.ui.VDragAndDropWrapper::html5DragStart(Lcom/vaadin/client/ui/dd/VHtml5DragEvent;)(ev); })); @@ -69,19 +69,19 @@ public class VDragAndDropWrapperIE extends VDragAndDropWrapper { protected native void hookHtml5Events(com.google.gwt.user.client.Element el) /*-{ var me = this; - + el.attachEvent("ondragenter", $entry(function(ev) { return me.@com.vaadin.client.ui.VDragAndDropWrapper::html5DragEnter(Lcom/vaadin/client/ui/dd/VHtml5DragEvent;)(ev); })); - + el.attachEvent("ondragleave", $entry(function(ev) { return me.@com.vaadin.client.ui.VDragAndDropWrapper::html5DragLeave(Lcom/vaadin/client/ui/dd/VHtml5DragEvent;)(ev); })); - + el.attachEvent("ondragover", $entry(function(ev) { return me.@com.vaadin.client.ui.VDragAndDropWrapper::html5DragOver(Lcom/vaadin/client/ui/dd/VHtml5DragEvent;)(ev); })); - + el.attachEvent("ondrop", $entry(function(ev) { return me.@com.vaadin.client.ui.VDragAndDropWrapper::html5DragDrop(Lcom/vaadin/client/ui/dd/VHtml5DragEvent;)(ev); })); diff --git a/client/src/main/java/com/vaadin/client/ui/VEmbedded.java b/client/src/main/java/com/vaadin/client/ui/VEmbedded.java index 1ac755d23a..68dcc6152a 100644 --- a/client/src/main/java/com/vaadin/client/ui/VEmbedded.java +++ b/client/src/main/java/com/vaadin/client/ui/VEmbedded.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -58,7 +58,7 @@ public class VEmbedded extends HTML { * cross-browser. * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param uidl * The UIDL * @return Tags concatenated into a string @@ -201,7 +201,7 @@ public class VEmbedded extends HTML { * Returns a map (name -> value) of all parameters in the UIDL. * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param uidl * @return */ @@ -231,7 +231,7 @@ public class VEmbedded extends HTML { * Helper to return translated src-attribute from embedded's UIDL * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param uidl * @param client * @return diff --git a/client/src/main/java/com/vaadin/client/ui/VFilterSelect.java b/client/src/main/java/com/vaadin/client/ui/VFilterSelect.java index 4d908ddc17..c6224140cb 100644 --- a/client/src/main/java/com/vaadin/client/ui/VFilterSelect.java +++ b/client/src/main/java/com/vaadin/client/ui/VFilterSelect.java @@ -86,7 +86,7 @@ import com.vaadin.shared.util.SharedUtil; /** * Client side implementation of the Select component. - * + * * TODO needs major refactoring (to be extensible etc) */ @SuppressWarnings("deprecation") @@ -107,7 +107,7 @@ public class VFilterSelect extends Composite /** * Constructor - * + * * @param key * item key, empty string for a special null item not in * container @@ -164,7 +164,7 @@ public class VFilterSelect extends Composite /** * Get the option key which represents the item on the server side. - * + * * @return The key of the item */ public String getOptionKey() { @@ -173,7 +173,7 @@ public class VFilterSelect extends Composite /** * Get the URI of the icon. Used when constructing the displayed option. - * + * * @return */ public String getIconUri() { @@ -185,7 +185,7 @@ public class VFilterSelect extends Composite * Gets the style set for this suggestion item. Styles are typically set * by a server-side {@link com.vaadin.ui.ComboBox.ItemStyleGenerator}. * The returned style is prefixed by <code>v-filterselect-item-</code>. - * + * * @since 7.5.6 * @return the style name to use, or <code>null</code> to not apply any * custom style. @@ -242,12 +242,12 @@ public class VFilterSelect extends Composite return $entry(function(e) { var deltaX = e.deltaX ? e.deltaX : -0.5*e.wheelDeltaX; var deltaY = e.deltaY ? e.deltaY : -0.5*e.wheelDeltaY; - + // IE8 has only delta y if (isNaN(deltaY)) { deltaY = -0.5*e.wheelDelta; } - + @com.vaadin.client.ui.VFilterSelect.JsniUtil::moveScrollFromEvent(*)(widget, deltaX, deltaY, e, e.deltaMode); }); }-*/; @@ -394,7 +394,7 @@ public class VFilterSelect extends Composite /** * Shows the popup where the user can see the filtered options - * + * * @param currentSuggestions * The filtered suggestions * @param currentPage @@ -415,7 +415,7 @@ public class VFilterSelect extends Composite * correctly. This issue manifests when a Combobox is placed in * another popupView which also needs to calculate the absoluteTop() * to position itself. #9768 - * + * * After deferring the showSuggestions method, a problem with * navigating in the combo box occurs. Because of that the method * navigateItemAfterPageChange in ComboBoxConnector class, which @@ -484,7 +484,7 @@ public class VFilterSelect extends Composite /** * Should the next page button be visible to the user? - * + * * @param active */ private void setNextButtonActive(boolean active) { @@ -504,7 +504,7 @@ public class VFilterSelect extends Composite /** * Should the previous page button be visible to the user - * + * * @param active */ private void setPrevButtonActive(boolean active) { @@ -561,7 +561,7 @@ public class VFilterSelect extends Composite /** * Select the first item of the suggestions list popup. - * + * * @since 7.2.6 */ public void selectFirstItem() { @@ -571,7 +571,7 @@ public class VFilterSelect extends Composite /** * Select the last item of the suggestions list popup. - * + * * @since 7.2.6 */ public void selectLastItem() { @@ -614,7 +614,7 @@ public class VFilterSelect extends Composite * because otherwise the waiting flag will be reset in * the first response and the second response will be * ignored, causing an empty popup... - * + * * As long as the scrolling delay is suitable * double/triple clicks will work by scrolling two or * three pages at a time and this should not be a @@ -687,7 +687,7 @@ public class VFilterSelect extends Composite * amount of items are visible at a time and a scrollbar or buttons are * visible to change page. If paging is turned of then all options are * rendered into the popup menu. - * + * * @param paging * Should the paging be turned on? */ @@ -870,7 +870,7 @@ public class VFilterSelect extends Composite /** * Adds in-line CSS rules to the DOM according to the * suggestionPopupWidth field - * + * * @param desiredWidth * @param naturalMenuWidth */ @@ -878,13 +878,13 @@ public class VFilterSelect extends Composite int naturalMenuWidth) { /** * Three different width modes for the suggestion pop-up: - * + * * 1. Legacy "null"-mode: width is determined by the longest item * caption for each page while still maintaining minimum width of * (desiredWidth - popupOuterPadding) - * + * * 2. relative to the component itself - * + * * 3. fixed width */ String width = "auto"; @@ -928,7 +928,7 @@ public class VFilterSelect extends Composite * Descends to child elements until finds TD elements and sets their * width in pixels. Can be used to workaround IE8 & 9 TD element * display: block issues - * + * * @param parent * @param width */ @@ -946,7 +946,7 @@ public class VFilterSelect extends Composite /** * Returns the percentage value as a fraction, e.g. 42% -> 0.42 - * + * * @param percentage */ private float asFraction(String percentage) { @@ -968,7 +968,7 @@ public class VFilterSelect extends Composite /** * Was the popup just closed? - * + * * @return true if popup was just closed */ public boolean isJustClosed() { @@ -979,7 +979,7 @@ public class VFilterSelect extends Composite /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.logical.shared.CloseHandler#onClose(com.google * .gwt.event.logical.shared.CloseEvent) @@ -997,7 +997,7 @@ public class VFilterSelect extends Composite /** * Updates style names in suggestion popup to help theme building. - * + * * @param componentState * shared state of the combo box */ @@ -1078,7 +1078,7 @@ public class VFilterSelect extends Composite /** * Sets the suggestions rendered in the menu - * + * * @param suggestions * The suggestions to be rendered in the menu */ @@ -1305,7 +1305,7 @@ public class VFilterSelect extends Composite * menu currently displays the last page with less items then the * maximum visibility (in which case the scroll is not active, but the * scroll is active for any other page in general). - * + * * @since 7.2.6 */ @Override @@ -1322,23 +1322,23 @@ public class VFilterSelect extends Composite /** * TextBox variant used as input element for filter selects, which prevents * selecting text when disabled. - * + * * @since 7.1.5 */ public class FilterSelectTextBox extends TextBox { /** * Creates a new filter select text box. - * + * * @since 7.6.4 */ public FilterSelectTextBox() { /*- * Stop the browser from showing its own suggestion popup. - * + * * Using an invalid value instead of "off" as suggested by * https://developer.mozilla.org/en-US/docs/Web/Security/Securing_your_site/Turning_off_form_autocompletion - * + * * Leaving the non-standard Safari options autocapitalize and * autocorrect untouched since those do not interfere in the same * way, and they might be useful in a combo box where new items are @@ -1358,7 +1358,7 @@ public class VFilterSelect extends Composite * back, focus at the front. This means that items that are too * long to display will display from the start and not the end * even on Firefox. - * + * * We need the JSNI function to set selection range so that we * can use the optional direction attribute to set the anchor to * the end and the focus to the start. This makes Firefox work @@ -1373,7 +1373,7 @@ public class VFilterSelect extends Composite * unwanted behaviour when the width of the textbox is narrower * than the width of the entry: the end of the entry is shown * instead of the beginning. (see #13477) - * + * * To avoid this, we set the caret to the beginning of the line. */ @@ -1386,10 +1386,10 @@ public class VFilterSelect extends Composite /** * Handler receiving notifications from the connector and updating the * widget state accordingly. - * + * * This class is still subject to change and should not be considered as * public stable API. - * + * * @since */ public class DataReceivedHandler { @@ -1467,7 +1467,7 @@ public class VFilterSelect extends Composite * Set a callback that is invoked when a page change occurs if there * have not been intervening requests to the server. The callback is * reset when any additional request is made to the server. - * + * * @param callback */ public void setNavigationCallback(Runnable callback) { @@ -1503,7 +1503,7 @@ public class VFilterSelect extends Composite /** * For internal use only - this method will be removed in the future. - * + * * @return true if the combo box is waiting for a reply from the server * with a new page of data, false otherwise */ @@ -1537,7 +1537,7 @@ public class VFilterSelect extends Composite * When this method is called, the suggestions have been reset if new * ones (different from the previous list) were received from the * server. - * + * * @param selectedKey * new selected key or null if none given by the server * @param selectedCaption @@ -1608,7 +1608,7 @@ public class VFilterSelect extends Composite /* * (non-Javadoc) - * + * * @see * com.google.gwt.user.client.ui.Widget#onBrowserEvent(com.google.gwt * .user.client.Event) @@ -1761,7 +1761,7 @@ public class VFilterSelect extends Composite /* * (non-Javadoc) - * + * * @see * com.google.gwt.user.client.ui.Composite#onBrowserEvent(com.google.gwt * .user.client.Event) @@ -1788,7 +1788,7 @@ public class VFilterSelect extends Composite * It is invoked during the Constructor and should only be overridden if a * custom TextBox shall be used. The overriding method cannot use any * instance variables. - * + * * @since 7.1.5 * @return TextBox instance used by this VFilterSelect */ @@ -1801,7 +1801,7 @@ public class VFilterSelect extends Composite * instance. It is invoked during the Constructor and should only be * overridden if a custom SuggestionPopup shall be used. The overriding * method cannot use any instance variables. - * + * * @since 7.1.5 * @return SuggestionPopup instance used by this VFilterSelect */ @@ -1829,7 +1829,7 @@ public class VFilterSelect extends Composite /** * Does the Select have more pages? - * + * * @return true if a next page exists, else false if the current page is the * last page */ @@ -1844,7 +1844,7 @@ public class VFilterSelect extends Composite /** * Filters the options at a certain page. Uses the text box input as a * filter - * + * * @param page * The page which items are to be filtered */ @@ -1854,7 +1854,7 @@ public class VFilterSelect extends Composite /** * Filters the options at certain page using the given filter - * + * * @param page * The page to filter * @param filter @@ -1917,7 +1917,7 @@ public class VFilterSelect extends Composite /** * Sets the text in the text box. - * + * * @param text * the text to set in the text box */ @@ -1957,7 +1957,7 @@ public class VFilterSelect extends Composite * shown in the text box if nothing has been entered. * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param text * The text the text box should contain. */ @@ -1972,7 +1972,7 @@ public class VFilterSelect extends Composite /** * Triggered when a suggestion is selected - * + * * @param suggestion * The suggestion that just got selected. */ @@ -2024,7 +2024,7 @@ public class VFilterSelect extends Composite /** * Sets the icon URI of the selected item. The icon is shown on the left * side of the item caption text. Set the URI to null to remove the icon. - * + * * @param iconUri * The URI of the icon */ @@ -2070,12 +2070,12 @@ public class VFilterSelect extends Composite /** * Perform selection based on a message from the server. - * + * * This method is called when the server gave a non-empty selected item key, * whereas null selection is handled by {@link #resetSelection()} and the * special case where the selected item is not on the current page is * handled separately by the caller. - * + * * @param selectedKey * non-empty selected item key * @param oldSuggestionTextMatchTheOldSelection @@ -2117,7 +2117,7 @@ public class VFilterSelect extends Composite /** * Reset the selection of the combo box to an empty string if focused, the * input prompt if not. - * + * * This method also clears the current suggestion and the selected option * key. */ @@ -2180,7 +2180,7 @@ public class VFilterSelect extends Composite /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.KeyDownHandler#onKeyDown(com.google.gwt * .event.dom.client.KeyDownEvent) @@ -2232,7 +2232,7 @@ public class VFilterSelect extends Composite /** * Triggered when a key is pressed in the text box - * + * * @param event * The KeyDownEvent */ @@ -2276,7 +2276,7 @@ public class VFilterSelect extends Composite /** * Triggered when a key was pressed in the suggestion popup. - * + * * @param event * The KeyDownEvent of the key */ @@ -2369,7 +2369,7 @@ public class VFilterSelect extends Composite /** * Triggered when a key was depressed - * + * * @param event * The KeyUpEvent of the key depressed */ @@ -2515,7 +2515,7 @@ public class VFilterSelect extends Composite /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.FocusHandler#onFocus(com.google.gwt.event * .dom.client.FocusEvent) @@ -2557,7 +2557,7 @@ public class VFilterSelect extends Composite /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.BlurHandler#onBlur(com.google.gwt.event * .dom.client.BlurEvent) @@ -2610,7 +2610,7 @@ public class VFilterSelect extends Composite /* * (non-Javadoc) - * + * * @see com.vaadin.client.Focusable#focus() */ @@ -2692,7 +2692,7 @@ public class VFilterSelect extends Composite /** * Get the width of the select in pixels where the text area and icon has * been included. - * + * * @return The width in pixels */ private int getMainWidth() { @@ -2709,7 +2709,7 @@ public class VFilterSelect extends Composite /** * Handles special behavior of the mouse down event - * + * * @param event */ private void handleMouseDownEvent(Event event) { @@ -2796,7 +2796,7 @@ public class VFilterSelect extends Composite /** * Sets the caption of selected item, if "scroll to page" is disabled. This * method is meant for internal use and may change in future versions. - * + * * @since 7.7 * @param selectedCaption * the caption of selected item @@ -2810,7 +2810,7 @@ public class VFilterSelect extends Composite /** * This method is meant for internal use and may change in future versions. - * + * * @since 7.7 * @return the caption of selected item, if "scroll to page" is disabled */ @@ -2821,7 +2821,7 @@ public class VFilterSelect extends Composite /** * Returns a handler receiving notifications from the connector about * communications. - * + * * @return the dataReceivedHandler */ public DataReceivedHandler getDataReceivedHandler() { diff --git a/client/src/main/java/com/vaadin/client/ui/VFlash.java b/client/src/main/java/com/vaadin/client/ui/VFlash.java index f6d62f0c07..00fc881bc3 100644 --- a/client/src/main/java/com/vaadin/client/ui/VFlash.java +++ b/client/src/main/java/com/vaadin/client/ui/VFlash.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VFormLayout.java b/client/src/main/java/com/vaadin/client/ui/VFormLayout.java index 150328e867..a221222b92 100644 --- a/client/src/main/java/com/vaadin/client/ui/VFormLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/VFormLayout.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -60,7 +60,7 @@ public class VFormLayout extends SimplePanel { /** * Parses the stylenames from shared state - * + * * @param state * shared state of the component * @param enabled @@ -100,7 +100,7 @@ public class VFormLayout extends SimplePanel { /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.ClickHandler#onClick(com.google.gwt * .event.dom.client.ClickEvent) @@ -225,7 +225,7 @@ public class VFormLayout extends SimplePanel { private Element captionContent; /** - * + * * @param component * optional owner of caption. If not set, getOwner will * return null @@ -330,7 +330,7 @@ public class VFormLayout extends SimplePanel { /** * Returns Paintable for which this Caption belongs to. - * + * * @return owner Widget */ public ComponentConnector getOwner() { diff --git a/client/src/main/java/com/vaadin/client/ui/VGridLayout.java b/client/src/main/java/com/vaadin/client/ui/VGridLayout.java index 3578ab8c36..c9140b8e91 100644 --- a/client/src/main/java/com/vaadin/client/ui/VGridLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/VGridLayout.java @@ -97,7 +97,7 @@ public class VGridLayout extends ComplexPanel { /** * Returns the column widths measured in pixels - * + * * @return */ protected int[] getColumnWidths() { @@ -106,7 +106,7 @@ public class VGridLayout extends ComplexPanel { /** * Returns the row heights measured in pixels - * + * * @return */ protected int[] getRowHeights() { @@ -115,7 +115,7 @@ public class VGridLayout extends ComplexPanel { /** * Returns the spacing between the cells horizontally in pixels - * + * * @return */ protected int getHorizontalSpacing() { @@ -124,7 +124,7 @@ public class VGridLayout extends ComplexPanel { /** * Returns the spacing between the cells vertically in pixels - * + * * @return */ protected int getVerticalSpacing() { @@ -185,7 +185,7 @@ public class VGridLayout extends ComplexPanel { /** * Checks if it is ok to hide (or ignore) the given row. - * + * * @param rowIndex * the row to check * @return true, if the row should be interpreted as non-existant (hides @@ -198,7 +198,7 @@ public class VGridLayout extends ComplexPanel { /** * Checks if it is ok to hide (or ignore) the given column. - * + * * @param columnIndex * the column to check * @return true, if the column should be interpreted as non-existant (hides @@ -785,7 +785,7 @@ public class VGridLayout extends ComplexPanel { * Creates a new Cell with the given coordinates. * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param row * @param col * @return @@ -801,7 +801,7 @@ public class VGridLayout extends ComplexPanel { * child component is also returned if "element" is part of its caption. * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param element * An element that is a nested sub element of the root element in * this layout @@ -822,13 +822,13 @@ public class VGridLayout extends ComplexPanel { * child component is also returned if "element" is part of its caption. * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param element * An element that is a nested sub element of the root element in * this layout * @return The Paintable which the element is a part of. Null if the element * belongs to the layout and not to a child. - * + * * @since 7.2 */ public ComponentConnector getComponent(Element element) { diff --git a/client/src/main/java/com/vaadin/client/ui/VHorizontalLayout.java b/client/src/main/java/com/vaadin/client/ui/VHorizontalLayout.java index b890aefe3d..295117f6c9 100644 --- a/client/src/main/java/com/vaadin/client/ui/VHorizontalLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/VHorizontalLayout.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VImage.java b/client/src/main/java/com/vaadin/client/ui/VImage.java index 2742182179..3f0828a9ba 100644 --- a/client/src/main/java/com/vaadin/client/ui/VImage.java +++ b/client/src/main/java/com/vaadin/client/ui/VImage.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VLabel.java b/client/src/main/java/com/vaadin/client/ui/VLabel.java index a3572759c4..d1358c4df0 100644 --- a/client/src/main/java/com/vaadin/client/ui/VLabel.java +++ b/client/src/main/java/com/vaadin/client/ui/VLabel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VLazyExecutor.java b/client/src/main/java/com/vaadin/client/ui/VLazyExecutor.java index dfa4f574c6..7190de45b3 100644 --- a/client/src/main/java/com/vaadin/client/ui/VLazyExecutor.java +++ b/client/src/main/java/com/vaadin/client/ui/VLazyExecutor.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -23,7 +23,7 @@ import com.google.gwt.user.client.Timer; * {@link #trigger()}. Calling {@link #trigger()} again before the command has * been executed causes the execution to be rescheduled to {@code delayMs} after * the second call. - * + * */ public class VLazyExecutor { diff --git a/client/src/main/java/com/vaadin/client/ui/VLink.java b/client/src/main/java/com/vaadin/client/ui/VLink.java index de99a8617f..929413db77 100644 --- a/client/src/main/java/com/vaadin/client/ui/VLink.java +++ b/client/src/main/java/com/vaadin/client/ui/VLink.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VListSelect.java b/client/src/main/java/com/vaadin/client/ui/VListSelect.java index 83e25163b3..82b7e9a229 100644 --- a/client/src/main/java/com/vaadin/client/ui/VListSelect.java +++ b/client/src/main/java/com/vaadin/client/ui/VListSelect.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VMediaBase.java b/client/src/main/java/com/vaadin/client/ui/VMediaBase.java index 53d7cef02d..8a6cd1af29 100644 --- a/client/src/main/java/com/vaadin/client/ui/VMediaBase.java +++ b/client/src/main/java/com/vaadin/client/ui/VMediaBase.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -31,7 +31,7 @@ public abstract class VMediaBase extends Widget { /** * Sets the MediaElement that is to receive all commands and properties. - * + * * @param element */ public void setMediaElement(MediaElement element) { diff --git a/client/src/main/java/com/vaadin/client/ui/VMenuBar.java b/client/src/main/java/com/vaadin/client/ui/VMenuBar.java index e0358413ac..93137ef82e 100644 --- a/client/src/main/java/com/vaadin/client/ui/VMenuBar.java +++ b/client/src/main/java/com/vaadin/client/ui/VMenuBar.java @@ -247,7 +247,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * This is called by the items in the menu and it communicates the * information to the server - * + * * @param clickedItemId * id of the item that was clicked */ @@ -284,7 +284,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Returns the containing element of the menu - * + * * @return */ @Override @@ -294,7 +294,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Add a new item to this menu - * + * * @param html * items text * @param cmd @@ -311,7 +311,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Add a new item to this menu - * + * * @param item */ public void addItem(CustomMenuItem item) { @@ -336,7 +336,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Remove the given item from this menu - * + * * @param item */ public void removeItem(CustomMenuItem item) { @@ -433,7 +433,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * When an item is clicked - * + * * @param item */ public void itemClick(CustomMenuItem item) { @@ -464,7 +464,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * When the user hovers the mouse over the item - * + * * @param item */ public void itemOver(CustomMenuItem item) { @@ -491,7 +491,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * When the mouse is moved away from an item - * + * * @param item */ public void itemOut(CustomMenuItem item) { @@ -549,7 +549,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Shows the child menu of an item. The caller must ensure that the item has * a submenu. - * + * * @param item */ public void showChildMenu(CustomMenuItem item) { @@ -639,9 +639,9 @@ public class VMenuBar extends SimpleFocusablePanel /** * Create an overlay for the menu bar. - * + * * This method can be overridden to use a custom overlay. - * + * * @since 7.6 * @return overlay to use */ @@ -686,7 +686,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Hides the submenu of an item - * + * * @param item */ public void hideChildMenu(CustomMenuItem item) { @@ -730,9 +730,9 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * + * * Recursively hide all child menus - * + * * @param animateIn * enable/disable animate-in animation when hide popup * @param animateOut @@ -764,7 +764,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Returns the parent menu of this menu, or null if this is the top-level * menu - * + * * @return */ public VMenuBar getParentMenu() { @@ -773,7 +773,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Set the parent menu of this menu - * + * * @param parent */ public void setParentMenu(VMenuBar parent) { @@ -783,7 +783,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Returns the currently selected item of this menu, or null if nothing is * selected - * + * * @return */ public CustomMenuItem getSelected() { @@ -792,7 +792,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Set the currently selected item of this menu - * + * * @param item */ public void setSelected(CustomMenuItem item) { @@ -809,9 +809,9 @@ public class VMenuBar extends SimpleFocusablePanel } /** - * + * * A class to hold information on menu items - * + * */ public static class CustomMenuItem extends Widget implements HasHTML { @@ -830,7 +830,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Default menu item {@link Widget} constructor for GWT.create(). - * + * * Use {@link #setHTML(String)} and {@link #setCommand(Command)} after * constructing a menu item. */ @@ -840,7 +840,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Creates a menu item {@link Widget}. - * + * * @param html * @param cmd * @deprecated use the default constructor and {@link #setHTML(String)} @@ -1087,7 +1087,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Checks if the item can be selected. - * + * * @return true if it is possible to select this item, false otherwise */ public boolean isSelectable() { @@ -1198,7 +1198,7 @@ public class VMenuBar extends SimpleFocusablePanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.KeyPressHandler#onKeyPress(com.google * .gwt.event.dom.client.KeyPressEvent) @@ -1221,7 +1221,7 @@ public class VMenuBar extends SimpleFocusablePanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.KeyDownHandler#onKeyDown(com.google.gwt * .event.dom.client.KeyDownEvent) @@ -1246,7 +1246,7 @@ public class VMenuBar extends SimpleFocusablePanel * Get the key that moves the selection upwards. By default it is the up * arrow key but by overriding this you can change the key to whatever you * want. - * + * * @return The keycode of the key */ protected int getNavigationUpKey() { @@ -1257,7 +1257,7 @@ public class VMenuBar extends SimpleFocusablePanel * Get the key that moves the selection downwards. By default it is the down * arrow key but by overriding this you can change the key to whatever you * want. - * + * * @return The keycode of the key */ protected int getNavigationDownKey() { @@ -1268,7 +1268,7 @@ public class VMenuBar extends SimpleFocusablePanel * Get the key that moves the selection left. By default it is the left * arrow key but by overriding this you can change the key to whatever you * want. - * + * * @return The keycode of the key */ protected int getNavigationLeftKey() { @@ -1279,7 +1279,7 @@ public class VMenuBar extends SimpleFocusablePanel * Get the key that moves the selection right. By default it is the right * arrow key but by overriding this you can change the key to whatever you * want. - * + * * @return The keycode of the key */ protected int getNavigationRightKey() { @@ -1289,7 +1289,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Get the key that selects a menu item. By default it is the Enter key but * by overriding this you can change the key to whatever you want. - * + * * @deprecated use {@link #isNavigationSelectKey(int)} instead * @return */ @@ -1302,7 +1302,7 @@ public class VMenuBar extends SimpleFocusablePanel * Checks whether key code selects a menu item. By default it is the Enter * and Space keys but by overriding this you can change the keys to whatever * you want. - * + * * @since 7.2 * @param keycode * @return true if key selects menu item @@ -1315,7 +1315,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Get the key that closes the menu. By default it is the escape key but by * overriding this yoy can change the key to whatever you want. - * + * * @return */ protected int getCloseMenuKey() { @@ -1324,7 +1324,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Handles the keyboard events handled by the MenuBar - * + * * @param event * The keyboard event received * @return true iff the navigation event was handled @@ -1577,7 +1577,7 @@ public class VMenuBar extends SimpleFocusablePanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.FocusHandler#onFocus(com.google.gwt.event * .dom.client.FocusEvent) @@ -1684,7 +1684,7 @@ public class VMenuBar extends SimpleFocusablePanel /** * Get menu item with given DOM element - * + * * @param element * Element used in search * @return Menu item or null if not found @@ -1713,11 +1713,11 @@ public class VMenuBar extends SimpleFocusablePanel /** * Get menu item with given DOM element - * + * * @param element * Element used in search * @return Menu item or null if not found - * + * * @since 7.2 */ public CustomMenuItem getMenuItemWithElement(Element element) { diff --git a/client/src/main/java/com/vaadin/client/ui/VNativeButton.java b/client/src/main/java/com/vaadin/client/ui/VNativeButton.java index 77b2515f45..6378da871d 100644 --- a/client/src/main/java/com/vaadin/client/ui/VNativeButton.java +++ b/client/src/main/java/com/vaadin/client/ui/VNativeButton.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -126,7 +126,7 @@ public class VNativeButton extends Button implements ClickHandler { /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.ClickHandler#onClick(com.google.gwt.event * .dom.client.ClickEvent) diff --git a/client/src/main/java/com/vaadin/client/ui/VNativeSelect.java b/client/src/main/java/com/vaadin/client/ui/VNativeSelect.java index d3c29b64ad..bd9386f601 100644 --- a/client/src/main/java/com/vaadin/client/ui/VNativeSelect.java +++ b/client/src/main/java/com/vaadin/client/ui/VNativeSelect.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -102,9 +102,9 @@ public class VNativeSelect extends VOptionGroupBase implements Field { /* * Workaround to achrome bug that may cause value change event not * to fire when selection is done with keyboard. - * + * * http://dev.vaadin.com/ticket/10109 - * + * * Problem is confirmed to exist only on Chrome-Win, but just * execute in for all webkits. Probably exists also in other * webkits/blinks on windows. diff --git a/client/src/main/java/com/vaadin/client/ui/VNotification.java b/client/src/main/java/com/vaadin/client/ui/VNotification.java index c33c0e4835..9b361ae114 100644 --- a/client/src/main/java/com/vaadin/client/ui/VNotification.java +++ b/client/src/main/java/com/vaadin/client/ui/VNotification.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -108,7 +108,7 @@ public class VNotification extends VOverlay { /** * @deprecated Use static {@link #createNotification(int)} instead to enable * GWT deferred binding. - * + * * @param delayMsec */ @Deprecated @@ -131,7 +131,7 @@ public class VNotification extends VOverlay { /** * @deprecated Use static {@link #createNotification(int, int, int)} instead * to enable GWT deferred binding. - * + * * @param delayMsec * @param fadeMsec * @param startOpacity @@ -538,7 +538,7 @@ public class VNotification extends VOverlay { /** * Meant for internal usage only. - * + * * @since 7.5.0 * @param client * application connection @@ -593,7 +593,7 @@ public class VNotification extends VOverlay { * stack. Can be called when opening other overlays such as subwindows to * ensure the notifications receive the events they need and don't linger * indefinitely. See #7136. - * + * * TODO Should this be a generic Overlay feature instead? */ public static void bringNotificationsToFront() { @@ -606,10 +606,10 @@ public class VNotification extends VOverlay { /** * Shows an error notification and redirects the user to the given URL when * she clicks on the notification. - * + * * If both message and caption are null, redirects the user to the url * immediately - * + * * @since 7.5.1 * @param connection * A reference to the ApplicationConnection @@ -667,7 +667,7 @@ public class VNotification extends VOverlay { /** * Listens for Notification hide event, and redirects. Used for system * messages, such as session expired. - * + * */ private static class NotificationRedirect implements VNotification.EventListener { diff --git a/client/src/main/java/com/vaadin/client/ui/VOptionGroup.java b/client/src/main/java/com/vaadin/client/ui/VOptionGroup.java index 4391683ac7..93054522a6 100644 --- a/client/src/main/java/com/vaadin/client/ui/VOptionGroup.java +++ b/client/src/main/java/com/vaadin/client/ui/VOptionGroup.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VOptionGroupBase.java b/client/src/main/java/com/vaadin/client/ui/VOptionGroupBase.java index d94f205edc..946128cbc6 100644 --- a/client/src/main/java/com/vaadin/client/ui/VOptionGroupBase.java +++ b/client/src/main/java/com/vaadin/client/ui/VOptionGroupBase.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -135,7 +135,7 @@ public abstract class VOptionGroupBase extends Composite implements Field, /** * For internal use only. May be removed or replaced in the future. - * + * * @return "rows" specified in uidl, 0 if not specified */ public int getRows() { diff --git a/client/src/main/java/com/vaadin/client/ui/VOverlay.java b/client/src/main/java/com/vaadin/client/ui/VOverlay.java index 52b5fbb3c1..076d7994cb 100644 --- a/client/src/main/java/com/vaadin/client/ui/VOverlay.java +++ b/client/src/main/java/com/vaadin/client/ui/VOverlay.java @@ -39,7 +39,7 @@ import com.vaadin.client.widgets.Overlay; * {@link Overlay} superclass and the default widgetset will replace it with * this. The widget will not be dependent on this Vaadin specific widget and can * be used in a pure GWT environment. - * + * * @deprecated as this is specifically for Vaadin only, it should not be used * directly. */ @@ -80,7 +80,7 @@ public class VOverlay extends Overlay implements CloseHandler<PopupPanel> { * A "thread local" of sorts, set temporarily so that VOverlayImpl knows * which VOverlay is using it, so that it can be attached to the correct * overlay container. - * + * * TODO this is a strange pattern that we should get rid of when possible. */ protected static VOverlay current; @@ -88,7 +88,7 @@ public class VOverlay extends Overlay implements CloseHandler<PopupPanel> { /** * Get the {@link ApplicationConnection} that this overlay belongs to. If * it's not set, {@link #getOwner()} is used to figure it out. - * + * * @return */ protected ApplicationConnection getApplicationConnection() { @@ -108,7 +108,7 @@ public class VOverlay extends Overlay implements CloseHandler<PopupPanel> { /** * Gets the 'overlay container' element. Tries to find the current * {@link ApplicationConnection} using {@link #getApplicationConnection()}. - * + * * @return the overlay container element for the current * {@link ApplicationConnection} or another element if the current * {@link ApplicationConnection} cannot be determined. @@ -132,7 +132,7 @@ public class VOverlay extends Overlay implements CloseHandler<PopupPanel> { * {@link ApplicationConnection}. Each overlay should be created in a * overlay container element, so that the correct theme and styles can be * applied. - * + * * @param ac * A reference to {@link ApplicationConnection} * @return The overlay container @@ -159,7 +159,7 @@ public class VOverlay extends Overlay implements CloseHandler<PopupPanel> { /** * Set the label of the container element, where tooltip, notification and * dialgs are added to. - * + * * @param applicationConnection * the application connection for which to change the label * @param overlayContainerLabel diff --git a/client/src/main/java/com/vaadin/client/ui/VPanel.java b/client/src/main/java/com/vaadin/client/ui/VPanel.java index 1bda29fbbf..a48703c914 100644 --- a/client/src/main/java/com/vaadin/client/ui/VPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/VPanel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -99,7 +99,7 @@ public class VPanel extends SimplePanel /** * Sets the keyboard focus on the Panel - * + * * @param focus * Should the panel have focus or not. */ @@ -113,7 +113,7 @@ public class VPanel extends SimplePanel /* * (non-Javadoc) - * + * * @see com.vaadin.client.Focusable#focus() */ diff --git a/client/src/main/java/com/vaadin/client/ui/VPasswordField.java b/client/src/main/java/com/vaadin/client/ui/VPasswordField.java index 1239c4cc75..c649028b8d 100644 --- a/client/src/main/java/com/vaadin/client/ui/VPasswordField.java +++ b/client/src/main/java/com/vaadin/client/ui/VPasswordField.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,9 +21,9 @@ import com.vaadin.client.legacy.ui.VLegacyTextField; /** * This class represents a password field. - * + * * @author Vaadin Ltd. - * + * */ public class VPasswordField extends VLegacyTextField { diff --git a/client/src/main/java/com/vaadin/client/ui/VPopupCalendar.java b/client/src/main/java/com/vaadin/client/ui/VPopupCalendar.java index 1b0f26d08a..bba1045b89 100644 --- a/client/src/main/java/com/vaadin/client/ui/VPopupCalendar.java +++ b/client/src/main/java/com/vaadin/client/ui/VPopupCalendar.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -57,12 +57,12 @@ import com.vaadin.shared.ui.datefield.Resolution; /** * Represents a date selection component with a text field and a popup date * selector. - * + * * <b>Note:</b> To change the keyboard assignments used in the popup dialog you * should extend <code>com.vaadin.client.ui.VCalendarPanel</code> and then pass * set it by calling the <code>setCalendarPanel(VCalendarPanel panel)</code> * method. - * + * */ public class VPopupCalendar extends VTextualDate implements Field, ClickHandler, CloseHandler<PopupPanel>, SubPartAware { @@ -255,7 +255,7 @@ public class VPopupCalendar extends VTextualDate /** * Checks whether the text field is enabled. - * + * * @see VPopupCalendar#setTextFieldEnabled(boolean) * @return The current state of the text field. */ @@ -268,7 +268,7 @@ public class VPopupCalendar extends VTextualDate * field is enabled. Disabling it causes only the button for date selection * to be active, thus preventing the user from entering invalid dates. See * {@link http://dev.vaadin.com/ticket/6790}. - * + * * @param state */ public void setTextFieldEnabled(boolean textFieldEnabled) { @@ -312,7 +312,7 @@ public class VPopupCalendar extends VTextualDate * Set correct tab index for disabled text field in IE as the value set in * setTextFieldEnabled(...) gets overridden in * TextualDateConnection.updateFromUIDL(...) - * + * * @since 7.3.1 */ public void setTextFieldTabIndex() { @@ -365,7 +365,7 @@ public class VPopupCalendar extends VTextualDate /* * (non-Javadoc) - * + * * @see * com.google.gwt.user.client.ui.UIObject#setStyleName(java.lang.String) */ @@ -418,7 +418,7 @@ public class VPopupCalendar extends VTextualDate /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.ClickHandler#onClick(com.google.gwt.event * .dom.client.ClickEvent) @@ -435,7 +435,7 @@ public class VPopupCalendar extends VTextualDate /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.logical.shared.CloseHandler#onClose(com.google.gwt * .event.logical.shared.CloseEvent) @@ -465,7 +465,7 @@ public class VPopupCalendar extends VTextualDate /** * Sets focus to Calendar panel. - * + * * @param focus */ public void setFocus(boolean focus) { @@ -485,7 +485,7 @@ public class VPopupCalendar extends VTextualDate * Sets the content of a special field for assistive devices, so that they * can recognize the change and inform the user (reading out in case of * screen reader) - * + * * @param selectedDate * Date that is currently selected */ @@ -496,7 +496,7 @@ public class VPopupCalendar extends VTextualDate /** * For internal use only. May be removed or replaced in the future. - * + * * @see com.vaadin.client.ui.VTextualDate#buildDate() */ @Override @@ -514,7 +514,7 @@ public class VPopupCalendar extends VTextualDate /** * Update the text field contents from the date. See {@link #buildDate()}. - * + * * @param forceValid * true to force the text field to be updated, false to only * update if the parsable flag is true. @@ -528,7 +528,7 @@ public class VPopupCalendar extends VTextualDate /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.VDateField#onBrowserEvent(com.google * .gwt.user.client.Event) */ @@ -545,7 +545,7 @@ public class VPopupCalendar extends VTextualDate /** * Get the key code that opens the calendar panel. By default it is the down * key but you can override this to be whatever you like - * + * * @return */ protected int getOpenCalenderPanelKey() { @@ -587,7 +587,7 @@ public class VPopupCalendar extends VTextualDate /** * Set a description that explains the usage of the Widget for users of * assistive devices. - * + * * @param descriptionForAssistiveDevices * String with the description */ @@ -600,7 +600,7 @@ public class VPopupCalendar extends VTextualDate /** * Get the description that explains the usage of the Widget for users of * assistive devices. - * + * * @return String with the description */ public String getDescriptionForAssistiveDevices() { @@ -611,7 +611,7 @@ public class VPopupCalendar extends VTextualDate * Sets the start range for this component. The start range is inclusive, * and it depends on the current resolution, what is considered inside the * range. - * + * * @param startDate * - the allowed range's start date */ @@ -622,7 +622,7 @@ public class VPopupCalendar extends VTextualDate /** * Sets the end range for this component. The end range is inclusive, and it * depends on the current resolution, what is considered inside the range. - * + * * @param endDate * - the allowed range's end date */ diff --git a/client/src/main/java/com/vaadin/client/ui/VProgressBar.java b/client/src/main/java/com/vaadin/client/ui/VProgressBar.java index 348791728f..b01c017fd9 100644 --- a/client/src/main/java/com/vaadin/client/ui/VProgressBar.java +++ b/client/src/main/java/com/vaadin/client/ui/VProgressBar.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -30,7 +30,7 @@ import com.vaadin.client.StyleConstants; * floating point value between 0 and 1 (inclusive). The progress bar can also * be in an indeterminate mode showing an animation indicating that the task is * running but without providing any information about the current progress. - * + * * @since 7.1 * @author Vaadin Ltd */ @@ -55,7 +55,7 @@ public class VProgressBar extends Widget implements HasEnabled { /* * (non-Javadoc) - * + * * @see * com.google.gwt.user.client.ui.UIObject#setStylePrimaryName(java.lang. * String) diff --git a/client/src/main/java/com/vaadin/client/ui/VProgressIndicator.java b/client/src/main/java/com/vaadin/client/ui/VProgressIndicator.java index f93fa37af6..158c8d3cd6 100644 --- a/client/src/main/java/com/vaadin/client/ui/VProgressIndicator.java +++ b/client/src/main/java/com/vaadin/client/ui/VProgressIndicator.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,9 +19,9 @@ package com.vaadin.client.ui; import com.vaadin.shared.ui.progressindicator.ProgressIndicatorState; /** - * + * * @author Vaadin Ltd - * + * * @deprecated as of 7.1, renamed to VProgressBar */ @Deprecated diff --git a/client/src/main/java/com/vaadin/client/ui/VRichTextArea.java b/client/src/main/java/com/vaadin/client/ui/VRichTextArea.java index 14cd17ea2e..8f1ff6c513 100644 --- a/client/src/main/java/com/vaadin/client/ui/VRichTextArea.java +++ b/client/src/main/java/com/vaadin/client/ui/VRichTextArea.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -43,9 +43,9 @@ import com.vaadin.client.ui.richtextarea.VRichTextToolbar; /** * This class implements a basic client side rich text editor component. - * + * * @author Vaadin Ltd. - * + * */ public class VRichTextArea extends Composite implements Field, KeyPressHandler, KeyDownHandler, Focusable { @@ -155,7 +155,7 @@ public class VRichTextArea extends Composite * render. Simple deferred command is not enough. Using Timer with * moderated timeout. If this appears to fail on many (most likely slow) * environments, consider increasing the timeout. - * + * * FF seems to require the most time to stabilize its RTA. On Vaadin * tiergarden test machines, 200ms was not enough always (about 50% * success rate) - 300 ms was 100% successful. This however was not @@ -284,7 +284,7 @@ public class VRichTextArea extends Composite /** * Set the value of the text area - * + * * @param value * The text value. Can be html. */ @@ -311,7 +311,7 @@ public class VRichTextArea extends Composite * Browsers differ in what they return as the content of a visually empty * rich text area. This method is used to normalize these to an empty * string. See #8004. - * + * * @return cleaned html string */ public String getSanitizedValue() { @@ -339,7 +339,7 @@ public class VRichTextArea extends Composite /** * Adds a blur handler to the component. - * + * * @param blurHandler * the blur handler to add */ @@ -349,7 +349,7 @@ public class VRichTextArea extends Composite /** * Removes a blur handler. - * + * * @param blurHandler * the handler to remove */ diff --git a/client/src/main/java/com/vaadin/client/ui/VScrollTable.java b/client/src/main/java/com/vaadin/client/ui/VScrollTable.java index 54eae33400..eb0b57e1dd 100644 --- a/client/src/main/java/com/vaadin/client/ui/VScrollTable.java +++ b/client/src/main/java/com/vaadin/client/ui/VScrollTable.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -110,25 +110,25 @@ import com.vaadin.shared.ui.table.TableConstants; /** * VScrollTable - * + * * VScrollTable is a FlowPanel having two widgets in it: * TableHead component * * ScrollPanel - * + * * TableHead contains table's header and widgets + logic for resizing, * reordering and hiding columns. - * + * * ScrollPanel contains VScrollTableBody object which handles content. To save * some bandwidth and to improve clients responsiveness with loads of data, in * VScrollTableBody all rows are not necessary rendered. There are "spacers" in * VScrollTableBody to use the exact same space as non-rendered rows would use. * This way we can use seamlessly traditional scrollbars and scrolling to fetch * more rows instead of "paging". - * + * * In VScrollTable we listen to scroll events. On horizontal scrolling we also * update TableHeads scroll position which has its scrollbars hidden. On * vertical scroll events we will check if we are reaching the end of area where * we have rows rendered and - * + * * TODO implement unregistering for child components in Cells */ public class VScrollTable extends FlowPanel @@ -137,7 +137,7 @@ public class VScrollTable extends FlowPanel /** * Simple interface for parts of the table capable of owning a context menu. - * + * * @since 7.2 * @author Vaadin Ltd */ @@ -147,7 +147,7 @@ public class VScrollTable extends FlowPanel /** * Handles showing context menu on "long press" from a touch screen. - * + * * @since 7.2 * @author Vaadin Ltd */ @@ -163,7 +163,7 @@ public class VScrollTable extends FlowPanel /** * Initializes a handler for a certain context menu owner. - * + * * @param target * the owner of the context menu */ @@ -184,7 +184,7 @@ public class VScrollTable extends FlowPanel /** * A function to handle touch context events in a table. - * + * * @param event * browser event to handle */ @@ -238,7 +238,7 @@ public class VScrollTable extends FlowPanel * Calculates how many pixels away the user's finger has traveled. This * reduces the chance of small non-intentional movements from canceling * the long press detection. - * + * * @param event * the Event for which to check the move distance * @return true if this is considered an intentional move by the user @@ -404,7 +404,7 @@ public class VScrollTable extends FlowPanel * The last known row height used to preserve the height of a table with * custom row heights and a fixed page length after removing the last row * from the table. - * + * * A new VScrollTableBody instance is created every time the number of rows * changes causing {@link VScrollTableBody#rowHeight} to be discarded and * the height recalculated by {@link VScrollTableBody#getRowHeight(boolean)} @@ -448,7 +448,7 @@ public class VScrollTable extends FlowPanel /* * (non-Javadoc) - * + * * @see java.lang.Object#toString() */ @@ -530,11 +530,11 @@ public class VScrollTable extends FlowPanel /** * For internal use only. May be removed or replaced in the future. - * + * * Overwrites onBrowserEvent function on FocusableScrollPanel to give event * access to touchContextProvider. Has to be public to give TableConnector * access to the scrollBodyPanel field. - * + * * @since 7.2 * @author Vaadin Ltd */ @@ -720,14 +720,14 @@ public class VScrollTable extends FlowPanel * Values (serverCacheFirst+serverCacheLast) sent by server that tells which * rows (indexes) are in the server side cache (page buffer). -1 means * unknown. The server side cache row MUST MATCH the client side cache rows. - * + * * If the client side cache contains additional rows with e.g. buttons, it * will cause out of sync when such a button is pressed. - * + * * If the server side cache contains additional rows with e.g. buttons, * scrolling in the client will cause empty buttons to be rendered * (cached=true request for non-existing components) - * + * * For internal use only. May be removed or replaced in the future. */ public int serverCacheFirst = -1; @@ -905,7 +905,7 @@ public class VScrollTable extends FlowPanel /** * Handles a context menu event on table body. - * + * * @param left * left position of the context menu * @param top @@ -925,7 +925,7 @@ public class VScrollTable extends FlowPanel /** * Fires a column resize event which sends the resize information to the * server. - * + * * @param columnId * The columnId of the column which was resized * @param originalWidth @@ -947,7 +947,7 @@ public class VScrollTable extends FlowPanel /** * Non-immediate variable update of column widths for a collection of * columns. - * + * * @param columns * the columns to trigger the events for. */ @@ -963,7 +963,7 @@ public class VScrollTable extends FlowPanel /** * Moves the focus one step down - * + * * @return Returns true if succeeded */ private boolean moveFocusDown() { @@ -972,7 +972,7 @@ public class VScrollTable extends FlowPanel /** * Moves the focus down by 1+offset rows - * + * * @return Returns true if succeeded, else false if the selection could not * be move downwards */ @@ -996,7 +996,7 @@ public class VScrollTable extends FlowPanel /** * Moves the selection one step up - * + * * @return Returns true if succeeded */ private boolean moveFocusUp() { @@ -1005,10 +1005,10 @@ public class VScrollTable extends FlowPanel /** * Moves the focus row upwards - * + * * @return Returns true if succeeded, else false if the selection could not * be move upwards - * + * */ private boolean moveFocusUp(int offset) { if (isSelectable()) { @@ -1032,7 +1032,7 @@ public class VScrollTable extends FlowPanel /** * Selects a row where the current selection head is - * + * * @param ctrlSelect * Is the selection a ctrl+selection * @param shiftSelect @@ -1072,7 +1072,7 @@ public class VScrollTable extends FlowPanel /** * Sends the selection to the server if it has been changed since the last * update/visit. - * + * * @param immediately * set to true to immediately send the rows */ @@ -1130,7 +1130,7 @@ public class VScrollTable extends FlowPanel * Get the key that moves the selection head upwards. By default it is the * up arrow key but by overriding this you can change the key to whatever * you want. - * + * * @return The keycode of the key */ protected int getNavigationUpKey() { @@ -1141,7 +1141,7 @@ public class VScrollTable extends FlowPanel * Get the key that moves the selection head downwards. By default it is the * down arrow key but by overriding this you can change the key to whatever * you want. - * + * * @return The keycode of the key */ protected int getNavigationDownKey() { @@ -1152,7 +1152,7 @@ public class VScrollTable extends FlowPanel * Get the key that scrolls to the left in the table. By default it is the * left arrow key but by overriding this you can change the key to whatever * you want. - * + * * @return The keycode of the key */ protected int getNavigationLeftKey() { @@ -1163,7 +1163,7 @@ public class VScrollTable extends FlowPanel * Get the key that scroll to the right on the table. By default it is the * right arrow key but by overriding this you can change the key to whatever * you want. - * + * * @return The keycode of the key */ protected int getNavigationRightKey() { @@ -1174,7 +1174,7 @@ public class VScrollTable extends FlowPanel * Get the key that selects an item in the table. By default it is the space * bar key but by overriding this you can change the key to whatever you * want. - * + * * @return */ protected int getNavigationSelectKey() { @@ -1185,7 +1185,7 @@ public class VScrollTable extends FlowPanel * Get the key the moves the selection one page up in the table. By default * this is the Page Up key but by overriding this you can change the key to * whatever you want. - * + * * @return */ protected int getNavigationPageUpKey() { @@ -1196,7 +1196,7 @@ public class VScrollTable extends FlowPanel * Get the key the moves the selection one page down in the table. By * default this is the Page Down key but by overriding this you can change * the key to whatever you want. - * + * * @return */ protected int getNavigationPageDownKey() { @@ -1207,7 +1207,7 @@ public class VScrollTable extends FlowPanel * Get the key the moves the selection to the beginning of the table. By * default this is the Home key but by overriding this you can change the * key to whatever you want. - * + * * @return */ protected int getNavigationStartKey() { @@ -1218,7 +1218,7 @@ public class VScrollTable extends FlowPanel * Get the key the moves the selection to the end of the table. By default * this is the End key but by overriding this you can change the key to * whatever you want. - * + * * @return */ protected int getNavigationEndKey() { @@ -1525,7 +1525,7 @@ public class VScrollTable extends FlowPanel /** * Returns the extra space that is given to the header column when column * width is determined by header text. - * + * * @return extra space in pixels */ private int getHeaderPadding() { @@ -1536,7 +1536,7 @@ public class VScrollTable extends FlowPanel * This method exists for the needs of {@link VTreeTable} only. Not part of * the official API, <b>extend at your own risk</b>. May be removed or * replaced in the future. - * + * * @return index of TreeTable's hierarchy column, or -1 if not applicable */ protected int getHierarchyColumnIndex() { @@ -1584,7 +1584,7 @@ public class VScrollTable extends FlowPanel * Selects the last row visible in the table * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param focusOnly * Should the focus only be moved to the last row */ @@ -1611,7 +1611,7 @@ public class VScrollTable extends FlowPanel * Selects the first row visible in the table * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param focusOnly * Should the focus only be moved to the first row */ @@ -1709,7 +1709,7 @@ public class VScrollTable extends FlowPanel * <p> * Update headers whould be called before this method is called! * </p> - * + * * @param strings */ private void updateFooter(String[] strings) { @@ -1738,7 +1738,7 @@ public class VScrollTable extends FlowPanel /** * For internal use only. May be removed or replaced in the future. - * + * * @param uidl * which contains row data * @param firstRow @@ -1867,7 +1867,7 @@ public class VScrollTable extends FlowPanel * on the commands in the UIDL. * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param partialRowAdditions * the UIDL containing row updates. */ @@ -1897,7 +1897,7 @@ public class VScrollTable extends FlowPanel /** * Gives correct column index for given column key ("cid" in UIDL). - * + * * @param colKey * @return column index of visible columns, -1 if column not visible */ @@ -1965,9 +1965,9 @@ public class VScrollTable extends FlowPanel /** * Note: not part of the official API, extend at your own risk. May be * removed or replaced in the future. - * + * * Sets the indicated column's width for headers and scrollBody alike. - * + * * @param colIndex * index of the modified column * @param w @@ -2015,7 +2015,7 @@ public class VScrollTable extends FlowPanel /** * Get a rendered row by its key - * + * * @param key * The key to search with * @return @@ -2036,10 +2036,10 @@ public class VScrollTable extends FlowPanel /** * Returns the next row to the given row - * + * * @param row * The row to calculate from - * + * * @return The next row or null if no row exists */ private VScrollTableRow getNextRow(VScrollTableRow row, int offset) { @@ -2062,7 +2062,7 @@ public class VScrollTable extends FlowPanel /** * Returns the previous row from the given row - * + * * @param row * The row to calculate from * @return The previous row or null if no row exists @@ -2174,13 +2174,13 @@ public class VScrollTable extends FlowPanel /** * Run only once when component is attached and received its initial * content. This function: - * + * * * Syncs headers and bodys "natural widths and saves the values. - * + * * * Sets proper width and height - * + * * * Makes deferred request to get some cache rows - * + * * For internal use only. May be removed or replaced in the future. */ public void sizeInit() { @@ -2192,7 +2192,7 @@ public class VScrollTable extends FlowPanel * We will use browsers table rendering algorithm to find proper column * widths. If content and header take less space than available, we will * divide extra space relatively to each column which has not width set. - * + * * Overflow pixels are added to last column. */ @@ -2497,7 +2497,7 @@ public class VScrollTable extends FlowPanel /** * Note: this method is not part of official API although declared as * protected. Extend at your own risk. - * + * * @return true if content area will have scrollbars visible. */ protected boolean willHaveScrollbars() { @@ -2637,7 +2637,7 @@ public class VScrollTable extends FlowPanel * to Table.setCurrentPageFirstItemIndex(int) In this case, * scrolling event takes way too late, and all the rows from * previous viewport to this one were requested. - * + * * This should prevent requesting unneeded rows by updating * reqFirstRow and reqRows before needing them. See (#14135) */ @@ -2927,7 +2927,7 @@ public class VScrollTable extends FlowPanel * Sets width to the header cell. This width should not include any * possible indent modifications that are present in * {@link VScrollTableBody#getMaxIndent()}. - * + * * @param w * required width of the cell sans indentations * @param ensureDefinedWidth @@ -2994,7 +2994,7 @@ public class VScrollTable extends FlowPanel /** * Detects if width is fixed by developer on server side or resized to * current width by user. - * + * * @return true if defined, false if "natural" width */ public boolean isDefinedWidth() { @@ -3003,10 +3003,10 @@ public class VScrollTable extends FlowPanel /** * This method exists for the needs of {@link VTreeTable} only. - * + * * Returns the pixels width of the header cell. This includes the * indent, if applicable. - * + * * @return The width in pixels */ protected int getWidthWithIndent() { @@ -3021,7 +3021,7 @@ public class VScrollTable extends FlowPanel /** * Returns the pixels width of the header cell. - * + * * @return The width in pixels */ public int getWidth() { @@ -3030,7 +3030,7 @@ public class VScrollTable extends FlowPanel /** * This method exists for the needs of {@link VTreeTable} only. - * + * * @return <code>true</code> if this is hierarcyColumn's header cell, * <code>false</code> otherwise */ @@ -3143,7 +3143,7 @@ public class VScrollTable extends FlowPanel /** * Fires a header click event after the user has clicked a column header * cell - * + * * @param event * The click event */ @@ -3374,7 +3374,7 @@ public class VScrollTable extends FlowPanel /** * Returns the smallest possible cell width in pixels. - * + * * @param includeIndent * - width should include hierarchy column indent if * applicable (VTreeTable only) @@ -3424,7 +3424,7 @@ public class VScrollTable extends FlowPanel /** * Saves natural column width if it hasn't been saved already. - * + * * @param columnIndex * @since 7.3.9 */ @@ -3455,10 +3455,10 @@ public class VScrollTable extends FlowPanel * Detects the natural minimum width for the column of this header cell. * If column is resized by user or the width is defined by server the * actual width is returned. Else the natural min width is returned. - * + * * @param columnIndex * column index hint, if -1 (unknown) it will be detected - * + * * @return */ public int getNaturalColumnWidth(int columnIndex) { @@ -3499,7 +3499,7 @@ public class VScrollTable extends FlowPanel /** * HeaderCell that is header cell for row headers. - * + * * Reordering disabled and clicking on it resets sorting. */ public class RowHeadersHeaderCell extends HeaderCell { @@ -3836,9 +3836,9 @@ public class VScrollTable extends FlowPanel /** * Get's HeaderCell by it's column Key. - * + * * Note that this returns HeaderCell even if it is currently collapsed. - * + * * @param cid * Column key of accessed HeaderCell * @return HeaderCell @@ -4139,7 +4139,7 @@ public class VScrollTable extends FlowPanel /** * Sets the text of the footer - * + * * @param footerText * The text in the footer */ @@ -4153,7 +4153,7 @@ public class VScrollTable extends FlowPanel /** * Set alignment of the text in the cell - * + * * @param c * The alignment which can be ALIGN_CENTER, ALIGN_LEFT, * ALIGN_RIGHT @@ -4177,7 +4177,7 @@ public class VScrollTable extends FlowPanel /** * Get the alignment of the text int the cell - * + * * @return Returns either ALIGN_CENTER, ALIGN_LEFT or ALIGN_RIGHT */ public char getAlign() { @@ -4188,7 +4188,7 @@ public class VScrollTable extends FlowPanel * Sets the width of the cell. This width should not include any * possible indent modifications that are present in * {@link VScrollTableBody#getMaxIndent()}. - * + * * @param w * The width of the cell * @param ensureDefinedWidth @@ -4271,7 +4271,7 @@ public class VScrollTable extends FlowPanel /** * Detects if width is fixed by developer on server side or resized to * current width by user. - * + * * @return true if defined, false if "natural" width */ public boolean isDefinedWidth() { @@ -4280,7 +4280,7 @@ public class VScrollTable extends FlowPanel /** * Returns the pixels width of the footer cell. - * + * * @return The width in pixels */ public int getWidth() { @@ -4289,7 +4289,7 @@ public class VScrollTable extends FlowPanel /** * Sets the expand ratio of the cell - * + * * @param floatAttribute * The expand ratio */ @@ -4299,7 +4299,7 @@ public class VScrollTable extends FlowPanel /** * Returns the expand ratio of the cell - * + * * @return The expand ratio */ public float getExpandRatio() { @@ -4308,7 +4308,7 @@ public class VScrollTable extends FlowPanel /** * Is the cell enabled? - * + * * @return True if enabled else False */ public boolean isEnabled() { @@ -4344,7 +4344,7 @@ public class VScrollTable extends FlowPanel /** * Handles a event on the captions - * + * * @param event * The event to handle */ @@ -4358,7 +4358,7 @@ public class VScrollTable extends FlowPanel /** * Fires a footer click event after the user has clicked a column footer * cell - * + * * @param event * The click event */ @@ -4375,7 +4375,7 @@ public class VScrollTable extends FlowPanel /** * Returns the column key of the column - * + * * @return The column key */ public String getColKey() { @@ -4384,7 +4384,7 @@ public class VScrollTable extends FlowPanel /** * Saves natural column width if it hasn't been saved already. - * + * * @param columnIndex * @since 7.3.9 */ @@ -4413,10 +4413,10 @@ public class VScrollTable extends FlowPanel * Detects the natural minimum width for the column of this header cell. * If column is resized by user or the width is defined by server the * actual width is returned. Else the natural min width is returned. - * + * * @param columnIndex * column index hint, if -1 (unknown) it will be detected - * + * * @return */ public int getNaturalColumnWidth(int columnIndex) { @@ -4444,7 +4444,7 @@ public class VScrollTable extends FlowPanel /** * HeaderCell that is header cell for row headers. - * + * * Reordering disabled and clicking on it resets sorting. */ public class RowHeadersFooterCell extends FooterCell { @@ -4514,7 +4514,7 @@ public class VScrollTable extends FlowPanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.user.client.ui.Panel#remove(com.google.gwt.user.client * .ui.Widget) @@ -4533,7 +4533,7 @@ public class VScrollTable extends FlowPanel /* * (non-Javadoc) - * + * * @see com.google.gwt.user.client.ui.HasWidgets#iterator() */ @@ -4544,10 +4544,10 @@ public class VScrollTable extends FlowPanel /** * Gets a footer cell which represents the given columnId - * + * * @param cid * The columnId - * + * * @return The cell */ public FooterCell getFooterCell(String cid) { @@ -4556,7 +4556,7 @@ public class VScrollTable extends FlowPanel /** * Gets a footer cell by using a column index - * + * * @param index * The index of the column * @return The Cell @@ -4571,7 +4571,7 @@ public class VScrollTable extends FlowPanel /** * Updates the cells contents when updateUIDL request is received - * + * * @param uidl * The UIDL */ @@ -4642,7 +4642,7 @@ public class VScrollTable extends FlowPanel /** * Set a footer cell for a specified column index - * + * * @param index * The index * @param cell @@ -4673,7 +4673,7 @@ public class VScrollTable extends FlowPanel /** * Remove a cell by using the columnId - * + * * @param colKey * The columnId to remove */ @@ -4684,7 +4684,7 @@ public class VScrollTable extends FlowPanel /** * Enable a column (Sets the footer cell) - * + * * @param cid * The columnId * @param index @@ -4717,7 +4717,7 @@ public class VScrollTable extends FlowPanel /** * Set the horizontal position in the cell in the footer. This is done * when a horizontal scrollbar is present. - * + * * @param scrollLeft * The value of the leftScroll */ @@ -4727,7 +4727,7 @@ public class VScrollTable extends FlowPanel /** * Swap cells when the column are dragged - * + * * @param oldIndex * The old index of the cell * @param newIndex @@ -4749,7 +4749,7 @@ public class VScrollTable extends FlowPanel * This Panel can only contain VScrollTableRow type of widgets. This * "simulates" very large table, keeping spacers which take room of * unrendered rows. - * + * */ public class VScrollTableBody extends Panel { @@ -4956,7 +4956,7 @@ public class VScrollTable extends FlowPanel /* * #8040 - scroll position is completely changed since the * latest request, so request a new set of rows. - * + * * TODO: We should probably check whether the fetched rows match * the current scroll position right when they arrive, so as to * not waste time rendering a set of rows that will never be @@ -4971,7 +4971,7 @@ public class VScrollTable extends FlowPanel } else if (firstRendered > reactFirstRow) { /* * Branch for fetching cache above visible area. - * + * * If cache needed for both before and after visible area, this * will be rendered after-cache is received and rendered. So in * some rare situations the table may make two cache visits to @@ -4984,7 +4984,7 @@ public class VScrollTable extends FlowPanel /** * Inserts rows as provided in the rowData starting at firstIndex. - * + * * @param rowData * @param firstIndex * @param rows @@ -5066,9 +5066,9 @@ public class VScrollTable extends FlowPanel * This method is used to instantiate new rows for this table. It * automatically sets correct widths to rows cells and assigns correct * client reference for child widgets. - * + * * This method can be called only after table has been initialized - * + * * @param uidl */ private VScrollTableRow prepareRow(UIDL uidl) { @@ -5309,7 +5309,7 @@ public class VScrollTable extends FlowPanel /** * Returns the width available for column content. - * + * * @param columnIndex * @return */ @@ -5339,14 +5339,14 @@ public class VScrollTable extends FlowPanel /** * Sets the content width of a column. - * + * * Due IE limitation, we must set the width to a wrapper elements inside * table cells (with overflow hidden, which does not work on td * elements). - * + * * To get this work properly crossplatform, we will also set the width * of td. - * + * * @param colIndex * @param w */ @@ -5373,9 +5373,9 @@ public class VScrollTable extends FlowPanel * removed or replaced in the future.</br> * </br> * Returns the maximum indent of the hierarcyColumn, if applicable. - * + * * @see {@link VScrollTable#getHierarchyColumnIndex()} - * + * * @return maximum indent in pixels */ protected int getMaxIndent() { @@ -5649,7 +5649,7 @@ public class VScrollTable extends FlowPanel /** * Overriding this and returning true causes all text cells to be * rendered as HTML. - * + * * @return always returns false in the default implementation */ protected boolean isRenderHtmlInCells() { @@ -5658,7 +5658,7 @@ public class VScrollTable extends FlowPanel /** * Detects whether row is visible in tables viewport. - * + * * @return */ public boolean isInViewPort() { @@ -5674,7 +5674,7 @@ public class VScrollTable extends FlowPanel /** * Makes a check based on indexes whether the row is before the * compared row. - * + * * @param row1 * @return true if this rows index is smaller than in the row1 */ @@ -5685,7 +5685,7 @@ public class VScrollTable extends FlowPanel /** * Sets the index of the row in the whole table. Currently used just * to set even/odd classname - * + * * @param indexInWholeTable */ private void setIndex(int indexInWholeTable) { @@ -5864,7 +5864,7 @@ public class VScrollTable extends FlowPanel /** * If there are registered click listeners, sends a click event and * returns true. Otherwise, does nothing and returns false. - * + * * @param event * @param targetTdOrTr * @param immediate @@ -5939,7 +5939,7 @@ public class VScrollTable extends FlowPanel /** * Special handler for touch devices that support native scrolling - * + * * @return Whether the event was handled by this method. */ private boolean handleTouchEvent(final Event event) { @@ -6392,7 +6392,7 @@ public class VScrollTable extends FlowPanel /** * Checks if the row represented by the row key has been selected - * + * * @param key * The generated row key */ @@ -6462,7 +6462,7 @@ public class VScrollTable extends FlowPanel * target of the event should not be handled. If the event target is * the row directly this method returns the TR element instead of * the TD. - * + * * @param event * @return TD or TR element that the event targets (the actual event * target is this element or a child of it) @@ -6518,7 +6518,7 @@ public class VScrollTable extends FlowPanel /** * Has the row been selected? - * + * * @return Returns true if selected, else false */ public boolean isSelected() { @@ -6543,7 +6543,7 @@ public class VScrollTable extends FlowPanel /** * Is called when a user clicks an item when holding SHIFT key down. * This will select a new range from the last focused row - * + * * @param deselectPrevious * Should the previous selected range be deselected */ @@ -6612,7 +6612,7 @@ public class VScrollTable extends FlowPanel /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.IActionOwner#getActions () */ @@ -6790,7 +6790,7 @@ public class VScrollTable extends FlowPanel /** * Ensure the component has a focus. - * + * * TODO the current implementation simply always calls focus for the * component. In case the Table at some point implements focus/blur * listeners, this method needs to be evolved to conditionally call @@ -7001,7 +7001,7 @@ public class VScrollTable extends FlowPanel if (getTotalRows() == 0) { /* * Too wide header combined with no rows in the table. - * + * * No horizontal scrollbars would be displayed because * there's no rows that grows too wide causing the * scrollBody container div to overflow. Must explicitely @@ -7164,7 +7164,7 @@ public class VScrollTable extends FlowPanel /** * helper to set pixel size of head and body part - * + * * @param pixels */ private void setContentWidth(int pixels) { @@ -7314,7 +7314,7 @@ public class VScrollTable extends FlowPanel /** * Helper function to build html snippet for column or row headers - * + * * @param uidl * possibly with values caption and icon * @return html snippet containing possibly an icon + caption text @@ -7361,7 +7361,7 @@ public class VScrollTable extends FlowPanel scrollTop = scrollBodyPanel.getScrollPosition(); /* * #6970 - IE sometimes fires scroll events for a detached table. - * + * * FIXME initializedAndAttached should probably be renamed - its name * doesn't seem to reflect its semantics. onDetach() doesn't set it to * false, and changing that might break something else, so we need to @@ -7661,7 +7661,7 @@ public class VScrollTable extends FlowPanel /** * Moves the selection head to a specific row - * + * * @param row * The row to where the selection head should move * @return Returns true if focus was moved successfully, else false @@ -7703,7 +7703,7 @@ public class VScrollTable extends FlowPanel /** * Ensures that the row is visible - * + * * @param row * The row to ensure is visible */ @@ -7722,7 +7722,7 @@ public class VScrollTable extends FlowPanel /** * Handles the keyboard events handled by the table - * + * * @param event * The keyboard event received * @return true iff the navigation event was handled @@ -7982,7 +7982,7 @@ public class VScrollTable extends FlowPanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.FocusHandler#onFocus(com.google.gwt.event * .dom.client.FocusEvent) @@ -8004,7 +8004,7 @@ public class VScrollTable extends FlowPanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.BlurHandler#onBlur(com.google.gwt.event * .dom.client.BlurEvent) @@ -8048,7 +8048,7 @@ public class VScrollTable extends FlowPanel /** * Removes a key from a range if the key is found in a selected range - * + * * @param key * The key to remove */ @@ -8074,7 +8074,7 @@ public class VScrollTable extends FlowPanel /** * Can the Table be focused? - * + * * @return True if the table can be focused, else false */ public boolean isFocusable() { @@ -8095,7 +8095,7 @@ public class VScrollTable extends FlowPanel /* * (non-Javadoc) - * + * * @see com.vaadin.client.Focusable#focus() */ @@ -8164,7 +8164,7 @@ public class VScrollTable extends FlowPanel } /** - * + * * @param keyCode * @return true if the given keyCode is used by the table for navigation */ @@ -8225,7 +8225,7 @@ public class VScrollTable extends FlowPanel * Add this to the element mouse down event by using element.setPropertyJSO * ("onselectstart",applyDisableTextSelectionIEHack()); Remove it then again * when the mouse is depressed in the mouse up event. - * + * * @return Returns the JSO preventing text selection */ private static native JavaScriptObject getPreventTextSelectionIEHack() diff --git a/client/src/main/java/com/vaadin/client/ui/VSlider.java b/client/src/main/java/com/vaadin/client/ui/VSlider.java index 0d7ab474e1..cc36d8b8d9 100644 --- a/client/src/main/java/com/vaadin/client/ui/VSlider.java +++ b/client/src/main/java/com/vaadin/client/ui/VSlider.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -425,7 +425,7 @@ public class VSlider extends SimpleFocusablePanel /** * TODO consider extracting touches support to an impl class specific for * webkit (only browser that really supports touches). - * + * * @param event * @return */ @@ -463,7 +463,7 @@ public class VSlider extends SimpleFocusablePanel /** * Handles the keyboard events handled by the Slider - * + * * @param event * The keyboard event received * @return true iff the navigation event was handled @@ -506,7 +506,7 @@ public class VSlider extends SimpleFocusablePanel * Get the key that increases the vertical slider. By default it is the up * arrow key but by overriding this you can change the key to whatever you * want. - * + * * @return The keycode of the key */ protected int getNavigationUpKey() { @@ -517,7 +517,7 @@ public class VSlider extends SimpleFocusablePanel * Get the key that decreases the vertical slider. By default it is the down * arrow key but by overriding this you can change the key to whatever you * want. - * + * * @return The keycode of the key */ protected int getNavigationDownKey() { @@ -528,7 +528,7 @@ public class VSlider extends SimpleFocusablePanel * Get the key that decreases the horizontal slider. By default it is the * left arrow key but by overriding this you can change the key to whatever * you want. - * + * * @return The keycode of the key */ protected int getNavigationLeftKey() { @@ -539,7 +539,7 @@ public class VSlider extends SimpleFocusablePanel * Get the key that increases the horizontal slider. By default it is the * right arrow key but by overriding this you can change the key to whatever * you want. - * + * * @return The keycode of the key */ protected int getNavigationRightKey() { diff --git a/client/src/main/java/com/vaadin/client/ui/VSplitPanelHorizontal.java b/client/src/main/java/com/vaadin/client/ui/VSplitPanelHorizontal.java index 1a3e699b20..facba82b4a 100644 --- a/client/src/main/java/com/vaadin/client/ui/VSplitPanelHorizontal.java +++ b/client/src/main/java/com/vaadin/client/ui/VSplitPanelHorizontal.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VSplitPanelVertical.java b/client/src/main/java/com/vaadin/client/ui/VSplitPanelVertical.java index 5f645887bc..b3904960ad 100644 --- a/client/src/main/java/com/vaadin/client/ui/VSplitPanelVertical.java +++ b/client/src/main/java/com/vaadin/client/ui/VSplitPanelVertical.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VTabsheet.java b/client/src/main/java/com/vaadin/client/ui/VTabsheet.java index 74b3cf3871..ca7db968d8 100644 --- a/client/src/main/java/com/vaadin/client/ui/VTabsheet.java +++ b/client/src/main/java/com/vaadin/client/ui/VTabsheet.java @@ -1466,7 +1466,7 @@ public class VTabsheet extends VTabsheetBase /* * Generate the correct focus/blur events for the main TabSheet component * (#14304). - * + * * The TabSheet must fire one focus event when the user clicks on the tab * bar (i.e. inner TabBar class) containing the Tabs or when the focus is * provided to the TabSheet by any means. Also one blur event should be @@ -1474,15 +1474,15 @@ public class VTabsheet extends VTabsheetBase * tab bar and before leaving it, no matter how many times he's pressing the * Tabs or the scroll buttons, the TabSheet component should not fire any of * those blur/focus events. - * + * * The only focusable elements contained in the tab bar are the Tabs (see * inner class Tab). The reason is the accessibility support. - * + * * Having this in mind, the chosen solution path for our problem is to match * a sequence of focus/blur events on the tabs, choose only the first focus * and last blur events and pass only those further to the main component. * Any consecutive blur/focus events on 2 Tabs must be ignored. - * + * * Because in a blur event we don't know whether or not a focus will follow, * we just defer a command initiated on the blur event to wait and see if * any focus will appear. The command will be executed after the next focus, @@ -1893,9 +1893,9 @@ public class VTabsheet extends VTabsheetBase /** * Gets the key to activate the selected tab when navigating using * previous/next (left/right) keys. - * + * * @return the key to activate the selected tab. - * + * * @see #getNextTabKey() * @see #getPreviousTabKey() */ @@ -1949,7 +1949,7 @@ public class VTabsheet extends VTabsheetBase /** * Makes tab bar visible. - * + * * @since 7.2 */ public void showTabs() { diff --git a/client/src/main/java/com/vaadin/client/ui/VTabsheetBase.java b/client/src/main/java/com/vaadin/client/ui/VTabsheetBase.java index e96aa035ed..cc22213b14 100644 --- a/client/src/main/java/com/vaadin/client/ui/VTabsheetBase.java +++ b/client/src/main/java/com/vaadin/client/ui/VTabsheetBase.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -92,7 +92,7 @@ public abstract class VTabsheetBase extends ComplexPanel implements HasEnabled { /** * Returns true if the width of the widget is undefined, false otherwise. - * + * * @since 7.2 * @return true if width of the widget is determined by its content */ @@ -102,7 +102,7 @@ public abstract class VTabsheetBase extends ComplexPanel implements HasEnabled { /** * Returns true if the height of the widget is undefined, false otherwise. - * + * * @since 7.2 * @return true if width of the height is determined by its content */ @@ -112,10 +112,10 @@ public abstract class VTabsheetBase extends ComplexPanel implements HasEnabled { /** * Sets the connector that should be notified of events etc. - * + * * For internal use only. This method may be removed or replaced in the * future. - * + * * @since 7.2 * @param connector */ @@ -175,7 +175,7 @@ public abstract class VTabsheetBase extends ComplexPanel implements HasEnabled { * Sets whether the caption is rendered as HTML. * <p> * The default is false, i.e. render tab captions as plain text - * + * * @since 7.4 * @param captionAsHtml * true if the captions are rendered as HTML, false if rendered @@ -187,9 +187,9 @@ public abstract class VTabsheetBase extends ComplexPanel implements HasEnabled { /** * Checks whether captions are rendered as HTML - * + * * The default is false, i.e. render tab captions as plain text - * + * * @since 7.4 * @return true if the captions are rendered as HTML, false if rendered as * plain text diff --git a/client/src/main/java/com/vaadin/client/ui/VTabsheetPanel.java b/client/src/main/java/com/vaadin/client/ui/VTabsheetPanel.java index 6360a32785..a2da8f948a 100644 --- a/client/src/main/java/com/vaadin/client/ui/VTabsheetPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/VTabsheetPanel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -29,7 +29,7 @@ import com.vaadin.client.ui.TouchScrollDelegate.TouchScrollHandler; * A panel that displays all of its child widgets in a 'deck', where only one * can be visible at a time. It is used by * {@link com.vaadin.client.ui.VTabsheet}. - * + * * This class has the same basic functionality as the GWT DeckPanel * {@link com.google.gwt.user.client.ui.DeckPanel}, with the exception that it * doesn't manipulate the child widgets' width and height attributes. @@ -50,7 +50,7 @@ public class VTabsheetPanel extends ComplexPanel { /** * Adds the specified widget to the deck. - * + * * @param w * the widget to be added */ @@ -71,7 +71,7 @@ public class VTabsheetPanel extends ComplexPanel { /** * Gets the index of the currently-visible widget. - * + * * @return the visible widget's index */ public int getVisibleWidget() { @@ -80,7 +80,7 @@ public class VTabsheetPanel extends ComplexPanel { /** * Inserts a widget before the specified index. - * + * * @param w * the widget to be inserted * @param beforeIndex @@ -117,7 +117,7 @@ public class VTabsheetPanel extends ComplexPanel { /** * Shows the widget at the specified index. This causes the currently- * visible widget to be hidden. - * + * * @param index * the index of the widget to be shown */ diff --git a/client/src/main/java/com/vaadin/client/ui/VTextArea.java b/client/src/main/java/com/vaadin/client/ui/VTextArea.java index 4cf5743294..778da6fc45 100644 --- a/client/src/main/java/com/vaadin/client/ui/VTextArea.java +++ b/client/src/main/java/com/vaadin/client/ui/VTextArea.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -38,12 +38,12 @@ import com.vaadin.client.ui.dd.DragImageModifier; /** * This class represents a multiline textfield (textarea). - * + * * TODO consider replacing this with a RichTextArea based implementation. IE * does not support CSS height for textareas in Strict mode :-( - * + * * @author Vaadin Ltd. - * + * */ public class VTextArea extends VLegacyTextField implements DragImageModifier { diff --git a/client/src/main/java/com/vaadin/client/ui/VTextField.java b/client/src/main/java/com/vaadin/client/ui/VTextField.java index ea7e436178..5dfa0219df 100644 --- a/client/src/main/java/com/vaadin/client/ui/VTextField.java +++ b/client/src/main/java/com/vaadin/client/ui/VTextField.java @@ -22,9 +22,9 @@ import com.google.gwt.user.client.ui.TextBoxBase; /** * This class represents a basic text input field with one row. - * + * * @author Vaadin Ltd. - * + * */ public class VTextField extends TextBoxBase implements Field { diff --git a/client/src/main/java/com/vaadin/client/ui/VTextualDate.java b/client/src/main/java/com/vaadin/client/ui/VTextualDate.java index c71108c86f..6b1370579a 100644 --- a/client/src/main/java/com/vaadin/client/ui/VTextualDate.java +++ b/client/src/main/java/com/vaadin/client/ui/VTextualDate.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VTree.java b/client/src/main/java/com/vaadin/client/ui/VTree.java index 86d5c0afcd..7f83548010 100644 --- a/client/src/main/java/com/vaadin/client/ui/VTree.java +++ b/client/src/main/java/com/vaadin/client/ui/VTree.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -79,7 +79,7 @@ import com.vaadin.shared.ui.dd.VerticalDropLocation; import com.vaadin.shared.ui.tree.TreeConstants; /** - * + * */ public class VTree extends FocusElementPanel implements VHasDropHandler, FocusHandler, BlurHandler, KeyPressHandler, @@ -237,7 +237,7 @@ public class VTree extends FocusElementPanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.user.client.ui.Widget#onBrowserEvent(com.google.gwt.user * .client.Event) @@ -289,7 +289,7 @@ public class VTree extends FocusElementPanel /** * Returns the first root node of the tree or null if there are no root * nodes. - * + * * @return The first root {@link TreeNode} */ protected TreeNode getFirstRootNode() { @@ -302,7 +302,7 @@ public class VTree extends FocusElementPanel /** * Returns the last root node of the tree or null if there are no root * nodes. - * + * * @return The last root {@link TreeNode} */ protected TreeNode getLastRootNode() { @@ -315,7 +315,7 @@ public class VTree extends FocusElementPanel /** * Returns a list of all root nodes in the Tree in the order they appear in * the tree. - * + * * @return A list of all root {@link TreeNode}s. */ protected List<TreeNode> getRootNodes() { @@ -514,7 +514,7 @@ public class VTree extends FocusElementPanel /** * Is a node selected in the tree - * + * * @param treeNode * The node to check * @return @@ -637,7 +637,7 @@ public class VTree extends FocusElementPanel /** * Handles mouse selection - * + * * @param ctrl * Was the ctrl-key pressed * @param shift @@ -702,7 +702,7 @@ public class VTree extends FocusElementPanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.user.client.ui.Widget#onBrowserEvent(com.google.gwt * .user.client.Event) @@ -811,7 +811,7 @@ public class VTree extends FocusElementPanel /** * Checks if the given element is the caption or the icon. - * + * * @param target * The element to check * @return true if the element is the caption or the icon @@ -1000,7 +1000,7 @@ public class VTree extends FocusElementPanel /** * Returns the children of the node - * + * * @return A set of tree nodes */ public List<TreeNode> getChildren() { @@ -1047,7 +1047,7 @@ public class VTree extends FocusElementPanel * Adds/removes Vaadin specific style name. * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param selected */ public void setSelected(boolean selected) { @@ -1061,7 +1061,7 @@ public class VTree extends FocusElementPanel /** * Travels up the hierarchy looking for this node - * + * * @param child * The child which grandparent this is or is not * @return True if this is a grandparent of the child node @@ -1100,7 +1100,7 @@ public class VTree extends FocusElementPanel /* * (non-Javadoc) - * + * * @see com.google.gwt.user.client.ui.Widget#onDetach() */ @Override @@ -1111,7 +1111,7 @@ public class VTree extends FocusElementPanel /* * (non-Javadoc) - * + * * @see com.google.gwt.user.client.ui.UIObject#toString() */ @Override @@ -1121,7 +1121,7 @@ public class VTree extends FocusElementPanel /** * Is the node focused? - * + * * @param focused * True if focused, false if not */ @@ -1197,7 +1197,7 @@ public class VTree extends FocusElementPanel /** * Selects a range of nodes - * + * * @param startNodeKey * The start node key * @param endNodeKey @@ -1227,7 +1227,7 @@ public class VTree extends FocusElementPanel /** * Selects a node and deselect all other nodes - * + * * @param node * The node to select */ @@ -1246,7 +1246,7 @@ public class VTree extends FocusElementPanel /** * Deselects a node - * + * * @param node * The node to deselect */ @@ -1258,7 +1258,7 @@ public class VTree extends FocusElementPanel /** * Selects all the open children to a node - * + * * @param node * The parent node */ @@ -1281,7 +1281,7 @@ public class VTree extends FocusElementPanel /** * Selects all children until a stop child is reached - * + * * @param root * The root not to start from * @param stopNode @@ -1290,7 +1290,7 @@ public class VTree extends FocusElementPanel * Should the root node be selected * @param includeStopNode * Should the stop node be selected - * + * * @return Returns false if the stop child was found, else true if all * children was selected */ @@ -1326,7 +1326,7 @@ public class VTree extends FocusElementPanel /** * Select a range between two nodes which have no relation to each other - * + * * @param startNode * The start node to start the selection from * @param endNode @@ -1396,7 +1396,7 @@ public class VTree extends FocusElementPanel /** * Examines the children of the branch node and returns true if a node is in * that branch - * + * * @param node * The node to search for * @param branch @@ -1424,9 +1424,9 @@ public class VTree extends FocusElementPanel * Selects a range of items which are in direct relation with each * other.<br/> * NOTE: The start node <b>MUST</b> be before the end node! - * + * * @param startNode - * + * * @param endNode */ private void doRelationSelection(TreeNode startNode, TreeNode endNode) { @@ -1456,7 +1456,7 @@ public class VTree extends FocusElementPanel /** * Selects a range of items which have the same parent. - * + * * @param startNode * The start node * @param endNode @@ -1506,7 +1506,7 @@ public class VTree extends FocusElementPanel /** * Returns the first common parent of two nodes - * + * * @param node1 * The first node * @param node2 @@ -1556,7 +1556,7 @@ public class VTree extends FocusElementPanel /** * Sets the node currently in focus - * + * * @param node * The node to focus or null to remove the focus completely * @param scrollIntoView @@ -1579,12 +1579,12 @@ public class VTree extends FocusElementPanel /* * FIXME: This code needs to be changed when the keyboard navigation * doesn't immediately trigger a selection change anymore. - * + * * Right now this function is called before and after the Tree is * rebuilt when up/down arrow keys are pressed. This leads to the * problem, that the newly selected item is announced too often with * a screen reader. - * + * * Behaviour is different when using the Tree with and without * screen reader. */ @@ -1618,7 +1618,7 @@ public class VTree extends FocusElementPanel /** * Focuses a node and scrolls it into view - * + * * @param node * The node to focus */ @@ -1628,7 +1628,7 @@ public class VTree extends FocusElementPanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.FocusHandler#onFocus(com.google.gwt.event * .dom.client.FocusEvent) @@ -1648,7 +1648,7 @@ public class VTree extends FocusElementPanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.BlurHandler#onBlur(com.google.gwt.event * .dom.client.BlurEvent) @@ -1663,7 +1663,7 @@ public class VTree extends FocusElementPanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.KeyPressHandler#onKeyPress(com.google * .gwt.event.dom.client.KeyPressEvent) @@ -1687,7 +1687,7 @@ public class VTree extends FocusElementPanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.KeyDownHandler#onKeyDown(com.google.gwt * .event.dom.client.KeyDownEvent) @@ -1704,7 +1704,7 @@ public class VTree extends FocusElementPanel /** * Handles the keyboard navigation - * + * * @param keycode * The keycode of the pressed key * @param ctrl @@ -1885,7 +1885,7 @@ public class VTree extends FocusElementPanel * be at least one selection. After this the newly focused node is * selected and we've ended up with two selected nodes even though we * only navigated with the arrow keys. - * + * * Because of this, we first select the next node and later de-select * the old one. */ @@ -1897,7 +1897,7 @@ public class VTree extends FocusElementPanel /** * Traverses the tree to the bottom most child - * + * * @param root * The root of the tree * @return The bottom most child @@ -1913,7 +1913,7 @@ public class VTree extends FocusElementPanel /** * Gets the next sibling in the tree - * + * * @param node * The node to get the sibling for * @return The sibling node or null if the node is the last sibling @@ -1937,7 +1937,7 @@ public class VTree extends FocusElementPanel /** * Returns the previous sibling in the tree - * + * * @param node * The node to get the sibling for * @return The sibling node or null if the node is the first sibling @@ -1963,7 +1963,7 @@ public class VTree extends FocusElementPanel * Add this to the element mouse down event by using element.setPropertyJSO * ("onselectstart",applyDisableTextSelectionIEHack()); Remove it then again * when the mouse is depressed in the mouse up event. - * + * * @return Returns the JSO preventing text selection */ private native JavaScriptObject applyDisableTextSelectionIEHack() @@ -1975,7 +1975,7 @@ public class VTree extends FocusElementPanel * Get the key that moves the selection head upwards. By default it is the * up arrow key but by overriding this you can change the key to whatever * you want. - * + * * @return The keycode of the key */ protected int getNavigationUpKey() { @@ -1986,7 +1986,7 @@ public class VTree extends FocusElementPanel * Get the key that moves the selection head downwards. By default it is the * down arrow key but by overriding this you can change the key to whatever * you want. - * + * * @return The keycode of the key */ protected int getNavigationDownKey() { @@ -1997,7 +1997,7 @@ public class VTree extends FocusElementPanel * Get the key that scrolls to the left in the table. By default it is the * left arrow key but by overriding this you can change the key to whatever * you want. - * + * * @return The keycode of the key */ protected int getNavigationLeftKey() { @@ -2008,7 +2008,7 @@ public class VTree extends FocusElementPanel * Get the key that scroll to the right on the table. By default it is the * right arrow key but by overriding this you can change the key to whatever * you want. - * + * * @return The keycode of the key */ protected int getNavigationRightKey() { @@ -2019,7 +2019,7 @@ public class VTree extends FocusElementPanel * Get the key that selects an item in the table. By default it is the space * bar key but by overriding this you can change the key to whatever you * want. - * + * * @return */ protected int getNavigationSelectKey() { @@ -2030,7 +2030,7 @@ public class VTree extends FocusElementPanel * Get the key the moves the selection one page up in the table. By default * this is the Page Up key but by overriding this you can change the key to * whatever you want. - * + * * @return */ protected int getNavigationPageUpKey() { @@ -2041,7 +2041,7 @@ public class VTree extends FocusElementPanel * Get the key the moves the selection one page down in the table. By * default this is the Page Down key but by overriding this you can change * the key to whatever you want. - * + * * @return */ protected int getNavigationPageDownKey() { @@ -2052,7 +2052,7 @@ public class VTree extends FocusElementPanel * Get the key the moves the selection to the beginning of the table. By * default this is the Home key but by overriding this you can change the * key to whatever you want. - * + * * @return */ protected int getNavigationStartKey() { @@ -2063,7 +2063,7 @@ public class VTree extends FocusElementPanel * Get the key the moves the selection to the end of the table. By default * this is the End key but by overriding this you can change the key to * whatever you want. - * + * * @return */ protected int getNavigationEndKey() { @@ -2082,7 +2082,7 @@ public class VTree extends FocusElementPanel /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.SubPartAware#getSubPartElement(java * .lang.String) */ @@ -2136,7 +2136,7 @@ public class VTree extends FocusElementPanel /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.SubPartAware#getSubPartName(com.google * .gwt.user.client.Element) */ diff --git a/client/src/main/java/com/vaadin/client/ui/VTreeTable.java b/client/src/main/java/com/vaadin/client/ui/VTreeTable.java index 2dd912acaa..2538e2707c 100644 --- a/client/src/main/java/com/vaadin/client/ui/VTreeTable.java +++ b/client/src/main/java/com/vaadin/client/ui/VTreeTable.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -580,35 +580,35 @@ public class VTreeTable extends VScrollTable { /** * Animates row expansion using the GWT animation framework. - * + * * The idea is as follows: - * + * * 1. Insert all rows normally - * + * * 2. Insert a newly created DIV containing a new TABLE element below * the DIV containing the actual scroll table body. - * + * * 3. Clone the rows that were inserted in step 1 and attach the clones * to the new TABLE element created in step 2. - * + * * 4. The new DIV from step 2 is absolutely positioned so that the last * inserted row is just behind the row that was expanded. - * + * * 5. Hide the contents of the originally inserted rows by setting the * DIV.v-table-cell-wrapper to display:none;. - * + * * 6. Set the height of the originally inserted rows to 0. - * + * * 7. The animation loop slides the DIV from step 2 downwards, while at * the same pace growing the height of each of the inserted rows from 0 * to full height. The first inserted row grows from 0 to full and after * this the second row grows from 0 to full, etc until all rows are full * height. - * + * * 8. Remove the DIV from step 2 - * + * * 9. Restore display:block; to the DIV.v-table-cell-wrapper elements. - * + * * 10. DONE */ private class RowExpandAnimation extends Animation { diff --git a/client/src/main/java/com/vaadin/client/ui/VTwinColSelect.java b/client/src/main/java/com/vaadin/client/ui/VTwinColSelect.java index e2d06d811b..2ea09f4c4e 100644 --- a/client/src/main/java/com/vaadin/client/ui/VTwinColSelect.java +++ b/client/src/main/java/com/vaadin/client/ui/VTwinColSelect.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -72,7 +72,7 @@ public class VTwinColSelect extends VOptionGroupBase implements KeyDownHandler, /** * A ListBox which catches double clicks - * + * */ public class DoubleClickListBox extends ListBox implements HasDoubleClickHandlers { @@ -439,7 +439,7 @@ public class VTwinColSelect extends VOptionGroupBase implements KeyDownHandler, /** * Get the key that selects an item in the table. By default it is the Enter * key but by overriding this you can change the key to whatever you want. - * + * * @return */ protected int getNavigationSelectKey() { @@ -448,7 +448,7 @@ public class VTwinColSelect extends VOptionGroupBase implements KeyDownHandler, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.KeyDownHandler#onKeyDown(com.google.gwt * .event.dom.client.KeyDownEvent) @@ -512,7 +512,7 @@ public class VTwinColSelect extends VOptionGroupBase implements KeyDownHandler, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.MouseDownHandler#onMouseDown(com.google * .gwt.event.dom.client.MouseDownEvent) @@ -535,7 +535,7 @@ public class VTwinColSelect extends VOptionGroupBase implements KeyDownHandler, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.DoubleClickHandler#onDoubleClick(com. * google.gwt.event.dom.client.DoubleClickEvent) diff --git a/client/src/main/java/com/vaadin/client/ui/VUnknownComponent.java b/client/src/main/java/com/vaadin/client/ui/VUnknownComponent.java index 89907854de..cd1fd57727 100644 --- a/client/src/main/java/com/vaadin/client/ui/VUnknownComponent.java +++ b/client/src/main/java/com/vaadin/client/ui/VUnknownComponent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VUpload.java b/client/src/main/java/com/vaadin/client/ui/VUpload.java index 99d4511b15..18766b32c0 100644 --- a/client/src/main/java/com/vaadin/client/ui/VUpload.java +++ b/client/src/main/java/com/vaadin/client/ui/VUpload.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -44,10 +44,10 @@ import com.vaadin.client.ui.upload.UploadIFrameOnloadStrategy; import com.vaadin.shared.ui.upload.UploadServerRpc; /** - * + * * Note, we are not using GWT FormPanel as we want to listen submitcomplete * events even though the upload component is already detached. - * + * */ public class VUpload extends SimplePanel { @@ -282,7 +282,7 @@ public class VUpload extends SimplePanel { /* * Visit server a moment after upload has started to see possible * changes from UploadStarted event. Will be cleared on complete. - * + * * Must get the id here as the upload can finish before the timer * expires and in that case nextUploadId has been updated and is * wrong. diff --git a/client/src/main/java/com/vaadin/client/ui/VVerticalLayout.java b/client/src/main/java/com/vaadin/client/ui/VVerticalLayout.java index 00ef0fc719..ba01c5330a 100644 --- a/client/src/main/java/com/vaadin/client/ui/VVerticalLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/VVerticalLayout.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/VVideo.java b/client/src/main/java/com/vaadin/client/ui/VVideo.java index 93d0a28a59..e7f86a51f4 100644 --- a/client/src/main/java/com/vaadin/client/ui/VVideo.java +++ b/client/src/main/java/com/vaadin/client/ui/VVideo.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -39,7 +39,7 @@ public class VVideo extends VMediaBase { /** * Registers a listener that updates the dimensions of the widget when the * video metadata has been loaded. - * + * * @param el */ private native void updateDimensionsWhenMetadataLoaded(Element el) @@ -48,12 +48,12 @@ public class VVideo extends VMediaBase { el.addEventListener('loadedmetadata', $entry(function(e) { self.@com.vaadin.client.ui.VVideo::updateElementDynamicSize(II)(el.videoWidth, el.videoHeight); }), false); - + }-*/; /** * Updates the dimensions of the widget. - * + * * @param w * @param h */ diff --git a/client/src/main/java/com/vaadin/client/ui/VWindow.java b/client/src/main/java/com/vaadin/client/ui/VWindow.java index bd89191a35..008ea4ef83 100644 --- a/client/src/main/java/com/vaadin/client/ui/VWindow.java +++ b/client/src/main/java/com/vaadin/client/ui/VWindow.java @@ -73,7 +73,7 @@ import com.vaadin.shared.ui.window.WindowRole; /** * "Sub window" component. - * + * * @author Vaadin Ltd */ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, @@ -237,7 +237,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, /* * Stores the element that has focus in the application UI when the * window is opened, so it can be restored when the window closes. - * + * * This is currently implemented for the case when one non-modal window * can be open at the same time, and the focus is not changed while the * window is open. @@ -271,7 +271,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, /* * Restores the previously stored focused element. - * + * * When the focus was changed outside the window while the window was * open, the originally stored element is restored. */ @@ -313,7 +313,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, /** * Returns true if this window is the topmost VWindow - * + * * @return */ private boolean isActive() { @@ -465,7 +465,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, * is prevented. * <p> * This message is not visible on the screen. - * + * * @param topMessage * String provided when the user navigates with Shift-Tab keys to * the top of the window @@ -480,7 +480,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, * key is prevented. * <p> * This message is not visible on the screen. - * + * * @param bottomMessage * String provided when the user navigates with the Tab key to * the bottom of the window @@ -493,7 +493,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, * Gets the message that is provided to users of assistive devices when the * user reaches the top of the window when leaving a window with the tab key * is prevented. - * + * * @return the top message */ public String getTabStopTopAssistiveText() { @@ -504,7 +504,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, * Gets the message that is provided to users of assistive devices when the * user reaches the bottom of the window when leaving a window with the tab * key is prevented. - * + * * @return the bottom message */ public String getTabStopBottomAssistiveText() { @@ -623,7 +623,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, /** * Sets the closable state of the window. Additionally hides/shows the close * button according to the new state. - * + * * @param closable * true if the window can be closed by the user */ @@ -649,7 +649,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, * Returns the closable state of the sub window. If the sub window is * closable a decoration (typically an X) is shown to the user. By clicking * on the X the user can close the window. - * + * * @return true if the sub window is closable */ protected boolean isClosable() { @@ -681,7 +681,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, * correctly if clicking on the "close" button in the window header but * closing the window from a button for example in the window will fail. * Symptom described in #10776 - * + * * The problematic part is that for the focus to be returned correctly * an input element needs to be focused in the root panel. Focusing some * other element apparently won't work. @@ -919,7 +919,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, /** * Setter for the text for assistive devices the window caption is prefixed * with. - * + * * @param assistivePrefix * the assistivePrefix to set */ @@ -930,7 +930,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, /** * Getter for the text for assistive devices the window caption is prefixed * with. - * + * * @return the assistivePrefix */ public String getAssistivePrefix() { @@ -940,7 +940,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, /** * Setter for the text for assistive devices the window caption is postfixed * with. - * + * * @param assistivePostfix * the assistivePostfix to set */ @@ -951,7 +951,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, /** * Getter for the text for assistive devices the window caption is postfixed * with. - * + * * @return the assistivePostfix */ public String getAssistivePostfix() { @@ -1116,14 +1116,14 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, /** * TODO check if we need to support this with touch based devices. - * + * * Checks if the cursor was inside the browser content area when the event * happened. - * + * * @param event * The event to be checked * @return true, if the cursor is inside the browser content area - * + * * false, otherwise */ private boolean cursorInsideBrowserContentArea(Event event) { @@ -1417,7 +1417,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, * assistive devices when it is opened. * <p> * When the provided array is empty, an existing description is removed. - * + * * @param connectors * with the connectors of the widgets to use as description */ @@ -1455,7 +1455,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, * Gets the connectors that are used as assistive description. Text * contained in these connectors will be read by assistive devices when the * window is opened. - * + * * @return list of previously set connectors */ public List<Connector> getAssistiveDescription() { @@ -1464,14 +1464,14 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, /** * Sets the WAI-ARIA role the window. - * + * * This role defines how an assistive device handles a window. Available * roles are alertdialog and dialog (@see * <a href="http://www.w3.org/TR/2011/CR-wai-aria-20110118/roles">Roles * Model</a>). - * + * * The default role is dialog. - * + * * @param role * WAI-ARIA role to set for the window */ @@ -1490,7 +1490,7 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, * The value of the parameter doTabStop is stored and used for non-modal * windows. For modal windows, the handlers are always registered, while * preserving the stored value. - * + * * @param doTabStop * true to prevent leaving the window, false to allow leaving the * window for non modal windows @@ -1507,9 +1507,9 @@ public class VWindow extends VOverlay implements ShortcutActionHandlerOwner, /** * Adds a Handler for when user moves the window. - * + * * @since 7.1.9 - * + * * @return {@link HandlerRegistration} used to remove the handler */ public HandlerRegistration addMoveHandler(WindowMoveHandler handler) { diff --git a/client/src/main/java/com/vaadin/client/ui/absolutelayout/AbsoluteLayoutConnector.java b/client/src/main/java/com/vaadin/client/ui/absolutelayout/AbsoluteLayoutConnector.java index f3d1706e4c..477d59289e 100644 --- a/client/src/main/java/com/vaadin/client/ui/absolutelayout/AbsoluteLayoutConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/absolutelayout/AbsoluteLayoutConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -77,7 +77,7 @@ public class AbsoluteLayoutConnector extends AbstractComponentContainerConnector /** * Returns the deepest nested child component which contains "element". The * child component is also returned if "element" is part of its caption. - * + * * @param element * An element that is a nested sub element of the root element in * this layout @@ -96,13 +96,13 @@ public class AbsoluteLayoutConnector extends AbstractComponentContainerConnector /** * Returns the deepest nested child component which contains "element". The * child component is also returned if "element" is part of its caption. - * + * * @param element * An element that is a nested sub element of the root element in * this layout * @return The Paintable which the element is a part of. Null if the element * belongs to the layout and not to a child. - * + * * @since 7.2 */ protected ComponentConnector getConnectorForElement(Element element) { @@ -111,7 +111,7 @@ public class AbsoluteLayoutConnector extends AbstractComponentContainerConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.HasComponentsConnector#updateCaption(com.vaadin * .client.ComponentConnector) */ @@ -135,7 +135,7 @@ public class AbsoluteLayoutConnector extends AbstractComponentContainerConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.AbstractComponentConnector#getWidget() */ @Override @@ -145,7 +145,7 @@ public class AbsoluteLayoutConnector extends AbstractComponentContainerConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.AbstractComponentConnector#getState() */ @Override @@ -155,7 +155,7 @@ public class AbsoluteLayoutConnector extends AbstractComponentContainerConnector /* * (non-Javadoc) - * + * * @see * com.vaadin.client.ui.AbstractComponentConnector#onStateChanged(com.vaadin * .client.communication.StateChangeEvent) @@ -196,7 +196,7 @@ public class AbsoluteLayoutConnector extends AbstractComponentContainerConnector * Adds default value of 0.0px for the given property if it's missing from * the position string altogether. If the property value is already set no * changes are needed. - * + * * @param position * original position styles * @param property @@ -214,7 +214,7 @@ public class AbsoluteLayoutConnector extends AbstractComponentContainerConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.AbstractComponentContainerConnector# * onConnectorHierarchyChange * (com.vaadin.client.ConnectorHierarchyChangeEvent) @@ -241,7 +241,7 @@ public class AbsoluteLayoutConnector extends AbstractComponentContainerConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.DirectionalManagedLayout#layoutVertically() */ @Override @@ -257,7 +257,7 @@ public class AbsoluteLayoutConnector extends AbstractComponentContainerConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.DirectionalManagedLayout#layoutHorizontally() */ @Override diff --git a/client/src/main/java/com/vaadin/client/ui/accordion/AccordionConnector.java b/client/src/main/java/com/vaadin/client/ui/accordion/AccordionConnector.java index 6e74443863..8e12af213c 100644 --- a/client/src/main/java/com/vaadin/client/ui/accordion/AccordionConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/accordion/AccordionConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -126,7 +126,7 @@ public class AccordionConnector extends TabsheetBaseConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ConnectorHierarchyChangeEvent. * ConnectorHierarchyChangeHandler * #onConnectorHierarchyChange(com.vaadin.client diff --git a/client/src/main/java/com/vaadin/client/ui/aria/AriaHelper.java b/client/src/main/java/com/vaadin/client/ui/aria/AriaHelper.java index 368b1b51ef..7b8c248130 100644 --- a/client/src/main/java/com/vaadin/client/ui/aria/AriaHelper.java +++ b/client/src/main/java/com/vaadin/client/ui/aria/AriaHelper.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -32,7 +32,7 @@ public class AriaHelper { /** * Binds a caption (label in HTML speak) to the form element as required by * WAI-ARIA specification. - * + * * @param widget * Widget, that should be bound to the caption * @param captionElements @@ -66,7 +66,7 @@ public class AriaHelper { /** * Removes a binding to a caption added with bindCaption() from the provided * Widget. - * + * * @param widget * Widget, that was bound to a caption before */ @@ -78,7 +78,7 @@ public class AriaHelper { /** * Handles the required actions depending of the input Widget being required * or not. - * + * * @param widget * Widget, typically an input Widget like TextField * @param required @@ -97,7 +97,7 @@ public class AriaHelper { /** * Handles the required actions depending of the input element being * required or not. - * + * * @param element * Element, typically from an input Widget like TextField * @param required @@ -114,7 +114,7 @@ public class AriaHelper { /** * Handles the required actions depending of the input Widget contains * unaccepted input. - * + * * @param widget * Widget, typically an input Widget like TextField * @param invalid @@ -133,7 +133,7 @@ public class AriaHelper { /** * Handles the required actions depending of the input element contains * unaccepted input. - * + * * @param element * Element, typically an input Widget like TextField * @param invalid @@ -151,7 +151,7 @@ public class AriaHelper { /** * Makes sure that the provided element has an id attribute. Adds a new * unique id if not. - * + * * @param element * Element to check * @return String with the id of the element @@ -169,10 +169,10 @@ public class AriaHelper { /** * Allows to move an element out of the visible area of the browser window. - * + * * This makes it possible to have additional information for an assistive * device, that is not in the way for visual users. - * + * * @param element * Element to move out of sight * @param boolean diff --git a/client/src/main/java/com/vaadin/client/ui/aria/HandlesAriaCaption.java b/client/src/main/java/com/vaadin/client/ui/aria/HandlesAriaCaption.java index 369edb7d69..4f704b8c09 100644 --- a/client/src/main/java/com/vaadin/client/ui/aria/HandlesAriaCaption.java +++ b/client/src/main/java/com/vaadin/client/ui/aria/HandlesAriaCaption.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -26,10 +26,10 @@ public interface HandlesAriaCaption { /** * Called to bind the provided caption (label in HTML speak) element to the * main input element of the Widget. - * + * * Binding should be removed from the main input field when captionElement * is null. - * + * * @param captionElement * Element of the caption */ diff --git a/client/src/main/java/com/vaadin/client/ui/aria/HandlesAriaInvalid.java b/client/src/main/java/com/vaadin/client/ui/aria/HandlesAriaInvalid.java index 296e455dcd..3866c68e5e 100644 --- a/client/src/main/java/com/vaadin/client/ui/aria/HandlesAriaInvalid.java +++ b/client/src/main/java/com/vaadin/client/ui/aria/HandlesAriaInvalid.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,7 +24,7 @@ package com.vaadin.client.ui.aria; public interface HandlesAriaInvalid { /** * Called to set the element, typically an input element, as invalid. - * + * * @param invalid * boolean, true when the element should be marked invalid, false * otherwise diff --git a/client/src/main/java/com/vaadin/client/ui/aria/HandlesAriaRequired.java b/client/src/main/java/com/vaadin/client/ui/aria/HandlesAriaRequired.java index 95ebd7fb9a..da04d9974a 100644 --- a/client/src/main/java/com/vaadin/client/ui/aria/HandlesAriaRequired.java +++ b/client/src/main/java/com/vaadin/client/ui/aria/HandlesAriaRequired.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,7 +24,7 @@ package com.vaadin.client.ui.aria; public interface HandlesAriaRequired { /** * Called to set the element, typically an input element, as required. - * + * * @param required * boolean true when the element needs to be set as required */ diff --git a/client/src/main/java/com/vaadin/client/ui/audio/AudioConnector.java b/client/src/main/java/com/vaadin/client/ui/audio/AudioConnector.java index a451d117f2..108a57eca5 100644 --- a/client/src/main/java/com/vaadin/client/ui/audio/AudioConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/audio/AudioConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/browserframe/BrowserFrameConnector.java b/client/src/main/java/com/vaadin/client/ui/browserframe/BrowserFrameConnector.java index 95d64b61d0..998d822428 100644 --- a/client/src/main/java/com/vaadin/client/ui/browserframe/BrowserFrameConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/browserframe/BrowserFrameConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/button/ButtonConnector.java b/client/src/main/java/com/vaadin/client/ui/button/ButtonConnector.java index 1b5fd9e509..0bd403edff 100644 --- a/client/src/main/java/com/vaadin/client/ui/button/ButtonConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/button/ButtonConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/CalendarConnector.java b/client/src/main/java/com/vaadin/client/ui/calendar/CalendarConnector.java index 753a47265a..04c6943edc 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/CalendarConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/CalendarConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -77,7 +77,7 @@ import com.vaadin.ui.Calendar; /** * Handles communication between Calendar on the server side and * {@link VCalendar} on the client side. - * + * * @since 7.1 * @author Vaadin Ltd. */ @@ -94,7 +94,7 @@ public class CalendarConnector extends AbstractComponentConnector private static final String DROPHANDLER_ACCEPT_CRITERIA_PAINT_TAG = "-ac"; /** - * + * */ public CalendarConnector() { @@ -378,7 +378,7 @@ public class CalendarConnector extends AbstractComponentConnector /* * (non-Javadoc) - * + * * @see com.vaadin.terminal.gwt.client.Paintable#updateFromUIDL(com.vaadin. * terminal .gwt.client.UIDL, * com.vaadin.terminal.gwt.client.ApplicationConnection) @@ -556,7 +556,7 @@ public class CalendarConnector extends AbstractComponentConnector /** * Get the original action ID that was passed in from the shared state - * + * * @since 7.1.2 * @param actionKey * the unique action key @@ -568,7 +568,7 @@ public class CalendarConnector extends AbstractComponentConnector /** * Get the text that is displayed for a context menu item - * + * * @param actionKey * The unique action key * @return @@ -579,7 +579,7 @@ public class CalendarConnector extends AbstractComponentConnector /** * Get the icon url for a context menu item - * + * * @param actionKey * The unique action key * @return @@ -590,7 +590,7 @@ public class CalendarConnector extends AbstractComponentConnector /** * Get the start date for an action item - * + * * @param actionKey * The unique action key * @return @@ -605,7 +605,7 @@ public class CalendarConnector extends AbstractComponentConnector /** * Get the end date for an action item - * + * * @param actionKey * The unique action key * @return @@ -645,7 +645,7 @@ public class CalendarConnector extends AbstractComponentConnector /* * (non-Javadoc) - * + * * @see com.vaadin.terminal.gwt.client.ui.ActionOwner#getPaintableId() */ @Override diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/VCalendarAction.java b/client/src/main/java/com/vaadin/client/ui/calendar/VCalendarAction.java index 470ee3cf1a..70ecce18b6 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/VCalendarAction.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/VCalendarAction.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -25,7 +25,7 @@ import com.vaadin.shared.ui.calendar.DateConstants; /** * Action performed by the calendar - * + * * @since 7.1 * @author Vaadin Ltd. */ @@ -45,7 +45,7 @@ public class VCalendarAction extends Action { .getFormat(DateConstants.ACTION_DATE_FORMAT_PATTERN); /** - * + * * @param owner */ public VCalendarAction(CalendarConnector owner) { @@ -54,7 +54,7 @@ public class VCalendarAction extends Action { /** * Constructor - * + * * @param owner * The owner who trigger this kinds of events * @param rpc @@ -71,7 +71,7 @@ public class VCalendarAction extends Action { /* * (non-Javadoc) - * + * * @see com.vaadin.terminal.gwt.client.ui.Action#execute() */ @Override @@ -91,7 +91,7 @@ public class VCalendarAction extends Action { /** * Get the date and time when the action starts - * + * * @return */ public Date getActionStartDate() { @@ -100,7 +100,7 @@ public class VCalendarAction extends Action { /** * Set the date when the actions start - * + * * @param actionStartDate * The date and time when the action starts */ @@ -110,7 +110,7 @@ public class VCalendarAction extends Action { /** * Get the date and time when the action ends - * + * * @return */ public Date getActionEndDate() { @@ -119,7 +119,7 @@ public class VCalendarAction extends Action { /** * Set the date and time when the action ends - * + * * @param actionEndDate * The date and time when the action ends */ diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/CalendarDay.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/CalendarDay.java index 0fceb6b6f9..7b25abdb38 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/CalendarDay.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/CalendarDay.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -18,7 +18,7 @@ package com.vaadin.client.ui.calendar.schedule; /** * Utility class used to represent a day when updating views. Only used * internally. - * + * * @since 7.1 * @author Vaadin Ltd. */ diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/CalendarEvent.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/CalendarEvent.java index 687dcd2b52..21088e92e6 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/CalendarEvent.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/CalendarEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -22,7 +22,7 @@ import com.vaadin.shared.ui.calendar.DateConstants; /** * A client side implementation of a calendar event - * + * * @since 7.1 * @author Vaadin Ltd. */ @@ -88,7 +88,7 @@ public class CalendarEvent { /** * Returns the start time of the event - * + * * @return Time embedded in the {@link Date} object */ public Date getStartTime() { @@ -97,7 +97,7 @@ public class CalendarEvent { /** * Set the start time of the event - * + * * @param startTime * The time of the event. Use the time fields in the {@link Date} * object @@ -108,7 +108,7 @@ public class CalendarEvent { /** * Get the end time of the event - * + * * @return Time embedded in the {@link Date} object */ public Date getEndTime() { @@ -117,7 +117,7 @@ public class CalendarEvent { /** * Set the end time of the event - * + * * @param endTime * Time embedded in the {@link Date} object */ @@ -127,7 +127,7 @@ public class CalendarEvent { /** * Get the (server side) index of the event - * + * * @return */ public int getIndex() { @@ -136,7 +136,7 @@ public class CalendarEvent { /** * Get the index of the slot where the event in rendered - * + * * @return */ public int getSlotIndex() { @@ -145,7 +145,7 @@ public class CalendarEvent { /** * Set the index of the slot where the event in rendered - * + * * @param index * The index of the slot */ @@ -155,7 +155,7 @@ public class CalendarEvent { /** * Set the (server side) index of the event - * + * * @param index * The index */ @@ -166,7 +166,7 @@ public class CalendarEvent { /** * Get the caption of the event. The caption is the text displayed in the * calendar on the event. - * + * * @return */ public String getCaption() { @@ -176,7 +176,7 @@ public class CalendarEvent { /** * Set the caption of the event. The caption is the text displayed in the * calendar on the event. - * + * * @param caption * The visible caption of the event */ @@ -187,7 +187,7 @@ public class CalendarEvent { /** * Get the description of the event. The description is the text displayed * when hoovering over the event with the mouse - * + * * @return */ public String getDescription() { @@ -197,7 +197,7 @@ public class CalendarEvent { /** * Set the description of the event. The description is the text displayed * when hoovering over the event with the mouse - * + * * @param description */ public void setDescription(String description) { @@ -206,7 +206,7 @@ public class CalendarEvent { /** * Does the event use the 24h time format - * + * * @param format24h * True if it uses the 24h format, false if it uses the 12h time * format @@ -217,7 +217,7 @@ public class CalendarEvent { /** * Is the event an all day event. - * + * * @param allDay * True if the event should be rendered all day */ @@ -227,7 +227,7 @@ public class CalendarEvent { /** * Is the event an all day event. - * + * * @return */ public boolean isAllDay() { @@ -236,7 +236,7 @@ public class CalendarEvent { /** * Get the time as a formatted string - * + * * @return */ public String getTimeAsText() { @@ -249,7 +249,7 @@ public class CalendarEvent { /** * Get the amount of milliseconds between the start and end of the event - * + * * @return */ public long getRangeInMilliseconds() { @@ -258,7 +258,7 @@ public class CalendarEvent { /** * Get the amount of minutes between the start and end of the event - * + * * @return */ public long getRangeInMinutes() { @@ -268,7 +268,7 @@ public class CalendarEvent { /** * Get the amount of minutes for the event on a specific day. This is useful * if the event spans several days. - * + * * @param targetDay * The date to check * @return @@ -297,7 +297,7 @@ public class CalendarEvent { /** * Does the event span several days - * + * * @return */ @SuppressWarnings("deprecation") diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCell.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCell.java index ef200ef095..83017713d9 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCell.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCell.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -441,7 +441,7 @@ public class DateCell extends FocusableComplexPanel implements MouseDownHandler, /** * Returns all overlapping DayEvent indexes in the Group. Including the * target. - * + * * @param targetIndex * Index of DayEvent in the current DateCell widget. * @return Group that contains all Overlapping DayEvent indexes @@ -561,10 +561,10 @@ public class DateCell extends FocusableComplexPanel implements MouseDownHandler, } /** - * + * * @param event * @return - * + * * This method is not necessary in the long run.. Or here can be * various types of implementations.. */ diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCellContainer.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCellContainer.java index 4ba22f61f8..82cd26dd3c 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCellContainer.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCellContainer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -28,7 +28,7 @@ import com.vaadin.client.ui.VCalendar; /** * Internally used class by the Calendar - * + * * since 7.1 */ public class DateCellContainer extends FlowPanel diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCellDayEvent.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCellDayEvent.java index 173506497c..7d938e42be 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCellDayEvent.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCellDayEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -46,7 +46,7 @@ import com.vaadin.shared.ui.calendar.DateConstants; /** * Internally used by the calendar - * + * * @since 7.1 */ public class DateCellDayEvent extends FocusableHTML @@ -549,7 +549,7 @@ public class DateCellDayEvent extends FocusableHTML /** * Check if the given time range is too small for events - * + * * @param start * @param end * @return @@ -567,7 +567,7 @@ public class DateCellDayEvent extends FocusableHTML /** * Build the string for sending resize events to server - * + * * @param event * @return */ diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCellGroup.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCellGroup.java index f4ef22f4ca..12fb07ea81 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCellGroup.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateCellGroup.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import java.util.List; /** * Internally used by the calendar - * + * * @since 7.1 */ public class DateCellGroup { diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateUtil.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateUtil.java index 165bbefefc..2e7952ae18 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateUtil.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DateUtil.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -22,7 +22,7 @@ import com.vaadin.shared.ui.calendar.DateConstants; /** * Utility class for {@link Date} operations - * + * * @since 7.1 * @author Vaadin Ltd. */ @@ -30,7 +30,7 @@ public class DateUtil { /** * Checks if dates are same day without checking datetimes. - * + * * @param date1 * @param date2 * @return @@ -48,7 +48,7 @@ public class DateUtil { /** * @param date * the date to format - * + * * @return given Date as String, for communicating to server-side */ public static String formatClientSideDate(Date date) { diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DayToolbar.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DayToolbar.java index 523410262d..24ad02d132 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DayToolbar.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/DayToolbar.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -27,10 +27,10 @@ import com.google.gwt.user.client.ui.Widget; import com.vaadin.client.ui.VCalendar; /** - * + * * @since 7.1 * @author Vaadin Ltd. - * + * */ public class DayToolbar extends HorizontalPanel implements ClickHandler { private int width = 0; diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/FocusableComplexPanel.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/FocusableComplexPanel.java index 6c629e01a4..3a632bcc7f 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/FocusableComplexPanel.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/FocusableComplexPanel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -34,10 +34,10 @@ import com.vaadin.client.Focusable; /** * A ComplexPanel that can be focused - * + * * @since 7.1 * @author Vaadin Ltd. - * + * */ public class FocusableComplexPanel extends ComplexPanel implements HasFocusHandlers, HasBlurHandlers, HasKeyDownHandlers, @@ -51,7 +51,7 @@ public class FocusableComplexPanel extends ComplexPanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasFocusHandlers#addFocusHandler(com. * google.gwt.event.dom.client.FocusHandler) @@ -63,7 +63,7 @@ public class FocusableComplexPanel extends ComplexPanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasBlurHandlers#addBlurHandler(com.google * .gwt.event.dom.client.BlurHandler) @@ -75,7 +75,7 @@ public class FocusableComplexPanel extends ComplexPanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasKeyDownHandlers#addKeyDownHandler( * com.google.gwt.event.dom.client.KeyDownHandler) @@ -87,7 +87,7 @@ public class FocusableComplexPanel extends ComplexPanel /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasKeyPressHandlers#addKeyPressHandler * (com.google.gwt.event.dom.client.KeyPressHandler) @@ -99,7 +99,7 @@ public class FocusableComplexPanel extends ComplexPanel /** * Sets/Removes the keyboard focus to the panel. - * + * * @param focus * If set to true then the focus is moved to the panel, if set to * false the focus is removed diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/FocusableGrid.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/FocusableGrid.java index 1369392656..e022c41a8b 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/FocusableGrid.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/FocusableGrid.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -34,10 +34,10 @@ import com.vaadin.client.Focusable; /** * A Grid that can be focused - * + * * @since 7.1 * @author Vaadin Ltd. - * + * */ public class FocusableGrid extends Grid implements HasFocusHandlers, HasBlurHandlers, HasKeyDownHandlers, HasKeyPressHandlers, Focusable { @@ -63,7 +63,7 @@ public class FocusableGrid extends Grid implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasFocusHandlers#addFocusHandler(com. * google.gwt.event.dom.client.FocusHandler) @@ -75,7 +75,7 @@ public class FocusableGrid extends Grid implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasBlurHandlers#addBlurHandler(com.google * .gwt.event.dom.client.BlurHandler) @@ -87,7 +87,7 @@ public class FocusableGrid extends Grid implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasKeyDownHandlers#addKeyDownHandler( * com.google.gwt.event.dom.client.KeyDownHandler) @@ -99,7 +99,7 @@ public class FocusableGrid extends Grid implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasKeyPressHandlers#addKeyPressHandler * (com.google.gwt.event.dom.client.KeyPressHandler) @@ -111,7 +111,7 @@ public class FocusableGrid extends Grid implements HasFocusHandlers, /** * Sets/Removes the keyboard focus to the panel. - * + * * @param focus * If set to true then the focus is moved to the panel, if set to * false the focus is removed diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/FocusableHTML.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/FocusableHTML.java index 0c6ddb3697..8ca7e83ffe 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/FocusableHTML.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/FocusableHTML.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -34,10 +34,10 @@ import com.vaadin.client.Focusable; /** * A HTML widget that can be focused - * + * * @since 7.1 * @author Vaadin Ltd. - * + * */ public class FocusableHTML extends HTML implements HasFocusHandlers, HasBlurHandlers, HasKeyDownHandlers, HasKeyPressHandlers, Focusable { @@ -53,7 +53,7 @@ public class FocusableHTML extends HTML implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasFocusHandlers#addFocusHandler(com. * google.gwt.event.dom.client.FocusHandler) @@ -65,7 +65,7 @@ public class FocusableHTML extends HTML implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasBlurHandlers#addBlurHandler(com.google * .gwt.event.dom.client.BlurHandler) @@ -77,7 +77,7 @@ public class FocusableHTML extends HTML implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasKeyDownHandlers#addKeyDownHandler( * com.google.gwt.event.dom.client.KeyDownHandler) @@ -89,7 +89,7 @@ public class FocusableHTML extends HTML implements HasFocusHandlers, /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.dom.client.HasKeyPressHandlers#addKeyPressHandler * (com.google.gwt.event.dom.client.KeyPressHandler) @@ -101,7 +101,7 @@ public class FocusableHTML extends HTML implements HasFocusHandlers, /** * Sets/Removes the keyboard focus to the panel. - * + * * @param focus * If set to true then the focus is moved to the panel, if set to * false the focus is removed diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/HasTooltipKey.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/HasTooltipKey.java index d04ec39527..29fc825d90 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/HasTooltipKey.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/HasTooltipKey.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -17,16 +17,16 @@ package com.vaadin.client.ui.calendar.schedule; /** * For Calendar client-side internal use only. - * + * * @since 7.1 * @author Vaadin Ltd. - * + * */ public interface HasTooltipKey { /** * Gets the key associated for the Widget implementing this interface. This * key is used for getting a tooltip title identified by the key - * + * * @return the tooltip key */ Object getTooltipKey(); diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/MonthEventLabel.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/MonthEventLabel.java index 31e600c8f9..8ee9183192 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/MonthEventLabel.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/MonthEventLabel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -25,7 +25,7 @@ import com.vaadin.client.ui.VCalendar; /** * The label in a month cell - * + * * @since 7.1 */ public class MonthEventLabel extends HTML implements HasTooltipKey { @@ -63,7 +63,7 @@ public class MonthEventLabel extends HTML implements HasTooltipKey { /** * Set the time of the event label - * + * * @param date * The date object that specifies the time */ @@ -74,7 +74,7 @@ public class MonthEventLabel extends HTML implements HasTooltipKey { /** * Set the caption of the event label - * + * * @param caption * The caption string, can be HTML if * {@link VCalendar#isEventCaptionAsHtml()} is true @@ -113,7 +113,7 @@ public class MonthEventLabel extends HTML implements HasTooltipKey { /** * Set the (server side) index of the event - * + * * @param index * The integer index */ @@ -123,7 +123,7 @@ public class MonthEventLabel extends HTML implements HasTooltipKey { /** * Set the Calendar instance this label belongs to - * + * * @param calendar * The calendar instance */ @@ -133,7 +133,7 @@ public class MonthEventLabel extends HTML implements HasTooltipKey { /** * Is the event bound to a specific time - * + * * @return */ public boolean isTimeSpecificEvent() { @@ -142,7 +142,7 @@ public class MonthEventLabel extends HTML implements HasTooltipKey { /** * Is the event bound to a specific time - * + * * @param timeSpecificEvent * True if the event is bound to a time, false if it is only * bound to the day @@ -153,7 +153,7 @@ public class MonthEventLabel extends HTML implements HasTooltipKey { /* * (non-Javadoc) - * + * * @see com.google.gwt.user.client.ui.HTML#setHTML(java.lang.String) */ @Override diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/MonthGrid.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/MonthGrid.java index 52a81d0eb9..4bd03d5dc9 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/MonthGrid.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/MonthGrid.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,10 +24,10 @@ import com.google.gwt.event.shared.HandlerRegistration; import com.vaadin.client.ui.VCalendar; /** - * + * * @since 7.1 * @author Vaadin Ltd. - * + * */ public class MonthGrid extends FocusableGrid implements KeyDownHandler { diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/SimpleDayCell.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/SimpleDayCell.java index 0c3fd30059..0ec26cda58 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/SimpleDayCell.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/SimpleDayCell.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -43,7 +43,7 @@ import com.vaadin.shared.ui.calendar.DateConstants; /** * A class representing a single cell within the calendar in month-view - * + * * @since 7.1 * @author Vaadin Ltd. */ diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/SimpleDayToolbar.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/SimpleDayToolbar.java index 3133341542..234dc4fbc2 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/SimpleDayToolbar.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/SimpleDayToolbar.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,10 +20,10 @@ import com.google.gwt.user.client.ui.Label; import com.google.gwt.user.client.ui.Widget; /** - * + * * @since 7.1.0 * @author Vaadin Ltd. - * + * */ public class SimpleDayToolbar extends HorizontalPanel { private int width = 0; diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/SimpleWeekToolbar.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/SimpleWeekToolbar.java index e4b1740513..ed1807603a 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/SimpleWeekToolbar.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/SimpleWeekToolbar.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,10 +21,10 @@ import com.google.gwt.user.client.ui.FlexTable; import com.vaadin.client.ui.VCalendar; /** - * + * * @since 7.1 * @author Vaadin Ltd. - * + * */ public class SimpleWeekToolbar extends FlexTable implements ClickHandler { private int height; diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeekGrid.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeekGrid.java index ceab62c35e..10fb77df92 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeekGrid.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeekGrid.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -36,10 +36,10 @@ import com.vaadin.client.ui.VCalendar; import com.vaadin.shared.ui.calendar.DateConstants; /** - * + * * @since 7.1 * @author Vaadin Ltd. - * + * */ public class WeekGrid extends SimplePanel { @@ -494,7 +494,7 @@ public class WeekGrid extends SimplePanel { /** * Get width of the single date cell - * + * * @return Date cell width */ public int getDateCellWidth() { diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeekGridMinuteTimeRange.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeekGridMinuteTimeRange.java index 07bcc1e887..fbd616e5f3 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeekGridMinuteTimeRange.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeekGridMinuteTimeRange.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import java.util.Date; /** * Internally used by the calendar - * + * * @since 7.1 */ public class WeekGridMinuteTimeRange { @@ -29,7 +29,7 @@ public class WeekGridMinuteTimeRange { /** * Creates a Date time range between start and end date. Drops seconds from * the range. - * + * * @param start * Start time of the range * @param end diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeekLabel.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeekLabel.java index bb0cf5d1ea..1a4b0d3bf7 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeekLabel.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeekLabel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.google.gwt.user.client.ui.Label; /** * A label in the {@link SimpleWeekToolbar} - * + * * @since 7.1 */ public class WeekLabel extends Label { diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeeklyLongEvents.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeeklyLongEvents.java index 6b9bdf64d0..8299f28ea0 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeeklyLongEvents.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeeklyLongEvents.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -22,10 +22,10 @@ import com.google.gwt.user.client.ui.HorizontalPanel; import com.vaadin.client.ui.VCalendar; /** - * + * * @since 7.1 * @author Vaadin Ltd. - * + * */ public class WeeklyLongEvents extends HorizontalPanel implements HasTooltipKey { diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeeklyLongEventsDateCell.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeeklyLongEventsDateCell.java index 7d3dc9b89a..a097ab2a6a 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeeklyLongEventsDateCell.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/WeeklyLongEventsDateCell.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -22,7 +22,7 @@ import com.vaadin.client.ui.VCalendar; /** * Represents a cell used in {@link WeeklyLongEvents} - * + * * @since 7.1 */ public class WeeklyLongEventsDateCell extends HTML implements HasTooltipKey { diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/dd/CalendarDropHandler.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/dd/CalendarDropHandler.java index ce892c1867..821370bbce 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/dd/CalendarDropHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/dd/CalendarDropHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,10 +21,10 @@ import com.vaadin.client.ui.dd.VAbstractDropHandler; /** * Abstract base class for calendar drop handlers. - * + * * @since 7.1 * @author Vaadin Ltd. - * + * */ public abstract class CalendarDropHandler extends VAbstractDropHandler { @@ -32,7 +32,7 @@ public abstract class CalendarDropHandler extends VAbstractDropHandler { /** * Constructor - * + * * @param connector * The connector of the calendar */ @@ -42,7 +42,7 @@ public abstract class CalendarDropHandler extends VAbstractDropHandler { /* * (non-Javadoc) - * + * * @see * com.vaadin.terminal.gwt.client.ui.dd.VAbstractDropHandler#getConnector() */ @@ -53,7 +53,7 @@ public abstract class CalendarDropHandler extends VAbstractDropHandler { /* * (non-Javadoc) - * + * * @see com.vaadin.terminal.gwt.client.ui.dd.VDropHandler# * getApplicationConnection () */ diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/dd/CalendarMonthDropHandler.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/dd/CalendarMonthDropHandler.java index 39e08e9d70..26491d3d01 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/dd/CalendarMonthDropHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/dd/CalendarMonthDropHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -27,7 +27,7 @@ import com.vaadin.client.ui.dd.VDragEvent; * Handles DD when the monthly view is showing in the Calendar. In the monthly * view, drops are only allowed in the the day cells. Only the day index is * included in the drop details sent to the server. - * + * * @since 7.1 * @author Vaadin Ltd. */ @@ -42,7 +42,7 @@ public class CalendarMonthDropHandler extends CalendarDropHandler { /* * (non-Javadoc) - * + * * @see * com.vaadin.terminal.gwt.client.ui.dd.VAbstractDropHandler#dragAccepted * (com.vaadin.terminal.gwt.client.ui.dd.VDragEvent) @@ -77,7 +77,7 @@ public class CalendarMonthDropHandler extends CalendarDropHandler { /* * (non-Javadoc) - * + * * @see * com.vaadin.terminal.gwt.client.ui.dd.VAbstractDropHandler#dragOver(com * .vaadin.terminal.gwt.client.ui.dd.VDragEvent) @@ -96,7 +96,7 @@ public class CalendarMonthDropHandler extends CalendarDropHandler { /** * Checks if the one can perform a drop in a element - * + * * @param elementOver * The element to check * @return @@ -113,7 +113,7 @@ public class CalendarMonthDropHandler extends CalendarDropHandler { /* * (non-Javadoc) - * + * * @see * com.vaadin.terminal.gwt.client.ui.dd.VAbstractDropHandler#dragEnter(com * .vaadin.terminal.gwt.client.ui.dd.VDragEvent) @@ -125,7 +125,7 @@ public class CalendarMonthDropHandler extends CalendarDropHandler { /* * (non-Javadoc) - * + * * @see * com.vaadin.terminal.gwt.client.ui.dd.VAbstractDropHandler#drop(com.vaadin * .terminal.gwt.client.ui.dd.VDragEvent) @@ -145,7 +145,7 @@ public class CalendarMonthDropHandler extends CalendarDropHandler { /** * Updates the drop details sent to the server - * + * * @param drag * The drag event */ @@ -158,7 +158,7 @@ public class CalendarMonthDropHandler extends CalendarDropHandler { /* * (non-Javadoc) - * + * * @see * com.vaadin.terminal.gwt.client.ui.dd.VAbstractDropHandler#dragLeave(com * .vaadin.terminal.gwt.client.ui.dd.VDragEvent) diff --git a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/dd/CalendarWeekDropHandler.java b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/dd/CalendarWeekDropHandler.java index 6af67de15c..9032321118 100644 --- a/client/src/main/java/com/vaadin/client/ui/calendar/schedule/dd/CalendarWeekDropHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/calendar/schedule/dd/CalendarWeekDropHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -28,7 +28,7 @@ import com.vaadin.client.ui.dd.VDragEvent; * Handles DD when the weekly view is showing in the Calendar. In the weekly * view, drops are only allowed in the the time slots for each day. The slot * index and the day index are included in the drop details sent to the server. - * + * * @since 7.1 * @author Vaadin Ltd. */ @@ -43,7 +43,7 @@ public class CalendarWeekDropHandler extends CalendarDropHandler { /* * (non-Javadoc) - * + * * @see * com.vaadin.terminal.gwt.client.ui.dd.VAbstractDropHandler#dragAccepted * (com.vaadin.terminal.gwt.client.ui.dd.VDragEvent) @@ -76,7 +76,7 @@ public class CalendarWeekDropHandler extends CalendarDropHandler { /* * (non-Javadoc) - * + * * @see * com.vaadin.terminal.gwt.client.ui.dd.VAbstractDropHandler#dragOver(com * .vaadin.terminal.gwt.client.ui.dd.VDragEvent) @@ -95,7 +95,7 @@ public class CalendarWeekDropHandler extends CalendarDropHandler { /** * Checks if the location is a valid drop location - * + * * @param elementOver * The element to check * @return @@ -127,7 +127,7 @@ public class CalendarWeekDropHandler extends CalendarDropHandler { /* * (non-Javadoc) - * + * * @see * com.vaadin.terminal.gwt.client.ui.dd.VAbstractDropHandler#dragEnter(com * .vaadin.terminal.gwt.client.ui.dd.VDragEvent) @@ -139,7 +139,7 @@ public class CalendarWeekDropHandler extends CalendarDropHandler { /* * (non-Javadoc) - * + * * @see * com.vaadin.terminal.gwt.client.ui.dd.VAbstractDropHandler#drop(com.vaadin * .terminal.gwt.client.ui.dd.VDragEvent) @@ -159,7 +159,7 @@ public class CalendarWeekDropHandler extends CalendarDropHandler { /** * Update the drop details sent to the server - * + * * @param drag * The drag event */ @@ -174,7 +174,7 @@ public class CalendarWeekDropHandler extends CalendarDropHandler { /* * (non-Javadoc) - * + * * @see * com.vaadin.terminal.gwt.client.ui.dd.VAbstractDropHandler#dragLeave(com * .vaadin.terminal.gwt.client.ui.dd.VDragEvent) diff --git a/client/src/main/java/com/vaadin/client/ui/checkbox/CheckBoxConnector.java b/client/src/main/java/com/vaadin/client/ui/checkbox/CheckBoxConnector.java index 36509e62de..2e58124494 100644 --- a/client/src/main/java/com/vaadin/client/ui/checkbox/CheckBoxConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/checkbox/CheckBoxConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/colorpicker/AbstractColorPickerConnector.java b/client/src/main/java/com/vaadin/client/ui/colorpicker/AbstractColorPickerConnector.java index 769ced7ba8..53cf815323 100644 --- a/client/src/main/java/com/vaadin/client/ui/colorpicker/AbstractColorPickerConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/colorpicker/AbstractColorPickerConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,7 +24,7 @@ import com.vaadin.shared.ui.colorpicker.ColorPickerState; /** * An abstract class that defines default implementation for a color picker * connector. - * + * * @since 7.0.0 */ public abstract class AbstractColorPickerConnector @@ -74,7 +74,7 @@ public abstract class AbstractColorPickerConnector /** * Get caption for the color picker widget. - * + * * @return */ protected String getCaption() { @@ -100,7 +100,7 @@ public abstract class AbstractColorPickerConnector /** * Set caption of the color picker widget. - * + * * @param caption */ protected abstract void setCaption(String caption); diff --git a/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerAreaConnector.java b/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerAreaConnector.java index 238bd2112a..98b6c666ad 100644 --- a/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerAreaConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerAreaConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -30,7 +30,7 @@ import com.vaadin.ui.ColorPickerArea; * A class that defines an implementation for a color picker connector. Connects * the server side {@link com.vaadin.ui.ColorPickerArea} with the client side * counterpart {@link VColorPickerArea} - * + * * @since 7.0.0 */ @Connect(value = ColorPickerArea.class, loadStyle = LoadStyle.LAZY) diff --git a/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerConnector.java b/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerConnector.java index 12fb8b241e..9fc25a9e19 100644 --- a/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -29,7 +29,7 @@ import com.vaadin.ui.ColorPicker; * A class that defines default implementation for a color picker connector. * Connects the server side {@link com.vaadin.ui.ColorPicker} with the client * side counterpart {@link VColorPicker} - * + * * @since 7.0.0 */ @Connect(value = ColorPicker.class, loadStyle = LoadStyle.LAZY) diff --git a/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerGradientConnector.java b/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerGradientConnector.java index 541b479a61..3cff8a4d0d 100644 --- a/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerGradientConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerGradientConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -33,7 +33,7 @@ import com.vaadin.ui.components.colorpicker.ColorPickerGradient; * connector. Connects the server side * {@link com.vaadin.ui.components.colorpicker.ColorPickerGradient} with the * client side counterpart {@link VColorPickerGradient} - * + * * @since 7.0.0 */ @Connect(value = ColorPickerGradient.class, loadStyle = LoadStyle.LAZY) diff --git a/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerGridConnector.java b/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerGridConnector.java index b212f2e273..b13fe8fa0e 100644 --- a/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerGridConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/colorpicker/ColorPickerGridConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -33,7 +33,7 @@ import com.vaadin.ui.components.colorpicker.ColorPickerGrid; * connector. Connects the server side * {@link com.vaadin.ui.components.colorpicker.ColorPickerGrid} with the client * side counterpart {@link VColorPickerGrid} - * + * * @since 7.0.0 */ @Connect(value = ColorPickerGrid.class, loadStyle = LoadStyle.LAZY) diff --git a/client/src/main/java/com/vaadin/client/ui/colorpicker/VColorPickerGradient.java b/client/src/main/java/com/vaadin/client/ui/colorpicker/VColorPickerGradient.java index 125ec48370..df93d485a6 100644 --- a/client/src/main/java/com/vaadin/client/ui/colorpicker/VColorPickerGradient.java +++ b/client/src/main/java/com/vaadin/client/ui/colorpicker/VColorPickerGradient.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -29,9 +29,9 @@ import com.vaadin.client.ui.SubPartAware; /** * Client side implementation for ColorPickerGradient. - * + * * @since 7.0.0 - * + * */ public class VColorPickerGradient extends FocusPanel implements MouseDownHandler, MouseUpHandler, MouseMoveHandler, SubPartAware { @@ -120,7 +120,7 @@ public class VColorPickerGradient extends FocusPanel implements /** * Sets the given css color as the background. - * + * * @param bgColor */ protected void setBGColor(String bgColor) { @@ -161,7 +161,7 @@ public class VColorPickerGradient extends FocusPanel implements /** * Sets the latest coordinates for pressed-down mouse cursor and updates the * cross elements. - * + * * @param x * @param y */ diff --git a/client/src/main/java/com/vaadin/client/ui/colorpicker/VColorPickerGrid.java b/client/src/main/java/com/vaadin/client/ui/colorpicker/VColorPickerGrid.java index 04f06c2f4f..316bfce504 100644 --- a/client/src/main/java/com/vaadin/client/ui/colorpicker/VColorPickerGrid.java +++ b/client/src/main/java/com/vaadin/client/ui/colorpicker/VColorPickerGrid.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -26,9 +26,9 @@ import com.google.gwt.user.client.ui.HTMLTable.Cell; /** * Client side implementation for ColorPickerGrid. - * + * * @since 7.0.0 - * + * */ public class VColorPickerGrid extends AbsolutePanel implements ClickHandler, HasClickHandlers { @@ -54,7 +54,7 @@ public class VColorPickerGrid extends AbsolutePanel /** * Creates a grid according to the current row and column count information. - * + * * @return grid */ private Grid createGrid() { @@ -68,7 +68,7 @@ public class VColorPickerGrid extends AbsolutePanel /** * Updates the row and column count and creates a new grid based on them. * The new grid replaces the old grid if one existed. - * + * * @param rowCount * @param columnCount */ @@ -83,7 +83,7 @@ public class VColorPickerGrid extends AbsolutePanel * Updates the changed colors within the grid based on the given x- and * y-coordinates. Nothing happens if any of the parameters is null or the * parameter lengths don't match. - * + * * @param changedColor * @param changedX * @param changedY diff --git a/client/src/main/java/com/vaadin/client/ui/combobox/ComboBoxConnector.java b/client/src/main/java/com/vaadin/client/ui/combobox/ComboBoxConnector.java index 1c24f14cd7..5b3611b711 100644 --- a/client/src/main/java/com/vaadin/client/ui/combobox/ComboBoxConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/combobox/ComboBoxConnector.java @@ -81,7 +81,7 @@ public class ComboBoxConnector extends AbstractFieldConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.Paintable#updateFromUIDL(com.vaadin.client.UIDL, * com.vaadin.client.ApplicationConnection) */ @@ -270,10 +270,10 @@ public class ComboBoxConnector extends AbstractFieldConnector /** * Send a message about a newly created item to the server. - * + * * This method is for internal use only and may be removed in future * versions. - * + * * @since * @param itemValue * user entered string value for the new item @@ -286,10 +286,10 @@ public class ComboBoxConnector extends AbstractFieldConnector /** * Send a message to the server to request the first page of items without * filtering or selection. - * + * * This method is for internal use only and may be removed in future * versions. - * + * * @since */ public void requestFirstPage() { @@ -300,10 +300,10 @@ public class ComboBoxConnector extends AbstractFieldConnector /** * Send a message to the server to request a page of items with a given * filter. - * + * * This method is for internal use only and may be removed in future * versions. - * + * * @since * @param filter * the current filter string @@ -317,10 +317,10 @@ public class ComboBoxConnector extends AbstractFieldConnector /** * Send a message to the server updating the current selection. - * + * * This method is for internal use only and may be removed in future * versions. - * + * * @since * @param selection * the current selection @@ -332,13 +332,13 @@ public class ComboBoxConnector extends AbstractFieldConnector /** * Notify the server that the combo box received focus. - * + * * For timing reasons, ConnectorFocusAndBlurHandler is not used at the * moment. - * + * * This method is for internal use only and may be removed in future * versions. - * + * * @since */ public void sendFocusEvent() { @@ -351,13 +351,13 @@ public class ComboBoxConnector extends AbstractFieldConnector /** * Notify the server that the combo box lost focus. - * + * * For timing reasons, ConnectorFocusAndBlurHandler is not used at the * moment. - * + * * This method is for internal use only and may be removed in future * versions. - * + * * @since */ public void sendBlurEvent() { diff --git a/client/src/main/java/com/vaadin/client/ui/csslayout/CssLayoutConnector.java b/client/src/main/java/com/vaadin/client/ui/csslayout/CssLayoutConnector.java index c40a7d3801..46df5c183d 100644 --- a/client/src/main/java/com/vaadin/client/ui/csslayout/CssLayoutConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/csslayout/CssLayoutConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -63,7 +63,7 @@ public class CssLayoutConnector extends AbstractLayoutConnector { /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.AbstractLayoutConnector#getState() */ @Override @@ -73,7 +73,7 @@ public class CssLayoutConnector extends AbstractLayoutConnector { /* * (non-Javadoc) - * + * * @see * com.vaadin.client.ui.AbstractComponentConnector#onStateChanged(com.vaadin * .client.communication.StateChangeEvent) @@ -105,7 +105,7 @@ public class CssLayoutConnector extends AbstractLayoutConnector { /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.AbstractComponentContainerConnector# * onConnectorHierarchyChange * (com.vaadin.client.ConnectorHierarchyChangeEvent) @@ -150,7 +150,7 @@ public class CssLayoutConnector extends AbstractLayoutConnector { /** * Converts a css property string to CamelCase - * + * * @param cssProperty * The property string * @return A string converted to camelcase @@ -169,7 +169,7 @@ public class CssLayoutConnector extends AbstractLayoutConnector { /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.AbstractComponentConnector#getWidget() */ @Override @@ -179,7 +179,7 @@ public class CssLayoutConnector extends AbstractLayoutConnector { /* * (non-Javadoc) - * + * * @see com.vaadin.client.HasComponentsConnector#updateCaption(com.vaadin * .client.ComponentConnector) */ diff --git a/client/src/main/java/com/vaadin/client/ui/customcomponent/CustomComponentConnector.java b/client/src/main/java/com/vaadin/client/ui/customcomponent/CustomComponentConnector.java index c2c00a2975..60d3a0dc82 100644 --- a/client/src/main/java/com/vaadin/client/ui/customcomponent/CustomComponentConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/customcomponent/CustomComponentConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/customfield/CustomFieldConnector.java b/client/src/main/java/com/vaadin/client/ui/customfield/CustomFieldConnector.java index 75bb63f6e9..7260599fe6 100644 --- a/client/src/main/java/com/vaadin/client/ui/customfield/CustomFieldConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/customfield/CustomFieldConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -61,7 +61,7 @@ public class CustomFieldConnector extends AbstractFieldConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.HasComponentsConnector#getChildren() */ @Override @@ -75,7 +75,7 @@ public class CustomFieldConnector extends AbstractFieldConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.HasComponentsConnector#setChildren * (java.util.Collection) */ @@ -93,7 +93,7 @@ public class CustomFieldConnector extends AbstractFieldConnector /** * Returns the content (only/first child) of the container. - * + * * @return child connector or null if none (e.g. invisible or not set on * server) */ @@ -108,7 +108,7 @@ public class CustomFieldConnector extends AbstractFieldConnector /** * Returns the widget (if any) of the content of the container. - * + * * @return widget of the only/first connector of the container, null if no * content or if there is no widget for the connector */ diff --git a/client/src/main/java/com/vaadin/client/ui/customlayout/CustomLayoutConnector.java b/client/src/main/java/com/vaadin/client/ui/customlayout/CustomLayoutConnector.java index c8ced70dd7..d24ecf8911 100644 --- a/client/src/main/java/com/vaadin/client/ui/customlayout/CustomLayoutConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/customlayout/CustomLayoutConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/datefield/AbstractDateFieldConnector.java b/client/src/main/java/com/vaadin/client/ui/datefield/AbstractDateFieldConnector.java index e7e52d4021..0b855eb7d2 100644 --- a/client/src/main/java/com/vaadin/client/ui/datefield/AbstractDateFieldConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/datefield/AbstractDateFieldConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/datefield/DateFieldConnector.java b/client/src/main/java/com/vaadin/client/ui/datefield/DateFieldConnector.java index 22c1995279..04868c04b9 100644 --- a/client/src/main/java/com/vaadin/client/ui/datefield/DateFieldConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/datefield/DateFieldConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -38,7 +38,7 @@ public class DateFieldConnector extends TextualDateConnector { /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.AbstractConnector#init() */ @Override @@ -51,7 +51,7 @@ public class DateFieldConnector extends TextualDateConnector { * FIXME This is a hack so we do not have to rewrite half of the * datefield so values are not sent while selecting a date * (#6252). - * + * * The datefield will now only set the date UIDL variables while * the user is selecting year/month/date/time and not send them * directly. Only when the user closes the popup (by clicking on @@ -67,7 +67,7 @@ public class DateFieldConnector extends TextualDateConnector { /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.VTextualDate#updateFromUIDL(com.vaadin * .client.UIDL, com.vaadin.client.ApplicationConnection) */ diff --git a/client/src/main/java/com/vaadin/client/ui/datefield/InlineDateFieldConnector.java b/client/src/main/java/com/vaadin/client/ui/datefield/InlineDateFieldConnector.java index 0ed7c1ced3..eb9b017c91 100644 --- a/client/src/main/java/com/vaadin/client/ui/datefield/InlineDateFieldConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/datefield/InlineDateFieldConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/datefield/TextualDateConnector.java b/client/src/main/java/com/vaadin/client/ui/datefield/TextualDateConnector.java index 8545c20d7d..b4845a7054 100644 --- a/client/src/main/java/com/vaadin/client/ui/datefield/TextualDateConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/datefield/TextualDateConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/dd/DDEventHandleStrategy.java b/client/src/main/java/com/vaadin/client/ui/dd/DDEventHandleStrategy.java index bffd3c3353..74bafd098c 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/DDEventHandleStrategy.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/DDEventHandleStrategy.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -27,9 +27,9 @@ import com.vaadin.client.ui.dd.VDragAndDropManager.DDManagerMediator; /** * Strategy to handle native preview events for VDragAndDropManager. - * + * * The strategy could be overridden via GWT Deferred Binding mechanism. - * + * * @author Vaadin Ltd * @since 7.4.4 */ @@ -37,7 +37,7 @@ public class DDEventHandleStrategy { /** * Returns {@code true} if {@code event} interrupts Drag and Drop. - * + * * @param event * GWT event to handle * @param mediator @@ -58,9 +58,9 @@ public class DDEventHandleStrategy { /** * Handles key down {@code event}. - * + * * Default implementation doesn't do anything. - * + * * @param event * key down GWT event * @param mediator @@ -73,7 +73,7 @@ public class DDEventHandleStrategy { /** * Get target element for {@code event}. - * + * * @param event * GWT event to find target * @param mediator @@ -113,7 +113,7 @@ public class DDEventHandleStrategy { * drag image. This value will be passed to the * {@link #restoreDragImage(String, DDManagerMediator, NativePreviewEvent)} * method. - * + * * @param event * GWT event for active DnD operation * @param mediator @@ -139,7 +139,7 @@ public class DDEventHandleStrategy { /** * Restores drag image after temporary update by * {@link #updateDragImage(NativePreviewEvent, DDManagerMediator)}. - * + * * @param originalImageDisplay * original "display" CSS style property of drag image element * @param mediator @@ -160,9 +160,9 @@ public class DDEventHandleStrategy { * Handles event when drag image element ( * {@link VDragAndDropManager#getDragElement()} return value) is not null or * {@code event} is touch event. - * + * * If method returns {@code true} then event processing will be stoped. - * + * * @param target * target element over which DnD event has happened * @param event @@ -212,7 +212,7 @@ public class DDEventHandleStrategy { /** * Handles drag enter on new element. - * + * * @param mediator * VDragAndDropManager data accessor * @param target @@ -228,7 +228,7 @@ public class DDEventHandleStrategy { /** * Handles drag over on element. - * + * * @param mediator * VDragAndDropManager data accessor * @param target @@ -242,7 +242,7 @@ public class DDEventHandleStrategy { /** * Final phase of event handling. - * + * * @param targetElement * target element over which DnD event has happened * @param event @@ -274,7 +274,7 @@ public class DDEventHandleStrategy { /** * Called to handle {@link Event#ONMOUSEMOVE} event. - * + * * @param target * target element over which DnD event has happened * @param event @@ -293,7 +293,7 @@ public class DDEventHandleStrategy { /** * Called to handle {@link Event#ONTOUCHEND} event. - * + * * @param target * target element over which DnD event has happened * @param event @@ -310,7 +310,7 @@ public class DDEventHandleStrategy { /** * Called to handle {@link Event#ONMOUSEUP} event. - * + * * @param target * target element over which DnD event has happened * @param event @@ -325,7 +325,7 @@ public class DDEventHandleStrategy { /** * Called to handle {@link Event#ONMOUSEOUT} event. - * + * * @param target * target element over which DnD event has happened * @param event @@ -354,7 +354,7 @@ public class DDEventHandleStrategy { /** * Handles drag leave on old element. - * + * * @param mediator * VDragAndDropManager data accessor */ @@ -372,7 +372,7 @@ public class DDEventHandleStrategy { /** * Called to handle {@link Event#ONMOUSEOVER} event. - * + * * @param target * target element over which DnD event has happened * @param event @@ -404,7 +404,7 @@ public class DDEventHandleStrategy { /** * Find drag handler for the {@code target} element. - * + * * @param target * target element over which DnD event has happened * @param mediator diff --git a/client/src/main/java/com/vaadin/client/ui/dd/DDUtil.java b/client/src/main/java/com/vaadin/client/ui/dd/DDUtil.java index fdccd61767..8d8c44b460 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/DDUtil.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/DDUtil.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/dd/DragAndDropHandler.java b/client/src/main/java/com/vaadin/client/ui/dd/DragAndDropHandler.java index f6ae4ba0ab..82348e4901 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/DragAndDropHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/DragAndDropHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -33,7 +33,7 @@ import com.vaadin.client.widgets.Grid; * <p> * The showing of the dragged element, drag hints and reacting to drop/cancel is * delegated to {@link DragAndDropCallback} implementation. - * + * * @since 7.5.0 * @author Vaadin Ltd */ @@ -46,7 +46,7 @@ public class DragAndDropHandler { /** * Called when the drag has started. The drag can be canceled by * returning {@code false}. - * + * * @param e * the original event that started the drag * @return {@code true} if the drag is OK to start, {@code false} to @@ -56,7 +56,7 @@ public class DragAndDropHandler { /** * Called on drag. - * + * * @param e * the event related to the drag */ @@ -150,11 +150,11 @@ public class DragAndDropHandler { /** * This method can be called to trigger drag and drop on any grid element * that can be dragged and dropped. - * + * * @param dragStartingEvent * the drag triggering event, usually a {@link Event#ONMOUSEDOWN} * or {@link Event#ONTOUCHSTART} event on the draggable element - * + * * @param callback * the callback that will handle actual drag and drop related * operations diff --git a/client/src/main/java/com/vaadin/client/ui/dd/DragHandle.java b/client/src/main/java/com/vaadin/client/ui/dd/DragHandle.java index 77184e14af..a983337c22 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/DragHandle.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/DragHandle.java @@ -31,7 +31,7 @@ import com.vaadin.client.ui.dd.DragAndDropHandler.DragAndDropCallback; * view of this component, there really is no use for that). For the more * general, event-providing interface that this component is based on, see * {@link DragAndDropHandler}. - * + * * @since 7.6 */ public class DragHandle { @@ -48,7 +48,7 @@ public class DragHandle { /** * Called when the drag handle has moved. - * + * * @param deltaX * change in X direction since start * @param deltaY @@ -80,7 +80,7 @@ public class DragHandle { /** * Creates a new DragHandle. - * + * * @param baseName * CSS style name to use for this DragHandle element. This * parameter is supplied to the constructor (rather than added @@ -158,7 +158,7 @@ public class DragHandle { /** * Returns the current parent element for this drag handle. May be null. - * + * * @return an Element or null */ public Element getParent() { @@ -167,7 +167,7 @@ public class DragHandle { /** * Gets the element used as actual drag handle. - * + * * @return an Element */ public Element getElement() { @@ -176,7 +176,7 @@ public class DragHandle { /** * Adds this drag handle to an HTML element. - * + * * @param elem * an element */ @@ -198,7 +198,7 @@ public class DragHandle { /** * Adds CSS style name to the drag handle element. - * + * * @param styleName * a CSS style name */ @@ -208,7 +208,7 @@ public class DragHandle { /** * Removes existing style name from drag handle element. - * + * * @param styleName * a CSS style name */ diff --git a/client/src/main/java/com/vaadin/client/ui/dd/DragImageModifier.java b/client/src/main/java/com/vaadin/client/ui/dd/DragImageModifier.java index 45ab5d9bb3..2402d59dd1 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/DragImageModifier.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/DragImageModifier.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -22,7 +22,7 @@ import com.google.gwt.dom.client.Element; * requires additional initialization/configuration. The method * {@link #modifyDragImage(Element)} is called for each element in the * automatically generated drag image. - * + * * @since 7.2 * @author Vaadin Ltd */ @@ -32,7 +32,7 @@ public interface DragImageModifier { * This method is called for cloned <code>element</code> which corresponds * to the widget element. One could modify/correct this <code>element</code> * for drag image. - * + * * @param element * cloned element of drag image */ diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VAbstractDropHandler.java b/client/src/main/java/com/vaadin/client/ui/dd/VAbstractDropHandler.java index 025bb49e81..cdec7d611f 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VAbstractDropHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VAbstractDropHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -33,7 +33,7 @@ public abstract class VAbstractDropHandler implements VDropHandler { * Implementor/user of {@link VAbstractDropHandler} must pass the UIDL * painted by {@link AcceptCriterion} to this method. Practically the * details about {@link AcceptCriterion} are saved. - * + * * @param uidl */ public void updateAcceptRules(UIDL uidl) { @@ -85,7 +85,7 @@ public abstract class VAbstractDropHandler implements VDropHandler { * {@link Transferable} and others don't, one should use similar validation * logic in dragOver method and replace this method with empty * implementation. - * + * */ @Override public void dragEnter(final VDragEvent drag) { @@ -103,7 +103,7 @@ public abstract class VAbstractDropHandler implements VDropHandler { * <p> * Implementations can set some hints for users here to highlight that the * drag is on a valid drop location. - * + * * @param drag */ abstract protected void dragAccepted(VDragEvent drag); diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VAcceptAll.java b/client/src/main/java/com/vaadin/client/ui/dd/VAcceptAll.java index bb6170da45..38e306598c 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VAcceptAll.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VAcceptAll.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -14,7 +14,7 @@ * the License. */ /** - * + * */ package com.vaadin.client.ui.dd; diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCallback.java b/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCallback.java index 706abb0e05..583c1bed1f 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCallback.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCallback.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCriteria.java b/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCriteria.java index 4bf23cbe7f..e5e59290de 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCriteria.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCriteria.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCriterion.java b/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCriterion.java index 5205b9182b..711e030c6c 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCriterion.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCriterion.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -22,7 +22,7 @@ public abstract class VAcceptCriterion { /** * Checks if current drag event has valid drop target and target accepts the * transferable. If drop target is valid, callback is used. - * + * * @param drag * @param configuration * @param callback diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCriterionFactory.java b/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCriterionFactory.java index 1503b1f84d..5d0267b99f 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCriterionFactory.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VAcceptCriterionFactory.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VAnd.java b/client/src/main/java/com/vaadin/client/ui/dd/VAnd.java index ee4bc94f9e..2b448e3ed4 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VAnd.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VAnd.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -14,7 +14,7 @@ * the License. */ /** - * + * */ package com.vaadin.client.ui.dd; diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VContainsDataFlavor.java b/client/src/main/java/com/vaadin/client/ui/dd/VContainsDataFlavor.java index 2ad375fd77..cadfb79c20 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VContainsDataFlavor.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VContainsDataFlavor.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -14,7 +14,7 @@ * the License. */ /** - * + * */ package com.vaadin.client.ui.dd; diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VDragAndDropManager.java b/client/src/main/java/com/vaadin/client/ui/dd/VDragAndDropManager.java index 0afb23ed3e..a3e3e9bcf1 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VDragAndDropManager.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VDragAndDropManager.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -52,7 +52,7 @@ import com.vaadin.shared.ui.dd.DragEventType; * <p> * Singleton. Only one drag and drop operation can be active anyways. Use * {@link #get()} to get instance. - * + * * TODO cancel drag and drop if more than one touches !? */ public class VDragAndDropManager { @@ -63,7 +63,7 @@ public class VDragAndDropManager { * Implementation if this interface is provided as a parameter to * DDEventHandleStrategy methods. The mediator instance allows to manage * DnD. - * + * * @since 7.4.4 */ public interface DDManagerMediator { @@ -199,7 +199,7 @@ public class VDragAndDropManager { * If drag and drop operation is not handled by {@link VDragAndDropManager}s * internal handler, this can be used to update current {@link VDropHandler} * . - * + * * @param currentDropHandler */ public void setCurrentDropHandler(VDropHandler currentDropHandler) { @@ -242,7 +242,7 @@ public class VDragAndDropManager { * May also be used to control the drag and drop operation. If this option * is used, {@link VDropHandler} is searched on mouse events and appropriate * methods on it called automatically. - * + * * @param transferable * @param nativeEvent * @param handleDragEvents @@ -406,7 +406,7 @@ public class VDragAndDropManager { /** * First seeks the widget from this element, then iterates widgets until one * implement HasDropHandler. Returns DropHandler from that. - * + * * @param element * @return */ @@ -561,11 +561,11 @@ public class VDragAndDropManager { /** * Visits server during drag and drop procedure. Transferable and event type * is given to server side counterpart of DropHandler. - * + * * If another server visit is started before the current is received, the * current is just dropped. TODO consider if callback should have * interrupted() method for cleanup. - * + * * @param acceptCallback */ public void visitServer(VDragEventServerCallback acceptCallback) { @@ -584,9 +584,9 @@ public class VDragAndDropManager { * For drag events we are using special id that are routed to * "drag service" which then again finds the corresponding DropHandler * on server side. - * + * * TODO add rest of the data in Transferable - * + * * TODO implement partial updates to Transferable (currently the whole * Transferable is sent on each request) */ @@ -649,10 +649,10 @@ public class VDragAndDropManager { /** * Returns DnD strategy to handle native preview events used by the manager. - * + * * Subclasses can override this method to return custom strategy or use GWT * deferred binding. - * + * * @return internal DnD native preview event handler */ protected DDEventHandleStrategy getEventHandleStrategy() { @@ -733,7 +733,7 @@ public class VDragAndDropManager { /** * Method to que tasks until all dd related server visits are done - * + * * @param command */ private void defer(Command command) { @@ -749,7 +749,7 @@ public class VDragAndDropManager { * <p> * TODO Optimization: consider if we actually only need to keep the last * command in queue here. - * + * * @param command */ public void executeWhenReady(Command command) { diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VDragEvent.java b/client/src/main/java/com/vaadin/client/ui/dd/VDragEvent.java index aaa6e5c488..210e956825 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VDragEvent.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VDragEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -35,8 +35,8 @@ import com.vaadin.client.WidgetUtil; /** * DragEvent used by Vaadin client side engine. Supports components, items, * properties and custom payload (HTML5 style). - * - * + * + * */ public class VDragEvent { @@ -70,7 +70,7 @@ public class VDragEvent { * Returns the the latest {@link NativeEvent} that relates to this drag and * drop operation. For example on {@link VDropHandler#dragEnter(VDragEvent)} * this is commonly a {@link MouseOverEvent}. - * + * * @return */ public NativeEvent getCurrentGwtEvent() { @@ -95,7 +95,7 @@ public class VDragEvent { * the pointer currently is (drag image excluded). {@link VDropHandler}s can * then more easily react properly on drag events by reading the element via * this method. - * + * * @return the element in {@link VDropHandler} on which mouse cursor is on */ public com.google.gwt.user.client.Element getElementOver() { @@ -130,13 +130,13 @@ public class VDragEvent { * <p> * The element to be used as drag image will automatically get CSS style * name "v-drag-element". - * + * * TODO decide if this method should be here or in {@link VTransferable} (in * HTML5 it is in DataTransfer) or {@link VDragAndDropManager} - * + * * TODO should be possible to override behavior. Like to proxy the element * to HTML5 DataTransfer - * + * * @param node * @deprecated As of 7.2, call or override {@link #setDragImage(Element)} * instead @@ -152,15 +152,15 @@ public class VDragEvent { * <p> * The element to be used as drag image will automatically get CSS style * name "v-drag-element". - * + * * TODO decide if this method should be here or in {@link VTransferable} (in * HTML5 it is in DataTransfer) or {@link VDragAndDropManager} - * + * * TODO should be possible to override behavior. Like to proxy the element * to HTML5 DataTransfer - * + * * @param node - * + * * @since 7.2 */ public void setDragImage(Element node) { @@ -169,9 +169,9 @@ public class VDragEvent { /** * TODO consider using similar smaller (than map) api as in Transferable - * + * * TODO clean up when drop handler changes - * + * * @return */ public Map<String, Object> getDropDetails() { @@ -184,7 +184,7 @@ public class VDragEvent { * <p> * The element to be used as drag image will automatically get CSS style * name "v-drag-element". - * + * * @param element * the dom element to be positioned next to mouse cursor * @param offsetX @@ -209,14 +209,14 @@ public class VDragEvent { * <p> * The element to be used as drag image will automatically get CSS style * name "v-drag-element". - * + * * @param element * the dom element to be positioned next to mouse cursor * @param offsetX * the horizontal offset of drag image from mouse cursor * @param offsetY * the vertical offset of drag image from mouse cursor - * + * * @since 7.2 */ public void setDragImage(Element element, int offsetX, int offsetY) { @@ -233,7 +233,7 @@ public class VDragEvent { /** * Automatically tries to create a proxy image from given element. - * + * * @param element * @param alignImageToEvent * if true, proxy image is aligned to start event, else next to @@ -276,7 +276,7 @@ public class VDragEvent { /** * Automatically tries to create a proxy image from given element. - * + * * @param element * @param alignImageToEvent * if true, proxy image is aligned to start event, else next to @@ -290,7 +290,7 @@ public class VDragEvent { /** * Do additional content sync between <code>original</code> element and its * <code>copy</code> if needed. - * + * * @since 7.2 * @param original * original element diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VDragEventServerCallback.java b/client/src/main/java/com/vaadin/client/ui/dd/VDragEventServerCallback.java index ba2d0f789b..bc6e325bce 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VDragEventServerCallback.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VDragEventServerCallback.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VDragSourceIs.java b/client/src/main/java/com/vaadin/client/ui/dd/VDragSourceIs.java index 8a8d1d7bb9..26b21a2146 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VDragSourceIs.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VDragSourceIs.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -23,7 +23,7 @@ import com.vaadin.shared.ui.dd.AcceptCriterion; /** * TODO Javadoc! - * + * * @since 6.3 */ @AcceptCriterion(SourceIs.class) diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VDropHandler.java b/client/src/main/java/com/vaadin/client/ui/dd/VDropHandler.java index 96059883e7..b6fb6b370b 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VDropHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VDropHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -27,7 +27,7 @@ public interface VDropHandler { /** * Called by DragAndDropManager when a drag operation is in progress and the * cursor enters the area occupied by this Paintable. - * + * * @param dragEvent * DragEvent which contains the transferable and other * information for the operation @@ -37,7 +37,7 @@ public interface VDropHandler { /** * Called by DragAndDropManager when a drag operation is in progress and the * cursor leaves the area occupied by this Paintable. - * + * * @param dragEvent * DragEvent which contains the transferable and other * information for the operation @@ -47,12 +47,12 @@ public interface VDropHandler { /** * Called by DragAndDropManager when a drag operation was in progress and a * drop was performed on this Paintable. - * - * + * + * * @param dragEvent * DragEvent which contains the transferable and other * information for the operation - * + * * @return true if the Tranferrable of this drag event needs to be sent to * the server, false if drop is rejected or no server side event * should be sent @@ -61,11 +61,11 @@ public interface VDropHandler { /** * When drag is over current drag handler. - * + * * With drag implementation by {@link VDragAndDropManager} will be called * when mouse is moved. HTML5 implementations call this continuously even * though mouse is not moved. - * + * * @param currentDrag */ public void dragOver(VDragEvent currentDrag); diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VHasDropHandler.java b/client/src/main/java/com/vaadin/client/ui/dd/VHasDropHandler.java index 4d82c5c9cf..05c6649e80 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VHasDropHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VHasDropHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,10 +19,10 @@ import com.vaadin.client.ComponentConnector; /** * Used to detect Widget from widget tree that has {@link #getDropHandler()} - * + * * Decide whether to get rid of this class. If so, {@link VAbstractDropHandler} * must extend {@link ComponentConnector}. - * + * */ public interface VHasDropHandler { public VDropHandler getDropHandler(); diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VHtml5DragEvent.java b/client/src/main/java/com/vaadin/client/ui/dd/VHtml5DragEvent.java index ed4dd1b6cb..785d24af74 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VHtml5DragEvent.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VHtml5DragEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.google.gwt.dom.client.NativeEvent; /** * Helper class to access html5 style drag events. - * + * * TODO Gears support ? */ public class VHtml5DragEvent extends NativeEvent { @@ -41,7 +41,7 @@ public class VHtml5DragEvent extends NativeEvent { /** * Works on FF 3.6 and possibly with gears. - * + * * @param index * @return */ @@ -94,15 +94,15 @@ public class VHtml5DragEvent extends NativeEvent { return item.webkitGetAsEntry().isFile; } } - + // Zero sized files without a type are also likely to be folders var file = this.dataTransfer.files[fileIndex]; if (file.size == 0 && !file.type) { return false; } - + // TODO Make it detect folders on all browsers - + return true; }-*/; diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VHtml5File.java b/client/src/main/java/com/vaadin/client/ui/dd/VHtml5File.java index 6022835343..dac5d9a961 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VHtml5File.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VHtml5File.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VIsOverId.java b/client/src/main/java/com/vaadin/client/ui/dd/VIsOverId.java index 8e8abf1a97..d3fb378b16 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VIsOverId.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VIsOverId.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -14,7 +14,7 @@ * the License. */ /** - * + * */ package com.vaadin.client.ui.dd; diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VItemIdIs.java b/client/src/main/java/com/vaadin/client/ui/dd/VItemIdIs.java index 4bfc71ab14..22ec05448d 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VItemIdIs.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VItemIdIs.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -14,7 +14,7 @@ * the License. */ /** - * + * */ package com.vaadin.client.ui.dd; diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VNot.java b/client/src/main/java/com/vaadin/client/ui/dd/VNot.java index 3e931f9580..92b2de7eea 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VNot.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VNot.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -14,7 +14,7 @@ * the License. */ /** - * + * */ package com.vaadin.client.ui.dd; @@ -25,7 +25,7 @@ import com.vaadin.shared.ui.dd.AcceptCriterion; /** * TODO implementation could now be simplified/optimized - * + * */ @AcceptCriterion(Not.class) final public class VNot extends VAcceptCriterion { diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VOr.java b/client/src/main/java/com/vaadin/client/ui/dd/VOr.java index e189e22b45..98e6a08b94 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VOr.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VOr.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -14,7 +14,7 @@ * the License. */ /** - * + * */ package com.vaadin.client.ui.dd; @@ -23,7 +23,7 @@ import com.vaadin.event.dd.acceptcriteria.Or; import com.vaadin.shared.ui.dd.AcceptCriterion; /** - * + * */ @AcceptCriterion(Or.class) final public class VOr extends VAcceptCriterion implements VAcceptCallback { diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VOverTreeNode.java b/client/src/main/java/com/vaadin/client/ui/dd/VOverTreeNode.java index 2ebde20780..a8bac3e5a7 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VOverTreeNode.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VOverTreeNode.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -14,7 +14,7 @@ * the License. */ /** - * + * */ package com.vaadin.client.ui.dd; diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VServerAccept.java b/client/src/main/java/com/vaadin/client/ui/dd/VServerAccept.java index 9ead6298b0..291e22e950 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VServerAccept.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VServerAccept.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -14,7 +14,7 @@ * the License. */ /** - * + * */ package com.vaadin.client.ui.dd; diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VSourceIsTarget.java b/client/src/main/java/com/vaadin/client/ui/dd/VSourceIsTarget.java index 3e453b4105..01d8fc2c6f 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VSourceIsTarget.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VSourceIsTarget.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -14,7 +14,7 @@ * the License. */ /** - * + * */ package com.vaadin.client.ui.dd; diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VTargetDetailIs.java b/client/src/main/java/com/vaadin/client/ui/dd/VTargetDetailIs.java index 72cf0b4c2b..1ced0afc3c 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VTargetDetailIs.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VTargetDetailIs.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -14,7 +14,7 @@ * the License. */ /** - * + * */ package com.vaadin.client.ui.dd; diff --git a/client/src/main/java/com/vaadin/client/ui/dd/VTransferable.java b/client/src/main/java/com/vaadin/client/ui/dd/VTransferable.java index b03dcbcb35..479cadb159 100644 --- a/client/src/main/java/com/vaadin/client/ui/dd/VTransferable.java +++ b/client/src/main/java/com/vaadin/client/ui/dd/VTransferable.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,7 +24,7 @@ import com.vaadin.event.dd.DragSource; /** * Client side counterpart for Transferable in com.vaadin.event.Transferable - * + * */ public class VTransferable { @@ -35,7 +35,7 @@ public class VTransferable { /** * Returns the component from which the transferable is created (eg. a tree * which node is dragged). - * + * * @return the component */ public ComponentConnector getDragSource() { @@ -49,7 +49,7 @@ public class VTransferable { * The server side counterpart of the component may implement * {@link DragSource} interface if it wants to translate or complement the * server side instance of this Transferable. - * + * * @param component * the component to set */ @@ -71,7 +71,7 @@ public class VTransferable { /** * This helper method should only be called by {@link VDragAndDropManager}. - * + * * @return data in this Transferable that needs to be moved to server. */ Map<String, Object> getVariableMap() { diff --git a/client/src/main/java/com/vaadin/client/ui/draganddropwrapper/DragAndDropWrapperConnector.java b/client/src/main/java/com/vaadin/client/ui/draganddropwrapper/DragAndDropWrapperConnector.java index b1d326ee84..f11b4a8b2d 100644 --- a/client/src/main/java/com/vaadin/client/ui/draganddropwrapper/DragAndDropWrapperConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/draganddropwrapper/DragAndDropWrapperConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/embedded/EmbeddedConnector.java b/client/src/main/java/com/vaadin/client/ui/embedded/EmbeddedConnector.java index 2419d0f361..168f0e7f70 100644 --- a/client/src/main/java/com/vaadin/client/ui/embedded/EmbeddedConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/embedded/EmbeddedConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/flash/FlashConnector.java b/client/src/main/java/com/vaadin/client/ui/flash/FlashConnector.java index e859e9cbf1..856fc776a8 100644 --- a/client/src/main/java/com/vaadin/client/ui/flash/FlashConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/flash/FlashConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/formlayout/FormLayoutConnector.java b/client/src/main/java/com/vaadin/client/ui/formlayout/FormLayoutConnector.java index c8cbf6e54c..682d0dfd1f 100644 --- a/client/src/main/java/com/vaadin/client/ui/formlayout/FormLayoutConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/formlayout/FormLayoutConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/image/ImageConnector.java b/client/src/main/java/com/vaadin/client/ui/image/ImageConnector.java index e4ba4af070..042cbd2d40 100644 --- a/client/src/main/java/com/vaadin/client/ui/image/ImageConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/image/ImageConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/label/LabelConnector.java b/client/src/main/java/com/vaadin/client/ui/label/LabelConnector.java index fc94f27cf0..c0f1d37bdc 100644 --- a/client/src/main/java/com/vaadin/client/ui/label/LabelConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/label/LabelConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/layout/ComponentConnectorLayoutSlot.java b/client/src/main/java/com/vaadin/client/ui/layout/ComponentConnectorLayoutSlot.java index 80bde33449..3df4833772 100644 --- a/client/src/main/java/com/vaadin/client/ui/layout/ComponentConnectorLayoutSlot.java +++ b/client/src/main/java/com/vaadin/client/ui/layout/ComponentConnectorLayoutSlot.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/layout/ElementResizeEvent.java b/client/src/main/java/com/vaadin/client/ui/layout/ElementResizeEvent.java index a1f75baff4..91aa7850c0 100644 --- a/client/src/main/java/com/vaadin/client/ui/layout/ElementResizeEvent.java +++ b/client/src/main/java/com/vaadin/client/ui/layout/ElementResizeEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/layout/ElementResizeListener.java b/client/src/main/java/com/vaadin/client/ui/layout/ElementResizeListener.java index 97ca34a8a4..6a625f72d1 100644 --- a/client/src/main/java/com/vaadin/client/ui/layout/ElementResizeListener.java +++ b/client/src/main/java/com/vaadin/client/ui/layout/ElementResizeListener.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/layout/LayoutDependencyTree.java b/client/src/main/java/com/vaadin/client/ui/layout/LayoutDependencyTree.java index 105f905ac4..5f277a903e 100644 --- a/client/src/main/java/com/vaadin/client/ui/layout/LayoutDependencyTree.java +++ b/client/src/main/java/com/vaadin/client/ui/layout/LayoutDependencyTree.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -37,7 +37,7 @@ import com.vaadin.shared.AbstractComponentState; /** * Internal class used to keep track of layout dependencies during one layout * run. This class is not intended to be used directly by applications. - * + * * @author Vaadin Ltd * @since 7.0.0 */ @@ -315,7 +315,7 @@ public class LayoutDependencyTree { * Go up the hierarchy to find a component whose size might have changed * in the other direction because changes to this component causes * scrollbars to appear or disappear. - * + * * @return */ private LayoutDependency findPotentiallyChangedScrollbar() { @@ -449,7 +449,7 @@ public class LayoutDependencyTree { /** * @param connectorId * @param needsMeasure - * + * * @deprecated As of 7.4.2, use * {@link #setNeedsMeasure(ComponentConnector, boolean)} for * improved performance. @@ -541,7 +541,7 @@ public class LayoutDependencyTree { /** * @param layout * @param needsLayout - * + * * @deprecated As of 7.0.1, use * {@link #setNeedsHorizontalLayout(String, boolean)} for * improved performance. @@ -566,7 +566,7 @@ public class LayoutDependencyTree { /** * @param layout * @param needsLayout - * + * * @deprecated As of 7.0.1, use * {@link #setNeedsVerticalLayout(String, boolean)} for improved * performance. diff --git a/client/src/main/java/com/vaadin/client/ui/layout/Margins.java b/client/src/main/java/com/vaadin/client/ui/layout/Margins.java index 75839c9ce8..a1466b9b61 100644 --- a/client/src/main/java/com/vaadin/client/ui/layout/Margins.java +++ b/client/src/main/java/com/vaadin/client/ui/layout/Margins.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/layout/MayScrollChildren.java b/client/src/main/java/com/vaadin/client/ui/layout/MayScrollChildren.java index 2a0b821646..9b9e90cefa 100644 --- a/client/src/main/java/com/vaadin/client/ui/layout/MayScrollChildren.java +++ b/client/src/main/java/com/vaadin/client/ui/layout/MayScrollChildren.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/layout/VLayoutSlot.java b/client/src/main/java/com/vaadin/client/ui/layout/VLayoutSlot.java index 3dc661cd15..762056de0d 100644 --- a/client/src/main/java/com/vaadin/client/ui/layout/VLayoutSlot.java +++ b/client/src/main/java/com/vaadin/client/ui/layout/VLayoutSlot.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/link/LinkConnector.java b/client/src/main/java/com/vaadin/client/ui/link/LinkConnector.java index bc0cf33e98..fb49db05c9 100644 --- a/client/src/main/java/com/vaadin/client/ui/link/LinkConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/link/LinkConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/listselect/ListSelectConnector.java b/client/src/main/java/com/vaadin/client/ui/listselect/ListSelectConnector.java index b867a3358c..1334e92c6d 100644 --- a/client/src/main/java/com/vaadin/client/ui/listselect/ListSelectConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/listselect/ListSelectConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/loginform/LoginFormConnector.java b/client/src/main/java/com/vaadin/client/ui/loginform/LoginFormConnector.java index 42e4d51f03..0de535b39a 100644 --- a/client/src/main/java/com/vaadin/client/ui/loginform/LoginFormConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/loginform/LoginFormConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/loginform/VLoginForm.java b/client/src/main/java/com/vaadin/client/ui/loginform/VLoginForm.java index e3dccd1ba5..d31ba55173 100644 --- a/client/src/main/java/com/vaadin/client/ui/loginform/VLoginForm.java +++ b/client/src/main/java/com/vaadin/client/ui/loginform/VLoginForm.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/menubar/MenuBar.java b/client/src/main/java/com/vaadin/client/ui/menubar/MenuBar.java index 0b1fbde1c8..25f2ca753f 100644 --- a/client/src/main/java/com/vaadin/client/ui/menubar/MenuBar.java +++ b/client/src/main/java/com/vaadin/client/ui/menubar/MenuBar.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -18,13 +18,13 @@ package com.vaadin.client.ui.menubar; /* * Copyright 2007 Google Inc. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -51,22 +51,22 @@ import com.vaadin.client.ui.VOverlay; * A standard menu bar widget. A menu bar can contain any number of menu items, * each of which can either fire a {@link com.google.gwt.user.client.Command} or * open a cascaded menu bar. - * + * * <p> * <img class='gallery' src='MenuBar.png'/> * </p> - * + * * <h3>CSS Style Rules</h3> * <ul class='css'> * <li>.gwt-MenuBar { the menu bar itself }</li> * <li>.gwt-MenuBar .gwt-MenuItem { menu items }</li> * <li>.gwt-MenuBar .gwt-MenuItem-selected { selected menu items }</li> * </ul> - * + * * <p> * <h3>Example</h3> {@example com.google.gwt.examples.MenuBarExample} * </p> - * + * * @deprecated */ @Deprecated @@ -93,7 +93,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Creates an empty menu bar. - * + * * @param vertical * <code>true</code> to orient the menu bar vertically */ @@ -121,7 +121,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Adds a menu item to the bar. - * + * * @param item * the item to be added */ @@ -144,7 +144,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Adds a menu item to the bar, that will fire the given command when it is * selected. - * + * * @param text * the item's text * @param asHTML @@ -162,7 +162,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Adds a menu item to the bar, that will open the specified menu when it is * selected. - * + * * @param text * the item's text * @param asHTML @@ -180,7 +180,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Adds a menu item to the bar, that will fire the given command when it is * selected. - * + * * @param text * the item's text * @param cmd @@ -196,7 +196,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Adds a menu item to the bar, that will open the specified menu when it is * selected. - * + * * @param text * the item's text * @param popup @@ -223,7 +223,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Gets whether this menu bar's child menus will open when the mouse is * moved over it. - * + * * @return <code>true</code> if child menus will auto-open */ public boolean getAutoOpen() { @@ -276,7 +276,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Removes the specified menu item from the bar. - * + * * @param item * the item to be removed */ @@ -294,7 +294,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Sets whether this menu bar's child menus will open when the mouse is * moved over it. - * + * * @param autoOpen * <code>true</code> to cause child menus to auto-open */ @@ -306,7 +306,7 @@ public class MenuBar extends Widget implements PopupListener { * Returns a list containing the <code>MenuItem</code> objects in the menu * bar. If there are no items in the menu bar, then an empty * <code>List</code> object will be returned. - * + * * @return a list containing the <code>MenuItem</code> objects in the menu * bar */ @@ -318,7 +318,7 @@ public class MenuBar extends Widget implements PopupListener { * Returns the <code>MenuItem</code> that is currently selected * (highlighted) by the user. If none of the items in the menu are currently * selected, then <code>null</code> will be returned. - * + * * @return the <code>MenuItem</code> that is currently selected, or * <code>null</code> if no items are currently selected */ @@ -328,7 +328,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Gets the first item from the menu or null if no items. - * + * * @since 7.2.6 * @return the first item from the menu or null if no items. */ @@ -338,7 +338,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Gest the last item from the menu or null if no items. - * + * * @since 7.2.6 * @return the last item from the menu or null if no items. */ @@ -349,7 +349,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Gets the index of the selected item. - * + * * @since 7.2.6 * @return the index of the selected item. */ @@ -390,7 +390,7 @@ public class MenuBar extends Widget implements PopupListener { * a popup associated with it, the popup will be shown. If it has a command * associated with it, and 'fireCommand' is true, then the command will be * fired. Popups associated with other items will be hidden. - * + * * @param item the item whose popup is to be shown. @param fireCommand * <code>true</code> if the item's command should be fired, * <code>false</code> otherwise. @@ -530,7 +530,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Scroll the selected item into view. - * + * * @since 7.2.6 */ public void scrollSelectionIntoView() { @@ -539,7 +539,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Sets the menu scroll enabled or disabled. - * + * * @since 7.2.6 * @param enabled * the enabled state of the scroll. @@ -563,7 +563,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Gets whether the scroll is activate for this menu. - * + * * @since 7.2.6 * @return true if the scroll is active, otherwise false. */ @@ -578,7 +578,7 @@ public class MenuBar extends Widget implements PopupListener { /** * Gets the preferred height of the menu. - * + * * @since 7.2.6 */ protected int getPreferredHeight() { diff --git a/client/src/main/java/com/vaadin/client/ui/menubar/MenuBarConnector.java b/client/src/main/java/com/vaadin/client/ui/menubar/MenuBarConnector.java index 5aa3a76d33..c0b1c84bce 100644 --- a/client/src/main/java/com/vaadin/client/ui/menubar/MenuBarConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/menubar/MenuBarConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -42,7 +42,7 @@ public class MenuBarConnector extends AbstractComponentConnector /** * This method must be implemented to update the client-side component from * UIDL data received from server. - * + * * This method is called when the page is loaded for the first time, and * every time UI changes in the component are received from the server. */ diff --git a/client/src/main/java/com/vaadin/client/ui/menubar/MenuItem.java b/client/src/main/java/com/vaadin/client/ui/menubar/MenuItem.java index bf2fbf8feb..f5dd968ad0 100644 --- a/client/src/main/java/com/vaadin/client/ui/menubar/MenuItem.java +++ b/client/src/main/java/com/vaadin/client/ui/menubar/MenuItem.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -18,13 +18,13 @@ package com.vaadin.client.ui.menubar; /* * Copyright 2007 Google Inc. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -43,7 +43,7 @@ import com.google.gwt.user.client.ui.UIObject; * {@link com.google.gwt.user.client.ui.MenuBar}. Menu items can either fire a * {@link com.google.gwt.user.client.Command} when they are clicked, or open a * cascading sub-menu. - * + * * @deprecated */ @Deprecated @@ -56,7 +56,7 @@ public class MenuItem extends UIObject implements HasHTML { /** * Constructs a new menu item that fires a command when it is selected. - * + * * @param text * the item's text * @param cmd @@ -69,7 +69,7 @@ public class MenuItem extends UIObject implements HasHTML { /** * Constructs a new menu item that fires a command when it is selected. - * + * * @param text * the item's text * @param asHTML @@ -85,7 +85,7 @@ public class MenuItem extends UIObject implements HasHTML { /** * Constructs a new menu item that cascades to a sub-menu when it is * selected. - * + * * @param text * the item's text * @param subMenu @@ -99,7 +99,7 @@ public class MenuItem extends UIObject implements HasHTML { /** * Constructs a new menu item that cascades to a sub-menu when it is * selected. - * + * * @param text * the item's text * @param asHTML @@ -126,7 +126,7 @@ public class MenuItem extends UIObject implements HasHTML { /** * Gets the command associated with this item. - * + * * @return this item's command, or <code>null</code> if none exists */ public Command getCommand() { @@ -140,7 +140,7 @@ public class MenuItem extends UIObject implements HasHTML { /** * Gets the menu that contains this item. - * + * * @return the parent menu, or <code>null</code> if none exists. */ public MenuBar getParentMenu() { @@ -149,7 +149,7 @@ public class MenuItem extends UIObject implements HasHTML { /** * Gets the sub-menu associated with this item. - * + * * @return this item's sub-menu, or <code>null</code> if none exists */ public MenuBar getSubMenu() { @@ -163,7 +163,7 @@ public class MenuItem extends UIObject implements HasHTML { /** * Sets the command associated with this item. - * + * * @param cmd * the command to be associated with this item */ @@ -178,7 +178,7 @@ public class MenuItem extends UIObject implements HasHTML { /** * Sets the sub-menu associated with this item. - * + * * @param subMenu * this item's new sub-menu */ diff --git a/client/src/main/java/com/vaadin/client/ui/nativebutton/NativeButtonConnector.java b/client/src/main/java/com/vaadin/client/ui/nativebutton/NativeButtonConnector.java index 6a9ba4a824..81823c3d3c 100644 --- a/client/src/main/java/com/vaadin/client/ui/nativebutton/NativeButtonConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/nativebutton/NativeButtonConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/nativeselect/NativeSelectConnector.java b/client/src/main/java/com/vaadin/client/ui/nativeselect/NativeSelectConnector.java index d6ff2015b4..4adc233cdf 100644 --- a/client/src/main/java/com/vaadin/client/ui/nativeselect/NativeSelectConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/nativeselect/NativeSelectConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/optiongroup/OptionGroupBaseConnector.java b/client/src/main/java/com/vaadin/client/ui/optiongroup/OptionGroupBaseConnector.java index f4dd34f0c8..37c563db33 100644 --- a/client/src/main/java/com/vaadin/client/ui/optiongroup/OptionGroupBaseConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/optiongroup/OptionGroupBaseConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/optiongroup/OptionGroupConnector.java b/client/src/main/java/com/vaadin/client/ui/optiongroup/OptionGroupConnector.java index 1762d72abc..a9349ade4b 100644 --- a/client/src/main/java/com/vaadin/client/ui/optiongroup/OptionGroupConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/optiongroup/OptionGroupConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/orderedlayout/AbstractOrderedLayoutConnector.java b/client/src/main/java/com/vaadin/client/ui/orderedlayout/AbstractOrderedLayoutConnector.java index 7f37e65ee9..960bf71884 100644 --- a/client/src/main/java/com/vaadin/client/ui/orderedlayout/AbstractOrderedLayoutConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/orderedlayout/AbstractOrderedLayoutConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -169,7 +169,7 @@ public abstract class AbstractOrderedLayoutConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.AbstractComponentConnector#init() */ @Override @@ -180,7 +180,7 @@ public abstract class AbstractOrderedLayoutConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.AbstractLayoutConnector#getState() */ @Override @@ -190,7 +190,7 @@ public abstract class AbstractOrderedLayoutConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.AbstractComponentConnector#getWidget() */ @Override @@ -234,7 +234,7 @@ public abstract class AbstractOrderedLayoutConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.HasComponentsConnector#updateCaption(com.vaadin * .client.ComponentConnector) */ @@ -299,7 +299,7 @@ public abstract class AbstractOrderedLayoutConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.AbstractComponentContainerConnector# * onConnectorHierarchyChange * (com.vaadin.client.ConnectorHierarchyChangeEvent) @@ -367,7 +367,7 @@ public abstract class AbstractOrderedLayoutConnector /* * (non-Javadoc) - * + * * @see * com.vaadin.client.ui.AbstractComponentConnector#onStateChanged(com.vaadin * .client.communication.StateChangeEvent) @@ -385,7 +385,7 @@ public abstract class AbstractOrderedLayoutConnector /* * (non-Javadoc) - * + * * @see * com.vaadin.client.ui.AbstractComponentConnector#getTooltipInfo(com.google * .gwt.dom.client.Element) @@ -410,7 +410,7 @@ public abstract class AbstractOrderedLayoutConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.AbstractComponentConnector#hasTooltip() */ @Override @@ -601,7 +601,7 @@ public abstract class AbstractOrderedLayoutConnector * If the slot has caption, we need to listen for its size changes * in order to update the padding/margin offset for relative sized * components. - * + * * TODO might only be needed if the caption is in the same direction * as the relative size? */ @@ -692,7 +692,7 @@ public abstract class AbstractOrderedLayoutConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.AbstractComponentConnector#onUnregister() */ @Override diff --git a/client/src/main/java/com/vaadin/client/ui/orderedlayout/CaptionPosition.java b/client/src/main/java/com/vaadin/client/ui/orderedlayout/CaptionPosition.java index 885dc1ecd7..6a55491639 100644 --- a/client/src/main/java/com/vaadin/client/ui/orderedlayout/CaptionPosition.java +++ b/client/src/main/java/com/vaadin/client/ui/orderedlayout/CaptionPosition.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/orderedlayout/HorizontalLayoutConnector.java b/client/src/main/java/com/vaadin/client/ui/orderedlayout/HorizontalLayoutConnector.java index 9e339f1860..b84be60a1a 100644 --- a/client/src/main/java/com/vaadin/client/ui/orderedlayout/HorizontalLayoutConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/orderedlayout/HorizontalLayoutConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -30,7 +30,7 @@ public class HorizontalLayoutConnector extends AbstractOrderedLayoutConnector { /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.orderedlayout.AbstractOrderedLayoutConnector# * getWidget () */ diff --git a/client/src/main/java/com/vaadin/client/ui/orderedlayout/Slot.java b/client/src/main/java/com/vaadin/client/ui/orderedlayout/Slot.java index e9cf6a0448..2315f0bc4b 100644 --- a/client/src/main/java/com/vaadin/client/ui/orderedlayout/Slot.java +++ b/client/src/main/java/com/vaadin/client/ui/orderedlayout/Slot.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -90,10 +90,10 @@ public class Slot extends SimplePanel { /** * Constructs a slot. - * + * * When using this constructor, the layout and widget must be set before any * other operations are performed on the slot. - * + * * @since 7.6 */ public Slot() { @@ -103,10 +103,10 @@ public class Slot extends SimplePanel { /** * Set the layout in which this slot is. This method must be called exactly * once at slot construction time when using the default constructor. - * + * * The method should normally only be called by * {@link VAbstractOrderedLayout#createSlot(Widget)}. - * + * * @since 7.6 * @param layout * the layout containing the slot @@ -117,7 +117,7 @@ public class Slot extends SimplePanel { /** * Constructs a slot. - * + * * @param layout * The layout to which this slot belongs * @param widget @@ -134,7 +134,7 @@ public class Slot extends SimplePanel { /* * (non-Javadoc) - * + * * @see com.google.gwt.user.client.ui.SimplePanel#remove(com.google.gwt.user * .client.ui.Widget) */ @@ -146,7 +146,7 @@ public class Slot extends SimplePanel { /* * (non-Javadoc) - * + * * @see com.google.gwt.user.client.ui.SimplePanel#setWidget(com.google.gwt * .user.client.ui.Widget) */ @@ -246,7 +246,7 @@ public class Slot extends SimplePanel { /** * Returns the alignment for the slot - * + * */ public AlignmentInfo getAlignment() { return alignment; @@ -254,7 +254,7 @@ public class Slot extends SimplePanel { /** * Sets the style names for the slot containing the widget - * + * * @param stylenames * The style names for the slot */ @@ -272,7 +272,7 @@ public class Slot extends SimplePanel { /** * Sets how the widget is aligned inside the slot - * + * * @param alignment * The alignment inside the slot */ @@ -308,10 +308,10 @@ public class Slot extends SimplePanel { * the expand ratios but instead be allocated space based on its natural * size. Other values causes the slot to get a share of the otherwise * unallocated space in proportion to the slot's expand ratio value. - * + * * @param expandRatio * The ratio of the space the slot should occupy - * + * */ public void setExpandRatio(double expandRatio) { this.expandRatio = expandRatio; @@ -320,9 +320,9 @@ public class Slot extends SimplePanel { /** * Get the expand ratio for the slot. The expand ratio describes how the * slot should be resized compared to other slots in the layout - * + * * @return the expand ratio of the slot - * + * * @see #setExpandRatio(double) */ public double getExpandRatio() { @@ -332,7 +332,7 @@ public class Slot extends SimplePanel { /** * Set the spacing for the slot. The spacing determines if there should be * empty space around the slot when the slot. - * + * * @param spacing * Should spacing be enabled */ @@ -360,7 +360,7 @@ public class Slot extends SimplePanel { /** * Get the element which is added to make the spacing - * + * * @return */ public com.google.gwt.user.client.Element getSpacingElement() { @@ -388,7 +388,7 @@ public class Slot extends SimplePanel { /** * Get the horizontal amount of pixels of the spacing - * + * * @return */ protected int getHorizontalSpacing() { @@ -402,7 +402,7 @@ public class Slot extends SimplePanel { /** * Set the position of the caption relative to the slot - * + * * @param captionPosition * The position of the caption */ @@ -434,7 +434,7 @@ public class Slot extends SimplePanel { /** * Set the caption of the slot - * + * * @param captionText * The text of the caption * @param iconUrl @@ -449,7 +449,7 @@ public class Slot extends SimplePanel { * Is the (field) required * @param enabled * Is the component enabled - * + * * @deprecated Use * {@link #setCaption(String, Icon, List, String, boolean, boolean, boolean)} * instead @@ -472,7 +472,7 @@ public class Slot extends SimplePanel { /** * Set the caption of the slot as text - * + * * @param captionText * The text of the caption * @param icon @@ -497,7 +497,7 @@ public class Slot extends SimplePanel { /** * Set the caption of the slot - * + * * @param captionText * The text of the caption * @param icon @@ -701,7 +701,7 @@ public class Slot extends SimplePanel { /** * Set if the slot has a relative width - * + * * @param relativeWidth * True if slot uses relative width, false if the slot has a * static width @@ -719,7 +719,7 @@ public class Slot extends SimplePanel { /** * Set if the slot has a relative height - * + * * @param relativeHeight * True if the slot uses a relative height, false if the slot has * a static height @@ -735,7 +735,7 @@ public class Slot extends SimplePanel { /** * Updates the captions size if the slot is relative - * + * * @param isRelativeSize * Is the slot relatively sized * @param direction @@ -766,7 +766,7 @@ public class Slot extends SimplePanel { /* * (non-Javadoc) - * + * * @see com.google.gwt.user.client.ui.Widget#onBrowserEvent(com.google.gwt * .user.client.Event) */ @@ -785,7 +785,7 @@ public class Slot extends SimplePanel { /* * (non-Javadoc) - * + * * @see com.google.gwt.user.client.ui.SimplePanel#getContainerElement() */ @Override @@ -799,7 +799,7 @@ public class Slot extends SimplePanel { /* * (non-Javadoc) - * + * * @see com.google.gwt.user.client.ui.Widget#onDetach() */ @Override @@ -812,7 +812,7 @@ public class Slot extends SimplePanel { /* * (non-Javadoc) - * + * * @see com.google.gwt.user.client.ui.Widget#onAttach() */ @Override diff --git a/client/src/main/java/com/vaadin/client/ui/orderedlayout/VAbstractOrderedLayout.java b/client/src/main/java/com/vaadin/client/ui/orderedlayout/VAbstractOrderedLayout.java index 02e4e651a3..bea0d19d95 100644 --- a/client/src/main/java/com/vaadin/client/ui/orderedlayout/VAbstractOrderedLayout.java +++ b/client/src/main/java/com/vaadin/client/ui/orderedlayout/VAbstractOrderedLayout.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -67,10 +67,10 @@ public class VAbstractOrderedLayout extends FlowPanel { /** * See the method {@link #addOrMoveSlot(Slot, int, boolean)}. - * + * * <p> * This method always adjusts spacings for the whole layout. - * + * * @param slot * The slot to move or add * @param index @@ -93,7 +93,7 @@ public class VAbstractOrderedLayout extends FlowPanel { * <p> * For instance when using spacing the index converts to DOM index in the * following way: - * + * * <pre> * index : 0 -> DOM index: 0 * index : 1 -> DOM index: 1 @@ -101,16 +101,16 @@ public class VAbstractOrderedLayout extends FlowPanel { * index : 3 -> DOM index: 5 * index : 4 -> DOM index: 7 * </pre> - * + * * When using this method never account for spacings. * <p> * The caller should remove all spacings before calling this method and * re-add them (if necessary) after this method. This can be done before and * after all slots have been added/moved. * </p> - * + * * @since 7.1.4 - * + * * @param slot * The slot to move or add * @param index @@ -148,7 +148,7 @@ public class VAbstractOrderedLayout extends FlowPanel { /** * {@inheritDoc} - * + * * @deprecated As of 7.2, use or override * {@link #insert(Widget, Element, int, boolean)} instead. */ @@ -177,11 +177,11 @@ public class VAbstractOrderedLayout extends FlowPanel { * Since the spacing elements are located at the same DOM * level as the slots we need to take them into account when * calculating the slot position. - * + * * The spacing elements are always located before the actual * slot except for the first slot which do not have a * spacing element like this - * + * * |<slot1><spacing2><slot2><spacing3><slot3>...| */ beforeIndex = beforeIndex * 2 - 1; @@ -198,7 +198,7 @@ public class VAbstractOrderedLayout extends FlowPanel { /** * {@inheritDoc} - * + * * @since 7.2 */ @Override @@ -209,7 +209,7 @@ public class VAbstractOrderedLayout extends FlowPanel { /** * Remove a slot from the layout - * + * * @param widget * @return */ @@ -222,11 +222,11 @@ public class VAbstractOrderedLayout extends FlowPanel { /** * Remove a slot from the layout. - * + * * This method is called automatically by {@link #removeWidget(Widget)} and * should not be called directly by the user. When overridden, the super * method must be called. - * + * * @since 7.6 * @param Slot * to remove @@ -238,10 +238,10 @@ public class VAbstractOrderedLayout extends FlowPanel { /** * Get the containing slot for a widget. If no slot is found a new slot is * created and returned. - * + * * @param widget * The widget whose slot you want to get - * + * * @return */ public Slot getSlot(Widget widget) { @@ -255,11 +255,11 @@ public class VAbstractOrderedLayout extends FlowPanel { /** * Create a slot to be added to the layout. - * + * * This method is called automatically by {@link #getSlot(Widget)} when a * new slot is needed. It should not be called directly by the user, but can * be overridden to customize slot creation. - * + * * @since 7.6 * @param widget * the widget for which a slot is being created @@ -275,7 +275,7 @@ public class VAbstractOrderedLayout extends FlowPanel { /** * Gets a slot based on the widget element. If no slot is found then null is * returned. - * + * * @param widgetElement * The element of the widget ( Same as getWidget().getElement() ) * @return @@ -294,11 +294,11 @@ public class VAbstractOrderedLayout extends FlowPanel { /** * Gets a slot based on the widget element. If no slot is found then null is * returned. - * + * * @param widgetElement * The element of the widget ( Same as getWidget().getElement() ) * @return - * + * * @since 7.2 */ public Slot getSlot(Element widgetElement) { @@ -307,7 +307,7 @@ public class VAbstractOrderedLayout extends FlowPanel { /** * Set the layout manager for the layout - * + * * @param manager * The layout manager to use */ @@ -317,7 +317,7 @@ public class VAbstractOrderedLayout extends FlowPanel { /** * Get the layout manager used by this layout - * + * */ public LayoutManager getLayoutManager() { return layoutManager; @@ -327,10 +327,10 @@ public class VAbstractOrderedLayout extends FlowPanel { * Deducts the caption position by examining the wrapping element. * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param captionWrap * The wrapping element - * + * * @return The caption position * @deprecated As of 7.2, call or override * {@link #getCaptionPositionFromElement(Element)} instead @@ -356,10 +356,10 @@ public class VAbstractOrderedLayout extends FlowPanel { * Deducts the caption position by examining the wrapping element. * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param captionWrap * The wrapping element - * + * * @return The caption position * @since 7.2 */ @@ -371,7 +371,7 @@ public class VAbstractOrderedLayout extends FlowPanel { * Update the offset off the caption relative to the slot * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param caption * The caption element * @deprecated As of 7.2, call or override @@ -443,7 +443,7 @@ public class VAbstractOrderedLayout extends FlowPanel { * Update the offset off the caption relative to the slot * <p> * For internal use only. May be removed or replaced in the future. - * + * * @param caption * The caption element * @since 7.2 @@ -454,7 +454,7 @@ public class VAbstractOrderedLayout extends FlowPanel { /** * Set the margin of the layout - * + * * @param marginInfo * The margin information */ @@ -469,7 +469,7 @@ public class VAbstractOrderedLayout extends FlowPanel { /** * Turn on or off spacing in the layout - * + * * @param spacing * True if spacing should be used, false if not */ @@ -634,7 +634,7 @@ public class VAbstractOrderedLayout extends FlowPanel { * is not considered for relative sizes and a corresponding negative * margin for the unexpanded slots. We calculate the size by summing * the size of all non-expanded non-relative slots. - * + * * Relatively sized slots without expansion are considered to get * 0px, but we still keep them visible (causing overflows) to help * the developer see what's happening. Forcing them to only get 0px @@ -733,7 +733,7 @@ public class VAbstractOrderedLayout extends FlowPanel { /** * Sets the slots style names. The style names will be prefixed with the * v-slot prefix. - * + * * @param stylenames * The style names of the slot. */ diff --git a/client/src/main/java/com/vaadin/client/ui/orderedlayout/VerticalLayoutConnector.java b/client/src/main/java/com/vaadin/client/ui/orderedlayout/VerticalLayoutConnector.java index 56a639692c..02669c3d98 100644 --- a/client/src/main/java/com/vaadin/client/ui/orderedlayout/VerticalLayoutConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/orderedlayout/VerticalLayoutConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -30,7 +30,7 @@ public class VerticalLayoutConnector extends AbstractOrderedLayoutConnector { /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.orderedlayout.AbstractOrderedLayoutConnector# * getWidget () */ diff --git a/client/src/main/java/com/vaadin/client/ui/panel/PanelConnector.java b/client/src/main/java/com/vaadin/client/ui/panel/PanelConnector.java index 839a9fd3b8..5766851bba 100644 --- a/client/src/main/java/com/vaadin/client/ui/panel/PanelConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/panel/PanelConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/passwordfield/PasswordFieldConnector.java b/client/src/main/java/com/vaadin/client/ui/passwordfield/PasswordFieldConnector.java index c8ce124315..4df8ac59ca 100644 --- a/client/src/main/java/com/vaadin/client/ui/passwordfield/PasswordFieldConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/passwordfield/PasswordFieldConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/popupview/PopupViewConnector.java b/client/src/main/java/com/vaadin/client/ui/popupview/PopupViewConnector.java index 02ec2ab243..b29c22529b 100644 --- a/client/src/main/java/com/vaadin/client/ui/popupview/PopupViewConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/popupview/PopupViewConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/popupview/VisibilityChangeEvent.java b/client/src/main/java/com/vaadin/client/ui/popupview/VisibilityChangeEvent.java index 8db2d1cb85..0bbdd39adf 100644 --- a/client/src/main/java/com/vaadin/client/ui/popupview/VisibilityChangeEvent.java +++ b/client/src/main/java/com/vaadin/client/ui/popupview/VisibilityChangeEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/popupview/VisibilityChangeHandler.java b/client/src/main/java/com/vaadin/client/ui/popupview/VisibilityChangeHandler.java index 3c5e09d1fc..b557cbec4d 100644 --- a/client/src/main/java/com/vaadin/client/ui/popupview/VisibilityChangeHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/popupview/VisibilityChangeHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/progressindicator/ProgressBarConnector.java b/client/src/main/java/com/vaadin/client/ui/progressindicator/ProgressBarConnector.java index 3a83430f7a..010a948b90 100644 --- a/client/src/main/java/com/vaadin/client/ui/progressindicator/ProgressBarConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/progressindicator/ProgressBarConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -25,7 +25,7 @@ import com.vaadin.ui.ProgressBar; /** * Connector for {@link VProgressBar}. - * + * * @since 7.1 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/ui/progressindicator/ProgressIndicatorConnector.java b/client/src/main/java/com/vaadin/client/ui/progressindicator/ProgressIndicatorConnector.java index 36bb1dd6b2..bbef5a0bf2 100644 --- a/client/src/main/java/com/vaadin/client/ui/progressindicator/ProgressIndicatorConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/progressindicator/ProgressIndicatorConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -27,7 +27,7 @@ import com.vaadin.ui.ProgressIndicator; /** * Connector for {@link VProgressBar} with polling support. - * + * * @since 7.0 * @author Vaadin Ltd * @deprecated as of 7.1, use {@link ProgressBarConnector} combined with server diff --git a/client/src/main/java/com/vaadin/client/ui/richtextarea/VRichTextToolbar.java b/client/src/main/java/com/vaadin/client/ui/richtextarea/VRichTextToolbar.java index 005bb80fa3..690d8cdacf 100644 --- a/client/src/main/java/com/vaadin/client/ui/richtextarea/VRichTextToolbar.java +++ b/client/src/main/java/com/vaadin/client/ui/richtextarea/VRichTextToolbar.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -320,7 +320,7 @@ public class VRichTextToolbar extends Composite { /** * Creates a new toolbar that drives the given rich text area. - * + * * @param richText * the rich text area to be controlled */ diff --git a/client/src/main/java/com/vaadin/client/ui/slider/SliderConnector.java b/client/src/main/java/com/vaadin/client/ui/slider/SliderConnector.java index a5e1ef1cb6..1128ba5100 100644 --- a/client/src/main/java/com/vaadin/client/ui/slider/SliderConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/slider/SliderConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/splitpanel/AbstractSplitPanelConnector.java b/client/src/main/java/com/vaadin/client/ui/splitpanel/AbstractSplitPanelConnector.java index ba4ec20662..b9ae29a89e 100644 --- a/client/src/main/java/com/vaadin/client/ui/splitpanel/AbstractSplitPanelConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/splitpanel/AbstractSplitPanelConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/splitpanel/HorizontalSplitPanelConnector.java b/client/src/main/java/com/vaadin/client/ui/splitpanel/HorizontalSplitPanelConnector.java index 75389b6cc4..a31cb979ad 100644 --- a/client/src/main/java/com/vaadin/client/ui/splitpanel/HorizontalSplitPanelConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/splitpanel/HorizontalSplitPanelConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/splitpanel/VerticalSplitPanelConnector.java b/client/src/main/java/com/vaadin/client/ui/splitpanel/VerticalSplitPanelConnector.java index e95f7143ba..5daf738c4e 100644 --- a/client/src/main/java/com/vaadin/client/ui/splitpanel/VerticalSplitPanelConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/splitpanel/VerticalSplitPanelConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/table/TableConnector.java b/client/src/main/java/com/vaadin/client/ui/table/TableConnector.java index 66ac86bf31..87685f3e15 100644 --- a/client/src/main/java/com/vaadin/client/ui/table/TableConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/table/TableConnector.java @@ -73,7 +73,7 @@ public class TableConnector extends AbstractFieldConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.AbstractComponentConnector#onUnregister() */ @Override @@ -143,7 +143,7 @@ public class TableConnector extends AbstractFieldConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.Paintable#updateFromUIDL(com.vaadin.client.UIDL, * com.vaadin.client.ApplicationConnection) */ @@ -461,7 +461,7 @@ public class TableConnector extends AbstractFieldConnector /** * Shows a saved row context menu if the row for the context menu is still * visible. Does nothing if a context menu has not been saved. - * + * * @param savedContextMenu */ public void showSavedContextMenu(ContextMenuDetails savedContextMenu) { diff --git a/client/src/main/java/com/vaadin/client/ui/tabsheet/TabsheetBaseConnector.java b/client/src/main/java/com/vaadin/client/ui/tabsheet/TabsheetBaseConnector.java index e1195ea8fe..e149235b6f 100644 --- a/client/src/main/java/com/vaadin/client/ui/tabsheet/TabsheetBaseConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/tabsheet/TabsheetBaseConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -31,7 +31,7 @@ public abstract class TabsheetBaseConnector /* * (non-Javadoc) - * + * * @see com.vaadin.client.ui.AbstractConnector#init() */ @Override @@ -43,7 +43,7 @@ public abstract class TabsheetBaseConnector /* * (non-Javadoc) - * + * * @see * com.vaadin.client.ui.AbstractComponentConnector#onStateChanged(com.vaadin * .client.communication.StateChangeEvent) diff --git a/client/src/main/java/com/vaadin/client/ui/tabsheet/TabsheetConnector.java b/client/src/main/java/com/vaadin/client/ui/tabsheet/TabsheetConnector.java index f2b3823af6..1dcb517e96 100644 --- a/client/src/main/java/com/vaadin/client/ui/tabsheet/TabsheetConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/tabsheet/TabsheetConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -60,7 +60,7 @@ public class TabsheetConnector extends TabsheetBaseConnector /* * (non-Javadoc) - * + * * @see * com.vaadin.client.ui.AbstractComponentConnector#onStateChanged(com.vaadin * .client.communication.StateChangeEvent) diff --git a/client/src/main/java/com/vaadin/client/ui/textfield/TextFieldConnector.java b/client/src/main/java/com/vaadin/client/ui/textfield/TextFieldConnector.java index 4d0057ed0e..ad521b606b 100644 --- a/client/src/main/java/com/vaadin/client/ui/textfield/TextFieldConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/textfield/TextFieldConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/tree/TreeConnector.java b/client/src/main/java/com/vaadin/client/ui/tree/TreeConnector.java index b034780196..8738120801 100644 --- a/client/src/main/java/com/vaadin/client/ui/tree/TreeConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/tree/TreeConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -222,7 +222,7 @@ public class TreeConnector extends AbstractComponentConnector /** * Registers action for the root and also for individual nodes - * + * * @param uidl */ private void updateActionMap(UIDL uidl) { diff --git a/client/src/main/java/com/vaadin/client/ui/tree/VTargetInSubtree.java b/client/src/main/java/com/vaadin/client/ui/tree/VTargetInSubtree.java index 01ae22ce8e..7dc30fef49 100644 --- a/client/src/main/java/com/vaadin/client/ui/tree/VTargetInSubtree.java +++ b/client/src/main/java/com/vaadin/client/ui/tree/VTargetInSubtree.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -14,7 +14,7 @@ * the License. */ /** - * + * */ package com.vaadin.client.ui.tree; diff --git a/client/src/main/java/com/vaadin/client/ui/treetable/TreeTableConnector.java b/client/src/main/java/com/vaadin/client/ui/treetable/TreeTableConnector.java index 555e86f510..410787fe27 100644 --- a/client/src/main/java/com/vaadin/client/ui/treetable/TreeTableConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/treetable/TreeTableConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/twincolselect/TwinColSelectConnector.java b/client/src/main/java/com/vaadin/client/ui/twincolselect/TwinColSelectConnector.java index 599c522eca..b0e6232f88 100644 --- a/client/src/main/java/com/vaadin/client/ui/twincolselect/TwinColSelectConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/twincolselect/TwinColSelectConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/ui/UIConnector.java b/client/src/main/java/com/vaadin/client/ui/ui/UIConnector.java index 66e1fa46cc..d94f030d26 100644 --- a/client/src/main/java/com/vaadin/client/ui/ui/UIConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/ui/UIConnector.java @@ -416,7 +416,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector /** * Reads CSS strings and resources injected by {@link Styles#inject} from * the UIDL stream. - * + * * @param uidl * The uidl which contains "css-resource" and "css-string" tags */ @@ -451,7 +451,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector /** * Internal helper to get the <head> tag of the page - * + * * @since 7.3 * @return the head element */ @@ -462,7 +462,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector /** * Internal helper for removing any stylesheet with the given URL - * + * * @since 7.3 * @param url * the url to match with existing stylesheets @@ -620,7 +620,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector /** * Checks if the given sub window is a child of this UI Connector - * + * * @deprecated Should be replaced by a more generic mechanism for getting * non-ComponentConnector children * @param wc @@ -634,7 +634,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector /** * Return an iterator for current subwindows. This method is meant for * testing purposes only. - * + * * @return */ public List<WindowConnector> getSubWindows() { @@ -661,7 +661,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector * public API instead of their state object directly. The page state might * not be an independent state object but can be embedded in UI state. * </p> - * + * * @since 7.1 * @return state object of the page */ @@ -739,10 +739,10 @@ public class UIConnector extends AbstractSingleComponentContainerConnector /** * Tries to scroll the viewport so that the given connector is in view. - * + * * @param componentConnector * The connector which should be visible - * + * */ public void scrollIntoView(final ComponentConnector componentConnector) { if (componentConnector == null) { @@ -840,7 +840,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector /** * Invokes the layout analyzer on the server - * + * * @since 7.1 */ public void analyzeLayouts() { @@ -851,7 +851,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector * Sends a request to the server to print details to console that will help * the developer to locate the corresponding server-side connector in the * source code. - * + * * @since 7.1 * @param serverConnector * the connector to locate @@ -864,7 +864,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector /** * Sends a request to the server to print a design to the console for the * given component. - * + * * @since 7.5 * @param connector * the component connector to output a declarative design for @@ -909,7 +909,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector /** * Loads the new theme and removes references to the old theme - * + * * @since 7.4.3 * @param oldTheme * The name of the old theme @@ -972,7 +972,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector /** * Finds a link tag for a style sheet with the given URL - * + * * @since 7.3 * @param url * the URL of the style sheet @@ -995,7 +995,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector /** * Loads the given theme and replaces the given link element with the new * theme link element. - * + * * @param newTheme * The name of the new theme * @param newThemeUrl @@ -1042,7 +1042,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector /** * Activates the new theme. Assumes the theme has been loaded and taken into * use in the browser. - * + * * @since 7.4.3 * @param newTheme * The name of the new theme @@ -1078,9 +1078,9 @@ public class UIConnector extends AbstractSingleComponentContainerConnector /** * Force a full recursive recheck of every connector's state variables. - * + * * @see #forceStateChange() - * + * * @since 7.3 */ protected static void forceStateChangeRecursively( @@ -1101,7 +1101,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector /** * Internal helper to get the theme URL for a given theme - * + * * @since 7.3 * @param theme * the name of the theme @@ -1119,7 +1119,7 @@ public class UIConnector extends AbstractSingleComponentContainerConnector /** * Returns the name of the theme currently in used by the UI - * + * * @since 7.3 * @return the theme name used by this UI */ diff --git a/client/src/main/java/com/vaadin/client/ui/upload/UploadConnector.java b/client/src/main/java/com/vaadin/client/ui/upload/UploadConnector.java index f5f2033d69..6e05387c1d 100644 --- a/client/src/main/java/com/vaadin/client/ui/upload/UploadConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/upload/UploadConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/upload/UploadIFrameOnloadStrategy.java b/client/src/main/java/com/vaadin/client/ui/upload/UploadIFrameOnloadStrategy.java index 2c2e10594d..4563f9a137 100644 --- a/client/src/main/java/com/vaadin/client/ui/upload/UploadIFrameOnloadStrategy.java +++ b/client/src/main/java/com/vaadin/client/ui/upload/UploadIFrameOnloadStrategy.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/upload/UploadIFrameOnloadStrategyIE.java b/client/src/main/java/com/vaadin/client/ui/upload/UploadIFrameOnloadStrategyIE.java index 0c114e2ee7..071c9cfef2 100644 --- a/client/src/main/java/com/vaadin/client/ui/upload/UploadIFrameOnloadStrategyIE.java +++ b/client/src/main/java/com/vaadin/client/ui/upload/UploadIFrameOnloadStrategyIE.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.ui.VUpload; /** * IE does not have onload, detect onload via readystatechange - * + * */ public class UploadIFrameOnloadStrategyIE extends UploadIFrameOnloadStrategy { @Override diff --git a/client/src/main/java/com/vaadin/client/ui/video/VideoConnector.java b/client/src/main/java/com/vaadin/client/ui/video/VideoConnector.java index de53368d6a..ee9fba950f 100644 --- a/client/src/main/java/com/vaadin/client/ui/video/VideoConnector.java +++ b/client/src/main/java/com/vaadin/client/ui/video/VideoConnector.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/main/java/com/vaadin/client/ui/window/WindowMoveEvent.java b/client/src/main/java/com/vaadin/client/ui/window/WindowMoveEvent.java index add7ee740f..498617cd30 100644 --- a/client/src/main/java/com/vaadin/client/ui/window/WindowMoveEvent.java +++ b/client/src/main/java/com/vaadin/client/ui/window/WindowMoveEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.google.gwt.event.shared.GwtEvent; /** * Event for window position updates - * + * * @since 7.1.9 * @author Vaadin Ltd */ @@ -32,7 +32,7 @@ public class WindowMoveEvent extends GwtEvent<WindowMoveHandler> { /** * Creates a new event with the given parameters - * + * * @param x * The new x-position for the VWindow * @param y @@ -45,7 +45,7 @@ public class WindowMoveEvent extends GwtEvent<WindowMoveHandler> { /** * Gets the new x position of the window - * + * * @return the new X position of the VWindow */ public int getNewX() { @@ -54,7 +54,7 @@ public class WindowMoveEvent extends GwtEvent<WindowMoveHandler> { /** * Gets the new y position of the window - * + * * @return the new Y position of the VWindow */ public int getNewY() { @@ -63,7 +63,7 @@ public class WindowMoveEvent extends GwtEvent<WindowMoveHandler> { /** * Gets the type of the event - * + * * @return the type of the event */ public static Type<WindowMoveHandler> getType() { diff --git a/client/src/main/java/com/vaadin/client/ui/window/WindowMoveHandler.java b/client/src/main/java/com/vaadin/client/ui/window/WindowMoveHandler.java index 0ac348af68..381c67ba37 100644 --- a/client/src/main/java/com/vaadin/client/ui/window/WindowMoveHandler.java +++ b/client/src/main/java/com/vaadin/client/ui/window/WindowMoveHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.google.gwt.event.shared.EventHandler; /** * Handler for {@link WindowMoveEvent}s - * + * * @since 7.1.9 * @author Vaadin Ltd */ @@ -27,7 +27,7 @@ public interface WindowMoveHandler extends EventHandler { /** * Called when the VWindow was moved by the user. - * + * * @param event * Contains new coordinates for the VWindow */ diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/Cell.java b/client/src/main/java/com/vaadin/client/widget/escalator/Cell.java index 08dbcf6955..e965557d2c 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/Cell.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/Cell.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -25,7 +25,7 @@ import com.google.gwt.dom.client.TableCellElement; * <p> * Unlike the {@link FlyweightRow}, an instance of {@link Cell} can be stored in * a field. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -39,7 +39,7 @@ public class Cell { /** * Constructs a new {@link Cell}. - * + * * @param row * The index of the row * @param column @@ -56,9 +56,9 @@ public class Cell { /** * Returns the index of the row the cell resides in. - * + * * @return the row index - * + * */ public int getRow() { return row; @@ -66,7 +66,7 @@ public class Cell { /** * Returns the index of the column the cell resides in. - * + * * @return the column index */ public int getColumn() { @@ -75,7 +75,7 @@ public class Cell { /** * Returns the element of the cell. - * + * * @return the cell element */ public TableCellElement getElement() { diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/ColumnConfiguration.java b/client/src/main/java/com/vaadin/client/widget/escalator/ColumnConfiguration.java index 76f6a55b8a..8e37b63b89 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/ColumnConfiguration.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/ColumnConfiguration.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import java.util.Map; /** * A representation of the columns in an instance of {@link Escalator}. - * + * * @since 7.4 * @author Vaadin Ltd * @see Escalator#getColumnConfiguration() @@ -37,7 +37,7 @@ public interface ColumnConfiguration { * do much of anything else. Especially if you have column spans, you * probably need to run {@link #refreshColumns(int, int)} or * {@link RowContainer#refreshRows(int, int)} - * + * * @param index * the index of the first column to be removed * @param numberOfColumns @@ -71,7 +71,7 @@ public interface ColumnConfiguration { * columns (e.g. you have column spans), * {@link RowContainer#refreshRows(int, int)} or * {@link #refreshColumns(int, int)} needs to be called as appropriate. - * + * * @param index * the index of the column before which new columns are inserted, * or {@link #getColumnCount()} to add new columns at the end @@ -88,7 +88,7 @@ public interface ColumnConfiguration { /** * Returns the number of columns in the escalator. - * + * * @return the number of columns in the escalator */ public int getColumnCount(); @@ -96,27 +96,27 @@ public interface ColumnConfiguration { /** * Sets the number of leftmost columns that are not affected by horizontal * scrolling. - * + * * @param count * the number of columns to freeze - * + * * @throws IllegalArgumentException * if the column count is < 0 or > the number of columns - * + * */ public void setFrozenColumnCount(int count) throws IllegalArgumentException; /** * Get the number of leftmost columns that are not affected by horizontal * scrolling. - * + * * @return the number of frozen columns */ public int getFrozenColumnCount(); /** * Sets (or unsets) an explicit width for a column. - * + * * @param index * the index of the column for which to set a width * @param px @@ -130,7 +130,7 @@ public interface ColumnConfiguration { /** * Returns the user-defined width of a column. - * + * * @param index * the index of the column for which to retrieve the width * @return the column's width in pixels, or a negative number if the width @@ -142,7 +142,7 @@ public interface ColumnConfiguration { /** * Sets widths for a set of columns. - * + * * @param indexWidthMap * a map from column index to its respective width to be set. If * the given width for a column index is negative, the column is @@ -159,7 +159,7 @@ public interface ColumnConfiguration { /** * Returns the actual width of a column. - * + * * @param index * the index of the column for which to retrieve the width * @return the column's actual width in pixels @@ -175,7 +175,7 @@ public interface ColumnConfiguration { * <p> * The data for the refreshed columns is queried from the current cell * renderer. - * + * * @param index * the index of the first row that will be updated * @param numberOfRows diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/EscalatorUpdater.java b/client/src/main/java/com/vaadin/client/widget/escalator/EscalatorUpdater.java index 54507a7650..c26776015e 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/EscalatorUpdater.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/EscalatorUpdater.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -26,7 +26,7 @@ package com.vaadin.client.widget.escalator; * <p> * This has a similar function to {@link Grid Grid's} {@link Renderer Renderers} * , although they operate on different abstraction levels. - * + * * @since 7.4 * @author Vaadin Ltd * @see RowContainer#setEscalatorUpdater(EscalatorUpdater) @@ -84,7 +84,7 @@ public interface EscalatorUpdater { * <p> * For performance reasons, the escalator will never autonomously clear any * data in a cell. - * + * * @param row * Information about the row that is being updated. * <em>Note:</em> You should not store nor reuse this reference. @@ -97,7 +97,7 @@ public interface EscalatorUpdater { /** * Called before attaching new cells to the escalator. - * + * * @param row * Information about the row to which the cells will be added. * <em>Note:</em> You should not store nor reuse this reference. @@ -105,13 +105,13 @@ public interface EscalatorUpdater { * A collection of cells that are about to be attached. * <em>Note:</em> You should neither store nor reuse the * reference to the iterable, nor to the individual cells. - * + * */ public void preAttach(Row row, Iterable<FlyweightCell> cellsToAttach); /** * Called after attaching new cells to the escalator. - * + * * @param row * Information about the row to which the cells were added. * <em>Note:</em> You should not store nor reuse this reference. @@ -119,13 +119,13 @@ public interface EscalatorUpdater { * A collection of cells that were attached. <em>Note:</em> You * should neither store nor reuse the reference to the iterable, * nor to the individual cells. - * + * */ public void postAttach(Row row, Iterable<FlyweightCell> attachedCells); /** * Called before detaching cells from the escalator. - * + * * @param row * Information about the row from which the cells will be * removed. <em>Note:</em> You should not store nor reuse this @@ -134,13 +134,13 @@ public interface EscalatorUpdater { * A collection of cells that are about to be detached. * <em>Note:</em> You should neither store nor reuse the * reference to the iterable, nor to the individual cells. - * + * */ public void preDetach(Row row, Iterable<FlyweightCell> cellsToDetach); /** * Called after detaching cells from the escalator. - * + * * @param row * Information about the row from which the cells were removed. * <em>Note:</em> You should not store nor reuse this reference. @@ -148,7 +148,7 @@ public interface EscalatorUpdater { * A collection of cells that were detached. <em>Note:</em> You * should neither store nor reuse the reference to the iterable, * nor to the individual cells. - * + * */ public void postDetach(Row row, Iterable<FlyweightCell> detachedCells); diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/FlyweightCell.java b/client/src/main/java/com/vaadin/client/widget/escalator/FlyweightCell.java index eba20f83f9..8e18c0f2c7 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/FlyweightCell.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/FlyweightCell.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -26,13 +26,13 @@ import com.vaadin.client.widgets.Escalator; /** * A {@link FlyweightCell} represents a cell in the {@link Grid} or * {@link Escalator} at a certain point in time. - * + * * <p> * Since the {@link FlyweightCell} follows the <code>Flyweight</code>-pattern * any instance of this object is subject to change without the user knowing it * and so should not be stored anywhere outside of the method providing these * instances. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -87,7 +87,7 @@ public class FlyweightCell { * Sets the DOM element for this FlyweightCell, either a <code>TD</code> or * a <code>TH</code>. It is the caller's responsibility to actually insert * the given element to the document when needed. - * + * * @param element * the element corresponding to this cell, cannot be null */ @@ -126,7 +126,7 @@ public class FlyweightCell { * This should only be used with asserts (" * <code>assert flyweightCell.teardown()</code> ") so that the code is never * run when asserts aren't enabled. - * + * * @return always <code>true</code> * @see FlyweightRow#teardown() */ diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/FlyweightRow.java b/client/src/main/java/com/vaadin/client/widget/escalator/FlyweightRow.java index 832e40ebbc..f98747c3f8 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/FlyweightRow.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/FlyweightRow.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -27,7 +27,7 @@ import com.google.gwt.dom.client.TableRowElement; * <p> * There is only one instance per Escalator. This is designed to be re-used when * rendering rows. - * + * * @since 7.4 * @author Vaadin Ltd * @see Escalator.AbstractRowContainer#refreshRow(Node, int) @@ -45,7 +45,7 @@ public class FlyweightRow implements Row { * Creates a new iterator of attached flyweight cells. A cell is * attached if it has a corresponding {@link FlyweightCell#getElement() * DOM element} attached to the row element. - * + * * @param cells * the collection of cells to iterate */ @@ -59,7 +59,7 @@ public class FlyweightRow implements Row { * unattached if it does not have a corresponding * {@link FlyweightCell#getElement() DOM element} attached to the row * element. - * + * * @param cells * the collection of cells to iterate */ @@ -101,7 +101,7 @@ public class FlyweightRow implements Row { /** * Sets the number of cells to skip when {@link #next()} is called the * next time. Cell hiding is also handled eagerly in this method. - * + * * @param colspan * the number of cells to skip on next invocation of * {@link #next()} @@ -115,7 +115,7 @@ public class FlyweightRow implements Row { /** * Gets the next <code>n</code> cells in the iterator, ignoring any * possibly spanned cells. - * + * * @param n * the number of next cells to retrieve * @return A list of next <code>n</code> cells, or less if there aren't @@ -160,7 +160,7 @@ public class FlyweightRow implements Row { * This should only be used with asserts (" * <code>assert flyweightRow.teardown()</code> ") so that the code is never * run when asserts aren't enabled. - * + * * @return always <code>true</code> */ public boolean teardown() { @@ -211,9 +211,9 @@ public class FlyweightRow implements Row { * element. * <p> * Precondition: each cell has a corresponding element in the row - * + * * @return an iterable of flyweight cells - * + * * @see #setup(Element, int, int[]) * @see #teardown() */ @@ -227,7 +227,7 @@ public class FlyweightRow implements Row { * from the row element. * <p> * Precondition: each cell has a corresponding element in the row - * + * * @param offset * the index of the first cell to return * @param numberOfCells @@ -256,7 +256,7 @@ public class FlyweightRow implements Row { * invoke this method with correct parameters. * <p> * Precondition: the range [offset, offset + numberOfCells) must be valid - * + * * @param offset * the index of the first cell to return * @param numberOfCells diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/PositionFunction.java b/client/src/main/java/com/vaadin/client/widget/escalator/PositionFunction.java index 929f27df37..8ee1733c1c 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/PositionFunction.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/PositionFunction.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.google.gwt.dom.client.Style.Unit; /** * A functional interface that can be used for positioning elements in the DOM. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -97,7 +97,7 @@ public interface PositionFunction { /** * Position an element in an (x,y) coordinate system in the DOM. - * + * * @param e * the element to position. Never <code>null</code>. * @param x @@ -110,7 +110,7 @@ public interface PositionFunction { /** * Resets any previously applied positioning, clearing the used style * attributes. - * + * * @param e * the element for which to reset the positioning */ diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/Row.java b/client/src/main/java/com/vaadin/client/widget/escalator/Row.java index fa89853120..936f256b92 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/Row.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/Row.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,14 +20,14 @@ import com.google.gwt.dom.client.TableRowElement; /** * A representation of a row in an {@link Escalator}. - * + * * @since 7.4 * @author Vaadin Ltd */ public interface Row { /** * Gets the row index. - * + * * @return the row index */ public int getRow(); @@ -41,7 +41,7 @@ public interface Row { * If you wish to modify the cells within this row element, access them via * the <code>List<{@link Cell}></code> objects passed in to * {@code EscalatorUpdater.updateCells(Row, List)} - * + * * @return the root element of the row */ public TableRowElement getElement(); diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/RowContainer.java b/client/src/main/java/com/vaadin/client/widget/escalator/RowContainer.java index f81e71bf6c..89da37897c 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/RowContainer.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/RowContainer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -23,7 +23,7 @@ import com.google.gwt.dom.client.TableSectionElement; /** * A representation of the rows in each of the sections (header, body and * footer) in an {@link com.vaadin.client.widgets.Escalator}. - * + * * @since 7.4 * @author Vaadin Ltd * @see com.vaadin.client.widgets.Escalator#getHeader() @@ -38,7 +38,7 @@ public interface RowContainer { * {@link com.vaadin.client.widgets.Escalator}. * <p> * The body section can contain both rows and spacers. - * + * * @since 7.5.0 * @author Vaadin Ltd * @see com.vaadin.client.widgets.Escalator#getBody() @@ -54,7 +54,7 @@ public interface RowContainer { * <em>Note:</em> The row index for a spacer will change if rows are * inserted or removed above the current position. Spacers will also be * removed alongside their associated rows - * + * * @param rowIndex * the row index for the spacer to modify. The affected * spacer is underneath the given index. Use -1 to insert a @@ -77,7 +77,7 @@ public interface RowContainer { * {@link SpacerUpdater#destroy(Spacer) destroyed} with the previous * one, and {@link SpacerUpdater#init(Spacer) initialized} with the new * one. - * + * * @param spacerUpdater * the new spacer updater * @throws IllegalArgumentException @@ -90,7 +90,7 @@ public interface RowContainer { * Gets the spacer updater currently in use. * <p> * {@link SpacerUpdater#NULL} is the default. - * + * * @return the spacer updater currently in use. Never <code>null</code> */ SpacerUpdater getSpacerUpdater(); @@ -125,7 +125,7 @@ public interface RowContainer { /** * Returns the current {@link EscalatorUpdater} used to render cells. - * + * * @return the current escalator updater */ public EscalatorUpdater getEscalatorUpdater(); @@ -133,7 +133,7 @@ public interface RowContainer { /** * Sets the {@link EscalatorUpdater} to use when displaying data in the * escalator. - * + * * @param escalatorUpdater * the escalator updater to use to render cells. May not be * <code>null</code> @@ -146,7 +146,7 @@ public interface RowContainer { /** * Removes rows at a certain index in the current row container. - * + * * @param index * the index of the first row to be removed * @param numberOfRows @@ -176,7 +176,7 @@ public interface RowContainer { * If inserting new rows affects the contents of existing rows, * {@link #refreshRows(int, int)} needs to be called for those rows * separately. - * + * * @param index * the index of the row before which new rows are inserted, or * {@link #getRowCount()} to add rows at the end @@ -197,7 +197,7 @@ public interface RowContainer { * <p> * The data for the refreshed rows is queried from the current cell * renderer. - * + * * @param index * the index of the first row that will be updated * @param numberOfRows @@ -215,14 +215,14 @@ public interface RowContainer { /** * Gets the number of rows in the current row container. - * + * * @return the number of rows in the current row container */ public int getRowCount(); /** * The default height of the rows in this RowContainer. - * + * * @param px * the default height in pixels of the rows in this RowContainer * @throws IllegalArgumentException @@ -237,7 +237,7 @@ public interface RowContainer { * This value will be equal to {@link #INITIAL_DEFAULT_ROW_HEIGHT} if the * {@link Escalator} has not yet had a chance to autodetect the row height, * or no explicit value has yet given via {@link #setDefaultRowHeight(int)} - * + * * @return the default height of the rows in this RowContainer, in pixels * @see #setDefaultRowHeight(int) */ @@ -246,11 +246,11 @@ public interface RowContainer { /** * Returns the cell object which contains information about the cell the * element is in. - * + * * @param element * The element to get the cell for. If element is not present in * row container then <code>null</code> is returned. - * + * * @return the cell of the element, or <code>null</code> if element is not * present in the {@link RowContainer}. */ @@ -260,7 +260,7 @@ public interface RowContainer { * Gets the row element with given logical index. For lazy loaded containers * such as Escalators BodyRowContainer visibility should be checked before * calling this function. See {@link Escalator#getVisibleRowRange()}. - * + * * @param index * the logical index of the element to retrieve * @return the element at position {@code index} @@ -274,7 +274,7 @@ public interface RowContainer { /** * Returns the root element of RowContainer - * + * * @return RowContainer root element */ public TableSectionElement getElement(); diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/RowVisibilityChangeEvent.java b/client/src/main/java/com/vaadin/client/widget/escalator/RowVisibilityChangeEvent.java index 93738fc89b..2ee232aa1d 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/RowVisibilityChangeEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/RowVisibilityChangeEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.vaadin.shared.ui.grid.Range; /** * Event fired when the range of visible rows changes e.g. because of scrolling. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -36,7 +36,7 @@ public class RowVisibilityChangeEvent /** * Creates a new row visibility change event - * + * * @param firstVisibleRow * the index of the first visible row * @param visibleRowCount @@ -48,7 +48,7 @@ public class RowVisibilityChangeEvent /** * Gets the index of the first row that is at least partially visible. - * + * * @return the index of the first visible row */ public int getFirstVisibleRow() { @@ -57,7 +57,7 @@ public class RowVisibilityChangeEvent /** * Gets the number of at least partially visible rows. - * + * * @return the number of visible rows */ public int getVisibleRowCount() { @@ -66,7 +66,7 @@ public class RowVisibilityChangeEvent /** * Gets the range of visible rows. - * + * * @since 7.6 * @return the visible rows */ @@ -76,7 +76,7 @@ public class RowVisibilityChangeEvent /* * (non-Javadoc) - * + * * @see com.google.gwt.event.shared.GwtEvent#getAssociatedType() */ @Override @@ -86,7 +86,7 @@ public class RowVisibilityChangeEvent /* * (non-Javadoc) - * + * * @see * com.google.gwt.event.shared.GwtEvent#dispatch(com.google.gwt.event.shared * .EventHandler) diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/RowVisibilityChangeHandler.java b/client/src/main/java/com/vaadin/client/widget/escalator/RowVisibilityChangeHandler.java index 80a30184c0..2489fe6002 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/RowVisibilityChangeHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/RowVisibilityChangeHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.google.gwt.event.shared.EventHandler; /** * Event handler that gets notified when the range of visible rows changes e.g. * because of scrolling. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -29,7 +29,7 @@ public interface RowVisibilityChangeHandler extends EventHandler { /** * Called when the range of visible rows changes e.g. because of scrolling. - * + * * @param event * the row visibility change event describing the change */ diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/ScrollbarBundle.java b/client/src/main/java/com/vaadin/client/widget/escalator/ScrollbarBundle.java index 09f81251bd..45e5b11252 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/ScrollbarBundle.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/ScrollbarBundle.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -39,7 +39,7 @@ import com.vaadin.client.widget.grid.events.ScrollHandler; /** * An element-like bundle representing a configurable and visual scrollbar in * one axis. - * + * * @since 7.4 * @author Vaadin Ltd * @see VerticalScrollbarBundle @@ -59,16 +59,16 @@ public abstract class ScrollbarBundle implements DeferredWorker { * The weird thing is, that happens only once, and if you drag * scrollbar fast enough. After it has failed once, it never * fails again. - * + * * Theory: the user drags the scrollbar, and this command is * executed before the browser has a chance to fire a scroll * event (which normally would correct this situation). This * would explain why slow scrolling doesn't trigger the problem, * while fast scrolling does. - * + * * To make absolutely sure that we have the latest scroll * position, let's update the internal value. - * + * * This might lead to a slight performance hit (on my computer * it was never more than 3ms on either of Chrome 38 or Firefox * 31). It also _slightly_ counteracts the purpose of the @@ -130,7 +130,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * This method is called whenever the scrollbar handle's visibility is * changed in a {@link ScrollbarBundle}. - * + * * @param event * the {@link VisibilityChangeEvent} */ @@ -154,7 +154,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * Checks whether the scroll handle is currently visible or not - * + * * @return <code>true</code> if the scroll handle is currently visible. * <code>false</code> if not. */ @@ -186,7 +186,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * A representation of a single vertical scrollbar. - * + * * @see VerticalScrollbarBundle#getElement() */ public final static class VerticalScrollbarBundle extends ScrollbarBundle { @@ -256,7 +256,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * A representation of a single horizontal scrollbar. - * + * * @see HorizontalScrollbarBundle#getElement() */ public final static class HorizontalScrollbarBundle @@ -357,7 +357,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * Sets the primary style name - * + * * @param primaryStyleName * The primary style name to use */ @@ -367,7 +367,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * Gets the root element of this scrollbar-composition. - * + * * @return the root element */ public final Element getElement() { @@ -381,7 +381,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { * currently only used as integers as large {@code int} (or small but fast * {@code long}). This means, all values are truncated to zero decimal * places. - * + * * @param delta * the delta in pixels to change the scroll position by */ @@ -394,7 +394,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * Modifies {@link #root root's} dimensions in the axis the scrollbar is * representing. - * + * * @param px * the new size of {@link #root} in the dimension this scrollbar * is representing @@ -403,7 +403,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * Sets the length of the scrollbar. - * + * * @param px * the length of the scrollbar in pixels */ @@ -465,7 +465,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * Gets the length of the scrollbar - * + * * @return the length of the scrollbar in pixels */ public double getOffsetSize() { @@ -482,7 +482,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { * currently only used as integers as large {@code int} (or small but fast * {@code long}). This means, all values are truncated to zero decimal * places. - * + * * @param px * the new scroll position in pixels */ @@ -515,7 +515,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { * Should be called whenever this bundle is attached to the DOM (typically, * from the onLoad of the containing widget). Used to ensure the DOM scroll * position is maintained when detaching and reattaching the bundle. - * + * * @since 7.4.1 */ public void onLoad() { @@ -526,7 +526,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { * Truncates a double such that no decimal places are retained. * <p> * E.g. {@code trunc(2.3d) == 2.0d} and {@code trunc(-2.3d) == -2.0d}. - * + * * @param num * the double value to be truncated * @return the {@code num} value without any decimal digits @@ -546,7 +546,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { * double) by design. The browsers internally convert all double values into * an integer value. To make this fact explicit, this API has chosen to * force integers already at this level. - * + * * @param px * integer pixel value to scroll to */ @@ -555,7 +555,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * Gets the scroll position of the scrollbar in the axis the scrollbar is * representing. - * + * * @return the new scroll position in pixels */ public final double getScrollPos() { @@ -573,7 +573,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { * double) by design. The browsers internally convert all double values into * an integer value. To make this fact explicit, this API has chosen to * force integers already at this level. - * + * * @return integer pixel value of the scroll position */ protected abstract int internalGetScrollPos(); @@ -582,7 +582,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { * Modifies {@link #scrollSizeElement scrollSizeElement's} dimensions in * such a way that the scrollbar is able to scroll a certain number of * pixels in the axis it is representing. - * + * * @param px * the new size of {@link #scrollSizeElement} in the dimension * this scrollbar is representing @@ -592,7 +592,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * Sets the amount of pixels the scrollbar needs to be able to scroll * through. - * + * * @param px * the number of pixels the scrollbar should be able to scroll * through @@ -637,7 +637,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * Gets the amount of pixels the scrollbar needs to be able to scroll * through. - * + * * @return the number of pixels the scrollbar should be able to scroll * through */ @@ -648,7 +648,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * Modifies {@link #scrollSizeElement scrollSizeElement's} dimensions in the * opposite axis to what the scrollbar is representing. - * + * * @param px * the dimension that {@link #scrollSizeElement} should take in * the opposite axis to what the scrollbar is representing @@ -662,7 +662,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { * "invisible" scrollbar. This means, the DOM structure will be given a * non-zero size, but {@link #getScrollbarThickness()} will still return the * value 0. - * + * * @param px * the scrollbar's thickness in pixels */ @@ -689,7 +689,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * Gets the scrollbar's thickness as defined in the DOM. - * + * * @return the scrollbar's thickness as defined in the DOM, in pixels */ protected abstract String internalGetScrollbarThickness(); @@ -700,7 +700,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { * This value will differ from the value in the DOM, if the thickness was * set to 0 with {@link #setScrollbarThickness(double)}, as the scrollbar is * then treated as "invisible." - * + * * @return the scrollbar's thickness in pixels */ public final double getScrollbarThickness() { @@ -716,7 +716,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { * <p> * In other words, this method checks whether the contents is larger than * can visually fit in the element. - * + * * @return <code>true</code> iff the scrollbar's handle is visible */ public boolean showsScrollHandle() { @@ -764,7 +764,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * Adds handler for the scrollbar handle visibility. - * + * * @param handler * the {@link VisibilityHandler} to add * @return {@link HandlerRegistration} used to remove the handler @@ -789,7 +789,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { * Converts a double into an integer by JavaScript's terms. * <p> * Implementation copied from {@link Element#toInt32(double)}. - * + * * @param val * the double value to convert into an integer * @return the double value converted to an integer @@ -804,7 +804,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { * <p> * A locked scrollbar bundle will refuse to scroll, both programmatically * and via user-triggered events. - * + * * @param isLocked * <code>true</code> to lock, <code>false</code> to unlock */ @@ -814,7 +814,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * Checks whether the scrollbar bundle is locked or not. - * + * * @return <code>true</code> iff the scrollbar bundle is locked */ public boolean isLocked() { @@ -823,14 +823,14 @@ public abstract class ScrollbarBundle implements DeferredWorker { /** * Returns the scroll direction of this scrollbar bundle. - * + * * @return the scroll direction of this scrollbar bundle */ public abstract Direction getDirection(); /** * Adds a scroll handler to the scrollbar bundle. - * + * * @param handler * the handler to add * @return the registration object for the handler registration @@ -846,7 +846,7 @@ public abstract class ScrollbarBundle implements DeferredWorker { * element.getOffset*() because those values are 0 whenever display: * none. Because we know that all elements have populated * CSS-dimensions, it's better to do it that way. - * + * * Another solution would be to make the elements visible while * measuring and then re-hide them, but that would cause unnecessary * reflows that would probably kill the performance dead. diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/Spacer.java b/client/src/main/java/com/vaadin/client/widget/escalator/Spacer.java index 789a64a21e..000cd14f6c 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/Spacer.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/Spacer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.google.gwt.dom.client.Element; /** * A representation of a spacer element in a * {@link com.vaadin.client.widget.escalator.RowContainer.BodyRowContainer}. - * + * * @since 7.5.0 * @author Vaadin Ltd */ @@ -28,7 +28,7 @@ public interface Spacer { /** * Gets the root element for the spacer content. - * + * * @return the root element for the spacer content */ Element getElement(); @@ -40,7 +40,7 @@ public interface Spacer { /** * Gets the row index. - * + * * @return the row index. */ int getRow(); diff --git a/client/src/main/java/com/vaadin/client/widget/escalator/SpacerUpdater.java b/client/src/main/java/com/vaadin/client/widget/escalator/SpacerUpdater.java index 49adefd536..16a385f70a 100644 --- a/client/src/main/java/com/vaadin/client/widget/escalator/SpacerUpdater.java +++ b/client/src/main/java/com/vaadin/client/widget/escalator/SpacerUpdater.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -22,7 +22,7 @@ import com.vaadin.client.widget.escalator.RowContainer.BodyRowContainer; * <p> * The updater is responsible for making sure all elements are properly * constructed and cleaned up. - * + * * @since 7.5.0 * @author Vaadin Ltd * @see Spacer @@ -45,7 +45,7 @@ public interface SpacerUpdater { /** * Called whenever a spacer should be initialized with content. - * + * * @param spacer * the spacer reference that should be initialized */ @@ -56,7 +56,7 @@ public interface SpacerUpdater { * <p> * The structure to clean up is the same that has been constructed by * {@link #init(Spacer)}. - * + * * @param spacer * the spacer reference that should be destroyed */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/AutoScroller.java b/client/src/main/java/com/vaadin/client/widget/grid/AutoScroller.java index 858e4a17ac..1d8d2864c1 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/AutoScroller.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/AutoScroller.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -33,7 +33,7 @@ import com.vaadin.client.widgets.Grid; * A class for handling automatic scrolling vertically / horizontally in the * Grid when the cursor is close enough the edge of the body of the grid, * depending on the scroll direction chosen. - * + * * @since 7.5.0 * @author Vaadin Ltd */ @@ -50,7 +50,7 @@ public class AutoScroller { * <p> * Because the auto scroller currently only supports scrolling in one * axis, this method is used for both vertical and horizontal scrolling. - * + * * @param scrollDiff * the amount of pixels that have been auto scrolled since * last call @@ -106,7 +106,7 @@ public class AutoScroller { * Something has dropped a touchend/touchcancel and the * scroller is most probably running amok. Let's cancel it * and pretend that everything's going as expected - * + * * Because this is a preview, this code is run before start * event can be passed to the start(...) method. */ @@ -448,7 +448,7 @@ public class AutoScroller { /** * Creates a new instance for scrolling the given grid. - * + * * @param grid * the grid to auto scroll */ @@ -458,7 +458,7 @@ public class AutoScroller { /** * Starts the automatic scrolling detection. - * + * * @param startEvent * the event that starts the automatic scroll * @param scrollAxis @@ -499,7 +499,7 @@ public class AutoScroller { * triggered. * <p> * Defaults to 100px. - * + * * @param px * the pixel height/width for the auto scroll area depending on * direction @@ -512,7 +512,7 @@ public class AutoScroller { * Returns the size of the auto scroll area in pixels. * <p> * Defaults to 100px. - * + * * @return size in pixels */ public int getScrollArea() { diff --git a/client/src/main/java/com/vaadin/client/widget/grid/CellReference.java b/client/src/main/java/com/vaadin/client/widget/grid/CellReference.java index e783cb92ae..17ab480d3b 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/CellReference.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/CellReference.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -25,7 +25,7 @@ import com.vaadin.client.widgets.Grid; * Since this class follows the <code>Flyweight</code>-pattern any instance of * this object is subject to change without the user knowing it and so should * not be stored anywhere outside of the method providing these instances. - * + * * @author Vaadin Ltd * @param <T> * the type of the row object containing this cell @@ -47,7 +47,7 @@ public class CellReference<T> { * <p> * The difference between {@link #columnIndexDOM} and {@link #columnIndex} * comes from hidden columns. - * + * * @param columnIndexDOM * the index of the column in the DOM * @param columnIndex @@ -64,7 +64,7 @@ public class CellReference<T> { /** * Gets the grid that contains the referenced cell. - * + * * @return the grid that contains referenced cell */ public Grid<T> getGrid() { @@ -73,7 +73,7 @@ public class CellReference<T> { /** * Gets the row index of the row. - * + * * @return the index of the row */ public int getRowIndex() { @@ -82,7 +82,7 @@ public class CellReference<T> { /** * Gets the row data object. - * + * * @return the row object */ public T getRow() { @@ -94,7 +94,7 @@ public class CellReference<T> { * <p> * <em>NOTE:</em> The index includes hidden columns in the count, unlike * {@link #getColumnIndexDOM()}. - * + * * @return the index of the column */ public int getColumnIndex() { @@ -104,7 +104,7 @@ public class CellReference<T> { /** * Gets the index of the cell in the DOM. The difference to * {@link #getColumnIndex()} is caused by hidden columns. - * + * * @since 7.5.0 * @return the index of the column in the DOM */ @@ -114,7 +114,7 @@ public class CellReference<T> { /** * Gets the column objects. - * + * * @return the column object */ public Grid.Column<?, T> getColumn() { @@ -123,7 +123,7 @@ public class CellReference<T> { /** * Gets the value of the cell. - * + * * @return the value of the cell */ public Object getValue() { @@ -132,7 +132,7 @@ public class CellReference<T> { /** * Get the element of the cell. - * + * * @return the element of the cell */ public TableCellElement getElement() { @@ -141,7 +141,7 @@ public class CellReference<T> { /** * Gets the RowReference for this CellReference. - * + * * @return the row reference */ protected RowReference<T> getRowReference() { diff --git a/client/src/main/java/com/vaadin/client/widget/grid/CellStyleGenerator.java b/client/src/main/java/com/vaadin/client/widget/grid/CellStyleGenerator.java index bbc540de64..0496001a9f 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/CellStyleGenerator.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/CellStyleGenerator.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.vaadin.client.widgets.Grid; /** * Callback interface for generating custom style names for cells - * + * * @author Vaadin Ltd * @param <T> * the row type of the target grid @@ -30,7 +30,7 @@ public interface CellStyleGenerator<T> { /** * Called by Grid to generate a style name for a column element. - * + * * @param cellReference * The cell to generate a style for * @return the style name to add to this cell, or {@code null} to not set diff --git a/client/src/main/java/com/vaadin/client/widget/grid/DataAvailableEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/DataAvailableEvent.java index d88fce4e11..5379c1cfa9 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/DataAvailableEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/DataAvailableEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.shared.ui.grid.Range; /** * Event object describing a change of row availability in DataSource of a Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -35,7 +35,7 @@ public class DataAvailableEvent extends GwtEvent<DataAvailableHandler> { /** * Returns the range of available rows in {@link DataSource} for this event. - * + * * @return range of available rows */ public Range getAvailableRows() { diff --git a/client/src/main/java/com/vaadin/client/widget/grid/DataAvailableHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/DataAvailableHandler.java index 5e0650bc41..e4d640b952 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/DataAvailableHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/DataAvailableHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.google.gwt.event.shared.EventHandler; /** * Handler for {@link DataAvailableEvent}s. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -27,7 +27,7 @@ public interface DataAvailableHandler extends EventHandler { /** * Called when DataSource has data available. Supplied with row range. - * + * * @param availableRows * Range of rows available in the DataSource * @return true if the command was successfully completed, false to call diff --git a/client/src/main/java/com/vaadin/client/widget/grid/DefaultEditorEventHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/DefaultEditorEventHandler.java index 2329f04878..f5e261f901 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/DefaultEditorEventHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/DefaultEditorEventHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -29,7 +29,7 @@ import com.vaadin.client.widgets.Grid.EditorDomEvent; /** * The default handler for Grid editor events. Offers several overridable * protected methods for easier customization. - * + * * @since 7.6 * @author Vaadin Ltd */ @@ -49,7 +49,7 @@ public class DefaultEditorEventHandler<T> implements Editor.EventHandler<T> { /** * Returns whether the given event is a touch event that should open the * editor. - * + * * @param event * the received event * @return whether the event is a touch open event @@ -85,7 +85,7 @@ public class DefaultEditorEventHandler<T> implements Editor.EventHandler<T> { * Returns whether the given event should open the editor. The default * implementation returns true if and only if the event is a doubleclick or * if it is a keydown event and the keycode is {@link #KEYCODE_OPEN}. - * + * * @param event * the received event * @return true if the event is an open event, false otherwise @@ -102,7 +102,7 @@ public class DefaultEditorEventHandler<T> implements Editor.EventHandler<T> { * Opens the editor on the appropriate row if the received event is an open * event. The default implementation uses * {@link #isOpenEvent(EditorDomEvent) isOpenEvent}. - * + * * @param event * the received event * @return true if this method handled the event and nothing else should be @@ -129,7 +129,7 @@ public class DefaultEditorEventHandler<T> implements Editor.EventHandler<T> { * row up or down if the shift key is pressed or not, respectively. Keydown * event with keycode {@link #KEYCODE_MOVE_HORIZONTAL} moves the editor left * or right if shift key is pressed or not, respectively. - * + * * @param event * the received event * @return true if this method handled the event and nothing else should be @@ -197,7 +197,7 @@ public class DefaultEditorEventHandler<T> implements Editor.EventHandler<T> { * By default the editor is moved on a keydown event with keycode * {@link #KEYCODE_MOVE_HORIZONTAL}. This moves the editor left or right if * shift key is pressed or not, respectively. - * + * * @param event * the received event * @return true if this method handled the event and nothing else should be @@ -240,7 +240,7 @@ public class DefaultEditorEventHandler<T> implements Editor.EventHandler<T> { * Returns whether the given event should close the editor. The default * implementation returns true if and only if the event is a keydown event * and the keycode is {@link #KEYCODE_CLOSE}. - * + * * @param event * the received event * @return true if the event is a close event, false otherwise @@ -254,7 +254,7 @@ public class DefaultEditorEventHandler<T> implements Editor.EventHandler<T> { /** * Closes the editor if the received event is a close event. The default * implementation uses {@link #isCloseEvent(EditorDomEvent) isCloseEvent}. - * + * * @param event * the received event * @return true if this method handled the event and nothing else should be @@ -290,7 +290,7 @@ public class DefaultEditorEventHandler<T> implements Editor.EventHandler<T> { * Triggers a value change event from the editor field if it has focus. This * is based on the assumption that editor field will fire the value change * when a blur event occurs. - * + * * @param event * the editor DOM event */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/DetailsGenerator.java b/client/src/main/java/com/vaadin/client/widget/grid/DetailsGenerator.java index b9427091a7..f2b75f2576 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/DetailsGenerator.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/DetailsGenerator.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.google.gwt.user.client.ui.Widget; /** * A callback interface for generating details for a particular row in Grid. - * + * * @since 7.5.0 * @author Vaadin Ltd */ @@ -36,7 +36,7 @@ public interface DetailsGenerator { /** * This method is called for whenever a new details row needs to be * generated. - * + * * @param rowIndex * the index of the row for which to generate details * @return the details for the given row, or <code>null</code> to leave the diff --git a/client/src/main/java/com/vaadin/client/widget/grid/EditorHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/EditorHandler.java index 91198700ca..5bb1035bd4 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/EditorHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/EditorHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,10 +24,10 @@ import com.vaadin.client.widgets.Grid; * An interface for binding widgets and data to the grid row editor. Used by the * editor to support different row types, data sources and custom data binding * mechanisms. - * + * * @param <T> * the row data type - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -41,35 +41,35 @@ public interface EditorHandler<T> { * An implementation must call either {@link #success()} or {@link #fail()}, * according to whether the operation was a success or failed during * execution, respectively. - * + * * @param <T> * the row data type */ public interface EditorRequest<T> { /** * Returns the index of the row being requested. - * + * * @return the row index */ public int getRowIndex(); /** * Returns the index of the column being focused. - * + * * @return the column index */ public int getColumnIndex(); /** * Returns the row data related to the row being requested. - * + * * @return the row data */ public T getRow(); /** * Returns the grid instance related to this editor request. - * + * * @return the grid instance */ public Grid<T> getGrid(); @@ -77,7 +77,7 @@ public interface EditorHandler<T> { /** * Returns the editor widget used to edit the values of the given * column. - * + * * @param column * the column whose widget to get * @return the widget related to the column @@ -92,7 +92,7 @@ public interface EditorHandler<T> { /** * Informs Grid that an error occurred while trying to process the * request. - * + * * @param errorMessage * and error message to show to the user, or * <code>null</code> to not show any message. @@ -106,7 +106,7 @@ public interface EditorHandler<T> { /** * Checks whether the request is completed or not. - * + * * @return <code>true</code> iff the request is completed */ public boolean isCompleted(); @@ -120,10 +120,10 @@ public interface EditorHandler<T> { * {@link EditorRequest#success()} or * {@link EditorRequest#failure(String, Collection)} to signal a successful * or a failed (respectively) bind action. - * + * * @param request * the data binding request - * + * * @see Grid#editRow(int) */ public void bind(EditorRequest<T> request); @@ -138,10 +138,10 @@ public interface EditorHandler<T> { * {@link EditorRequest#failure(String, Collection)} have no effect on the * outcome of the cancel action. The editor is already closed when this * method is called. - * + * * @param request * the cancel request - * + * * @see Grid#cancelEditor() */ public void cancel(EditorRequest<T> request); @@ -153,10 +153,10 @@ public interface EditorHandler<T> { * The implementation <em>must</em> call either * {@link EditorRequest#success()} or {@link EditorRequest#fail()} to signal * a successful or a failed (respectively) save action. - * + * * @param request * the save request - * + * * @see Grid#saveEditor() */ public void save(EditorRequest<T> request); @@ -164,7 +164,7 @@ public interface EditorHandler<T> { /** * Returns a widget instance that is used to edit the values in the given * column. A null return value means the column is not editable. - * + * * @param column * the column whose values should be edited * @return the editor widget for the column or null if the column is not diff --git a/client/src/main/java/com/vaadin/client/widget/grid/EventCellReference.java b/client/src/main/java/com/vaadin/client/widget/grid/EventCellReference.java index 4d37be2cc1..60a1c676e8 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/EventCellReference.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/EventCellReference.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -28,7 +28,7 @@ import com.vaadin.shared.ui.grid.GridConstants.Section; * Since this class follows the <code>Flyweight</code>-pattern any instance of * this object is subject to change without the user knowing it and so should * not be stored anywhere outside of the method providing these instances. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -43,7 +43,7 @@ public class EventCellReference<T> extends CellReference<T> { /** * Sets the RowReference and CellReference to point to given Cell. - * + * * @param targetCell * cell to point to */ @@ -85,7 +85,7 @@ public class EventCellReference<T> extends CellReference<T> { /** * Is the cell reference for a cell in the header of the Grid. - * + * * @since 7.5 * @return <code>true</true> if referenced cell is in the header, * <code>false</code> if not @@ -96,7 +96,7 @@ public class EventCellReference<T> extends CellReference<T> { /** * Is the cell reference for a cell in the body of the Grid. - * + * * @since 7.5 * @return <code>true</true> if referenced cell is in the body, * <code>false</code> if not @@ -107,7 +107,7 @@ public class EventCellReference<T> extends CellReference<T> { /** * Is the cell reference for a cell in the footer of the Grid. - * + * * @since 7.5 * @return <code>true</true> if referenced cell is in the footer, * <code>false</code> if not @@ -118,7 +118,7 @@ public class EventCellReference<T> extends CellReference<T> { /** * Gets the Grid section where the referenced cell is. - * + * * @since 7.5 * @return grid section */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/HeightAwareDetailsGenerator.java b/client/src/main/java/com/vaadin/client/widget/grid/HeightAwareDetailsGenerator.java index db3db85c2a..96a92d3fc6 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/HeightAwareDetailsGenerator.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/HeightAwareDetailsGenerator.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ package com.vaadin.client.widget.grid; * <b>FOR INTERNAL USE ONLY!</b> This class exists only for the sake of a * temporary workaround and might be removed or renamed at any time. * </p> - * + * * @since 7.6.1 * @author Vaadin Ltd */ @@ -35,7 +35,7 @@ public interface HeightAwareDetailsGenerator extends DetailsGenerator { * <b>FOR INTERNAL USE ONLY!</b> This method exists only for the sake of a * temporary workaround and might be removed or renamed at any time. * </p> - * + * * @since 7.6.1 * @param rowIndex * the index of the row for which to calculate details row height diff --git a/client/src/main/java/com/vaadin/client/widget/grid/RendererCellReference.java b/client/src/main/java/com/vaadin/client/widget/grid/RendererCellReference.java index 994db50aa0..b7aecf1aad 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/RendererCellReference.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/RendererCellReference.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -26,7 +26,7 @@ import com.vaadin.client.widgets.Grid; * Since this class follows the <code>Flyweight</code>-pattern any instance of * this object is subject to change without the user knowing it and so should * not be stored anywhere outside of the method providing these instances. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -34,7 +34,7 @@ public class RendererCellReference extends CellReference<Object> { /** * Creates a new renderer cell reference bound to a row reference. - * + * * @param rowReference * the row reference to bind to */ @@ -46,7 +46,7 @@ public class RendererCellReference extends CellReference<Object> { /** * Sets the identifying information for this cell. - * + * * @param cell * the flyweight cell to reference * @param columnIndex @@ -64,7 +64,7 @@ public class RendererCellReference extends CellReference<Object> { /** * Returns the element of the cell. Can be either a <code>TD</code> element * or a <code>TH</code> element. - * + * * @return the element of the cell */ @Override @@ -74,7 +74,7 @@ public class RendererCellReference extends CellReference<Object> { /** * Sets the colspan attribute of the element of this cell. - * + * * @param numberOfCells * the number of columns that the cell should span */ @@ -84,7 +84,7 @@ public class RendererCellReference extends CellReference<Object> { /** * Gets the colspan attribute of the element of this cell. - * + * * @return the number of columns that the cell should span */ public int getColSpan() { diff --git a/client/src/main/java/com/vaadin/client/widget/grid/RowReference.java b/client/src/main/java/com/vaadin/client/widget/grid/RowReference.java index 8874fcc5cc..1bbc440aba 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/RowReference.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/RowReference.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -25,7 +25,7 @@ import com.vaadin.client.widgets.Grid; * Since this class follows the <code>Flyweight</code>-pattern any instance of * this object is subject to change without the user knowing it and so should * not be stored anywhere outside of the method providing these instances. - * + * * @author Vaadin Ltd * @param <T> * the row object type @@ -41,7 +41,7 @@ public class RowReference<T> { /** * Creates a new row reference for the given grid. - * + * * @param grid * the grid that the row belongs to */ @@ -51,7 +51,7 @@ public class RowReference<T> { /** * Sets the identifying information for this row. - * + * * @param rowIndex * the index of the row * @param row @@ -67,7 +67,7 @@ public class RowReference<T> { /** * Gets the grid that contains the referenced row. - * + * * @return the grid that contains referenced row */ public Grid<T> getGrid() { @@ -76,7 +76,7 @@ public class RowReference<T> { /** * Gets the row index of the row. - * + * * @return the index of the row */ public int getRowIndex() { @@ -85,7 +85,7 @@ public class RowReference<T> { /** * Gets the row data object. - * + * * @return the row object */ public T getRow() { @@ -94,7 +94,7 @@ public class RowReference<T> { /** * Gets the table row element of the row. - * + * * @return the element of the row */ public TableRowElement getElement() { diff --git a/client/src/main/java/com/vaadin/client/widget/grid/RowStyleGenerator.java b/client/src/main/java/com/vaadin/client/widget/grid/RowStyleGenerator.java index a12a9ff47d..7bef3c58c7 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/RowStyleGenerator.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/RowStyleGenerator.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import java.io.Serializable; /** * Callback interface for generating custom style names for data rows - * + * * @author Vaadin Ltd * @param <T> * the row type of the target grid @@ -30,7 +30,7 @@ public interface RowStyleGenerator<T> extends Serializable { /** * Called by Grid to generate a style name for a row. - * + * * @param rowReference * The row to generate a style for * @return the style name to add to this row, or {@code null} to not set any diff --git a/client/src/main/java/com/vaadin/client/widget/grid/datasources/ListDataSource.java b/client/src/main/java/com/vaadin/client/widget/grid/datasources/ListDataSource.java index cf7ec53e68..cff544ac94 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/datasources/ListDataSource.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/datasources/ListDataSource.java @@ -34,23 +34,23 @@ import com.vaadin.shared.util.SharedUtil; * A simple list based on an in-memory data source for simply adding a list of * row pojos to the grid. Based on a wrapped list instance which supports adding * and removing of items. - * + * * <p> * Usage: - * + * * <pre> * ListDataSource<Integer> ds = new ListDataSource<Integer>(1, 2, 3, 4); - * + * * // Add item to the data source * ds.asList().add(5); - * + * * // Remove item from the data source * ds.asList().remove(3); - * + * * // Add multiple items * ds.asList().addAll(Arrays.asList(5, 6, 7)); * </pre> - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -355,8 +355,8 @@ public class ListDataSource<T> implements DataSource<T> { * data source after the data source has been constructed. To add or remove * items to the data source after it has been constructed use * {@link ListDataSource#asList()}. - * - * + * + * * @param datasource * The list to use for providing the data to the grid */ @@ -372,7 +372,7 @@ public class ListDataSource<T> implements DataSource<T> { * Constructs a data source with a set of rows. You can dynamically add and * remove rows from the data source via the list you get from * {@link ListDataSource#asList()} - * + * * @param rows * The rows to initially add to the data source */ @@ -418,7 +418,7 @@ public class ListDataSource<T> implements DataSource<T> { * <p> * Note: The list is not the same list as passed into the data source via * the constructor. - * + * * @return Returns a list implementation that wraps the real list that backs * the data source and provides events for the data source * listeners. @@ -436,7 +436,7 @@ public class ListDataSource<T> implements DataSource<T> { /** * Sort entire container according to a {@link Comparator}. - * + * * @param comparator * a comparator object, which compares two data source entries * (beans/pojos) @@ -453,7 +453,7 @@ public class ListDataSource<T> implements DataSource<T> { * <p> * <em>Note:</em> This method does not verify that the given row object * exists at all in this DataSource. - * + * * @param row * the row object * @return index of the row; or <code>-1</code> if row is not available @@ -464,7 +464,7 @@ public class ListDataSource<T> implements DataSource<T> { /** * Returns a {@link SelectAllHandler} for this ListDataSource. - * + * * @return select all handler */ public SelectAllHandler<T> getSelectAllHandler() { diff --git a/client/src/main/java/com/vaadin/client/widget/grid/datasources/ListSorter.java b/client/src/main/java/com/vaadin/client/widget/grid/datasources/ListSorter.java index 3e0d05a414..b0ae3ace89 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/datasources/ListSorter.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/datasources/ListSorter.java @@ -31,7 +31,7 @@ import com.vaadin.shared.data.sort.SortDirection; /** * Provides sorting facility from Grid for the {@link ListDataSource} in-memory * data source. - * + * * @author Vaadin Ltd * @param <T> * Grid row data type @@ -75,7 +75,7 @@ public class ListSorter<T> { * which includes all standard data classes like String, Number derivatives * and Dates). Any existing comparator can be removed by passing in a * non-null GridColumn and a null Comparator. - * + * * @param column * a grid column. May not be null. * @param comparator @@ -97,7 +97,7 @@ public class ListSorter<T> { /** * Retrieve the comparator assigned for a specific grid column. - * + * * @param column * a grid column. May not be null. * @return a comparator, or null if no comparator for the specified grid @@ -122,7 +122,7 @@ public class ListSorter<T> { /** * Apply sorting to the current ListDataSource. - * + * * @param order * the sort order list provided by the grid sort event */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/AbstractGridKeyEventHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/AbstractGridKeyEventHandler.java index 9106523606..a0e1b3fa9b 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/AbstractGridKeyEventHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/AbstractGridKeyEventHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.widgets.Grid.AbstractGridKeyEvent; /** * Base interface of all handlers for {@link AbstractGridKeyEvent}s. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/AbstractGridMouseEventHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/AbstractGridMouseEventHandler.java index e72b7df934..d3ed32978c 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/AbstractGridMouseEventHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/AbstractGridMouseEventHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.widgets.Grid.AbstractGridMouseEvent; /** * Base interface of all handlers for {@link AbstractGridMouseEvent}s. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/BodyClickHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/BodyClickHandler.java index a66e170524..c14a9650a0 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/BodyClickHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/BodyClickHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.vaadin.client.widget.grid.events.AbstractGridMouseEventHandler.GridCl /** * Handler for {@link GridClickEvent}s that happen in the body of the Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/BodyDoubleClickHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/BodyDoubleClickHandler.java index 7be29920e7..0eeb124e29 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/BodyDoubleClickHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/BodyDoubleClickHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.widget.grid.events.AbstractGridMouseEventHandler.GridDo /** * Handler for {@link GridDoubleClickEvent}s that happen in the body of the * Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/BodyKeyDownHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/BodyKeyDownHandler.java index ff1ae82d2e..2fdde86c6b 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/BodyKeyDownHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/BodyKeyDownHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.widget.grid.events.AbstractGridKeyEventHandler.GridKeyD /** * Handler for {@link GridKeyDownEvent}s that happen when the focused cell is in * the body of the Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/BodyKeyPressHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/BodyKeyPressHandler.java index 245250d4c0..b134566de1 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/BodyKeyPressHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/BodyKeyPressHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.widget.grid.events.AbstractGridKeyEventHandler.GridKeyP /** * Handler for {@link GridKeyPressEvent}s that happen when the focused cell is * in the body of the Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/BodyKeyUpHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/BodyKeyUpHandler.java index 2c0951ea40..2aac69a424 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/BodyKeyUpHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/BodyKeyUpHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.widget.grid.events.AbstractGridKeyEventHandler.GridKeyU /** * Handler for {@link GridKeyUpEvent}s that happen when the focused cell is in * the body of the Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnReorderEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnReorderEvent.java index 1712871089..54193e7a1b 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnReorderEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnReorderEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.google.gwt.event.shared.GwtEvent; /** * An event for notifying that the columns in the Grid have been reordered. - * + * * @param <T> * The row type of the grid. The row type is the POJO type from where * the data is retrieved into the column cells. diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnReorderHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnReorderHandler.java index 29c476058e..f46fe41afc 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnReorderHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnReorderHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.google.gwt.event.shared.EventHandler; /** * Handler for a Grid column reorder event, called when the Grid's columns has * been reordered. - * + * * @param <T> * The row type of the grid. The row type is the POJO type from where * the data is retrieved into the column cells. @@ -32,7 +32,7 @@ public interface ColumnReorderHandler<T> extends EventHandler { /** * A column reorder event, fired by Grid when the columns of the Grid have * been reordered. - * + * * @param event * column reorder event */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnResizeEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnResizeEvent.java index f5c8c0fa83..7c449ab763 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnResizeEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnResizeEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.widgets.Grid.Column; /** * An event for notifying that the columns in the Grid have been resized. - * + * * @param <T> * The row type of the grid. The row type is the POJO type from where * the data is retrieved into the column cells. diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnResizeHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnResizeHandler.java index a66dbf7bd2..c0dca31263 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnResizeHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnResizeHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.google.gwt.event.shared.EventHandler; /** * Handler for a Grid column resize event, called when the Grid's columns has * been resized. - * + * * @param <T> * The row type of the grid. The row type is the POJO type from where * the data is retrieved into the column cells. @@ -32,7 +32,7 @@ public interface ColumnResizeHandler<T> extends EventHandler { /** * A column resize event, fired by Grid when the columns of the Grid have * been resized. - * + * * @param event * column resize event */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnVisibilityChangeEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnVisibilityChangeEvent.java index 96e7694251..2a94d4ec4e 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnVisibilityChangeEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnVisibilityChangeEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.vaadin.client.widgets.Grid.Column; /** * An event for notifying that the columns in the Grid's have changed * visibility. - * + * * @param <T> * The row type of the grid. The row type is the POJO type from where * the data is retrieved into the column cells. @@ -52,7 +52,7 @@ public class ColumnVisibilityChangeEvent<T> /** * Returns the column where the visibility change occurred. - * + * * @return the column where the visibility change occurred. */ public Column<?, T> getColumn() { @@ -61,7 +61,7 @@ public class ColumnVisibilityChangeEvent<T> /** * Was the column set hidden or visible. - * + * * @return <code>true</code> if the column was hidden <code>false</code> if * it was set visible */ @@ -71,7 +71,7 @@ public class ColumnVisibilityChangeEvent<T> /** * Is the visibility change triggered by user. - * + * * @return <code>true</code> if the change was triggered by user, * <code>false</code> if not */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnVisibilityChangeHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnVisibilityChangeHandler.java index 181a0e69a7..1cdffe59e8 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnVisibilityChangeHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/ColumnVisibilityChangeHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,11 +20,11 @@ import com.google.gwt.event.shared.EventHandler; /** * Handler for a Grid column visibility change event, called when the Grid's * columns have changed visibility to hidden or visible. - * + * * @param<T> The * row type of the grid. The row type is the POJO type from where * the data is retrieved into the column cells. - * + * * @since 7.5.0 * @author Vaadin Ltd */ @@ -33,7 +33,7 @@ public interface ColumnVisibilityChangeHandler<T> extends EventHandler { /** * A column visibility change event, fired by Grid when a column in the Grid * has changed visibility. - * + * * @param event * column visibility change event */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/FooterClickHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/FooterClickHandler.java index 51fa38c948..55d8329077 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/FooterClickHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/FooterClickHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.vaadin.client.widget.grid.events.AbstractGridMouseEventHandler.GridCl /** * Handler for {@link GridClickEvent}s that happen in the footer of the Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/FooterDoubleClickHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/FooterDoubleClickHandler.java index 2f5ba21787..7c91eef7f7 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/FooterDoubleClickHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/FooterDoubleClickHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.widget.grid.events.AbstractGridMouseEventHandler.GridDo /** * Handler for {@link GridDoubleClickEvent}s that happen in the footer of the * Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/FooterKeyDownHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/FooterKeyDownHandler.java index 85f83970f2..43cf6d9a69 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/FooterKeyDownHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/FooterKeyDownHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.widget.grid.events.AbstractGridKeyEventHandler.GridKeyD /** * Handler for {@link GridKeyDownEvent}s that happen when the focused cell is in * the footer of the Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/FooterKeyPressHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/FooterKeyPressHandler.java index 09778f6873..be0da9cb69 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/FooterKeyPressHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/FooterKeyPressHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.widget.grid.events.AbstractGridKeyEventHandler.GridKeyP /** * Handler for {@link GridKeyPressEvent}s that happen when the focused cell is * in the footer of the Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/FooterKeyUpHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/FooterKeyUpHandler.java index 688f89880f..9068d6c888 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/FooterKeyUpHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/FooterKeyUpHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.widget.grid.events.AbstractGridKeyEventHandler.GridKeyU /** * Handler for {@link GridKeyUpEvent}s that happen when the focused cell is in * the footer of the Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/GridClickEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/events/GridClickEvent.java index 6d5f5ae38b..08d08f3011 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/GridClickEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/GridClickEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,7 +24,7 @@ import com.vaadin.shared.ui.grid.GridConstants.Section; /** * Represents native mouse click event in Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/GridDoubleClickEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/events/GridDoubleClickEvent.java index f134f863ab..55fe118426 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/GridDoubleClickEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/GridDoubleClickEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,7 +24,7 @@ import com.vaadin.shared.ui.grid.GridConstants.Section; /** * Represents native mouse double click event in Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/GridKeyDownEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/events/GridKeyDownEvent.java index 23efa56eb5..2b5b3dbeef 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/GridKeyDownEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/GridKeyDownEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -25,7 +25,7 @@ import com.vaadin.shared.ui.grid.GridConstants.Section; /** * Represents native key down event in Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -53,7 +53,7 @@ public class GridKeyDownEvent extends AbstractGridKeyEvent<GridKeyDownHandler> { /** * Does the key code represent an arrow key? - * + * * @param keyCode * the key code * @return if it is an arrow key code @@ -73,7 +73,7 @@ public class GridKeyDownEvent extends AbstractGridKeyEvent<GridKeyDownHandler> { /** * Gets the native key code. These key codes are enumerated in the * {@link KeyCodes} class. - * + * * @return the key code */ public int getNativeKeyCode() { @@ -82,7 +82,7 @@ public class GridKeyDownEvent extends AbstractGridKeyEvent<GridKeyDownHandler> { /** * Is this a key down arrow? - * + * * @return whether this is a down arrow key event */ public boolean isDownArrow() { @@ -91,7 +91,7 @@ public class GridKeyDownEvent extends AbstractGridKeyEvent<GridKeyDownHandler> { /** * Is this a left arrow? - * + * * @return whether this is a left arrow key event */ public boolean isLeftArrow() { @@ -100,7 +100,7 @@ public class GridKeyDownEvent extends AbstractGridKeyEvent<GridKeyDownHandler> { /** * Is this a right arrow? - * + * * @return whether this is a right arrow key event */ public boolean isRightArrow() { @@ -109,7 +109,7 @@ public class GridKeyDownEvent extends AbstractGridKeyEvent<GridKeyDownHandler> { /** * Is this a up arrow? - * + * * @return whether this is a right arrow key event */ public boolean isUpArrow() { diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/GridKeyPressEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/events/GridKeyPressEvent.java index b159b1e0b1..0b6abce26b 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/GridKeyPressEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/GridKeyPressEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -24,7 +24,7 @@ import com.vaadin.shared.ui.grid.GridConstants.Section; /** * Represents native key press event in Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -53,7 +53,7 @@ public class GridKeyPressEvent /** * Gets the char code for this event. - * + * * @return the char code */ public char getCharCode() { @@ -62,7 +62,7 @@ public class GridKeyPressEvent /** * Gets the Unicode char code (code point) for this event. - * + * * @return the Unicode char code */ public int getUnicodeCharCode() { diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/GridKeyUpEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/events/GridKeyUpEvent.java index ec1980b39b..8cf61f9032 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/GridKeyUpEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/GridKeyUpEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -25,7 +25,7 @@ import com.vaadin.shared.ui.grid.GridConstants.Section; /** * Represents native key up event in Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -53,7 +53,7 @@ public class GridKeyUpEvent extends AbstractGridKeyEvent<GridKeyUpHandler> { /** * Does the key code represent an arrow key? - * + * * @param keyCode * the key code * @return if it is an arrow key code @@ -73,7 +73,7 @@ public class GridKeyUpEvent extends AbstractGridKeyEvent<GridKeyUpHandler> { /** * Gets the native key code. These key codes are enumerated in the * {@link KeyCodes} class. - * + * * @return the key code */ public int getNativeKeyCode() { @@ -82,7 +82,7 @@ public class GridKeyUpEvent extends AbstractGridKeyEvent<GridKeyUpHandler> { /** * Is this a key down arrow? - * + * * @return whether this is a down arrow key event */ public boolean isDownArrow() { @@ -91,7 +91,7 @@ public class GridKeyUpEvent extends AbstractGridKeyEvent<GridKeyUpHandler> { /** * Is this a left arrow? - * + * * @return whether this is a left arrow key event */ public boolean isLeftArrow() { @@ -100,7 +100,7 @@ public class GridKeyUpEvent extends AbstractGridKeyEvent<GridKeyUpHandler> { /** * Is this a right arrow? - * + * * @return whether this is a right arrow key event */ public boolean isRightArrow() { @@ -109,7 +109,7 @@ public class GridKeyUpEvent extends AbstractGridKeyEvent<GridKeyUpHandler> { /** * Is this a up arrow? - * + * * @return whether this is a right arrow key event */ public boolean isUpArrow() { diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderClickHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderClickHandler.java index da20e80905..6913863b19 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderClickHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderClickHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.vaadin.client.widget.grid.events.AbstractGridMouseEventHandler.GridCl /** * Handler for {@link GridClickEvent}s that happen in the header of the Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderDoubleClickHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderDoubleClickHandler.java index 16a4cfe1f5..01a0ac300a 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderDoubleClickHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderDoubleClickHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.widget.grid.events.AbstractGridMouseEventHandler.GridDo /** * Handler for {@link GridDoubleClickEvent}s that happen in the header of the * Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderKeyDownHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderKeyDownHandler.java index 555eb936af..5e4e3d7893 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderKeyDownHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderKeyDownHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.widget.grid.events.AbstractGridKeyEventHandler.GridKeyD /** * Handler for {@link GridKeyDownEvent}s that happen when the focused cell is in * the header of the Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderKeyPressHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderKeyPressHandler.java index c4dd312f93..4bf9a64ba7 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderKeyPressHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderKeyPressHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.widget.grid.events.AbstractGridKeyEventHandler.GridKeyP /** * Handler for {@link GridKeyPressEvent}s that happen when the focused cell is * in the header of the Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderKeyUpHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderKeyUpHandler.java index 4dbe1c681e..365e5883f4 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderKeyUpHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/HeaderKeyUpHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.vaadin.client.widget.grid.events.AbstractGridKeyEventHandler.GridKeyU /** * Handler for {@link GridKeyUpEvent}s that happen when the focused cell is in * the header of the Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollEvent.java index 08e1e07eab..ed3fe3451d 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.google.gwt.event.shared.GwtEvent; /** * An event that signifies that a scrollbar bundle has been scrolled - * + * * @author Vaadin Ltd * @since 7.4 */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollHandler.java index 1ce901e707..5a106c614d 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/ScrollHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import com.google.gwt.event.shared.EventHandler; /** * A handler that gets called whenever a scrollbar bundle is scrolled - * + * * @author Vaadin Ltd * @since 7.4 */ @@ -27,7 +27,7 @@ public interface ScrollHandler extends EventHandler { /** * A callback method that is called once a scrollbar bundle has been * scrolled. - * + * * @param event * the scroll event */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/SelectAllEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/events/SelectAllEvent.java index 43c2055e95..fc317979f9 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/SelectAllEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/SelectAllEvent.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -21,7 +21,7 @@ import com.vaadin.client.widget.grid.selection.SelectionModel; /** * A select all event, fired by the Grid when it needs all rows in data source * to be selected. - * + * * @since 7.4 * @author Vaadin Ltd */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/events/SelectAllHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/events/SelectAllHandler.java index 2cdee8d1b3..12622f482c 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/events/SelectAllHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/events/SelectAllHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -20,7 +20,7 @@ import com.google.gwt.event.shared.EventHandler; /** * Handler for a Grid select all event, called when the Grid needs all rows in * data source to be selected. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -28,7 +28,7 @@ public interface SelectAllHandler<T> extends EventHandler { /** * Called when select all value in SelectionColumn header changes value. - * + * * @param event * select all event telling that all rows should be selected */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/selection/AbstractRowHandleSelectionModel.java b/client/src/main/java/com/vaadin/client/widget/grid/selection/AbstractRowHandleSelectionModel.java index bcd8f9beb7..b47ba49baf 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/selection/AbstractRowHandleSelectionModel.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/selection/AbstractRowHandleSelectionModel.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -23,7 +23,7 @@ import com.vaadin.client.data.DataSource.RowHandle; * <p> * <em>Note:</em> This should be an interface instead of an abstract class, if * only we could define protected methods in an interface. - * + * * @author Vaadin Ltd * @param <T> * The grid's row type @@ -36,7 +36,7 @@ public abstract class AbstractRowHandleSelectionModel<T> * {@link com.vaadin.client.data.DataSource.RowHandle RowHandle}. * <p> * <em>Note:</em> this method may not fire selection change events. - * + * * @param handle * the handle to select by * @return <code>true</code> iff the selection state was changed by this @@ -52,7 +52,7 @@ public abstract class AbstractRowHandleSelectionModel<T> * {@link com.vaadin.client.data.DataSource.RowHandle RowHandle}. * <p> * <em>Note:</em> this method may not fire selection change events. - * + * * @param handle * the handle to deselect by * @return <code>true</code> iff the selection state was changed by this diff --git a/client/src/main/java/com/vaadin/client/widget/grid/selection/ClickSelectHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/selection/ClickSelectHandler.java index c6bc52dd1c..e7be08f141 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/selection/ClickSelectHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/selection/ClickSelectHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -22,7 +22,7 @@ import com.vaadin.client.widgets.Grid; /** * Generic class to perform selections when clicking on cells in body of Grid. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -48,7 +48,7 @@ public class ClickSelectHandler<T> { /** * Constructor for ClickSelectHandler. This constructor will add all * necessary handlers for selecting rows by clicking cells. - * + * * @param grid * grid to attach to */ @@ -66,7 +66,7 @@ public class ClickSelectHandler<T> { /** * Sets whether clicking the currently selected row should deselect the row. - * + * * @param deselectAllowed * <code>true</code> to allow deselecting the selected row; * otherwise <code>false</code> diff --git a/client/src/main/java/com/vaadin/client/widget/grid/selection/HasSelectionHandlers.java b/client/src/main/java/com/vaadin/client/widget/grid/selection/HasSelectionHandlers.java index ffcad4c903..6690f32b4e 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/selection/HasSelectionHandlers.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/selection/HasSelectionHandlers.java @@ -19,7 +19,7 @@ import com.google.gwt.event.shared.HandlerRegistration; /** * Marker interface for widgets that fires selection events. - * + * * @author Vaadin Ltd * @since 7.4 */ @@ -31,7 +31,7 @@ public interface HasSelectionHandlers<T> { * This handler is called whenever a * {@link com.vaadin.ui.components.grid.selection.SelectionModel * SelectionModel} detects a change in selection state. - * + * * @param handler * a {@link SelectionHandler} * @return a handler registration object, which can be used to remove the diff --git a/client/src/main/java/com/vaadin/client/widget/grid/selection/MultiSelectionRenderer.java b/client/src/main/java/com/vaadin/client/widget/grid/selection/MultiSelectionRenderer.java index 9650a31b50..27e6108fa6 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/selection/MultiSelectionRenderer.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/selection/MultiSelectionRenderer.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -49,7 +49,7 @@ import com.vaadin.client.widgets.Grid; /** * Renderer showing multi selection check boxes. - * + * * @author Vaadin Ltd * @param <T> * the type of the associated grid @@ -74,7 +74,7 @@ public class MultiSelectionRenderer<T> /** * Handler for MouseDown and TouchStart events for selection checkboxes. - * + * * @since 7.5 */ private final class CheckBoxEventHandler implements MouseDownHandler, @@ -133,7 +133,7 @@ public class MultiSelectionRenderer<T> * Something has dropped a touchend/touchcancel and the * scroller is most probably running amok. Let's cancel it * and pretend that everything's going as expected - * + * * Because this is a preview, this code is run before the * event handler in MultiSelectionRenderer.onBrowserEvent. * Therefore, we can simply kill everything and let that diff --git a/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionEvent.java index 528beb5809..8ea2e56420 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionEvent.java @@ -25,7 +25,7 @@ import com.vaadin.client.widgets.Grid; /** * Event object describing a change in Grid row selection state. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -41,7 +41,7 @@ public class SelectionEvent<T> extends GwtEvent<SelectionHandler> { /** * Creates an event with a single added or removed row. - * + * * @param grid * grid reference, used for getSource * @param added @@ -72,7 +72,7 @@ public class SelectionEvent<T> extends GwtEvent<SelectionHandler> { /** * Creates an event where several rows have been added or removed. - * + * * @param grid * Grid reference, used for getSource * @param added @@ -106,7 +106,7 @@ public class SelectionEvent<T> extends GwtEvent<SelectionHandler> { /** * Gets a reference to the Grid object that fired this event. - * + * * @return a grid reference */ @Override @@ -117,7 +117,7 @@ public class SelectionEvent<T> extends GwtEvent<SelectionHandler> { /** * Gets all rows added to the selection since the last * {@link SelectionEvent} . - * + * * @return a collection of added rows. Empty collection if no rows were * added. */ @@ -128,7 +128,7 @@ public class SelectionEvent<T> extends GwtEvent<SelectionHandler> { /** * Gets all rows removed from the selection since the last * {@link SelectionEvent}. - * + * * @return a collection of removed rows. Empty collection if no rows were * removed. */ @@ -138,7 +138,7 @@ public class SelectionEvent<T> extends GwtEvent<SelectionHandler> { /** * Gets currently selected rows. - * + * * @return a non-null collection containing all currently selected rows. */ public Collection<T> getSelected() { @@ -147,7 +147,7 @@ public class SelectionEvent<T> extends GwtEvent<SelectionHandler> { /** * Gets a type identifier for this event. - * + * * @return a {@link Type} identifier. */ public static Type<SelectionHandler> getType() { @@ -168,7 +168,7 @@ public class SelectionEvent<T> extends GwtEvent<SelectionHandler> { /** * Checks if this selection change event is fired during a batched * selection/deselection operation. - * + * * @return <code>true</code> iff this event is fired during a batched * selection/deselection operation */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionHandler.java index 4f939fa798..46cafe6bbf 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionHandler.java @@ -19,7 +19,7 @@ import com.google.gwt.event.shared.EventHandler; /** * Handler for {@link SelectionEvent}s. - * + * * @author Vaadin Ltd * @param <T> * The row data type @@ -29,7 +29,7 @@ public interface SelectionHandler<T> extends EventHandler { /** * Called when a selection model's selection state is changed. - * + * * @param event * a selection event, containing info about rows that have been * added to or removed from the selection. diff --git a/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModel.java b/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModel.java index ec36ab52e8..000aa50702 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModel.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModel.java @@ -25,7 +25,7 @@ import com.vaadin.client.widgets.Grid; * <p> * Selection models perform tracking of selected rows in the Grid, as well as * dispatching events when the selection state changes. - * + * * @author Vaadin Ltd * @param <T> * Grid's row type @@ -36,7 +36,7 @@ public interface SelectionModel<T> { /** * Return true if the provided row is considered selected under the * implementing selection model. - * + * * @param row * row object instance * @return <code>true</code>, if the row given as argument is considered @@ -47,7 +47,7 @@ public interface SelectionModel<T> { /** * Return the {@link Renderer} responsible for rendering the selection * column. - * + * * @return a renderer instance. If null is returned, a selection column will * not be drawn. */ @@ -58,7 +58,7 @@ public interface SelectionModel<T> { * <p> * Implementations are free to have this be a no-op. This method is called * internally by Grid. - * + * * @param grid * a {@link Grid} instance; <code>null</code> when removing from * Grid @@ -75,7 +75,7 @@ public interface SelectionModel<T> { /** * Returns a Collection containing all selected rows. - * + * * @return a non-null collection. */ public Collection<T> getSelectedRows(); @@ -83,7 +83,7 @@ public interface SelectionModel<T> { /** * Selection model that allows a maximum of one row to be selected at any * one time. - * + * * @param <T> * type parameter corresponding with Grid row type */ @@ -91,7 +91,7 @@ public interface SelectionModel<T> { /** * Selects a row. - * + * * @param row * a {@link Grid} row object * @return true, if this row as not previously selected. @@ -102,7 +102,7 @@ public interface SelectionModel<T> { * Deselects a row. * <p> * This is a no-op unless {@link row} is the currently selected row. - * + * * @param row * a {@link Grid} row object * @return true, if the currently selected row was deselected. @@ -111,7 +111,7 @@ public interface SelectionModel<T> { /** * Returns the currently selected row. - * + * * @return a {@link Grid} row object or null, if nothing is selected. */ public T getSelectedRow(); @@ -119,7 +119,7 @@ public interface SelectionModel<T> { /** * Sets whether it's allowed to deselect the selected row through the * UI. Deselection is allowed by default. - * + * * @param deselectAllowed * <code>true</code> if the selected row can be deselected * without selecting another row instead; otherwise @@ -130,7 +130,7 @@ public interface SelectionModel<T> { /** * Sets whether it's allowed to deselect the selected row through the * UI. - * + * * @return <code>true</code> if deselection is allowed; otherwise * <code>false</code> */ @@ -140,7 +140,7 @@ public interface SelectionModel<T> { /** * Selection model that allows for several rows to be selected at once. - * + * * @param <T> * type parameter corresponding with Grid row type */ @@ -149,7 +149,7 @@ public interface SelectionModel<T> { /** * A multi selection model that can send selections and deselections in * a batch, instead of committing them one-by-one. - * + * * @param <T> * type parameter corresponding with Grid row type */ @@ -179,21 +179,21 @@ public interface SelectionModel<T> { /** * Checks whether or not a batch has been started. - * + * * @return <code>true</code> iff a batch has been started */ public boolean isBeingBatchSelected(); /** * Gets all the rows that would become selected in this batch. - * + * * @return a collection of the rows that would become selected */ public Collection<T> getSelectedRowsBatch(); /** * Gets all the rows that would become deselected in this batch. - * + * * @return a collection of the rows that would become deselected */ public Collection<T> getDeselectedRowsBatch(); @@ -201,7 +201,7 @@ public interface SelectionModel<T> { /** * Selects one or more rows. - * + * * @param rows * {@link Grid} row objects * @return true, if the set of selected rows was changed. @@ -210,7 +210,7 @@ public interface SelectionModel<T> { /** * Deselects one or more rows. - * + * * @param rows * Grid row objects * @return true, if the set of selected rows was changed. @@ -219,14 +219,14 @@ public interface SelectionModel<T> { /** * De-selects all rows. - * + * * @return true, if any row was previously selected. */ public boolean deselectAll(); /** * Select all rows in a {@link Collection}. - * + * * @param rows * a collection of Grid row objects * @return true, if the set of selected rows was changed. @@ -235,7 +235,7 @@ public interface SelectionModel<T> { /** * Deselect all rows in a {@link Collection}. - * + * * @param rows * a collection of Grid row objects * @return true, if the set of selected rows was changed. @@ -247,7 +247,7 @@ public interface SelectionModel<T> { /** * Interface for a selection model that does not allow anything to be * selected. - * + * * @param <T> * type parameter corresponding with Grid row type */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModelMulti.java b/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModelMulti.java index d654a28b7d..00c115c5c2 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModelMulti.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModelMulti.java @@ -28,7 +28,7 @@ import com.vaadin.client.widgets.Grid; /** * Multi-row selection model. - * + * * @author Vaadin Ltd * @since 7.4 */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModelNone.java b/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModelNone.java index 23ad203072..48c1e3a850 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModelNone.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModelNone.java @@ -24,7 +24,7 @@ import com.vaadin.client.widgets.Grid; /** * No-row selection model. - * + * * @author Vaadin Ltd * @since 7.4 */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModelSingle.java b/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModelSingle.java index 38605db12c..f3df892623 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModelSingle.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/selection/SelectionModelSingle.java @@ -24,7 +24,7 @@ import com.vaadin.client.widgets.Grid; /** * Single-row selection model. - * + * * @author Vaadin Ltd * @since 7.4 */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/selection/SpaceSelectHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/selection/SpaceSelectHandler.java index 42abb4592c..456f08c5b3 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/selection/SpaceSelectHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/selection/SpaceSelectHandler.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -28,7 +28,7 @@ import com.vaadin.shared.ui.grid.ScrollDestination; /** * Generic class to perform selections when pressing space key. - * + * * @author Vaadin Ltd * @param <T> * row data type @@ -96,7 +96,7 @@ public class SpaceSelectHandler<T> { /** * Constructor for SpaceSelectHandler. This constructor will add all * necessary handlers for selecting rows with space. - * + * * @param grid * grid to attach to */ @@ -126,7 +126,7 @@ public class SpaceSelectHandler<T> { /** * Sets whether pressing space for the currently selected row should * deselect the row. - * + * * @param deselectAllowed * <code>true</code> to allow deselecting the selected row; * otherwise <code>false</code> diff --git a/client/src/main/java/com/vaadin/client/widget/grid/sort/Sort.java b/client/src/main/java/com/vaadin/client/widget/grid/sort/Sort.java index b1f3c6e39a..6cc0e0f5ea 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/sort/Sort.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/sort/Sort.java @@ -23,7 +23,7 @@ import com.vaadin.shared.data.sort.SortDirection; /** * Fluid Sort descriptor object. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -36,7 +36,7 @@ public class Sort { /** * Basic constructor, used by the {@link #by(GridColumn)} and * {@link #by(GridColumn, SortDirection)} methods. - * + * * @param column * a grid column * @param direction @@ -54,7 +54,7 @@ public class Sort { * isn't already used earlier (which would indicate a bug). If the column * has been used before, this constructor throws an * {@link IllegalStateException}. - * + * * @param previous * the sort instance that the new sort instance is to extend * @param column @@ -81,7 +81,7 @@ public class Sort { /** * Start building a Sort order by sorting a provided column in ascending * order. - * + * * @param column * a grid column object reference * @return a sort instance, typed to the grid data type @@ -92,7 +92,7 @@ public class Sort { /** * Start building a Sort order by sorting a provided column. - * + * * @param column * a grid column object reference * @param direction @@ -107,7 +107,7 @@ public class Sort { * Continue building a Sort order. The provided column is sorted in * ascending order if the previously added columns have been evaluated as * equals. - * + * * @param column * a grid column object reference * @return a sort instance, typed to the grid data type @@ -120,7 +120,7 @@ public class Sort { * Continue building a Sort order. The provided column is sorted in * specified order if the previously added columns have been evaluated as * equals. - * + * * @param column * a grid column object reference * @param direction @@ -136,7 +136,7 @@ public class Sort { * calling {@link com.vaadin.client.ui.grid.Grid#sort(Sort)}, but can also * be called manually to create a SortOrder list, which can also be provided * directly to Grid. - * + * * @return a sort order list. */ public List<SortOrder> build() { diff --git a/client/src/main/java/com/vaadin/client/widget/grid/sort/SortEvent.java b/client/src/main/java/com/vaadin/client/widget/grid/sort/SortEvent.java index 7945fbb8b5..fce4aeba31 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/sort/SortEvent.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/sort/SortEvent.java @@ -23,7 +23,7 @@ import com.vaadin.client.widgets.Grid; /** * A sort event, fired by the Grid when it needs its data source to provide data * sorted in a specific manner. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -38,7 +38,7 @@ public class SortEvent<T> extends GwtEvent<SortHandler<?>> { /** * Creates a new Sort Event. All provided parameters are final, and passed * on as-is. - * + * * @param grid * a grid reference * @param order @@ -61,7 +61,7 @@ public class SortEvent<T> extends GwtEvent<SortHandler<?>> { /** * Static access to the GWT event type identifier associated with this Event * class - * + * * @return a type object, uniquely describing this event type. */ public static Type<SortHandler<?>> getType() { @@ -70,7 +70,7 @@ public class SortEvent<T> extends GwtEvent<SortHandler<?>> { /** * Get access to the Grid that fired this event - * + * * @return the grid instance */ @Override @@ -80,7 +80,7 @@ public class SortEvent<T> extends GwtEvent<SortHandler<?>> { /** * Get access to the Grid that fired this event - * + * * @return the grid instance */ public Grid<T> getGrid() { @@ -89,7 +89,7 @@ public class SortEvent<T> extends GwtEvent<SortHandler<?>> { /** * Get the sort ordering that is to be applied to the Grid - * + * * @return a list of sort order objects */ public List<SortOrder> getOrder() { @@ -98,7 +98,7 @@ public class SortEvent<T> extends GwtEvent<SortHandler<?>> { /** * Returns whether this event originated from actions done by the user. - * + * * @return true if sort event originated from user interaction */ public boolean isUserOriginated() { diff --git a/client/src/main/java/com/vaadin/client/widget/grid/sort/SortHandler.java b/client/src/main/java/com/vaadin/client/widget/grid/sort/SortHandler.java index 330cbe9d58..347b0f5687 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/sort/SortHandler.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/sort/SortHandler.java @@ -20,7 +20,7 @@ import com.google.gwt.event.shared.EventHandler; /** * Handler for a Grid sort event, called when the Grid needs its data source to * provide data sorted in a specific manner. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -29,7 +29,7 @@ public interface SortHandler<T> extends EventHandler { /** * Handle sorting of the Grid. This method is called when a re-sorting of * the Grid's data is requested. - * + * * @param event * the sort event */ diff --git a/client/src/main/java/com/vaadin/client/widget/grid/sort/SortOrder.java b/client/src/main/java/com/vaadin/client/widget/grid/sort/SortOrder.java index 8166f1e6ed..f8eb58b379 100644 --- a/client/src/main/java/com/vaadin/client/widget/grid/sort/SortOrder.java +++ b/client/src/main/java/com/vaadin/client/widget/grid/sort/SortOrder.java @@ -20,7 +20,7 @@ import com.vaadin.shared.data.sort.SortDirection; /** * Sort order descriptor. Contains column and direction references. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -32,7 +32,7 @@ public class SortOrder { /** * Create a sort order descriptor with a default sorting direction value of * {@link SortDirection#ASCENDING}. - * + * * @param column * a grid column descriptor object */ @@ -42,7 +42,7 @@ public class SortOrder { /** * Create a sort order descriptor. - * + * * @param column * a grid column descriptor object * @param direction @@ -63,7 +63,7 @@ public class SortOrder { /** * Returns the {@link GridColumn} reference given in the constructor. - * + * * @return a grid column reference */ public Grid.Column<?, ?> getColumn() { @@ -72,7 +72,7 @@ public class SortOrder { /** * Returns the {@link SortDirection} value given in the constructor. - * + * * @return a sort direction value */ public SortDirection getDirection() { @@ -81,7 +81,7 @@ public class SortOrder { /** * Returns a new SortOrder object with the sort direction reversed. - * + * * @return a new sort order object */ public SortOrder getOpposite() { diff --git a/client/src/main/java/com/vaadin/client/widgets/Escalator.java b/client/src/main/java/com/vaadin/client/widgets/Escalator.java index 7e92087c22..2d5a41efb1 100644 --- a/client/src/main/java/com/vaadin/client/widgets/Escalator.java +++ b/client/src/main/java/com/vaadin/client/widgets/Escalator.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -187,14 +187,14 @@ import com.vaadin.shared.util.SharedUtil; * implement such an interface), makes it possible for JSNI to indirectly refer * to the inner class, by invoking methods and fields in the non-inner-class * API. - * + * * @see Escalator.Scroller */ abstract class JsniWorkaround { /** * A JavaScript function that handles the scroll DOM event, and passes it on * to Java code. - * + * * @see #createScrollListenerFunction(Escalator) * @see Escalator#onScroll() * @see Escalator.Scroller#onScroll() @@ -204,7 +204,7 @@ abstract class JsniWorkaround { /** * A JavaScript function that handles the mousewheel DOM event, and passes * it on to Java code. - * + * * @see #createMousewheelListenerFunction(Escalator) * @see Escalator#onScroll() * @see Escalator.Scroller#onScroll() @@ -214,7 +214,7 @@ abstract class JsniWorkaround { /** * A JavaScript function that handles the touch start DOM event, and passes * it on to Java code. - * + * * @see TouchHandlerBundle#touchStart(Escalator.JsniUtil.TouchHandlerBundle.CustomTouchEvent) */ protected JavaScriptObject touchStartFunction; @@ -222,7 +222,7 @@ abstract class JsniWorkaround { /** * A JavaScript function that handles the touch move DOM event, and passes * it on to Java code. - * + * * @see TouchHandlerBundle#touchMove(Escalator.JsniUtil.TouchHandlerBundle.CustomTouchEvent) */ protected JavaScriptObject touchMoveFunction; @@ -230,7 +230,7 @@ abstract class JsniWorkaround { /** * A JavaScript function that handles the touch end and cancel DOM events, * and passes them on to Java code. - * + * * @see TouchHandlerBundle#touchEnd(Escalator.JsniUtil.TouchHandlerBundle.CustomTouchEvent) */ protected JavaScriptObject touchEndFunction; @@ -251,7 +251,7 @@ abstract class JsniWorkaround { /** * A method that constructs the JavaScript function that will be stored into * {@link #scrollListenerFunction}. - * + * * @param esc * a reference to the current instance of {@link Escalator} * @see Escalator#onScroll() @@ -262,7 +262,7 @@ abstract class JsniWorkaround { /** * A method that constructs the JavaScript function that will be stored into * {@link #mousewheelListenerFunction}. - * + * * @param esc * a reference to the current instance of {@link Escalator} * @see Escalator#onScroll() @@ -274,7 +274,7 @@ abstract class JsniWorkaround { /** * A low-level table-like widget that features a scrolling virtual viewport and * lazily generated rows. - * + * * @since 7.4 * @author Vaadin Ltd */ @@ -673,13 +673,13 @@ public class Escalator extends Widget /*-{ var vScroll = esc.@com.vaadin.client.widgets.Escalator::verticalScrollbar; var vScrollElem = vScroll.@com.vaadin.client.widget.escalator.ScrollbarBundle::getElement()(); - + var hScroll = esc.@com.vaadin.client.widgets.Escalator::horizontalScrollbar; var hScrollElem = hScroll.@com.vaadin.client.widget.escalator.ScrollbarBundle::getElement()(); - + return $entry(function(e) { var target = e.target || e.srcElement; // IE8 uses e.scrElement - + // in case the scroll event was native (i.e. scrollbars were dragged, or // the scrollTop/Left was manually modified), the bundles have old cache // values. We need to make sure that the caches are kept up to date. @@ -700,29 +700,29 @@ public class Escalator extends Widget return $entry(function(e) { var deltaX = e.deltaX ? e.deltaX : -0.5*e.wheelDeltaX; var deltaY = e.deltaY ? e.deltaY : -0.5*e.wheelDeltaY; - + // Delta mode 0 is in pixels; we don't need to do anything... - + // A delta mode of 1 means we're scrolling by lines instead of pixels // We need to scale the number of lines by the default line height if(e.deltaMode === 1) { var brc = esc.@com.vaadin.client.widgets.Escalator::body; deltaY *= brc.@com.vaadin.client.widgets.Escalator.AbstractRowContainer::getDefaultRowHeight()(); } - + // Other delta modes aren't supported if((e.deltaMode !== undefined) && (e.deltaMode >= 2 || e.deltaMode < 0)) { var msg = "Unsupported wheel delta mode \"" + e.deltaMode + "\""; - + // Print warning message esc.@com.vaadin.client.widgets.Escalator::logWarning(*)(msg); } - + // IE8 has only delta y if (isNaN(deltaY)) { deltaY = -0.5*e.wheelDelta; } - + @com.vaadin.client.widgets.Escalator.JsniUtil::moveScrollFromEvent(*)(esc, deltaX, deltaY, e); }); }-*/; @@ -1102,7 +1102,7 @@ public class Escalator extends Widget * <p> * <em>Note:</em> To actually <em>create</em> such an element, use * {@link #createCellElement(int, int)} instead. - * + * * @return the tag name for the element to represent cells as * @see #createCellElement(int, int) */ @@ -1119,7 +1119,7 @@ public class Escalator extends Widget * <em>Implementation detail:</em> This method does no DOM modifications * (i.e. is very cheap to call) if there is no data for rows or columns * when this method is called. - * + * * @see #hasColumnAndRowData() */ @Override @@ -1143,7 +1143,7 @@ public class Escalator extends Widget * <em>Implementation detail:</em> This method does no DOM modifications * (i.e. is very cheap to call) if there are no rows in the DOM when * this method is called. - * + * * @see #hasSomethingInDom() */ @Override @@ -1171,7 +1171,7 @@ public class Escalator extends Widget * <p> * The implementation must call {@link #paintRemoveRow(Element, int)} * for each row that is removed from the DOM. - * + * * @param index * the logical index of the first removed row * @param numberOfRows @@ -1189,7 +1189,7 @@ public class Escalator extends Widget * <p> * This method must be called for each removed DOM row by any * {@link #paintRemoveRows(int, int)} implementation. - * + * * @param tr * the row element to remove. */ @@ -1246,9 +1246,9 @@ public class Escalator extends Widget * <p> * Any extra content, such as spacers for the body, should not be * included in this count. - * + * * @since 7.5.0 - * + * * @return the actual DOM count of rows */ public abstract int getDomRowCount(); @@ -1259,7 +1259,7 @@ public class Escalator extends Widget * <em>Implementation detail:</em> This method does no DOM modifications * (i.e. is very cheap to call) if there is no data for columns when * this method is called. - * + * * @see #hasColumnAndRowData() */ @Override @@ -1310,7 +1310,7 @@ public class Escalator extends Widget /** * Actually add rows into the DOM, now that everything can be * calculated. - * + * * @param visualIndex * the DOM index to add rows into * @param numberOfRows @@ -1380,7 +1380,7 @@ public class Escalator extends Widget * {@link EscalatorUpdater#postAttach(Row, Iterable) postAttach} before * and after inserting the row, respectively. The row should have its * cells already inserted. - * + * * @param referenceRow * the row after which to insert or null if insert as first * @param tr @@ -1445,7 +1445,7 @@ public class Escalator extends Widget * <em>Implementation detail:</em> This method does no DOM modifications * (i.e. is very cheap to call) if there is no data for columns when * this method is called. - * + * * @see #hasColumnAndRowData() */ @Override @@ -1482,10 +1482,10 @@ public class Escalator extends Widget /** * Create and setup an empty cell element. - * + * * @param width * the width of the cell, in pixels - * + * * @return a set-up empty cell element */ public TableCellElement createCellElement(final double width) { @@ -1510,7 +1510,7 @@ public class Escalator extends Widget /** * Gets the child element that is visually at a certain index - * + * * @param index * the index of the element to retrieve * @return the element at position {@code index} @@ -1570,7 +1570,7 @@ public class Escalator extends Widget * Precondition: The row must be already attached to the DOM and the * FlyweightCell instances corresponding to the new columns added to * {@code flyweightRow}. - * + * * @param tr * the row in which to insert the cells * @param logicalRowIndex @@ -1671,9 +1671,9 @@ public class Escalator extends Widget * <p> * In practice, this applies for all header and footer rows. For body * rows, it applies for all rows except spacer rows. - * + * * @since 7.5.0 - * + * * @param tr * the row element to check for if it is or has elements that * can be frozen @@ -1685,7 +1685,7 @@ public class Escalator extends Widget /** * Iterates through all the cells in a column and returns the width of * the widest element in this RowContainer. - * + * * @param index * the index of the column to inspect * @return the pixel width of the widest element in the indicated column @@ -1785,7 +1785,7 @@ public class Escalator extends Widget /** * The primary style name for the container. - * + * * @param primaryStyleName * the style name to use as prefix for all row and cell style * names. @@ -1815,7 +1815,7 @@ public class Escalator extends Widget /** * Returns the primary style name of the container. - * + * * @return The primary style name or <code>null</code> if not set. */ protected String getStylePrimaryName() { @@ -1879,7 +1879,7 @@ public class Escalator extends Widget * <em>Note:</em> This method does not calculate what a row's top * position should be. It just returns an assigned value, correct or * not. - * + * * @param tr * the table row element to measure * @return the current top position for {@code tr} @@ -2000,7 +2000,7 @@ public class Escalator extends Widget /* * To get the actual width of the contents, we need to get the cell * content without any hardcoded height or width. - * + * * But we don't want to modify the existing column, because that * might trigger some unnecessary listeners and whatnot. So, * instead, we make a deep clone of that cell, but without any @@ -2031,7 +2031,7 @@ public class Escalator extends Widget /** * Gets the minimum width needed to display the cell properly. - * + * * @param colIndex * index of column to measure * @param withContent @@ -2079,9 +2079,9 @@ public class Escalator extends Widget * <p> * Note that {@link Escalator#getBody() the body} will calculate its * height, while the others will return a precomputed value. - * + * * @since 7.5.0 - * + * * @return the height of this table section */ protected abstract double getHeightOfSection(); @@ -2144,7 +2144,7 @@ public class Escalator extends Widget * temporarily shrunk and then re-expanded. This leads to the fact * that the scroll position is scooted up a bit. This means that we * need to reset the position here. - * + * * If Escalator, at some point, gets a JIT evaluation functionality, * this re-setting is a strong candidate for removal. */ @@ -2338,14 +2338,14 @@ public class Escalator extends Widget * The order in which row elements are rendered visually in the browser, * with the help of CSS tricks. Usually has nothing to do with the DOM * order. - * + * * @see #sortDomElements() */ private final LinkedList<TableRowElement> visualRowOrder = new LinkedList<TableRowElement>(); /** * The logical index of the topmost row. - * + * * @deprecated Use the accessors {@link #setTopRowLogicalIndex(int)}, * {@link #updateTopRowLogicalIndex(int)} and * {@link #getTopRowLogicalIndex()} instead @@ -2633,7 +2633,7 @@ public class Escalator extends Widget * TODO: this method should probably only add physical rows, and not * populate them - let everything be populated as appropriate by the * logic that follows. - * + * * This also would lead to the fact that paintInsertRows wouldn't * need to return anything. */ @@ -2677,7 +2677,7 @@ public class Escalator extends Widget /* * At this point, we have added new escalator rows, if so * needed. - * + * * If more rows were added than the new escalator rows can * account for, we need to start to spin the escalator to update * the remaining rows aswell. @@ -2737,7 +2737,7 @@ public class Escalator extends Widget /** * Move escalator rows around, and make sure everything gets * appropriately repositioned and repainted. - * + * * @param visualSourceRange * the range of rows to move to a new place * @param visualTargetIndex @@ -2781,7 +2781,7 @@ public class Escalator extends Widget * about. Having 10 rows, if we move 0..1 to index 10 (to the end of * the collection), the target range will end up being 8..9, instead * of 10..11. - * + * * This applies only if we move elements forward in the collection, * not backward. */ @@ -2863,7 +2863,7 @@ public class Escalator extends Widget * position with 27.5px will move the viewport 27.5px down, and place * the row at 20px.</dd> * </dl> - * + * * @param yDelta * the delta of pixels by which to move the viewport and * content. A positive value moves everything downwards, @@ -2905,7 +2905,7 @@ public class Escalator extends Widget * <p> * If Escalator already is at (or beyond) max capacity, this method does * nothing to the DOM. - * + * * @param index * the index at which to add new escalator rows. * <em>Note:</em>It is assumed that the index is both the @@ -2976,7 +2976,7 @@ public class Escalator extends Widget /* * Removing spacers as the very first step will correct the * scrollbars and row offsets right away. - * + * * TODO: actually, it kinda sounds like a Grid feature that a spacer * would be associated with a particular row. Maybe it would be * better to have a spacer separate from rows, and simply collapse @@ -3001,15 +3001,15 @@ public class Escalator extends Widget /* * Adjust scroll position in one of two scenarios: - * + * * 1) Rows were removed above. Then we just need to adjust the * scrollbar by the height of the removed rows. - * + * * 2) There are no logical rows above, and at least the first (if * not more) visual row is removed. Then we need to snap the scroll * position to the first visible row (i.e. reset scroll position to * absolute 0) - * + * * The logic is optimized in such a way that the * moveViewportAndContent is called only once, to avoid extra * reflows, and thus the code might seem a bit obscure. @@ -3106,17 +3106,17 @@ public class Escalator extends Widget /* * Two things (or a combination thereof) can happen: - * + * * 1) We're scrolled to the bottom, the last rows are * removed. SOLUTION: moveAndUpdateEscalatorRows the * bottommost rows, and place them at the top to be * refreshed. - * + * * 2) We're scrolled somewhere in the middle, arbitrary rows * are removed. SOLUTION: moveAndUpdateEscalatorRows the * removed rows, and place them at the bottom to be * refreshed. - * + * * Since a combination can also happen, we need to handle * this in a smart way, all while avoiding * double-refreshing. @@ -3160,7 +3160,7 @@ public class Escalator extends Widget * moveAndUpdateEscalatorRows recalculates the rows, but * logical top row index bookkeeping is handled in this * method. - * + * * TODO: Redesign how to keep it easy to track this. */ updateTopRowLogicalIndex( @@ -3171,7 +3171,7 @@ public class Escalator extends Widget * fixed automatically. Because the amount of rows is * decreased, the viewport is pushed up as the scrollbar * shrinks. So no need to do anything there. - * + * * TODO [[optimize]]: This might lead to a double body * refresh. Needs investigation. */ @@ -3201,12 +3201,12 @@ public class Escalator extends Widget /* * We're in a combination, where we need to both scroll * up AND show new rows at the bottom. - * + * * Example: Scrolled down to show the second to last * row. Remove two. Viewport scrolls up, revealing the * row above row. The last element collapses up and into * view. - * + * * Reminder: this use case handles only the case when * there are enough escalator rows to still render a * full view. I.e. all escalator rows will _always_ be @@ -3228,7 +3228,7 @@ public class Escalator extends Widget /* * STEP 1: - * + * * reorganize deprecated escalator rows to bottom, but * don't re-render anything yet */ @@ -3258,7 +3258,7 @@ public class Escalator extends Widget /* * STEP 2: - * + * * manually scroll */ /*- @@ -3290,7 +3290,7 @@ public class Escalator extends Widget /* * STEP 3: - * + * * update remaining escalator rows */ /*- @@ -3425,7 +3425,7 @@ public class Escalator extends Widget * <li>convertToVisual([35..1]) → [0..-1] <em>(empty)</em> * <li>convertToVisual([0..100]) → [0..9] * </ul> - * + * * @return a logical range converted to a visual range, truncated to the * current viewport. The first visual row has the index 0. */ @@ -3538,14 +3538,14 @@ public class Escalator extends Widget /* * This method indeed has a smell very similar to paintRemoveRows * and paintInsertRows. - * + * * Unfortunately, those the code can't trivially be shared, since * there are some slight differences in the respective * responsibilities. The "paint" methods fake the addition and * removal of rows, and make sure to either push existing data out * of view, or draw new data into view. Only in some special cases * will the DOM element count change. - * + * * This method, however, has the explicit responsibility to verify * that when "something" happens, we still have the correct amount * of escalator rows in the DOM, and if not, we make sure to modify @@ -3595,7 +3595,7 @@ public class Escalator extends Widget * index, we thank for the added escalator rows, but since * they're painted in the wrong CSS position, we need to * move them to their actual locations. - * + * * Note: this is the second (see body.paintInsertRows) * occasion where fillAndPopulateEscalatorRowsIfNeeded would * behave "more correctly" if it only would add escalator @@ -3608,17 +3608,17 @@ public class Escalator extends Widget } else { /* * TODO [[optimize]] - * + * * We're scrolled so far down that all rows can't be simply * appended at the end, since we might start displaying * escalator rows that don't exist. To avoid the mess that * is body.paintRemoveRows, this is a dirty hack that dumbs * the problem down to a more basic and already-solved * problem: - * + * * 1) scroll all the way up 2) add the missing escalator * rows 3) scroll back to the original position. - * + * * Letting the browser scroll back to our original position * will automatically solve any possible overflow problems, * since the browser will not allow us to scroll beyond the @@ -3651,7 +3651,7 @@ public class Escalator extends Widget * extra escalator row at the bottom, we'll probably end up with * blank space at the bottom of the escalator, and one extra row * above the header. - * + * * Experimentation idea #1: calculate "scrollbottom" vs content * bottom and remove one row from top, rest from bottom. This * FAILED, since setHeight has already happened, thus we never @@ -3732,7 +3732,7 @@ public class Escalator extends Widget /** * Sorts the rows in the DOM to correspond to the visual order. - * + * * @see #visualRowOrder */ private void sortDomElements() { @@ -3756,13 +3756,13 @@ public class Escalator extends Widget /* * Two cases handled simultaneously: - * + * * 1) No focus on rows. We iterate visualRowOrder backwards, and * take the respective element in the DOM, and place it as the first * child in the body element. Then we take the next-to-last from * visualRowOrder, and put that first, pushing the previous row as * the second child. And so on... - * + * * 2) Focus on some row within Escalator body. Again, we iterate * visualRowOrder backwards. This time, we use the focused row as a * pivot: Instead of placing rows from the bottom of visualRowOrder @@ -3826,7 +3826,7 @@ public class Escalator extends Widget /** * Get the {@literal <tbody>} row that contains (or has) focus. - * + * * @return The {@literal <tbody>} row that contains a focused DOM * element, or <code>null</code> if focus is outside of a body * row. @@ -3892,7 +3892,7 @@ public class Escalator extends Widget * A correct result requires that both {@link #getDefaultRowHeight()} is * consistent, and the placement and height of all spacers above the * given logical index are consistent. - * + * * @param logicalIndex * the logical index of the row for which to calculate the * top position @@ -3986,7 +3986,7 @@ public class Escalator extends Widget /** * Returns the actual width in the DOM. - * + * * @return the width in pixels in the DOM. Returns -1 if the column * needs measuring, but has not been yet measured */ @@ -3995,7 +3995,7 @@ public class Escalator extends Widget * This might return an untrue value (e.g. during init/onload), * since we haven't had a proper chance to actually calculate * widths yet. - * + * * This is fixed during Escalator.onLoad, by the call to * "measureAndSetWidthIfNeeded", which fixes "everything". */ @@ -4037,7 +4037,7 @@ public class Escalator extends Widget */ /** * A cached array of all the calculated column widths. - * + * * @see #getCalculatedColumnWidths() */ private double[] widthsArray = null; @@ -4048,7 +4048,7 @@ public class Escalator extends Widget * <em>Implementation detail:</em> This method does no DOM modifications * (i.e. is very cheap to call) if there are no rows in the DOM when * this method is called. - * + * * @see #hasSomethingInDom() */ @Override @@ -4103,7 +4103,7 @@ public class Escalator extends Widget * reveal further colspans, modifying the DOM structure once again, * ending in a cascade of updates. Because we don't know how the * data is updated. - * + * * So, instead, we don't do anything. The client code is responsible * for re-rendering the content (if so desired). Everything Just * Works (TM) if colspans aren't used. @@ -4145,7 +4145,7 @@ public class Escalator extends Widget /** * Calculate the width of a row, as the sum of columns' widths. - * + * * @return the width of a row, in pixels */ public double calculateRowWidth() { @@ -4176,7 +4176,7 @@ public class Escalator extends Widget * <em>Implementation detail:</em> This method does no DOM modifications * (i.e. is very cheap to call) if there is no data for rows when this * method is called. - * + * * @see #hasColumnAndRowData() */ @Override @@ -4253,7 +4253,7 @@ public class Escalator extends Widget * affect surrounding colspans, modifying the DOM structure once * again, ending in a cascade of updates. Because we don't know how * the data is updated. - * + * * So, instead, we don't do anything. The client code is responsible * for re-rendering the content (if so desired). Everything Just * Works (TM) if colspans aren't used. @@ -4406,7 +4406,7 @@ public class Escalator extends Widget /** * Calculates the width of the columns in a given range. - * + * * @param columns * the columns to calculate * @return the total width of the columns in the given @@ -4601,7 +4601,7 @@ public class Escalator extends Widget /* * We can't use adjustScrollPos here, probably because of a * bookkeeping-related race condition. - * + * * This particular situation is easier, however, since we * know exactly how many pixels we need to move (heightDiff) * and all elements below the spacer always need to move @@ -4627,7 +4627,7 @@ public class Escalator extends Widget * If the scroll top is in the middle of the modified * spacer, we want to scroll the viewport up as usual, * but we don't want to scroll past the top of it. - * + * * Math.max ensures this (remember: the result is going * to be negative). */ @@ -4727,7 +4727,7 @@ public class Escalator extends Widget /** * Crop the decorator element so that it doesn't overlap the header * and footer sections. - * + * * @param bodyTop * the top cordinate of the escalator body * @param bodyBottom @@ -4741,7 +4741,7 @@ public class Escalator extends Widget final int bottom = deco.getAbsoluteBottom(); /* * FIXME - * + * * Height and its use is a workaround for the issue where * coordinates of the deco are not calculated yet. This will * prevent a deco from being displayed when it's added to DOM @@ -4906,7 +4906,7 @@ public class Escalator extends Widget /** * Calculates the sum of all spacers. - * + * * @return sum of all spacers, or 0 if no spacers present */ public double getSpacerHeightsSum() { @@ -4915,7 +4915,7 @@ public class Escalator extends Widget /** * Calculates the sum of all spacers from one row index onwards. - * + * * @param logicalRowIndex * the spacer to include as the first calculated spacer * @return the sum of all spacers from {@code logicalRowIndex} and @@ -4931,7 +4931,7 @@ public class Escalator extends Widget /** * Get all spacers from one pixel point onwards. * <p> - * + * * In this method, the {@link SpacerInclusionStrategy} has the following * meaning when a spacer lies in the middle of either pixel argument: * <dl> @@ -4942,7 +4942,7 @@ public class Escalator extends Widget * <dt>{@link SpacerInclusionStrategy#NONE NONE} * <dd>ignore the spacer * </dl> - * + * * @param px * the pixel point after which to return all spacers * @param strategy @@ -4977,7 +4977,7 @@ public class Escalator extends Widget /** * Gets the spacers currently rendered in the DOM. - * + * * @return an unmodifiable (but live) collection of the spacers * currently in the DOM */ @@ -5000,7 +5000,7 @@ public class Escalator extends Widget * <dt>{@link SpacerInclusionStrategy#NONE NONE} * <dd>ignore that spacer * </dl> - * + * * @param rangeTop * the top pixel point * @param topInclusion @@ -5120,7 +5120,7 @@ public class Escalator extends Widget /** * Gets the amount of pixels occupied by spacers from the top until a * certain spot from the top of the body. - * + * * @param px * pixels counted from the top * @return the pixels occupied by spacers up until {@code px} @@ -5134,7 +5134,7 @@ public class Escalator extends Widget /** * Gets the amount of pixels occupied by spacers until a logical row * index. - * + * * @param logicalIndex * a logical row index * @return the pixels occupied by spacers up until {@code logicalIndex} @@ -5155,7 +5155,7 @@ public class Escalator extends Widget /** * Gets the height of the spacer for a row index. - * + * * @param rowIndex * the index of the row where the spacer should be * @return the height of the spacer at index {@code rowIndex}, or 0 if @@ -5322,7 +5322,7 @@ public class Escalator extends Widget * <p> * <em>Note:</em> This method does not check for the validity of any * arguments. - * + * * @param index * the index of first row to move * @param numberOfRows @@ -5397,7 +5397,7 @@ public class Escalator extends Widget /** * Utility class for parsing and storing SubPart request string attributes * for Grid and Escalator. - * + * * @since 7.5.0 */ public static class SubPartArguments { @@ -5484,7 +5484,7 @@ public class Escalator extends Widget /** * TODO: investigate whether this field is now unnecessary, as * {@link ScrollbarBundle} now caches its values. - * + * * @deprecated maybe... */ @Deprecated @@ -5493,7 +5493,7 @@ public class Escalator extends Widget /** * TODO: investigate whether this field is now unnecessary, as * {@link ScrollbarBundle} now caches its values. - * + * * @deprecated maybe... */ @Deprecated @@ -5676,7 +5676,7 @@ public class Escalator extends Widget /* * Because of all the IE hacks we've done above, we now have scrollbars * hiding underneath a lot of DOM elements. - * + * * This leads to problems with OSX (and many touch-only devices) when * scrollbars are only shown when scrolling, as the scrollbar elements * are hidden underneath everything. We trust that the scrollbars behave @@ -5711,7 +5711,7 @@ public class Escalator extends Widget * after it is first detached and then reattached to the DOM. * This only applies to a bare Escalator; inside a Grid * everything works fine either way. - * + * * The three autodetectRowHeightLater calls above seem obvious * suspects at first. However, they don't seem to have anything * to do with the issue, as they are no-ops in the @@ -5723,13 +5723,13 @@ public class Escalator extends Widget /* * Note: There's no need to explicitly insert rows into the body. - * + * * recalculateElementSizes will recalculate the height of the body. This * has the side-effect that as the body's size grows bigger (i.e. from 0 * to its actual height), more escalator rows are populated. Those * escalator rows are then immediately rendered. This, in effect, is the * same thing as inserting those rows. - * + * * In fact, having an extra paintInsertRows here would lead to duplicate * rows. */ @@ -5825,7 +5825,7 @@ public class Escalator extends Widget /** * Check whether there are both columns and any row data (for either * headers, body or footer). - * + * * @return <code>true</code> iff header, body or footer has rows && there * are columns */ @@ -5837,7 +5837,7 @@ public class Escalator extends Widget /** * Check whether there are any cells in the DOM. - * + * * @return <code>true</code> iff header, body or footer has any child * elements */ @@ -5848,7 +5848,7 @@ public class Escalator extends Widget /** * Returns the row container for the header in this Escalator. - * + * * @return the header. Never <code>null</code> */ public RowContainer getHeader() { @@ -5857,7 +5857,7 @@ public class Escalator extends Widget /** * Returns the row container for the body in this Escalator. - * + * * @return the body. Never <code>null</code> */ public BodyRowContainer getBody() { @@ -5866,7 +5866,7 @@ public class Escalator extends Widget /** * Returns the row container for the footer in this Escalator. - * + * * @return the footer. Never <code>null</code> */ public RowContainer getFooter() { @@ -5875,7 +5875,7 @@ public class Escalator extends Widget /** * Returns the configuration object for the columns in this Escalator. - * + * * @return the configuration object for the columns in this Escalator. Never * <code>null</code> */ @@ -5899,7 +5899,7 @@ public class Escalator extends Widget * <p> * If Escalator is currently not in {@link HeightMode#CSS}, the given value * is remembered, and applied once the mode is applied. - * + * * @see #setHeightMode(HeightMode) */ @Override @@ -5954,7 +5954,7 @@ public class Escalator extends Widget /** * Returns the vertical scroll offset. Note that this is not necessarily the * same as the {@code scrollTop} attribute in the DOM. - * + * * @return the logical vertical scroll offset */ public double getScrollTop() { @@ -5964,7 +5964,7 @@ public class Escalator extends Widget /** * Sets the vertical scroll offset. Note that this will not necessarily * become the same as the {@code scrollTop} attribute in the DOM. - * + * * @param scrollTop * the number of pixels to scroll vertically */ @@ -5975,7 +5975,7 @@ public class Escalator extends Widget /** * Returns the logical horizontal scroll offset. Note that this is not * necessarily the same as the {@code scrollLeft} attribute in the DOM. - * + * * @return the logical horizontal scroll offset */ public double getScrollLeft() { @@ -5985,7 +5985,7 @@ public class Escalator extends Widget /** * Sets the logical horizontal scroll offset. Note that will not necessarily * become the same as the {@code scrollLeft} attribute in the DOM. - * + * * @param scrollLeft * the number of pixels to scroll horizontally */ @@ -5996,7 +5996,7 @@ public class Escalator extends Widget /** * Returns the scroll width for the escalator. Note that this is not * necessary the same as {@code Element.scrollWidth} in the DOM. - * + * * @since 7.5.0 * @return the scroll width in pixels */ @@ -6007,7 +6007,7 @@ public class Escalator extends Widget /** * Returns the scroll height for the escalator. Note that this is not * necessary the same as {@code Element.scrollHeight} in the DOM. - * + * * @since 7.5.0 * @return the scroll height in pixels */ @@ -6019,7 +6019,7 @@ public class Escalator extends Widget * Scrolls the body horizontally so that the column at the given index is * visible and there is at least {@code padding} pixels in the direction of * the given scroll destination. - * + * * @param columnIndex * the index of the column to scroll to * @param destination @@ -6062,7 +6062,7 @@ public class Escalator extends Widget * Scrolls the body vertically so that the row at the given index is visible * and there is at least {@literal padding} pixels to the given scroll * destination. - * + * * @param rowIndex * the index of the logical row to scroll to * @param destination @@ -6102,7 +6102,7 @@ public class Escalator extends Widget * Scrolls the body vertically so that the spacer at the given row index is * visible and there is at least {@literal padding} pixesl to the given * scroll destination. - * + * * @since 7.5.0 * @param spacerIndex * the row index of the spacer to scroll to @@ -6130,7 +6130,7 @@ public class Escalator extends Widget * <p> * If a spacer is not open at that index, this method behaves like * {@link #scrollToRow(int, ScrollDestination, int)} - * + * * @since 7.5.0 * @param rowIndex * the index of the logical row to scroll to. -1 takes the @@ -6254,7 +6254,7 @@ public class Escalator extends Widget /** * Snap deltas of x and y to the major four axes (up, down, left, right) * with a threshold of a number of degrees from those axes. - * + * * @param deltaX * the delta in the x axis * @param deltaY @@ -6287,7 +6287,7 @@ public class Escalator extends Widget * Adds an event handler that gets notified when the range of visible rows * changes e.g. because of scrolling, row resizing or spacers * appearing/disappearing. - * + * * @param rowVisibilityChangeHandler * the event handler * @return a handler registration for the added handler @@ -6315,7 +6315,7 @@ public class Escalator extends Widget /** * Gets the logical index range of currently visible rows. - * + * * @return logical index range of visible rows */ public Range getVisibleRowRange() { @@ -6330,7 +6330,7 @@ public class Escalator extends Widget /** * Returns the widget from a cell node or <code>null</code> if there is no * widget in the cell - * + * * @param cellNode * The cell node */ @@ -6378,7 +6378,7 @@ public class Escalator extends Widget * <p> * If Escalator is currently not in {@link HeightMode#ROW}, the given value * is remembered, and applied once the mode is applied. - * + * * @param rows * the number of rows that should be visible in Escalator's body * @throws IllegalArgumentException @@ -6406,7 +6406,7 @@ public class Escalator extends Widget * {@link #getHeightMode()} is {@link HeightMode#ROW}. * <p> * By default, it is 10. - * + * * @return the amount of rows that are being shown in Escalator's body * @see #setHeightByRows(double) */ @@ -6451,7 +6451,7 @@ public class Escalator extends Widget * inserted or removed, the widget will resize itself to still display the * required amount of rows in its body. It also takes the horizontal * scrollbar into account. - * + * * @param heightMode * the mode in to which Escalator should be set */ @@ -6461,7 +6461,7 @@ public class Escalator extends Widget * widget dimensions (height/width) on each state change event. The * original design was to have setHeight an setHeightByRow be equals, * and whichever was called the latest was considered in effect. - * + * * But, because of Vaadin always calling setHeight on the widget, this * approach doesn't work. */ @@ -6490,7 +6490,7 @@ public class Escalator extends Widget * Returns the current {@link HeightMode} the Escalator is in. * <p> * Defaults to {@link HeightMode#CSS}. - * + * * @return the current HeightMode */ public HeightMode getHeightMode() { @@ -6499,7 +6499,7 @@ public class Escalator extends Widget /** * Returns the {@link RowContainer} which contains the element. - * + * * @param element * the element to check for * @return the container the element is in or <code>null</code> if element @@ -6524,7 +6524,7 @@ public class Escalator extends Widget * <p> * If a direction is locked, the escalator will refuse to scroll in that * direction. - * + * * @param direction * the orientation of the scroll to set the lock status * @param locked @@ -6547,7 +6547,7 @@ public class Escalator extends Widget /** * Checks whether or not an direction is locked for scrolling. - * + * * @param direction * the direction of the scroll of which to check the lock status * @return <code>true</code> iff the direction is locked @@ -6566,7 +6566,7 @@ public class Escalator extends Widget /** * Adds a scroll handler to this escalator - * + * * @param handler * the scroll handler to add * @return a handler registration for the registered scroll handler @@ -6592,7 +6592,7 @@ public class Escalator extends Widget /** * Gets the maximum number of body rows that can be visible on the screen at * once. - * + * * @return the maximum capacity */ public int getMaxVisibleRowCount() { @@ -6602,7 +6602,7 @@ public class Escalator extends Widget /** * Gets the escalator's inner width. This is the entire width in pixels, * without the vertical scrollbar. - * + * * @return escalator's inner width */ public double getInnerWidth() { @@ -6809,7 +6809,7 @@ public class Escalator extends Widget /** * This is an internal method for calculating minimum width for Column * resize. - * + * * @return minimum width for column */ double getMinCellWidth(int colIndex) { diff --git a/client/src/main/java/com/vaadin/client/widgets/Grid.java b/client/src/main/java/com/vaadin/client/widgets/Grid.java index 91d72518af..3ae64ecd7b 100644 --- a/client/src/main/java/com/vaadin/client/widgets/Grid.java +++ b/client/src/main/java/com/vaadin/client/widgets/Grid.java @@ -187,7 +187,7 @@ import com.vaadin.shared.util.SharedUtil; /** * A data grid view that supports columns and lazy loading of data rows from a * data source. - * + * * <h1>Columns</h1> * <p> * Each column in Grid is represented by a {@link Column}. Each @@ -207,7 +207,7 @@ import com.vaadin.shared.util.SharedUtil; * <em>See:</em> {@link #addColumn(Column)}, {@link #addColumn(Column, int)} and * {@link #addColumns(Column...)}. <em>Also</em> * {@link Column#setRenderer(Renderer)}. - * + * * <h1>Data Sources</h1> * <p> * Grid gets its data from a {@link DataSource}, providing row objects to Grid @@ -216,8 +216,8 @@ import com.vaadin.shared.util.SharedUtil; * ListDataSource}) or even a remote one, retrieving data from e.g. a REST API * (see {@link com.vaadin.client.data.AbstractRemoteDataSource * AbstractRemoteDataSource}). - * - * + * + * * @param <T> * The row type of the grid. The row type is the POJO type from where * the data is retrieved into the column cells. @@ -234,9 +234,9 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Abstract base class for Grid header and footer sections. - * + * * @since 7.5.0 - * + * * @param <ROWTYPE> * the type of the rows in the section */ @@ -244,7 +244,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * A header or footer cell. Has a simple textual caption. - * + * */ public static class StaticCell { @@ -260,7 +260,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the text displayed in this cell. - * + * * @param text * a plain text caption */ @@ -272,7 +272,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the text displayed in this cell. - * + * * @return the plain text caption */ public String getText() { @@ -294,7 +294,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the amount of columns the cell spans. By default is 1. - * + * * @return The amount of columns the cell spans. */ public int getColspan() { @@ -304,7 +304,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the amount of columns the cell spans. Must be more or equal * to 1. By default is 1. - * + * * @param colspan * the colspan to set */ @@ -320,7 +320,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the html inside the cell. - * + * * @throws IllegalStateException * if trying to retrive HTML from a cell with a type * other than {@link GridStaticCellType#HTML}. @@ -338,7 +338,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Sets the content of the cell to the provided html. All previous * content is discarded and the cell type is set to * {@link GridStaticCellType#HTML}. - * + * * @param html * The html content of the cell */ @@ -350,10 +350,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the widget in the cell. - * + * * @throws IllegalStateException * if the cell is not {@link GridStaticCellType#WIDGET} - * + * * @return the widget in the cell */ public Widget getWidget() { @@ -369,7 +369,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Set widget as the content of the cell. The type of the cell * becomes {@link GridStaticCellType#WIDGET}. All previous content * is discarded. - * + * * @param widget * The widget to add to the cell. Should not be * previously attached anywhere (widget.getParent == @@ -391,7 +391,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the type of the cell. - * + * * @return the type of content the cell contains. */ public GridStaticCellType getType() { @@ -400,7 +400,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the custom style name for this cell. - * + * * @return the style name or null if no style name has been set */ public String getStyleName() { @@ -409,7 +409,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets a custom style name for this cell. - * + * * @param styleName * the style name to set or null to not use any style * name @@ -422,7 +422,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Called when the cell is detached from the row - * + * * @since 7.6.3 */ void detach() { @@ -435,7 +435,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Abstract base class for Grid header and footer rows. - * + * * @param <CELLTYPE> * the type of the cells in the row */ @@ -458,7 +458,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the cell on given GridColumn. If the column is merged * returned cell is the cell for the whole group. - * + * * @param column * the column in grid * @return the cell on given column, merged cell for merged columns, @@ -474,7 +474,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns <code>true</code> if this row contains spanned cells. - * + * * @since 7.5.0 * @return does this row contain spanned cells */ @@ -484,7 +484,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Merges columns cells in a row - * + * * @param columns * the columns which header should be merged * @return the remaining visible cell after the merge, or the cell @@ -522,7 +522,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Merges columns cells in a row - * + * * @param cells * The cells to merge. Must be from the same row. * @return The remaining visible cell after the merge, or the first @@ -634,7 +634,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the custom style name for this row. - * + * * @return the style name or null if no style name has been set */ public String getStyleName() { @@ -643,7 +643,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets a custom style name for this row. - * + * * @param styleName * the style name to set or null to not use any style * name @@ -655,7 +655,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Called when the row is detached from the grid - * + * * @since 7.6.3 */ void detach() { @@ -678,7 +678,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Creates and returns a new instance of the row type. - * + * * @return the created row */ protected abstract ROWTYPE createRow(); @@ -694,7 +694,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the visibility of the whole section. - * + * * @param visible * true to show this section, false to hide */ @@ -705,7 +705,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the visibility of this section. - * + * * @return true if visible, false otherwise. */ public boolean isVisible() { @@ -716,11 +716,11 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Inserts a new row at the given position. Shifts the row currently at * that position and any subsequent rows down (adds one to their * indices). - * + * * @param index * the position at which to insert the row * @return the new row - * + * * @throws IndexOutOfBoundsException * if the index is out of bounds * @see #appendRow() @@ -742,7 +742,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Adds a new row at the top of this section. - * + * * @return the new row * @see #appendRow() * @see #addRowAt(int) @@ -755,7 +755,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Adds a new row at the bottom of this section. - * + * * @return the new row * @see #prependRow() * @see #addRowAt(int) @@ -768,10 +768,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Removes the row at the given position. - * + * * @param index * the position of the row - * + * * @throws IndexOutOfBoundsException * if the index is out of bounds * @see #addRowAt(int) @@ -787,10 +787,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Removes the given row from the section. - * + * * @param row * the row to be removed - * + * * @throws IllegalArgumentException * if the row does not exist in this section * @see #addRowAt(int) @@ -809,11 +809,11 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the row at the given position. - * + * * @param index * the position of the row * @return the row with the given index - * + * * @throws IndexOutOfBoundsException * if the index is out of bounds */ @@ -828,7 +828,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the number of rows in this section. - * + * * @return the number of rows */ public int getRowCount() { @@ -895,10 +895,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the default row of this header. The default row is a special * header row providing a user interface for sorting columns. - * + * * @param row * the new default row, or null for no default row - * + * * @throws IllegalArgumentException * this header does not contain the row */ @@ -924,7 +924,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the current default row of this header. The default row is a * special header row providing a user interface for sorting columns. - * + * * @return the default row or null if no default row set */ public HeaderRow getDefaultRow() { @@ -959,7 +959,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the events consumed by the header - * + * * @return a collection of BrowserEvents */ public Collection<String> getConsumedEvents() { @@ -981,7 +981,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * A single row in a grid header section. - * + * */ public static class HeaderRow extends StaticSection.StaticRow<HeaderCell> { @@ -1048,14 +1048,14 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * A single cell in a grid Footer row. Has a textual caption. - * + * */ public static class FooterCell extends StaticSection.StaticCell { } /** * A single row in a grid Footer section. - * + * */ public static class FooterRow extends StaticSection.StaticRow<FooterCell> { @@ -1070,7 +1070,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * A callback interface used to notify the invoker of the editor handler * of completed editor requests. - * + * * @param <T> * the row data type */ @@ -1078,7 +1078,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * The method that must be called when the request has been * processed correctly. - * + * * @param request * the original request object */ @@ -1087,7 +1087,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * The method that must be called when processing the request has * produced an aborting error. - * + * * @param request * the original request object */ @@ -1176,7 +1176,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * A wrapper for native DOM events originating from Grid. In addition to the * native event, contains a {@link CellReference} instance specifying which * cell the event originated from. - * + * * @since 7.6 * @param <T> * The row type of the grid @@ -1192,7 +1192,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the wrapped DOM event. - * + * * @return the DOM event */ public Event getDomEvent() { @@ -1201,7 +1201,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the Grid cell this event originated from. - * + * * @return the event cell */ public EventCellReference<T> getCell() { @@ -1210,7 +1210,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the Grid instance this event originated from. - * + * * @return the grid */ public Grid<T> getGrid() { @@ -1221,7 +1221,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * A wrapper for native DOM events related to the {@link Editor Grid editor} * . - * + * * @since 7.6 * @param <T> * the row type of the grid @@ -1238,7 +1238,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the editor of the Grid this event originated from. - * + * * @return the related editor instance */ public Editor<T> getEditor() { @@ -1247,7 +1247,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the currently focused editor widget. - * + * * @return the focused editor widget or {@code null} if not editable */ public Widget getEditorWidget() { @@ -1257,7 +1257,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the row index the editor is open at. If the editor is not * open, returns -1. - * + * * @return the index of the edited row or -1 if editor is not open */ public int getRowIndex() { @@ -1267,7 +1267,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the column index the editor was opened at. If the editor is * not open, returns -1. - * + * * @return the column index or -1 if editor is not open */ public int getFocusedColumnIndex() { @@ -1278,7 +1278,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * An editor UI for Grid rows. A single Grid row at a time can be opened for * editing. - * + * * @since 7.6 * @param <T> * the row type of the grid @@ -1311,7 +1311,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * A handler for events related to the Grid editor. Responsible for * opening, moving or closing the editor based on the received event. - * + * * @since 7.6 * @author Vaadin Ltd * @param <T> @@ -1321,7 +1321,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Handles editor-related events in an appropriate way. Opens, * moves, or closes the editor based on the given event. - * + * * @param event * the received event * @return true if the event was handled and nothing else should be @@ -1510,10 +1510,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * If a cell of this Grid had focus once this editRow call was * triggered, the editor component at the previously focused column * index will be focused. - * + * * If a Grid cell was not focused prior to calling this method, it will * be equivalent to {@code editRow(rowIndex, -1)}. - * + * * @see #editRow(int, int) */ public void editRow(int rowIndex) { @@ -1533,19 +1533,19 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Opens the editor over the row with the given index and attempts to * focus the editor widget in the given column index. Does not move * focus if the widget is not focusable or if the column index is -1. - * + * * @param rowIndex * the index of the row to be edited * @param columnIndex * the column index of the editor widget that should be * initially focused or -1 to not set focus - * + * * @throws IllegalStateException * if this editor is not enabled * @throws IllegalStateException * if this editor is already in edit mode and in buffered * mode - * + * * @since 7.5 */ public void editRow(final int rowIndex, final int columnIndex) { @@ -1630,7 +1630,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Cancels the currently active edit and hides the editor. Any changes * that are not {@link #save() saved} are lost. - * + * * @throws IllegalStateException * if this editor is not enabled * @throws IllegalStateException @@ -1672,7 +1672,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Saves any unsaved changes to the data source and hides the editor. - * + * * @throws IllegalStateException * if this editor is not enabled * @throws IllegalStateException @@ -1700,7 +1700,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the handler responsible for binding data and editor widgets * to this editor. - * + * * @return the editor handler or null if not set */ public EditorHandler<T> getHandler() { @@ -1710,10 +1710,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the handler responsible for binding data and editor widgets to * this editor. - * + * * @param rowHandler * the new editor handler - * + * * @throws IllegalStateException * if this editor is currently in edit mode */ @@ -1731,10 +1731,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the enabled state of this editor. - * + * * @param enabled * true if enabled, false otherwise - * + * * @throws IllegalStateException * if in edit mode and trying to disable * @throws IllegalStateException @@ -1783,7 +1783,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Returns the editor widget associated with the given column. If the * editor is not active or the column is not * {@link Grid.Column#isEditable() editable}, returns null. - * + * * @param column * the column * @return the widget if the editor is open and the column is editable, @@ -1795,10 +1795,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Equivalent to {@code showOverlay()}. The argument is ignored. - * + * * @param unused * ignored argument - * + * * @deprecated As of 7.5, use {@link #showOverlay()} instead. */ @Deprecated @@ -1809,7 +1809,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Opens the editor overlay over the table row indicated by * {@link #getRow()}. - * + * * @since 7.5 */ protected void showOverlay() { @@ -2079,7 +2079,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Creates an editor cell corresponding to the given table cell. The * returned element is empty and has the same dimensions and position as * the table cell. - * + * * @param td * the table cell used as a reference * @return an editor cell corresponding to the given cell @@ -2240,7 +2240,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the event handler for this Editor. - * + * * @since 7.6 * @param handler * the new event handler @@ -2251,7 +2251,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the event handler of this Editor. - * + * * @since 7.6 * @return the current event handler */ @@ -2303,7 +2303,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the Grid instance for this event. - * + * * @return grid */ public Grid<?> getGrid() { @@ -2312,7 +2312,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the focused cell for this event. - * + * * @return focused cell */ public CellReference<?> getFocusedCell() { @@ -2363,7 +2363,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the Grid instance for this event. - * + * * @return grid */ public Grid<?> getGrid() { @@ -2372,7 +2372,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the reference of target cell for this event. - * + * * @return target cell */ public CellReference<?> getTargetCell() { @@ -2423,7 +2423,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * An initial height that is given to new details rows before rendering the * appropriate widget that we then can be measure - * + * * @see GridSpacerUpdater */ private static final double DETAILS_ROW_INITIAL_HEIGHT = 50; @@ -2494,7 +2494,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets focus style for the given row if needed. - * + * * @param row * a row object */ @@ -2524,7 +2524,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * <em>NOTE:</em> the column index is the index in DOM, not the logical * column index which includes hidden columns. - * + * * @param rowIndex * the index of the row having focus * @param columnIndexDOM @@ -2605,11 +2605,11 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets focus on a cell. - * + * * <p> * <em>Note</em>: cell focus is not the same as JavaScript's * {@code document.activeElement}. - * + * * @param cell * a cell object */ @@ -2620,7 +2620,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets list of events that can be used for cell focusing. - * + * * @return list of navigation related event types */ public Collection<String> getNavigationEvents() { @@ -2792,7 +2792,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Offsets the focused cell's range. - * + * * @param offset * offset for fixing focused cell's range */ @@ -2804,7 +2804,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Informs {@link CellFocusHandler} that certain range of rows has been * added to the Grid body. {@link CellFocusHandler} will fix indices * accordingly. - * + * * @param added * a range of added rows */ @@ -2824,7 +2824,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Informs {@link CellFocusHandler} that certain range of rows has been * removed from the Grid body. {@link CellFocusHandler} will fix indices * accordingly. - * + * * @param removed * a range of removed rows */ @@ -2885,7 +2885,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * TODO: Currently the select all check box is shown when multi * selection is in use. This might result in malfunctions if no * SelectAllHandlers are present. - * + * * Later on this could be fixed so that it check such handlers * exist. */ @@ -3068,7 +3068,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * chain. If false, the sorting order is set to ASCENDING for that * cell's column. If that column was already the only sorted column in * the Grid, the sort direction is flipped. - * + * * @param cell * a valid cell reference * @param multisort @@ -3124,7 +3124,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Perform a sort after a delay. - * + * * @param delay * delay, in milliseconds */ @@ -3137,7 +3137,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Check if a delayed sort command has been issued but not yet carried * out. - * + * * @return a boolean value */ public boolean isDelayedSortScheduled() { @@ -3201,7 +3201,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Calculates and applies column widths, taking into account fixed * widths and column expand rules - * + * * @param immediately * <code>true</code> if the widths should be executed * immediately (ignoring lazy loading completely), or @@ -3299,7 +3299,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /* * Set all fixed widths and also calculate the size-to-fit widths * for the autocalculated columns. - * + * * This way we know with how many pixels we have left to expand the * rest. */ @@ -3544,7 +3544,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Check whether the auto width calculation is currently scheduled. - * + * * @return <code>true</code> if auto width calculation is currently * scheduled */ @@ -3593,7 +3593,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /* * Once we have the content properly inside the DOM, we should * re-measure it to make sure that it's the correct height. - * + * * This is rather tricky, since the row (tr) will get the * height, but the spacer cell (td) has the borders, which * should go on top of the previous row and next row. @@ -3675,7 +3675,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * grid, if it contains any column hiding options or custom widgets. The * column hiding toggles and custom widgets become visible once the sidebar * has been opened. - * + * * @since 7.5.0 */ private static class Sidebar extends Composite implements HasEnabled { @@ -3831,7 +3831,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns whether the sidebar is open or not. - * + * * @return <code>true</code> if open, <code>false</code> if not */ public boolean isOpen() { @@ -4100,7 +4100,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <li>a cell on another row, the click event is the table section ancestor * ({@code <thead>}, {@code <tbody>} or {@code <tfoot>}). * </ul> - * + * * @see #onBrowserEvent(Event) */ private Cell cellOnPrevMouseDown; @@ -4626,10 +4626,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Base class for grid columns internally used by the Grid. The user should * use {@link Column} when creating new columns. - * + * * @param <C> * the column type - * + * * @param <T> * the row type */ @@ -4706,10 +4706,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Constructs a new column with a simple TextRenderer. - * + * * @param caption * The header caption for this column - * + * * @throws IllegalArgumentException * if given header caption is null */ @@ -4720,10 +4720,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Constructs a new column with a custom renderer. - * + * * @param renderer * The renderer to use for rendering the cells - * + * * @throws IllegalArgumentException * if given Renderer is null */ @@ -4734,12 +4734,12 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Constructs a new column with a custom renderer. - * + * * @param renderer * The renderer to use for rendering the cells * @param caption * The header caption for this column - * + * * @throws IllegalArgumentException * if given Renderer or header caption is null */ @@ -4751,7 +4751,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Internally used by the grid to set itself - * + * * @param grid */ private void setGrid(Grid<T> grid) { @@ -4773,11 +4773,11 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets a header caption for this column. - * + * * @param caption * The header caption for this column * @return the column itself - * + * */ public Column<C, T> setHeaderCaption(String caption) { if (caption == null) { @@ -4796,7 +4796,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the current header caption for this column - * + * * @since 7.6 * @return the header caption string */ @@ -4821,10 +4821,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * To support other types you will need to pass a custom renderer to the * column via the column constructor. - * + * * @param row * The row object that provides the cell content. - * + * * @return The cell content */ public abstract C getValue(T row); @@ -4833,7 +4833,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * The renderer to render the cell with. By default renders the data as * a String or adds the widget into the cell if the column type is of * widget type. - * + * * @return The renderer to render the cell content with */ public Renderer<? super C> getRenderer() { @@ -4842,11 +4842,11 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets a custom {@link Renderer} for this column. - * + * * @param renderer * The renderer to use for rendering the cells * @return the column itself - * + * * @throws IllegalArgumentException * if given Renderer is null */ @@ -4904,7 +4904,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * If the column is currently {@link #isHidden() hidden}, then this set * width has effect only once the column has been made visible again. - * + * * @param pixels * the width in pixels or negative for auto sizing */ @@ -4936,7 +4936,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * <em>Note:</em> Returns the value, even if the column is currently * {@link #isHidden() hidden}. - * + * * @return pixel width of the column, or a negative number if the column * width has been automatically calculated. * @see #setWidth(double) @@ -4952,7 +4952,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * This differs from {@link #getWidth()} only when the column has been * automatically resized, or when the column is currently * {@link #isHidden() hidden}, when the value is 0. - * + * * @return pixel width of the column. */ public double getWidthActual() { @@ -4972,7 +4972,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * be sorted by a sortable column by clicking or tapping the column's * default header. Programmatic sorting using the Grid#sort methods is * not affected by this setting. - * + * * @param sortable * {@code true} if the user should be able to sort the * column, {@code false} otherwise @@ -4993,7 +4993,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * <em>Note:</em> it is possible to sort by this column programmatically * using the Grid#sort methods regardless of the returned value. - * + * * @return {@code true} if the column is sortable by the user, * {@code false} otherwise */ @@ -5003,9 +5003,9 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets whether this column can be resized by the user. - * + * * @since 7.6 - * + * * @param resizable * {@code true} if this column should be resizable, * {@code false} otherwise @@ -5027,9 +5027,9 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <em>Note:</em> the column can be programmatically resized using * {@link #setWidth(double)} and {@link #setWidthUndefined()} regardless * of the returned value. - * + * * @since 7.6 - * + * * @return {@code true} if this column is resizable, {@code false} * otherwise */ @@ -5040,7 +5040,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Hides or shows the column. By default columns are visible before * explicitly hiding them. - * + * * @since 7.5.0 * @param hidden * <code>true</code> to hide the column, <code>false</code> @@ -5088,7 +5088,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns whether this column is hidden. Default is {@code false}. - * + * * @since 7.5.0 * @return {@code true} if the column is currently hidden, {@code false} * otherwise @@ -5103,7 +5103,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * <em>Note:</em> it is still possible to hide the column * programmatically using {@link #setHidden(boolean)}. - * + * * @since 7.5.0 * @param hidable * {@code true} the user can hide this column, {@code false} @@ -5123,7 +5123,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * <em>Note:</em> the column can be programmatically hidden using * {@link #setHidden(boolean)} regardless of the returned value. - * + * * @since 7.5.0 * @return <code>true</code> if the user can hide the column, * <code>false</code> if not @@ -5139,7 +5139,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * The default value is <code>null</code>. In this case the header * caption is used, see {@link #setHeaderCaption(String)}. - * + * * @since 7.5.0 * @param hidingToggleCaption * the caption for the hiding toggle for this column @@ -5154,7 +5154,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the hiding toggle caption for this column. - * + * * @since 7.5.0 * @see #setHidingToggleCaption(String) * @return the hiding toggle's caption for this column @@ -5198,7 +5198,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * This action is done "finally", once the current execution loop * returns. This is done to reduce overhead of unintentionally always * recalculate all columns, when modifying several columns at once. - * + * * @param pixels * the minimum width * @return this column @@ -5227,7 +5227,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * This action is done "finally", once the current execution loop * returns. This is done to reduce overhead of unintentionally always * recalculate all columns, when modifying several columns at once. - * + * * @param pixels * the maximum width * @param immediately @@ -5275,7 +5275,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * This action is done "finally", once the current execution loop * returns. This is done to reduce overhead of unintentionally always * recalculate all columns, when modifying several columns at once. - * + * * @param expandRatio * the expand ratio of this column. {@code 0} to not have it * expand at all. A negative number to clear the expand @@ -5294,7 +5294,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Clears the column's expand ratio. * <p> * Same as calling {@link #setExpandRatio(int) setExpandRatio(-1)} - * + * * @return this column */ public Column<C, T> clearExpandRatio() { @@ -5303,7 +5303,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the minimum width for this column. - * + * * @return the minimum width for this column * @see #setMinimumWidth(double) */ @@ -5313,7 +5313,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the maximum width for this column. - * + * * @return the maximum width for this column * @see #setMaximumWidth(double) */ @@ -5323,7 +5323,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the expand ratio for this column. - * + * * @return the expand ratio for this column * @see #setExpandRatio(int) */ @@ -5334,15 +5334,15 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets whether the values in this column should be editable by the user * when the row editor is active. By default columns are editable. - * + * * @param editable * {@code true} to set this column editable, {@code false} * otherwise * @return this column - * + * * @throws IllegalStateException * if the editor is currently active - * + * * @see Grid#editRow(int) * @see Grid#isEditorActive() */ @@ -5358,10 +5358,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns whether the values in this column are editable by the user * when the row editor is active. - * + * * @return {@code true} if this column is editable, {@code false} * otherwise - * + * * @see #setEditable(boolean) */ public boolean isEditable() { @@ -5374,7 +5374,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, } else { /* * NOOP - * + * * Since setGrid() will call reapplyWidths as the colum is * attached to a grid, it will call setWidth, which, in turn, * will call this method again. Therefore, it's guaranteed that @@ -5386,7 +5386,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Resets the default header cell contents to column header captions. - * + * * @since 7.5.1 * @param cell * default header cell for this column @@ -5825,7 +5825,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sort indicator requires a bit more space from the cell than normally. * This method check that the now sorted column has enough width. - * + * * @param column * sorted column */ @@ -6059,9 +6059,9 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Creates the escalator updater used to update the header rows in this * grid. The updater is invoked when header rows or columns are added or * removed, or the content of existing header cells is changed. - * + * * @return the new header updater instance - * + * * @see GridHeader * @see Grid#getHeader() */ @@ -6074,7 +6074,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * The updater is invoked when body rows or columns are added or removed, * the content of body cells is changed, or the body is scrolled to expose * previously hidden content. - * + * * @return the new body updater instance */ protected EscalatorUpdater createBodyUpdater() { @@ -6085,9 +6085,9 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Creates the escalator updater used to update the footer rows in this * grid. The updater is invoked when header rows or columns are added or * removed, or the content of existing header cells is changed. - * + * * @return the new footer updater instance - * + * * @see GridFooter * @see #getFooter() */ @@ -6097,7 +6097,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Refreshes header or footer rows on demand - * + * * @param rows * The row container * @param firstRowIsVisible @@ -6125,7 +6125,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Focus a body cell by row and column index. - * + * * @param rowIndex * index of row to focus * @param columnIndex @@ -6171,7 +6171,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Adds columns as the last columns in the grid. - * + * * @param columns * the columns to add */ @@ -6184,7 +6184,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Adds a column as the last column in the grid. - * + * * @param column * the column to add * @return given column @@ -6196,13 +6196,13 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Inserts a column into a specific position in the grid. - * + * * @param index * the index where the column should be inserted into * @param column * the column to add * @return given column - * + * * @throws IllegalStateException * if Grid's current selection model renders a selection column, * and {@code index} is 0. @@ -6285,7 +6285,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Removes a column from the grid. - * + * * @param column * the column to remove */ @@ -6324,7 +6324,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Returns the amount of columns in the grid. * <p> * <em>NOTE:</em> this includes the hidden columns in the count. - * + * * @return The number of columns in the grid */ public int getColumnCount() { @@ -6335,7 +6335,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Returns a list columns in the grid, including hidden columns. * <p> * For currently visible columns, use {@link #getVisibleColumns()}. - * + * * @return A unmodifiable list of the columns in the grid */ public List<Column<?, T>> getColumns() { @@ -6347,7 +6347,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Returns a list of the currently visible columns in the grid. * <p> * No {@link Column#isHidden() hidden} columns included. - * + * * @since 7.5.0 * @return A unmodifiable list of the currently visible columns in the grid */ @@ -6365,7 +6365,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Returns a column by its index in the grid. * <p> * <em>NOTE:</em> The indexing includes hidden columns. - * + * * @param index * the index of the column * @return The column in the given index @@ -6391,7 +6391,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the header section of this grid. The default header contains a * single row displaying the column captions. - * + * * @return the header */ protected Header getHeader() { @@ -6400,7 +6400,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the header row at given index. - * + * * @param rowIndex * 0 based index for row. Counted from top to bottom * @return header row at given index @@ -6415,11 +6415,11 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Inserts a new row at the given position to the header section. Shifts the * row currently at that position and any subsequent rows down (adds one to * their indices). - * + * * @param index * the position at which to insert the row * @return the new row - * + * * @throws IllegalArgumentException * if the index is less than 0 or greater than row count * @see #appendHeaderRow() @@ -6433,7 +6433,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Adds a new row at the bottom of the header section. - * + * * @return the new row * @see #prependHeaderRow() * @see #addHeaderRowAt(int) @@ -6448,7 +6448,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Returns the current default row of the header section. The default row is * a special header row providing a user interface for sorting columns. * Setting a header caption for column updates cells in the default header. - * + * * @return the default row or null if no default row set */ public HeaderRow getDefaultHeaderRow() { @@ -6457,7 +6457,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the row count for the header section. - * + * * @return row count */ public int getHeaderRowCount() { @@ -6466,7 +6466,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Adds a new row at the top of the header section. - * + * * @return the new row * @see #appendHeaderRow() * @see #addHeaderRowAt(int) @@ -6479,10 +6479,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Removes the given row from the header section. - * + * * @param row * the row to be removed - * + * * @throws IllegalArgumentException * if the row does not exist in this section * @see #removeHeaderRow(int) @@ -6496,10 +6496,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Removes the row at the given position from the header section. - * + * * @param index * the position of the row - * + * * @throws IllegalArgumentException * if no row exists at given index * @see #removeHeaderRow(HeaderRow) @@ -6517,10 +6517,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * Note: Setting the default header row will reset all cell contents to * Column defaults. - * + * * @param row * the new default row, or null for no default row - * + * * @throws IllegalArgumentException * header does not contain the row */ @@ -6530,7 +6530,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the visibility of the header section. - * + * * @param visible * true to show header section, false to hide */ @@ -6540,7 +6540,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the visibility of the header section. - * + * * @return true if visible, false otherwise. */ public boolean isHeaderVisible() { @@ -6551,7 +6551,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the footer section of this grid. The default footer is empty. - * + * * @return the footer */ protected Footer getFooter() { @@ -6560,7 +6560,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the footer row at given index. - * + * * @param rowIndex * 0 based index for row. Counted from top to bottom * @return footer row at given index @@ -6575,11 +6575,11 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Inserts a new row at the given position to the footer section. Shifts the * row currently at that position and any subsequent rows down (adds one to * their indices). - * + * * @param index * the position at which to insert the row * @return the new row - * + * * @throws IllegalArgumentException * if the index is less than 0 or greater than row count * @see #appendFooterRow() @@ -6593,7 +6593,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Adds a new row at the bottom of the footer section. - * + * * @return the new row * @see #prependFooterRow() * @see #addFooterRowAt(int) @@ -6606,7 +6606,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the row count for the footer. - * + * * @return row count */ public int getFooterRowCount() { @@ -6615,7 +6615,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Adds a new row at the top of the footer section. - * + * * @return the new row * @see #appendFooterRow() * @see #addFooterRowAt(int) @@ -6628,10 +6628,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Removes the given row from the footer section. - * + * * @param row * the row to be removed - * + * * @throws IllegalArgumentException * if the row does not exist in this section * @see #removeFooterRow(int) @@ -6645,10 +6645,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Removes the row at the given position from the footer section. - * + * * @param index * the position of the row - * + * * @throws IllegalArgumentException * if no row exists at given index * @see #removeFooterRow(FooterRow) @@ -6662,7 +6662,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the visibility of the footer section. - * + * * @param visible * true to show footer section, false to hide */ @@ -6672,7 +6672,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the visibility of the footer section. - * + * * @return true if visible, false otherwise. */ public boolean isFooterVisible() { @@ -6692,7 +6692,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * <em>Note:</em> This method will change the widget's size in the browser * only if {@link #getHeightMode()} returns {@link HeightMode#CSS}. - * + * * @see #setHeightMode(HeightMode) */ @Override @@ -6707,7 +6707,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the data source used by this grid. - * + * * @param dataSource * the data source to use, not null * @throws IllegalArgumentException @@ -6813,7 +6813,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the {@Link DataSource} for this Grid. - * + * * @return the data source used by this grid */ public DataSource<T> getDataSource() { @@ -6827,10 +6827,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * -1 will also disable the selection column. * <p> * The default value is 0. - * + * * @param numberOfColumns * the number of columns that should be frozen - * + * * @throws IllegalArgumentException * if the column count is < -1 or > the number of visible * columns @@ -6878,7 +6878,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * <em>NOTE:</em> This includes {@link Column#isHidden() hidden columns} in * the count. - * + * * @return the number of frozen columns */ public int getFrozenColumnCount() { @@ -6900,7 +6900,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * If the details for that row are visible, those will be taken into account * as well. - * + * * @param rowIndex * zero-based index of the row to scroll to. * @throws IllegalArgumentException @@ -6917,7 +6917,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * If the details for that row are visible, those will be taken into account * as well. - * + * * @param rowIndex * zero-based index of the row to scroll to. * @param destination @@ -6939,7 +6939,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * If the details for that row are visible, those will be taken into account * as well. - * + * * @param rowIndex * zero-based index of the row to scroll to. * @param destination @@ -6988,7 +6988,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the vertical scroll offset. - * + * * @param px * the number of pixels this grid should be scrolled down */ @@ -6998,7 +6998,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the vertical scroll offset - * + * * @return the number of pixels this grid is scrolled down */ public double getScrollTop() { @@ -7007,7 +7007,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the horizontal scroll offset - * + * * @since 7.5.0 * @param px * the number of pixels this grid should be scrolled right @@ -7018,7 +7018,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the horizontal scroll offset - * + * * @return the number of pixels this grid is scrolled to the right */ public double getScrollLeft() { @@ -7027,7 +7027,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the height of the scrollable area in pixels. - * + * * @since 7.5.0 * @return the height of the scrollable area in pixels */ @@ -7037,7 +7037,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the width of the scrollable area in pixels. - * + * * @since 7.5.0 * @return the width of the scrollable area in pixels. */ @@ -7055,7 +7055,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * If Grid is currently not in {@link HeightMode#ROW}, the given value is * remembered, and applied once the mode is applied. - * + * * @param rows * The height in terms of number of rows displayed in Grid's * body. If Grid doesn't contain enough rows, white space is @@ -7067,7 +7067,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * infinite} * @throws IllegalArgumentException * if {@code rows} is {@link Double#isNaN(double) NaN} - * + * * @see #setHeightMode(HeightMode) */ public void setHeightByRows(double rows) throws IllegalArgumentException { @@ -7079,7 +7079,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * {@link #getHeightMode()} is {@link HeightMode#ROW}. * <p> * By default, it is {@value Escalator#DEFAULT_HEIGHT_BY_ROWS}. - * + * * @return the amount of rows that should be shown in Grid's body, while in * {@link HeightMode#ROW}. * @see #setHeightByRows(double) @@ -7099,7 +7099,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <em>Note:</em> If headers/footers are inserted or removed, the widget * will resize itself to still display the required amount of rows in its * body. It also takes the horizontal scrollbar into account. - * + * * @param heightMode * the mode in to which Grid should be set */ @@ -7109,7 +7109,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * widget dimensions (height/width) on each state change event. The * original design was to have setHeight an setHeightByRow be equals, * and whichever was called the latest was considered in effect. - * + * * But, because of Vaadin always calling setHeight on the widget, this * approach doesn't work. */ @@ -7121,7 +7121,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Returns the current {@link HeightMode} the Grid is in. * <p> * Defaults to {@link HeightMode#CSS}. - * + * * @return the current HeightMode */ public HeightMode getHeightMode() { @@ -7617,7 +7617,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Sets the current selection model. * <p> * This function will call {@link SelectionModel#setGrid(Grid)}. - * + * * @param selectionModel * a selection model implementation. * @throws IllegalArgumentException @@ -7645,7 +7645,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets a reference to the current selection model. - * + * * @return the currently used SelectionModel instance. */ public SelectionModel<T> getSelectionModel() { @@ -7656,7 +7656,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Sets current selection mode. * <p> * This is a shorthand method for {@link Grid#setSelectionModel}. - * + * * @param mode * a selection mode value * @see {@link SelectionMode}. @@ -7668,7 +7668,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Test if a row is selected. - * + * * @param row * a row object * @return true, if the current selection model considers the provided row @@ -7684,7 +7684,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Only selection models implementing {@link SelectionModel.Single} and * {@link SelectionModel.Multi} are supported; for anything else, an * exception will be thrown. - * + * * @param row * a row object * @return <code>true</code> iff the current selection changed @@ -7709,7 +7709,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Only selection models implementing {@link SelectionModel.Single} and * {@link SelectionModel.Multi} are supported; for anything else, an * exception will be thrown. - * + * * @param row * a row object * @return <code>true</code> iff the current selection changed @@ -7730,7 +7730,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Deselect all rows using the current selection model. - * + * * @param row * a row object * @return <code>true</code> iff the current selection changed @@ -7759,7 +7759,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Only selection models implementing {@link SelectionModel.Single} are * valid for this method; for anything else, use the * {@link Grid#getSelectedRows()} method. - * + * * @return a selected row reference, or null, if no row is selected * @throws IllegalStateException * if the current selection model is not an instance of @@ -7776,7 +7776,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets currently selected rows from the current selection model. - * + * * @return a non-null collection containing all currently selected rows. */ public Collection<T> getSelectedRows() { @@ -7792,7 +7792,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the current sort order using the fluid Sort API. Read the * documentation for {@link Sort} for more information. - * + * * @param s * a sort instance */ @@ -7802,7 +7802,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sorts the Grid data in ascending order along one column. - * + * * @param column * a grid column reference */ @@ -7812,7 +7812,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sorts the Grid data along one column. - * + * * @param column * a grid column reference * @param direction @@ -7825,7 +7825,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the sort order to use. Setting this causes the Grid to re-sort * itself. - * + * * @param order * a sort order list. If set to null, the sort order is cleared. */ @@ -7853,7 +7853,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Get a copy of the current sort order array. - * + * * @return a copy of the current sort order array */ public List<SortOrder> getSortOrder() { @@ -7876,7 +7876,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Register a GWT event handler for a sorting event. This handler gets * called whenever this Grid needs its data source to provide data sorted in * a specific order. - * + * * @param handler * a sort event handler * @return the registration for the event @@ -7888,7 +7888,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Register a GWT event handler for a select all event. This handler gets * called whenever Grid needs all rows selected. - * + * * @param handler * a select all event handler */ @@ -7904,7 +7904,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * This handle will be fired with the current available data after * registration is done. - * + * * @param handler * a data available event handler * @return the registartion for the event @@ -7928,7 +7928,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Register a BodyKeyDownHandler to this Grid. The event for this handler is * fired when a KeyDown event occurs while cell focus is in the Body of this * Grid. - * + * * @param handler * the key handler to register * @return the registration for the event @@ -7942,7 +7942,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Register a BodyKeyUpHandler to this Grid. The event for this handler is * fired when a KeyUp event occurs while cell focus is in the Body of this * Grid. - * + * * @param handler * the key handler to register * @return the registration for the event @@ -7955,7 +7955,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Register a BodyKeyPressHandler to this Grid. The event for this handler * is fired when a KeyPress event occurs while cell focus is in the Body of * this Grid. - * + * * @param handler * the key handler to register * @return the registration for the event @@ -7969,7 +7969,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Register a HeaderKeyDownHandler to this Grid. The event for this handler * is fired when a KeyDown event occurs while cell focus is in the Header of * this Grid. - * + * * @param handler * the key handler to register * @return the registration for the event @@ -7983,7 +7983,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Register a HeaderKeyUpHandler to this Grid. The event for this handler is * fired when a KeyUp event occurs while cell focus is in the Header of this * Grid. - * + * * @param handler * the key handler to register * @return the registration for the event @@ -7997,7 +7997,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Register a HeaderKeyPressHandler to this Grid. The event for this handler * is fired when a KeyPress event occurs while cell focus is in the Header * of this Grid. - * + * * @param handler * the key handler to register * @return the registration for the event @@ -8011,7 +8011,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Register a FooterKeyDownHandler to this Grid. The event for this handler * is fired when a KeyDown event occurs while cell focus is in the Footer of * this Grid. - * + * * @param handler * the key handler to register * @return the registration for the event @@ -8025,7 +8025,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Register a FooterKeyUpHandler to this Grid. The event for this handler is * fired when a KeyUp event occurs while cell focus is in the Footer of this * Grid. - * + * * @param handler * the key handler to register * @return the registration for the event @@ -8039,7 +8039,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Register a FooterKeyPressHandler to this Grid. The event for this handler * is fired when a KeyPress event occurs while cell focus is in the Footer * of this Grid. - * + * * @param handler * the key handler to register * @return the registration for the event @@ -8052,7 +8052,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Register a BodyClickHandler to this Grid. The event for this handler is * fired when a Click event occurs in the Body of this Grid. - * + * * @param handler * the click handler to register * @return the registration for the event @@ -8064,7 +8064,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Register a HeaderClickHandler to this Grid. The event for this handler is * fired when a Click event occurs in the Header of this Grid. - * + * * @param handler * the click handler to register * @return the registration for the event @@ -8077,7 +8077,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Register a FooterClickHandler to this Grid. The event for this handler is * fired when a Click event occurs in the Footer of this Grid. - * + * * @param handler * the click handler to register * @return the registration for the event @@ -8091,7 +8091,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Register a BodyDoubleClickHandler to this Grid. The event for this * handler is fired when a double click event occurs in the Body of this * Grid. - * + * * @param handler * the double click handler to register * @return the registration for the event @@ -8105,7 +8105,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Register a HeaderDoubleClickHandler to this Grid. The event for this * handler is fired when a double click event occurs in the Header of this * Grid. - * + * * @param handler * the double click handler to register * @return the registration for the event @@ -8119,7 +8119,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Register a FooterDoubleClickHandler to this Grid. The event for this * handler is fired when a double click event occurs in the Footer of this * Grid. - * + * * @param handler * the double click handler to register * @return the registration for the event @@ -8132,7 +8132,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Register a column reorder handler to this Grid. The event for this * handler is fired when the Grid's columns are reordered. - * + * * @since 7.5.0 * @param handler * the handler for the event @@ -8146,7 +8146,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Register a column visibility change handler to this Grid. The event for * this handler is fired when the Grid's columns change visibility. - * + * * @since 7.5.0 * @param handler * the handler for the event @@ -8160,7 +8160,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Register a column resize handler to this Grid. The event for this handler * is fired when the Grid's columns are resized. - * + * * @since 7.6 * @param handler * the handler for the event @@ -8175,7 +8175,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Register a enabled status change handler to this Grid. The event for this * handler is fired when the Grid changes from disabled to enabled and * vice-versa. - * + * * @param handler * the handler for the event * @return the registration for the event @@ -8225,7 +8225,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Adds a scroll handler to this grid - * + * * @param handler * the scroll handler to add * @return a handler registration for the registered scroll handler @@ -8243,7 +8243,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns whether columns can be reordered with drag and drop. - * + * * @since 7.5.0 * @return <code>true</code> if columns can be reordered, false otherwise */ @@ -8253,7 +8253,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets whether column reordering with drag and drop is allowed or not. - * + * * @since 7.5.0 * @param columnReorderingAllowed * specifies whether column reordering is allowed @@ -8266,7 +8266,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Sets a new column order for the grid. All columns which are not ordered * here will remain in the order they were before as the last columns of * grid. - * + * * @param orderedColumns * array of columns in wanted order */ @@ -8326,7 +8326,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the style generator that is used for generating styles for cells - * + * * @param cellStyleGenerator * the cell style generator to set, or <code>null</code> to * remove a previously set generator @@ -8339,7 +8339,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the style generator that is used for generating styles for cells - * + * * @return the cell style generator, or <code>null</code> if no generator is * set */ @@ -8349,7 +8349,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the style generator that is used for generating styles for rows - * + * * @param rowStyleGenerator * the row style generator to set, or <code>null</code> to remove * a previously set generator @@ -8361,7 +8361,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the style generator that is used for generating styles for rows - * + * * @return the row style generator, or <code>null</code> if no generator is * set */ @@ -8389,10 +8389,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Opens the editor over the row with the given index. - * + * * @param rowIndex * the index of the row to be edited - * + * * @throws IllegalStateException * if the editor is not enabled * @throws IllegalStateException @@ -8404,7 +8404,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns whether the editor is currently open on some row. - * + * * @return {@code true} if the editor is active, {@code false} otherwise. */ public boolean isEditorActive() { @@ -8413,7 +8413,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Saves any unsaved changes in the editor to the data source. - * + * * @throws IllegalStateException * if the editor is not enabled * @throws IllegalStateException @@ -8426,7 +8426,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Cancels the currently active edit and hides the editor. Any changes that * are not {@link #saveEditor() saved} are lost. - * + * * @throws IllegalStateException * if the editor is not enabled * @throws IllegalStateException @@ -8439,7 +8439,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the handler responsible for binding data and editor widgets to * the editor. - * + * * @return the editor handler or null if not set */ public EditorHandler<T> getEditorHandler() { @@ -8449,10 +8449,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the handler responsible for binding data and editor widgets to the * editor. - * + * * @param rowHandler * the new editor handler - * + * * @throws IllegalStateException * if the editor is currently in edit mode */ @@ -8462,7 +8462,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the enabled state of the editor. - * + * * @return true if editing is enabled, false otherwise */ public boolean isEditorEnabled() { @@ -8471,10 +8471,10 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the enabled state of the editor. - * + * * @param enabled * true to enable editing, false to disable - * + * * @throws IllegalStateException * if in edit mode and trying to disable * @throws IllegalStateException @@ -8487,7 +8487,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns the editor widget associated with the given column. If the editor * is not active, returns null. - * + * * @param column * the column * @return the widget if the editor is open, null otherwise @@ -8498,7 +8498,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the caption on the save button in the Grid editor. - * + * * @param saveCaption * the caption to set * @throws IllegalArgumentException @@ -8511,7 +8511,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the current caption on the save button in the Grid editor. - * + * * @return the current caption on the save button */ public String getEditorSaveCaption() { @@ -8520,7 +8520,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the caption on the cancel button in the Grid editor. - * + * * @param cancelCaption * the caption to set * @throws IllegalArgumentException @@ -8533,7 +8533,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the caption on the cancel button in the Grid editor. - * + * * @return the current caption on the cancel button */ public String getEditorCancelCaption() { @@ -8597,7 +8597,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * This method is implemented only because removing widgets from Grid (added * via e.g. {@link Renderer}s) requires the {@link HasWidgets} interface. - * + * * @param w * irrelevant * @throws UnsupportedOperationException @@ -8615,7 +8615,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * This method is implemented only because removing widgets from Grid (added * via e.g. {@link Renderer}s) requires the {@link HasWidgets} interface. - * + * * @throws UnsupportedOperationException * always */ @@ -8631,7 +8631,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * This method is implemented only because removing widgets from Grid (added * via e.g. {@link Renderer}s) requires the {@link HasWidgets} interface. - * + * * @return never * @throws UnsupportedOperationException * always @@ -8648,7 +8648,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * This method is implemented only because removing widgets from Grid (added * via e.g. {@link Renderer}s) requires the {@link HasWidgets} interface. - * + * * @return always <code>false</code> */ @Override @@ -8660,7 +8660,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * corresponding Widget will call removeFromParent() on itself. GWT will * check there that its parent (i.e. Grid) implements HasWidgets, and * will call this remove(Widget) method. - * + * * tl;dr: all this song and dance to make sure GWT's sanity checks * aren't triggered, even though they effectively do nothing interesting * from Grid's perspective. @@ -8670,7 +8670,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Accesses the package private method Widget#setParent() - * + * * @param widget * The widget to access * @param parent @@ -8732,7 +8732,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * Sets a new details generator for row details. * <p> * The currently opened row details will be re-rendered. - * + * * @since 7.5.0 * @param detailsGenerator * the details generator to set @@ -8759,7 +8759,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the current details generator for row details. - * + * * @since 7.5.0 * @return the detailsGenerator the current details generator */ @@ -8772,7 +8772,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * <p> * This method does nothing if trying to set show already-visible details, * or hide already-hidden details. - * + * * @since 7.5.0 * @param rowIndex * the index of the affected row @@ -8791,17 +8791,17 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /* * We want to prevent opening a details row twice, so any subsequent * openings (or closings) of details is a NOOP. - * + * * When a details row is opened, it is given an arbitrary height * (because Escalator requires a height upon opening). Only when it's * opened, Escalator will ask the generator to generate a widget, which * we then can measure. When measured, we correct the initial height by * the original height. - * + * * Without this check, we would override the measured height, and revert * back to the initial, arbitrary, height which would most probably be * wrong. - * + * * see GridSpacerUpdater.init for implementation details. */ @@ -8819,7 +8819,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Check whether the details for a row is visible or not. - * + * * @since 7.5.0 * @param rowIndex * the index of the row for which to check details @@ -8836,7 +8836,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * The actual recalculation is not necessarily done immediately so you * cannot rely on the columns being the correct width after the call * returns. - * + * * @since 7.4.1 */ public void recalculateColumnWidths() { @@ -8850,7 +8850,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * the items in the beginning of the menu that control the column hiding if * any columns are marked as hidable. A toggle for opening the menu will be * displayed whenever the menu contains at least one item. - * + * * @since 7.5.0 * @return the menu bar */ @@ -8860,7 +8860,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Tests whether the sidebar menu is currently open. - * + * * @since 7.5.0 * @see #getSidebarMenu() * @return <code>true</code> if the sidebar is open; <code>false</code> if @@ -8872,8 +8872,8 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets whether the sidebar menu is open. - * - * + * + * * @since 7.5.0 * @see #getSidebarMenu() * @see #isSidebarOpen() @@ -8916,7 +8916,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Sets the buffered editor mode. - * + * * @since 7.6 * @param editorUnbuffered * <code>true</code> to enable buffered editor, @@ -8928,7 +8928,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Gets the buffered editor mode. - * + * * @since 7.6 * @return <code>true</code> if buffered editor is enabled, * <code>false</code> otherwise @@ -8942,7 +8942,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, * this Grid. * <p> * Note: This cell reference will be updated when firing the next event. - * + * * @since 7.5 * @return event cell reference */ @@ -8953,7 +8953,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>, /** * Returns a CellReference for the cell to which the given element belongs * to. - * + * * @since 7.6 * @param element * Element to find from the cell's content. diff --git a/client/src/main/java/com/vaadin/client/widgets/Overlay.java b/client/src/main/java/com/vaadin/client/widgets/Overlay.java index 7d44b96892..f8c31f832c 100644 --- a/client/src/main/java/com/vaadin/client/widgets/Overlay.java +++ b/client/src/main/java/com/vaadin/client/widgets/Overlay.java @@ -50,7 +50,7 @@ import com.vaadin.client.WidgetUtil; * <p> * <b>Note:</b> This class should always be constructed with * {@link GWT#create(Class)}. - * + * * <h3>Shadow</h3> * <p> * The separate shadow element underneath the main overlay element is <strong> @@ -61,7 +61,7 @@ import com.vaadin.client.WidgetUtil; * supports, add <code>-webkit-box-shadow</code> and the standard * <code>box-shadow</code> properties. * </p> - * + * * <p> * For IE8, which doesn't support CSS box-shadow, you can use the proprietary * DropShadow filter. It doesn't provide the exact same features as box-shadow, @@ -69,13 +69,13 @@ import com.vaadin.client.WidgetUtil; * border or a pseudo-element underneath the overlay which mimics a shadow, or * any combination of these. * </p> - * + * * <p> * Read more about the DropShadow filter from * <a href="http://msdn.microsoft.com/en-us/library/ms532985(v=vs.85).aspx" * >Microsoft Developer Network</a> * </p> - * + * * @since 7.6.1 */ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { @@ -165,7 +165,7 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { * Shadow element style. If an extending class wishes to use a different * style of shadow, it can use setShadowStyle(String) to give the shadow * element a new style name. - * + * * @deprecated See main JavaDoc for Overlay */ @Deprecated @@ -188,9 +188,9 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { /** * The shadow element for this overlay. - * + * * @deprecated See main JavaDoc for Overlay - * + * */ @Deprecated private Element shadow; @@ -210,7 +210,7 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { /** * The HTML snippet that is used to render the actual shadow. In consists of * nine different DIV-elements with the following class names: - * + * * <pre> * .v-shadow[-stylename] * ---------------------------------------------- @@ -223,9 +223,9 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { * | .bottom-left | .bottom | .bottom-right | * ---------------------------------------------- * </pre> - * + * * See default theme 'shadow.css' for implementation example. - * + * * @deprecated See main JavaDoc for Overlay */ @Deprecated @@ -274,7 +274,7 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { * Return true if a separate shadow div should be used. Since Vaadin 7.3, * shadows are implemented with CSS box-shadow. Thus, a shadow div is only * used for IE8 by default. - * + * * @deprecated See main JavaDoc for Overlay * @since 7.3 * @return true to use a shadow div @@ -288,10 +288,10 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { * Method to control whether DOM elements for shadow are added. With this * method subclasses can control displaying of shadow also after the * constructor. - * + * * @param enabled * true if shadow should be displayed - * + * * @deprecated See main JavaDoc for Overlay */ @Deprecated @@ -355,7 +355,7 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { /** * Set the z-index (visual stack position) for this overlay. - * + * * @param zIndex * The new z-index */ @@ -526,7 +526,7 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { * A "thread local" of sorts, set temporarily so that OverlayImpl knows * which Overlay is using it, so that it can be attached to the correct * overlay container. - * + * * TODO this is a strange pattern that we should get rid of when possible. */ protected static Overlay current; @@ -647,12 +647,12 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { * Sets the shadow style for this overlay. Will override any previous style * for the shadow. The default style name is defined by CLASSNAME_SHADOW. * The given style will be prefixed with CLASSNAME_SHADOW. - * + * * @param style * The new style name for the shadow element. Will be prefixed by * CLASSNAME_SHADOW, e.g. style=='foobar' -> actual style * name=='v-shadow-foobar'. - * + * * @deprecated See main JavaDoc for Overlay */ @Deprecated @@ -666,7 +666,7 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { * Extending classes should always call this method after they change the * size of overlay without using normal 'setWidth(String)' and * 'setHeight(String)' methods (if not calling super.setWidth/Height). - * + * */ public void positionOrSizeUpdated() { positionOrSizeUpdated(1.0); @@ -685,7 +685,7 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { * elements. Can be used to animate the related elements, using the * 'progress' parameter (used to animate the shadow in sync with GWT * PopupPanel's default animation 'PopupPanel.AnimationType.CENTER'). - * + * * @param progress * A value between 0.0 and 1.0, indicating the progress of the * animation (0=start, 1=end). @@ -788,7 +788,7 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { * Returns true if we should add a shim iframe below the overlay to deal * with zindex issues with PDFs and applets. Can be overriden to disable * shim iframes if they are not needed. - * + * * @return true if a shim iframe should be added, false otherwise */ protected boolean needsShimElement() { @@ -850,13 +850,13 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { /** * Enables or disables sinking the events of the shadow to the same * onBrowserEvent as events to the actual overlay goes. - * + * * Please note, that if you enable this, you can't assume that e.g. * event.getEventTarget returns an element inside the DOM structure of the * overlay - * + * * @param sinkShadowEvents - * + * * @deprecated See main JavaDoc for Overlay */ @Deprecated @@ -880,7 +880,7 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { /** * Get owner (Widget that made this Overlay, not the layout parent) of * Overlay - * + * * @return Owner (creator) or null if not defined */ public Widget getOwner() { @@ -890,7 +890,7 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { /** * Set owner (Widget that made this Overlay, not the layout parent) of * Overlay - * + * * @param owner * Owner (creator) of Overlay */ @@ -900,7 +900,7 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { /** * Gets the 'overlay container' element. - * + * * @return the overlay container element */ public com.google.gwt.user.client.Element getOverlayContainer() { @@ -926,10 +926,10 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { /** * Gets the visual viewport width, which is useful for e.g iOS where the * view can be zoomed in while keeping the layout viewport intact. - * + * * Falls back to layout viewport; for those browsers/devices the difference * is that the scrollbar with is included (if there is a scrollbar). - * + * * @since 7.0.7 * @return */ @@ -945,10 +945,10 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { /** * Gets the visual viewport height, which is useful for e.g iOS where the * view can be zoomed in while keeping the layout viewport intact. - * + * * Falls back to layout viewport; for those browsers/devices the difference * is that the scrollbar with is included (if there is a scrollbar). - * + * * @since 7.0.7 * @return */ @@ -973,7 +973,7 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { /* * (non-Javadoc) - * + * * @see com.google.gwt.user.client.ui.PopupPanel#hide() */ @Override @@ -983,7 +983,7 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { /* * (non-Javadoc) - * + * * @see com.google.gwt.user.client.ui.PopupPanel#hide(boolean) */ @Override @@ -992,13 +992,13 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { } /** - * + * * Hides the popup and detaches it from the page. This has no effect if it * is not currently showing. Animation-in, animation-out can be * enable/disabled for different use cases. - * + * * @see com.google.gwt.user.client.ui.PopupPanel#hide(boolean) - * + * * @param autoClosed * the value that will be passed to * {@link CloseHandler#onClose(CloseEvent)} when the popup is @@ -1110,7 +1110,7 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { * it does not fit on either side. If the popup is larger than the window, * it will be shrunk to fit and assume that scrolling e.g. using * <code>overflow:auto</code>, is taken care of by the overlay user. - * + * * @since 7.6.6 * @param fitInWindow * <code>true</code> to ensure that no part of the popup is @@ -1124,9 +1124,9 @@ public class Overlay extends PopupPanel implements CloseHandler<PopupPanel> { /** * Checks whether the overlay should be moved or shrunk to fit inside the * window. - * + * * @see #setFitInWindow(boolean) - * + * * @since 7.6.6 * @return <code>true</code> if the popup will be moved and/or shrunk to fit * inside the window, <code>false</code> otherwise diff --git a/client/src/test/java/com/vaadin/client/DateTimeServiceTest.java b/client/src/test/java/com/vaadin/client/DateTimeServiceTest.java index 97eb22e87d..912abc412a 100755 --- a/client/src/test/java/com/vaadin/client/DateTimeServiceTest.java +++ b/client/src/test/java/com/vaadin/client/DateTimeServiceTest.java @@ -65,7 +65,7 @@ public class DateTimeServiceTest { /** * Test all dates from 1990-1992 + some more and see that {@link Calendar} * calculates the ISO week number like we do. - * + * */ @Test public void testISOWeekNumbers() { @@ -86,7 +86,7 @@ public class DateTimeServiceTest { /** * Verify that special cases are handled correctly by us (and * {@link Calendar}). - * + * */ @Test public void testSampleISOWeekNumbers() { diff --git a/client/src/test/java/com/vaadin/client/LocatorUtilTest.java b/client/src/test/java/com/vaadin/client/LocatorUtilTest.java index 971688e1c5..64a783549a 100644 --- a/client/src/test/java/com/vaadin/client/LocatorUtilTest.java +++ b/client/src/test/java/com/vaadin/client/LocatorUtilTest.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the diff --git a/client/src/test/java/com/vaadin/client/communication/ServerMessageHandlerTest.java b/client/src/test/java/com/vaadin/client/communication/ServerMessageHandlerTest.java index 7b0d886c39..8aa70bc4e9 100644 --- a/client/src/test/java/com/vaadin/client/communication/ServerMessageHandlerTest.java +++ b/client/src/test/java/com/vaadin/client/communication/ServerMessageHandlerTest.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2014 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the @@ -19,7 +19,7 @@ import org.junit.Assert; import org.junit.Test; /** - * + * * @since 7.7 * @author Vaadin Ltd */ diff --git a/client/src/test/java/com/vaadin/client/ui/grid/PartitioningTest.java b/client/src/test/java/com/vaadin/client/ui/grid/PartitioningTest.java index e97bb339e4..ac4d39006a 100644 --- a/client/src/test/java/com/vaadin/client/ui/grid/PartitioningTest.java +++ b/client/src/test/java/com/vaadin/client/ui/grid/PartitioningTest.java @@ -1,12 +1,12 @@ /* * Copyright 2000-2013 Vaadin Ltd. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the |