001    /*
002     * Created on Jul 13, 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.fixture;
017    
018    /**
019     * Understands simulation of input focus on a GUI component.
020     *
021     * @author Alex Ruiz 
022     */
023    public interface FocusableComponentFixture {
024    
025      /**
026       * Gives input focus to this fixture's GUI component.
027       * @return this fixture.
028       * @throws IllegalStateException if the component is disabled.
029       * @throws IllegalStateException if the component is not showing on the screen.
030       */
031      FocusableComponentFixture focus();
032      
033      /**
034       * Asserts that this fixture's GUI component has input focus.
035       * @return this fixture.
036       * @throws AssertionError if this component does not have input focus.
037       */
038      FocusableComponentFixture requireFocused();
039    }