12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273 |
- /*
- * Copyright 2000-2018 Vaadin Ltd.
- *
- * Licensed under the Apache License, Version 2.0 (the "License"); you may not
- * use this file except in compliance with the License. You may obtain a copy of
- * the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
- * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
- * License for the specific language governing permissions and limitations under
- * the License.
- */
- package com.vaadin.client;
-
- import com.vaadin.client.ui.ManagedLayout;
- 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
- */
- public interface HasChildMeasurementHintConnector
- extends HasComponentsConnector {
-
- /**
- * Specifies how you would like child components measurements to be handled.
- * Since this is a hint, it can be ignored when deemed necessary.
- */
- public enum ChildMeasurementHint {
-
- /**
- * Always measure all child components (default).
- */
- MEASURE_ALWAYS,
-
- /**
- * Measure child component only if child component is an
- * {@link com.vaadin.client.ui.AbstractLayoutConnector
- * AbstractLayoutConnector} or implements either {@link ManagedLayout}
- * or {@link ElementResizeListener}.
- */
- MEASURE_IF_NEEDED,
-
- /**
- * Never measure child components. This can improve rendering speed of
- * components with lots of children (e.g. Table), but can cause some
- * child components to be rendered incorrectly (e.g. ComboBox).
- */
- MEASURE_NEVER
- }
-
- /**
- * Sets the child measurement hint for this component.
- *
- * @param hint
- * the value to set
- */
- void setChildMeasurementHint(ChildMeasurementHint hint);
-
- /**
- * Returns the current child measurement hint value.
- *
- * @return a ChildLayoutMeasureMode value
- */
- ChildMeasurementHint getChildMeasurementHint();
-
- }
|