    001package org.vishia.gral.ifc;
    002
    003/**This interface is used to adapt the widget manager to the application frame.
    004 * It is implemented by {@link org.vishia.gral.area9.GralArea9Window}.
    005 * @author Hartmut Schorrig
    006 *
    007 */
    008public interface GralMngApplAdapter_ifc
    009{
    010  /**Version, history and license.
    011   * <ul>
    012   * <li>2011-06-00 Hartmut created
    013   * </ul>
    014   *
    015   * <b>Copyright/Copyleft</b>:<br>
    016   * For this source the LGPL Lesser General Public License,
    017   * published by the Free Software Foundation is valid.
    018   * It means:
    019   * <ol>
    020   * <li> You can use this source without any restriction for any desired purpose.
    021   * <li> You can redistribute copies of this source to everybody.
    022   * <li> Every user of this source, also the user of redistribute copies
    023   *    with or without payment, must accept this license for further using.
    024   * <li> But the LPGL is not appropriate for a whole software product,
    025   *    if this source is only a part of them. It means, the user
    026   *    must publish this part of source,
    027   *    but doesn't need to publish the whole source of the own product.
    028   * <li> You can study and modify (improve) this source
    029   *    for own using or for redistribution, but you have to license the
    030   *    modified sources likewise under this LGPL Lesser General Public License.
    031   *    You mustn't delete this Copyright/Copyleft inscription in this source file.
    032   * </ol>
    033   * If you intent to use this source without publishing its usage, you can get
    034   * a second license subscribing a special contract with the author.
    035   *
    036   * @author Hartmut Schorrig = hartmut.schorrig@vishia.de
    037   */
    038  public static final int version = 20120303;
    039
    040  /**For context sensitive help, it assigns an URL to the widget which has the focus gained.
    041   * @param url A "file#html.label" or "localdir/file.html#label" which describes the html help url
    042   *   in an local context. The origin of the url is given with a global context of the help window.
    043   *   See {@link org.vishia.gral.area9.GralArea9Window#setHelpBase(String)}
    044   *
    045   *   deprecated: It is often an absolute path. may be a relative path??
    046   *   deprecated: If it starts with "+", a base path is used as prefix.
    047   *
    048   */
    049  void setHelpUrl(String url);
    050}