aboutsummaryrefslogtreecommitdiffstats
path: root/server/src/com/vaadin/ui/HasComponents.java
blob: 71d5a3796f90fb81493ad856b0a00f5f0e849516 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
/*
@VaadinApache2LicenseForJavaFiles@
 */
package com.vaadin.ui;

import java.util.Iterator;

/**
 * Interface that must be implemented by all {@link Component}s that contain
 * other {@link Component}s.
 * 
 * @author Vaadin Ltd
 * @since 7.0.0
 * 
 */
public interface HasComponents extends Component, Iterable<Component> {
    /**
     * Gets an iterator to the collection of contained components. Using this
     * iterator it is possible to step through all components contained in this
     * container.
     * 
     * @return the component iterator.
     * 
     * @deprecated Use {@link #iterator()} instead.
     */
    @Deprecated
    public Iterator<Component> getComponentIterator();

    /**
     * Checks if the child component is visible. This method allows hiding a
     * child component from updates and communication to and from the client.
     * This is useful for components that show only a limited number of its
     * children at any given time and want to allow updates only for the
     * children that are visible (e.g. TabSheet has one tab open at a time).
     * <p>
     * Note that this will prevent updates from reaching the child even though
     * the child itself is set to visible. Also if a child is set to invisible
     * this will not force it to be visible.
     * </p>
     * 
     * @param childComponent
     *            The child component to check
     * @return true if the child component is visible to the user, false
     *         otherwise
     */
    public boolean isComponentVisible(Component childComponent);

}