001    /*
002     * Created on Jul 29, 2008
003     *
004     * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
005     * 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 is distributed on
010     * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
011     * specific language governing permissions and limitations under the License.
012     *
013     * Copyright @2008-2010 the original author or authors.
014     */
015    package org.fest.swing.query;
016    
017    import static org.fest.swing.edt.GuiActionRunner.execute;
018    
019    import java.awt.Component;
020    import java.awt.Point;
021    
022    import org.fest.swing.annotation.RunsInEDT;
023    import org.fest.swing.edt.GuiQuery;
024    
025    /**
026     * Understands an action, executed in the event dispatch thread, that returns the location of a
027     * <code>{@link Component}</code> on screen.
028     * @see Component#getLocationOnScreen()
029     *
030     * @author Yvonne Wang
031     * @author Alex Ruiz
032     */
033    public final class ComponentLocationOnScreenQuery {
034    
035      /**
036       * Returns the location of the given <code>{@link Component}</code> on screen. This action is executed in the event
037       * dispatch thread.
038       * @param component the given <code>Component</code>.
039       * @return the location of the given <code>Component</code> on screen.
040       * @see Component#getLocationOnScreen()
041       */
042      @RunsInEDT
043      public static Point locationOnScreen(final Component component) {
044        return execute(new GuiQuery<Point>() {
045          protected Point executeInEDT() {
046            return component.getLocationOnScreen();
047          }
048        });
049      }
050    
051      private ComponentLocationOnScreenQuery() {}
052    }