// Moodle - Modular Object-Oriented Dynamic Learning Environment //
// http://moodle.com //
// //
-// Copyright (C) 1999 onwards Martin Dougiamas http://dougiamas.com //
+// Copyright (C) 1999 onwards Martin Dougiamas http://dougiamas.com //
// (C) 2001-3001 Eloy Lafuente (stronk7) http://contiento.com //
// //
// This program is free software; you can redistribute it and/or modify //
/**
* Define and operate over one Moodle Workbook.
-*
+*
* A big part of this class acts as a wrapper over the PEAR
* Spreadsheet_Excel_Writer_Workbook and OLE libraries
* maintaining Moodle functions isolated from underlying code.
var $pear_excel_workbook;
var $latin_output;
- /* Constructs one Moodle Workbook.
+ /**
+ * Constructs one Moodle Workbook.
+ *
* @param string $filename The name of the file
*/
function MoodleExcelWorkbook($filename) {
$this->pear_excel_workbook->setTempDir($CFG->dataroot.'/temp/excel');
}
- /* Create one Moodle Worksheet
+ /**
+ * Create one Moodle Worksheet
+ *
* @param string $name Name of the sheet
*/
function &add_worksheet($name = '') {
return $ws;
}
- /* Create one Moodle Format
+ /**
+ * Create one Moodle Format
+ *
* @param array $properties array of properties [name]=value;
* valid names are set_XXXX existing
* functions without the set_ part
return $ft;
}
- /* Close the Moodle Workbook
+ /**
+ * Close the Moodle Workbook
*/
function close() {
$this->pear_excel_workbook->close();
}
- /* Write the correct HTTP headers
+ /**
+ * Write the correct HTTP headers
+ *
* @param string $name Name of the downloaded file
*/
function send($filename) {
/**
* Define and operate over one Worksheet.
-*
+*
* A big part of this class acts as a wrapper over the PEAR
* Spreadsheet_Excel_Writer_Workbook and OLE libraries
* maintaining Moodle functions isolated from underlying code.
var $pear_excel_worksheet;
var $latin_output;
- /* Constructs one Moodle Worksheet.
+ /**
+ * Constructs one Moodle Worksheet.
+ *
* @param string $filename The name of the file
* @param object $workbook The internal PEAR Workbook onject we are creating
*/
}
}
- /* Write one string somewhere in the worksheet
+ /**
+ * Write one string somewhere in the worksheet
+ *
* @param integer $row Zero indexed row
* @param integer $col Zero indexed column
* @param string $str The string to write
$this->pear_excel_worksheet->writeString($row, $col, $str, $format);
}
- /* Write one number somewhere in the worksheet
+ /**
+ * Write one number somewhere in the worksheet
+ *
* @param integer $row Zero indexed row
* @param integer $col Zero indexed column
* @param float $num The number to write
$this->pear_excel_worksheet->writeNumber($row, $col, $num, $format);
}
- /* Write one url somewhere in the worksheet
+ /**
+ * Write one url somewhere in the worksheet
+ *
* @param integer $row Zero indexed row
* @param integer $col Zero indexed column
* @param string $url The url to write
$this->pear_excel_worksheet->writeUrl($row, $col, $url, $format);
}
- /* Write one formula somewhere in the worksheet
+ /**
+ * Write one formula somewhere in the worksheet
+ *
* @param integer $row Zero indexed row
* @param integer $col Zero indexed column
* @param string $formula The formula to write
$this->pear_excel_worksheet->writeFormula($row, $col, $formula, $format);
}
- /* Write one blanck somewhere in the worksheet
+ /**
+ * Write one blanck somewhere in the worksheet
+ *
* @param integer $row Zero indexed row
* @param integer $col Zero indexed column
* @param mixed $format The XF format for the cell
$this->pear_excel_worksheet->writeBlank($row, $col, $format);
}
- /* Write anything somewhere in the worksheet
+ /**
+ * Write anything somewhere in the worksheet
* Type will be automatically detected
+ *
* @param integer $row Zero indexed row
* @param integer $col Zero indexed column
* @param mixed $token What we are writing
}
}
- /* Sets the height (and other settings) of one row
+ /**
+ * Sets the height (and other settings) of one row
+ *
* @param integer $row The row to set
* @param integer $height Height we are giving to the row (null to set just format withouth setting the height)
* @param mixed $format The optional XF format we are giving to the row
$this->pear_excel_worksheet->setRow($row, $height, $format, $hidden, $level);
}
- /* Sets the width (and other settings) of one column
+ /**
+ * Sets the width (and other settings) of one column
+ *
* @param integer $firstcol first column on the range
* @param integer $lastcol last column on the range
* @param integer $width width to set
/// Merge cells safely to the PEAR Worksheet
$this->pear_excel_worksheet->mergeCells($first_row, $first_col, $last_row, $last_col);
}
-
- /* Returns the PEAR Excel Format for one Moodle Excel Format
+
+ /**
+ * Returns the PEAR Excel Format for one Moodle Excel Format
+ *
* @param mixed MoodleExcelFormat object
* @return mixed PEAR Excel Format object
*/
/**
* Define and operate over one Format.
-*
+*
* A big part of this class acts as a wrapper over the PEAR
* Spreadsheet_Excel_Writer_Workbook and OLE libraries
* maintaining Moodle functions isolated from underlying code.
var $pear_excel_format;
- /* Constructs one Moodle Format.
+ /**
+ * Constructs one Moodle Format.
+ *
* @param object $workbook The internal PEAR Workbook onject we are creating
*/
function MoodleExcelFormat(&$workbook, $properties = array()) {
/**
* Set the size of the text in the format (in pixels).
* By default all texts in generated sheets are 10px.
+ *
* @param integer $size Size of the text (in pixels)
*/
function set_size($size) {
$this->pear_excel_format->setSize($size);
}
- /* Set weight of the format
+ /**
+ * Set weight of the format
+ *
* @param integer $weight Weight for the text, 0 maps to 400 (normal text),
* 1 maps to 700 (bold text). Valid range is: 100-1000.
* It's Optional, default is 1 (bold).
$this->pear_excel_format->setBold($weight);
}
- /* Set underline of the format
+ /**
+ * Set underline of the format
+ *
* @param integer $underline The value for underline. Possible values are:
* 1 => underline, 2 => double underline
*/
$this->pear_excel_format->setUnderline($underline);
}
- /* Set italic of the format
+ /**
+ * Set italic of the format
*/
function set_italic() {
/// Set the italic safely to the PEAR Format
$this->pear_excel_format->setItalic();
}
- /* Set strikeout of the format
+ /**
+ * Set strikeout of the format
*/
function set_strikeout() {
/// Set the strikeout safely to the PEAR Format
$this->pear_excel_format->setStrikeOut();
}
- /* Set outlining of the format
+ /**
+ * Set outlining of the format
*/
function set_outline() {
/// Set the outlining safely to the PEAR Format
$this->pear_excel_format->setOutLine();
}
- /* Set shadow of the format
+ /**
+ * Set shadow of the format
*/
function set_shadow() {
/// Set the shadow safely to the PEAR Format
$this->pear_excel_format->setShadow();
}
- /* Set the script of the text
+ /**
+ * Set the script of the text
+ *
* @param integer $script The value for script type. Possible values are:
* 1 => superscript, 2 => subscript
*/
$this->pear_excel_format->setScript($script);
}
- /* Set color of the format
+ /**
+ * Set color of the format. Used to specify the color of the text to be formatted.
+ *
* @param mixed $color either a string (like 'blue'), or an integer (range is [8...63])
*/
function set_color($color) {
$this->pear_excel_format->setColor($color);
}
- /* Set foreground color of the format
+ /**
+ * Set foreground color (top layer) of the format. About formatting colors note that cells backgrounds
+ * have TWO layers, in order to support patterns and paint them with two diferent colors.
+ * This method set the color of the TOP layer of the background format. So, when filling
+ * cells with plain colors (no patterns) this is the method to use.
+ *
* @param mixed $color either a string (like 'blue'), or an integer (range is [8...63])
*/
function set_fg_color($color) {
$this->pear_excel_format->setFgColor($color);
}
- /* Set background color of the format
+ /**
+ * Set background color (bottom layer) of the format. About formatting colors note that cells backgrounds
+ * have TWO layers, in order to support patterns and paint them with two diferent colors.
+ * This method set the color of the BOTTOM layer of the background format. So, the color
+ * specified here only will be visible if using patterns. Use set_fg_color() to fill
+ * cells with plain colors (no patterns).
+ *
* @param mixed $color either a string (like 'blue'), or an integer (range is [8...63])
*/
function set_bg_color($color) {
$this->pear_excel_format->setBgColor($color);
}
- /* Set the fill pattern of the format
+ /**
+ * Set the fill pattern of the format
* @param integer Optional. Defaults to 1. Meaningful values are: 0-18
* 0 meaning no background.
*/
$this->pear_excel_format->setPattern($pattern);
}
- /* Set text wrap of the format
+ /**
+ * Set text wrap of the format
*/
function set_text_wrap() {
/// Set the shadow safely to the PEAR Format
$this->pear_excel_format->setTextWrap();
}
- /* Set the cell alignment of the format
+ /**
+ * Set the cell alignment of the format
+ *
* @param string $location alignment for the cell ('left', 'right', etc...)
*/
function set_align($location) {
$this->pear_excel_format->setAlign($location);
}
- /* Set the cell horizontal alignment of the format
+ /**
+ * Set the cell horizontal alignment of the format
+ *
* @param string $location alignment for the cell ('left', 'right', etc...)
*/
function set_h_align($location) {
$this->pear_excel_format->setHAlign($location);
}
- /* Set the cell vertical alignment of the format
+ /**
+ * Set the cell vertical alignment of the format
+ *
* @param string $location alignment for the cell ('top', 'vleft', etc...)
*/
function set_v_align($location) {
$this->pear_excel_format->setVAlign($location);
}
- /* Set the top border of the format
+ /**
+ * Set the top border of the format
+ *
* @param integer $style style for the cell. 1 => thin, 2 => thick
*/
function set_top($style) {
$this->pear_excel_format->setTop($style);
}
- /* Set the bottom border of the format
+ /**
+ * Set the bottom border of the format
+ *
* @param integer $style style for the cell. 1 => thin, 2 => thick
*/
function set_bottom($style) {
$this->pear_excel_format->setBottom($style);
}
- /* Set the left border of the format
+ /**
+ * Set the left border of the format
+ *
* @param integer $style style for the cell. 1 => thin, 2 => thick
*/
function set_left($style) {
$this->pear_excel_format->setLeft($style);
}
- /* Set the right border of the format
+ /**
+ * Set the right border of the format
+ *
* @param integer $style style for the cell. 1 => thin, 2 => thick
*/
function set_right($style) {
/**
* Set cells borders to the same style
+ *
* @param integer $style style to apply for all cell borders. 1 => thin, 2 => thick.
*/
function set_border($style) {
$this->pear_excel_format->setBorder($style);
}
- /* Set the numerical format of the format
- * It can be date, time, currency, etc...
- /* Set the numerical format of the format
+ /**
+ * Set the numerical format of the format
* It can be date, time, currency, etc...
+ *
* @param integer $num_format The numeric format
*/
function set_num_format($num_format) {
projects / moodle.git / commitdiff