//
// $Id: CssBorderLeftWidthCSS2.java,v 1.1.1.1 2006/11/14 17:05:19 ciglesia Exp $
// From Philippe Le Hegaret (Philippe.Le_Hegaret@sophia.inria.fr)
//
// (c) COPYRIGHT MIT and INRIA, 1997.
// Please first read the full copyright statement in file COPYRIGHT.html
/*
 * $Log: CssBorderLeftWidthCSS2.java,v $
 * Revision 1.1.1.1  2006/11/14 17:05:19  ciglesia
 * no message
 *
 * Revision 1.2  2002/04/08 21:17:43  plehegar
 * New
 *
 * Revision 3.2  1997/09/09 10:57:12  plehegar
 * Added getValue()
 *
 * Revision 3.1  1997/08/29 13:13:38  plehegar
 * Freeze
 *
 * Revision 1.4  1997/08/20 11:41:18  plehegar
 * Freeze
 *
 */
package org.w3c.css.properties;

import org.w3c.css.parser.CssStyle;
import org.w3c.css.values.CssExpression;
import org.w3c.css.values.CssValue;
import org.w3c.css.util.InvalidParamException;
import org.w3c.css.util.ApplContext;

/**
 *   <H4>
 *      &nbsp;&nbsp; 'border-left-width'
 *   </H4>
 *   <P>
 *   <EM>Value:</EM> thin | medium | thick | &lt;length&gt;<BR>
 *   <EM>Initial:</EM> 'medium'<BR>
 *   <EM>Applies to:</EM> all elements<BR>
 *   <EM>Inherited:</EM> no<BR>
 *   <EM>Percentage values:</EM> N/A<BR>
 *   <P>
 *   This property sets the width of an element's left border. The width of the
 *   keyword values are UA dependent, but the following holds: 'thin' &lt;= 'medium'
 *   &lt;= 'thick'.
 *   <P>
 *   The keyword widths are constant throughout a document:
 *   <PRE>
 *   H1 { border: solid thick red }
 *   P  { border: solid thick blue }
 * </PRE>
 *   <P>
 *   In the example above, 'H1' and 'P' elements will have the same border width
 *   regardless of font size. To achieve relative widths, the 'em' unit can be
 *   used:
 *   <PRE>
 *   H1 { border: solid 0.5em }
 * </PRE>
 *   <P>
 *   Border widths cannot be negative.
 * @version $Revision: 1.1.1.1 $
 */
public class CssBorderLeftWidthCSS2 extends CssProperty {

  CssBorderFaceWidthCSS2 face;
  
  /**
   * Create a new CssBorderLeftWidthCSS2
   */
  public CssBorderLeftWidthCSS2() {
    face = new CssBorderFaceWidthCSS2();
  }
  
  /**
   * Create a new CssBorderLeftWidthCSS2 with an another CssBorderFaceWidthCSS2
   *
   * @param another The another side.
   */
  public CssBorderLeftWidthCSS2(CssBorderFaceWidthCSS2 another) {
	setByUser();

    face = another;
  }
  
  /**
   * Create a new CssBorderLeftWidthCSS2
   *
   * @param expression The expression for this property.
   * @exception InvalidParamException Values are incorrect
   */
  public CssBorderLeftWidthCSS2(ApplContext ac, CssExpression expression)
    throws InvalidParamException {
    
	setByUser();
    face = new CssBorderFaceWidthCSS2(ac, expression);
  }
  
  /**
   * Returns the value of this property
   */
  public Object get() {
    return face;
  }

  /**
   * Return the value of this property
   */
  public CssValue getValue() {
    return face.getValue();
  }

  /**
   * Returns a string representation of the object.
   */
  public String toString() {
    return face.toString();
  }

  /**
   * Returns the name of this property
   */  
  public String getPropertyName() {
    return "border-left-width";
  }

  /**
   * Add this property to the CssStyle.
   *
   * @param style The CssStyle
   */
  public void addToStyle(ApplContext ac, CssStyle style) {
    CssBorderLeftCSS2 left = ((Css1Style) style).cssBorderCSS2.left;
    if (left.width != null)
      style.addRedefinitionWarning(ac, this);
    left.width = this;
  }

  /**
   * Get this property in the style.
   *
   * @param style The style where the property is
   * @param resolve if true, resolve the style to find this property
   */  
  public CssProperty getPropertyInStyle(CssStyle style, boolean resolve) {
    if (resolve) {
      return ((Css1Style) style).getBorderLeftWidthCSS2();
    } else {
      return ((Css1Style) style).cssBorderCSS2.getLeft().width;
    }
  }

  /**
   * Compares two properties for equality.
   *
   * @param value The other property.
   */  
  public boolean equals(CssProperty property) {
    return (property instanceof CssBorderLeftWidthCSS2 && 
	    face.equals(((CssBorderLeftWidthCSS2) property).face));
  }

}
