/*
    GNU LESSER GENERAL PUBLIC LICENSE
    Copyright (C) 2006 The Lobo Project

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 2.1 of the License, or (at your option) any later version.

    This library 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
    Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public
    License along with this library; if not, write to the Free Software
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

    Contact info: lobochief@users.sourceforge.net
 */
package org.lobobrowser.html.renderer;

import java.awt.Dimension;
import java.awt.Graphics;
import java.awt.Point;
import java.awt.Rectangle;
import java.awt.event.MouseEvent;

import org.lobobrowser.html.domimpl.ModelNode;

/**
 * A renderer node with well-defined bounds. Most renderer nodes implement this
 * interface.
 */
public interface BoundableRenderable extends Renderable {
  public ModelNode getModelNode();

  public Rectangle getBounds();

  public Rectangle getVisualBounds();

  public boolean contains(final int x, final int y);

  public Dimension getSize();

  public Point getOrigin();

  public Point getOriginRelativeTo(RCollection ancestor);
  public Point getOriginRelativeToAbs(RCollection ancestor);
  public Point getOriginRelativeToNoScroll(RCollection ancestor);

  /**
   * Gets the parent where the renderable is rendered.
   */
  public RCollection getParent();

  public void setOriginalParent(RCollection origParent);

  /**
   * Gets the parent set with {@link #setOriginalParent(RCollection)}. It
   * represents the parent where the renderable would have been originally
   * rendered according to the DOM. This will be non-null only if
   * {@link #getParent()} is not the parent where this renderable would have
   * been originally rendered.
   */
  public RCollection getOriginalParent();

  /**
   * Returns {@link #getOriginalParent()} if not null. Otherwise it returns
   * {@link #getParent()}.
   */
  public RCollection getOriginalOrCurrentParent();

  public void setBounds(int x, int y, int with, int height);

  public void setOrigin(int x, int y);

  public void setX(int x);

  public void setY(int y);

  public int getX();

  public int getY();

  public int getVisualX();

  public int getVisualY();

  public int getHeight();

  public int getWidth();

  public int getVisualHeight();

  public int getVisualWidth();

  public void setHeight(int height);

  public void setWidth(int width);

  public RenderableSpot getLowestRenderableSpot(int x, int y);

  // public Point getRenderablePoint(int guiX, int guiY);

  public void repaint();

  /**
   * Returns false if the event is consumed. True to propagate further.
   */
  public boolean onMousePressed(MouseEvent event, int x, int y);

  public boolean onMouseReleased(MouseEvent event, int x, int y);

  public boolean onMouseDisarmed(MouseEvent event);

  public boolean onMouseClick(MouseEvent event, int x, int y);

  public boolean onDoubleClick(MouseEvent event, int x, int y);

  public boolean onMiddleClick(MouseEvent event, int x, int y);

  public boolean onRightClick(MouseEvent event, int x, int y);

  public void onMouseMoved(MouseEvent event, int x, int y, boolean triggerEvent, ModelNode limit);

  public void onMouseOut(MouseEvent event, int x, int y, ModelNode limit);

  /**
   * Returns true if the renderable is fully contained by its modelNode, but
   * said modelNode does not fully contain an ancestor renderable.
   */
  public boolean isContainedByNode();

  /**
   * Asks the Renderable to paint the selection between two points. Nothing will
   * be done if the points are outside the Renderable.
   *
   * @param g
   * @param inSelection
   * @param startPoint
   * @param endPoint
   * @return True iff it's in selection when finished painting.
   */
  public boolean paintSelection(Graphics g, boolean inSelection, RenderableSpot startPoint, RenderableSpot endPoint);

  /**
   * Paints by either creating a new clipped graphics context corresponding to
   * the bounds of the Renderable, or by translating the origin.
   *
   * @param g
   *          Parent's Graphics context.
   */
  public void paintTranslated(Graphics g);

  public boolean extractSelectionText(StringBuffer buffer, boolean inSelection, RenderableSpot startPoint, RenderableSpot endPoint);

  public void repaint(int x, int y, int width, int height);

  public void relayout();

  public void setParent(RCollection parent);

  public java.awt.Point getGUIPoint(int clientX, int clientY);

  public int getOrdinal();

  public void setOrdinal(int ordinal);

  public int getZIndex();

  public void invalidateLayoutUpTree();

  public void setInnerWidth(Integer newWidth);
  public void setInnerHeight(Integer newHeight);

  public void setDelegator(final BoundableRenderable pDelegator);
  public boolean isDelegated();

  default public int getHorizontalScrollBarHeight() {
    return 0;
  }

  default public int getVerticalScrollBarHeight() {
    return 0;
  }
}