--- /dev/null 2017-11-08 15:40:05.000000000 -0800 +++ new/core/JemmyCore/src/org/jemmy/lookup/Lookup.java 2017-11-08 15:40:05.000000000 -0800 @@ -0,0 +1,133 @@ +/* + * Copyright (c) 2007, 2017 Oracle and/or its affiliates. All rights reserved. + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * This code is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License version 2 only, as + * published by the Free Software Foundation. + * + * This code is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License + * version 2 for more details (a copy is included in the LICENSE file that + * accompanied this code). + * + * You should have received a copy of the GNU General Public License version + * 2 along with this work; if not, write to the Free Software Foundation, + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. + * + * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA + * or visit www.oracle.com if you need additional information or have any + * questions. + */ + +package org.jemmy.lookup; + +import java.io.PrintStream; +import org.jemmy.interfaces.*; +import org.jemmy.control.Wrap; +import org.jemmy.env.Environment; +import org.jemmy.env.Timeout; + + +/** + * A searcheable container of a set on UI controls. + * @param + * @author shura + */ +public interface Lookup extends Parent { + /** + * Default wait control timeout. + * @see Timeout + * @see Environment + */ + public static final Timeout WAIT_CONTROL_TIMEOUT = new Timeout("wait.control", 10000); + /** + * Reruns the search until the number of found components is equal or greater + * than required. + * @param count + * @return this or another Lookup instance. + */ + public Lookup wait(int count); + /** + * Creates an instance of the Wrap class for one of the found UI controls. + * @see Wrap + * @param index + * @return + */ + public Wrap wrap(int index); + /** + * Same as wrap(0) + * @see #wrap(int) + * @return + */ + public Wrap wrap(); + + /** + * Returns one of the found UI controls itself. + * @param index + * @return + */ + public CONTROL get(int index); + /** + * Same as get(0) + * @see #get(int) + * @return + */ + public CONTROL get(); + + /** + * Same as wrap(index).as(interfaceClass) + * @param + * @param index + * @param interfaceClass + * @return + * @see #wrap(int) + * @see Wrap#as(java.lang.Class) + */ + public INTERFACE as(int index, Class interfaceClass); + /** + * Same as wrap().as(interfaceClass) + * @param + * @param interfaceClass + * @return + * @see #wrap() + * @see Wrap#as(java.lang.Class) + */ + public INTERFACE as(Class interfaceClass); + /** + * Same as wrap(index).as(interfaceClass, type) + * @param + * @param + * @param index + * @param interfaceClass + * @param type + * @return + * @see #wrap(int) + * @see Wrap#as(java.lang.Class, java.lang.Class) + */ + public > INTERFACE as(int index, Class interfaceClass, Class type); + /** + * Same as wrap().as(interfaceClass, type) + * @param + * @param + * @param interfaceClass + * @param type + * @return + * @see #wrap(int) + * @see Wrap#as(java.lang.Class, java.lang.Class) + */ + public > INTERFACE as(Class interfaceClass, Class type); + + /** + * + * @return + */ + public int size(); + + /** + * + * @param out + */ + public void dump(PrintStream out); +}