Source for file StyleProperty.interface.php

Documentation is available at StyleProperty.interface.php

  1. <?php
  2.  
  3. /**
  4. * A StyleProperty (SP) is one of the tree building pieces of CSS styles. It stores
  5. * information about a single CSS style property by storing one or more
  6. * <code>StyleComponents</code>.
  7. *
  8. * The other two CSS styles building pieces are <code>StyleComponents</code> and
  9. * <code>StyleCollections</code>. To clarify the relationship between these three
  10. * building pieces, consider the following example:
  11. * <pre>
  12. * div {
  13. * margin: 20px;
  14. * border: 1px solid #000;
  15. * }
  16. * </pre>
  17. * <code>div</code> is a <code>StyleCollection</code> consisting of 2
  18. * <code>StyleProperties</code>: <code>margin</code> and <code>border</code>. Each
  19. * of the latter consists of one or more <code>StyleComponents</code>. In
  20. * specific, <code>margin</code> consists of one <code>StyleComponent</code>
  21. * with the value <code>20px</code>, and <code>border</code> has three
  22. * <code>StyleComponents</code> with values <code>1px</code>, <code>solid</code>,
  23. * and <code>#000</code> correspondingly.
  24. *
  25. * @package harmoni.gui
  26. *
  27. * @copyright Copyright &copy; 2005, Middlebury College
  28. * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License (GPL)
  29. *
  30. * @version $Id: StyleProperty.interface.php,v 1.6 2007/09/04 20:25:21 adamfranco Exp $
  31. ***/
  32.  
  33. class StylePropertyInterface {
  34.  
  35. /**
  36. * Returns the CSS code for this StyleProperty.
  37. * @access public
  38. * @return string The CSS code for this StyleProperty.
  39. ***/
  40. function getCSS() {
  41. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  42. }
  43. /**
  44. * Returns the name of this StyleProperty.
  45. * @access public
  46. * @return string The name of this StyleProperty.
  47. ***/
  48. function getName() {
  49. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  50. }
  51. /**
  52. * Returns the display name of this StyleProperty.
  53. * @access public
  54. * @return string The display name of this StyleProperty.
  55. ***/
  56. function getDisplayName() {
  57. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  58. }
  59. /**
  60. * Returns the description of this StlyeProperty.
  61. * @access public
  62. * @return string The description of this StlyeProperty.
  63. ***/
  64. function getDescription() {
  65. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  66. }
  67. /**
  68. * Adds one StyleComponent to this StyleProperty.
  69. * @access public
  70. * @param ref object A StyleComponent object.
  71. ***/
  72. function addSC($sc) {
  73. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  74. }
  75.  
  76. /**
  77. * Returns the StyleComponents of this StyleProperty in a suitable
  78. * for CSS generation order.
  79. * @access public
  80. * @return array An array of the StyleComponents of this StyleProperty.
  81. ***/
  82. function getSCs() {
  83. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  84. }
  85. }
  86.  
  87. ?>

Documentation generated on Wed, 19 Sep 2007 10:26:59 -0400 by phpDocumentor 1.3.0RC3