001    /*
002     * Created on Jul 31, 2008
003     *
004     * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
005     * in compliance with the License. You may obtain a copy of the License at
006     *
007     * http://www.apache.org/licenses/LICENSE-2.0
008     *
009     * Unless required by applicable law or agreed to in writing, software distributed under the License
010     * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
011     * or implied. See the License for the specific language governing permissions and limitations under
012     * the License.
013     *
014     * Copyright @2008-2010 the original author or authors.
015     */
016    package org.fest.swing.query;
017    
018    import static org.fest.swing.edt.GuiActionRunner.execute;
019    
020    import java.awt.Component;
021    import java.awt.Container;
022    
023    import org.fest.swing.annotation.RunsInEDT;
024    import org.fest.swing.edt.GuiQuery;
025    
026    /**
027     * Understands an action, executed in the event dispatch thread, that returns the parent of a
028     * <code>{@link Component}</code>.
029     * @see Component#getParent()
030     *
031     * @author Alex Ruiz
032     * @author Yvonne Wang
033     */
034    public final class ComponentParentQuery {
035    
036      /**
037       * Returns the parent of the given <code>{@link Component}</code>. This action is executed in the event dispatch
038       * thread.
039       * @param component the given <code>Component</code>.
040       * @return the parent of the given <code>Component</code>.
041       * @see Component#getParent()
042       */
043      @RunsInEDT
044      public static Container parentOf(final Component component) {
045        return execute(new GuiQuery<Container>() {
046          protected Container executeInEDT() {
047            return component.getParent();
048          }
049        });
050      }
051    
052      private ComponentParentQuery() {}
053    }