ILIAS  release_5-2 Revision v5.2.25-18-g3f80b828510
PHPExcel_Worksheet_BaseDrawing Class Reference
+ Inheritance diagram for PHPExcel_Worksheet_BaseDrawing:
+ Collaboration diagram for PHPExcel_Worksheet_BaseDrawing:

Public Member Functions

 __construct ()
 Create a new PHPExcel_Worksheet_BaseDrawing. More...
 
 getImageIndex ()
 Get image index. More...
 
 getName ()
 Get Name. More...
 
 setName ($pValue='')
 Set Name. More...
 
 getDescription ()
 Get Description. More...
 
 setDescription ($pValue='')
 Set Description. More...
 
 getWorksheet ()
 Get Worksheet. More...
 
 setWorksheet (PHPExcel_Worksheet $pValue=null, $pOverrideOld=false)
 Set Worksheet. More...
 
 getCoordinates ()
 Get Coordinates. More...
 
 setCoordinates ($pValue='A1')
 Set Coordinates. More...
 
 getOffsetX ()
 Get OffsetX. More...
 
 setOffsetX ($pValue=0)
 Set OffsetX. More...
 
 getOffsetY ()
 Get OffsetY. More...
 
 setOffsetY ($pValue=0)
 Set OffsetY. More...
 
 getWidth ()
 Get Width. More...
 
 setWidth ($pValue=0)
 Set Width. More...
 
 getHeight ()
 Get Height. More...
 
 setHeight ($pValue=0)
 Set Height. More...
 
 setWidthAndHeight ($width=0, $height=0)
 Set width and height with proportional resize Example: $objDrawing->setResizeProportional(true); $objDrawing->setWidthAndHeight(160,120); More...
 
 getResizeProportional ()
 Get ResizeProportional. More...
 
 setResizeProportional ($pValue=true)
 Set ResizeProportional. More...
 
 getRotation ()
 Get Rotation. More...
 
 setRotation ($pValue=0)
 Set Rotation. More...
 
 getShadow ()
 Get Shadow. More...
 
 setShadow (PHPExcel_Worksheet_Drawing_Shadow $pValue=null)
 Set Shadow. More...
 
 getHashCode ()
 Get hash code. More...
 
 __clone ()
 Implement PHP __clone to create a deep clone, not just a shallow copy. More...
 

Protected Attributes

 $_name
 
 $_description
 
 $_worksheet
 
 $_coordinates
 
 $_offsetX
 
 $_offsetY
 
 $_width
 
 $_height
 
 $_resizeProportional
 
 $_rotation
 
 $_shadow
 

Private Attributes

 $_imageIndex = 0
 

Static Private Attributes

static $_imageCounter = 0
 

Detailed Description

Definition at line 36 of file BaseDrawing.php.

Constructor & Destructor Documentation

◆ __construct()

PHPExcel_Worksheet_BaseDrawing::__construct ( )

Create a new PHPExcel_Worksheet_BaseDrawing.

Definition at line 132 of file BaseDrawing.php.

133  {
134  // Initialise values
135  $this->_name = '';
136  $this->_description = '';
137  $this->_worksheet = null;
138  $this->_coordinates = 'A1';
139  $this->_offsetX = 0;
140  $this->_offsetY = 0;
141  $this->_width = 0;
142  $this->_height = 0;
143  $this->_resizeProportional = true;
144  $this->_rotation = 0;
145  $this->_shadow = new PHPExcel_Worksheet_Drawing_Shadow();
146 
147  // Set image index
148  self::$_imageCounter++;
149  $this->_imageIndex = self::$_imageCounter;
150  }

Member Function Documentation

◆ __clone()

PHPExcel_Worksheet_BaseDrawing::__clone ( )

Implement PHP __clone to create a deep clone, not just a shallow copy.

Definition at line 479 of file BaseDrawing.php.

479  {
480  $vars = get_object_vars($this);
481  foreach ($vars as $key => $value) {
482  if (is_object($value)) {
483  $this->$key = clone $value;
484  } else {
485  $this->$key = $value;
486  }
487  }
488  }

◆ getCoordinates()

PHPExcel_Worksheet_BaseDrawing::getCoordinates ( )

Get Coordinates.

Returns
string

Definition at line 251 of file BaseDrawing.php.

References $_coordinates.

251  {
252  return $this->_coordinates;
253  }

◆ getDescription()

PHPExcel_Worksheet_BaseDrawing::getDescription ( )

Get Description.

Returns
string

Definition at line 186 of file BaseDrawing.php.

References $_description.

186  {
187  return $this->_description;
188  }

◆ getHashCode()

PHPExcel_Worksheet_BaseDrawing::getHashCode ( )

Get hash code.

Returns
string Hash code

Implements PHPExcel_IComparable.

Definition at line 460 of file BaseDrawing.php.

Referenced by setWorksheet().

460  {
461  return md5(
462  $this->_name
463  . $this->_description
464  . $this->_worksheet->getHashCode()
465  . $this->_coordinates
466  . $this->_offsetX
467  . $this->_offsetY
468  . $this->_width
469  . $this->_height
470  . $this->_rotation
471  . $this->_shadow->getHashCode()
472  . __CLASS__
473  );
474  }
+ Here is the caller graph for this function:

◆ getHeight()

PHPExcel_Worksheet_BaseDrawing::getHeight ( )

Get Height.

Returns
int

Definition at line 339 of file BaseDrawing.php.

References $_height.

339  {
340  return $this->_height;
341  }

◆ getImageIndex()

PHPExcel_Worksheet_BaseDrawing::getImageIndex ( )

Get image index.

Returns
int

Definition at line 157 of file BaseDrawing.php.

References $_imageIndex.

Referenced by PHPExcel_Worksheet_Drawing\getIndexedFilename(), and PHPExcel_Worksheet_MemoryDrawing\getIndexedFilename().

157  {
158  return $this->_imageIndex;
159  }
+ Here is the caller graph for this function:

◆ getName()

PHPExcel_Worksheet_BaseDrawing::getName ( )

Get Name.

Returns
string

Definition at line 166 of file BaseDrawing.php.

References $_name.

166  {
167  return $this->_name;
168  }

◆ getOffsetX()

PHPExcel_Worksheet_BaseDrawing::getOffsetX ( )

Get OffsetX.

Returns
int

Definition at line 271 of file BaseDrawing.php.

References $_offsetX.

271  {
272  return $this->_offsetX;
273  }

◆ getOffsetY()

PHPExcel_Worksheet_BaseDrawing::getOffsetY ( )

Get OffsetY.

Returns
int

Definition at line 291 of file BaseDrawing.php.

References $_offsetY.

291  {
292  return $this->_offsetY;
293  }

◆ getResizeProportional()

PHPExcel_Worksheet_BaseDrawing::getResizeProportional ( )

Get ResizeProportional.

Returns
boolean

Definition at line 399 of file BaseDrawing.php.

References $_resizeProportional.

399  {
401  }

◆ getRotation()

PHPExcel_Worksheet_BaseDrawing::getRotation ( )

Get Rotation.

Returns
int

Definition at line 419 of file BaseDrawing.php.

References $_rotation.

419  {
420  return $this->_rotation;
421  }

◆ getShadow()

PHPExcel_Worksheet_BaseDrawing::getShadow ( )

Get Shadow.

Returns
PHPExcel_Worksheet_Drawing_Shadow

Definition at line 439 of file BaseDrawing.php.

References $_shadow.

439  {
440  return $this->_shadow;
441  }

◆ getWidth()

PHPExcel_Worksheet_BaseDrawing::getWidth ( )

Get Width.

Returns
int

Definition at line 311 of file BaseDrawing.php.

References $_width.

311  {
312  return $this->_width;
313  }

◆ getWorksheet()

PHPExcel_Worksheet_BaseDrawing::getWorksheet ( )

Get Worksheet.

Returns
PHPExcel_Worksheet

Definition at line 206 of file BaseDrawing.php.

References $_worksheet.

206  {
207  return $this->_worksheet;
208  }

◆ setCoordinates()

PHPExcel_Worksheet_BaseDrawing::setCoordinates (   $pValue = 'A1')

Set Coordinates.

Parameters
string$pValue
Returns
PHPExcel_Worksheet_BaseDrawing

Definition at line 261 of file BaseDrawing.php.

261  {
262  $this->_coordinates = $pValue;
263  return $this;
264  }

◆ setDescription()

PHPExcel_Worksheet_BaseDrawing::setDescription (   $pValue = '')

Set Description.

Parameters
string$pValue
Returns
PHPExcel_Worksheet_BaseDrawing

Definition at line 196 of file BaseDrawing.php.

196  {
197  $this->_description = $pValue;
198  return $this;
199  }

◆ setHeight()

PHPExcel_Worksheet_BaseDrawing::setHeight (   $pValue = 0)

Set Height.

Parameters
int$pValue
Returns
PHPExcel_Worksheet_BaseDrawing

Definition at line 349 of file BaseDrawing.php.

349  {
350  // Resize proportional?
351  if ($this->_resizeProportional && $pValue != 0) {
352  $ratio = $this->_width / ($this->_height != 0 ? $this->_height : 1);
353  $this->_width = round($ratio * $pValue);
354  }
355 
356  // Set height
357  $this->_height = $pValue;
358 
359  return $this;
360  }

◆ setName()

PHPExcel_Worksheet_BaseDrawing::setName (   $pValue = '')

Set Name.

Parameters
string$pValue
Returns
PHPExcel_Worksheet_BaseDrawing

Definition at line 176 of file BaseDrawing.php.

176  {
177  $this->_name = $pValue;
178  return $this;
179  }

◆ setOffsetX()

PHPExcel_Worksheet_BaseDrawing::setOffsetX (   $pValue = 0)

Set OffsetX.

Parameters
int$pValue
Returns
PHPExcel_Worksheet_BaseDrawing

Definition at line 281 of file BaseDrawing.php.

281  {
282  $this->_offsetX = $pValue;
283  return $this;
284  }

◆ setOffsetY()

PHPExcel_Worksheet_BaseDrawing::setOffsetY (   $pValue = 0)

Set OffsetY.

Parameters
int$pValue
Returns
PHPExcel_Worksheet_BaseDrawing

Definition at line 301 of file BaseDrawing.php.

301  {
302  $this->_offsetY = $pValue;
303  return $this;
304  }

◆ setResizeProportional()

PHPExcel_Worksheet_BaseDrawing::setResizeProportional (   $pValue = true)

Set ResizeProportional.

Parameters
boolean$pValue
Returns
PHPExcel_Worksheet_BaseDrawing

Definition at line 409 of file BaseDrawing.php.

409  {
410  $this->_resizeProportional = $pValue;
411  return $this;
412  }

◆ setRotation()

PHPExcel_Worksheet_BaseDrawing::setRotation (   $pValue = 0)

Set Rotation.

Parameters
int$pValue
Returns
PHPExcel_Worksheet_BaseDrawing

Definition at line 429 of file BaseDrawing.php.

429  {
430  $this->_rotation = $pValue;
431  return $this;
432  }

◆ setShadow()

PHPExcel_Worksheet_BaseDrawing::setShadow ( PHPExcel_Worksheet_Drawing_Shadow  $pValue = null)

Set Shadow.

Parameters
PHPExcel_Worksheet_Drawing_Shadow$pValue
Exceptions
PHPExcel_Exception
Returns
PHPExcel_Worksheet_BaseDrawing

Definition at line 450 of file BaseDrawing.php.

450  {
451  $this->_shadow = $pValue;
452  return $this;
453  }

◆ setWidth()

PHPExcel_Worksheet_BaseDrawing::setWidth (   $pValue = 0)

Set Width.

Parameters
int$pValue
Returns
PHPExcel_Worksheet_BaseDrawing

Definition at line 321 of file BaseDrawing.php.

321  {
322  // Resize proportional?
323  if ($this->_resizeProportional && $pValue != 0) {
324  $ratio = $this->_height / ($this->_width != 0 ? $this->_width : 1);
325  $this->_height = round($ratio * $pValue);
326  }
327 
328  // Set width
329  $this->_width = $pValue;
330 
331  return $this;
332  }

◆ setWidthAndHeight()

PHPExcel_Worksheet_BaseDrawing::setWidthAndHeight (   $width = 0,
  $height = 0 
)

Set width and height with proportional resize Example: $objDrawing->setResizeProportional(true); $objDrawing->setWidthAndHeight(160,120);

Author
Vincent MSN:kele_.nosp@m.100@.nosp@m.hotma.nosp@m.il.c.nosp@m.om
Parameters
int$width
int$height
Returns
PHPExcel_Worksheet_BaseDrawing

Definition at line 375 of file BaseDrawing.php.

375  {
376  $xratio = $width / ($this->_width != 0 ? $this->_width : 1);
377  $yratio = $height / ($this->_height != 0 ? $this->_height : 1);
378  if ($this->_resizeProportional && !($width == 0 || $height == 0)) {
379  if (($xratio * $this->_height) < $height) {
380  $this->_height = ceil($xratio * $this->_height);
381  $this->_width = $width;
382  } else {
383  $this->_width = ceil($yratio * $this->_width);
384  $this->_height = $height;
385  }
386  } else {
387  $this->_width = $width;
388  $this->_height = $height;
389  }
390 
391  return $this;
392  }

◆ setWorksheet()

PHPExcel_Worksheet_BaseDrawing::setWorksheet ( PHPExcel_Worksheet  $pValue = null,
  $pOverrideOld = false 
)

Set Worksheet.

Parameters
PHPExcel_Worksheet$pValue
bool$pOverrideOldIf a Worksheet has already been assigned, overwrite it and remove image from old Worksheet?
Exceptions
PHPExcel_Exception
Returns
PHPExcel_Worksheet_BaseDrawing

Definition at line 218 of file BaseDrawing.php.

References getHashCode().

218  {
219  if (is_null($this->_worksheet)) {
220  // Add drawing to PHPExcel_Worksheet
221  $this->_worksheet = $pValue;
222  $this->_worksheet->getCell($this->_coordinates);
223  $this->_worksheet->getDrawingCollection()->append($this);
224  } else {
225  if ($pOverrideOld) {
226  // Remove drawing from old PHPExcel_Worksheet
227  $iterator = $this->_worksheet->getDrawingCollection()->getIterator();
228 
229  while ($iterator->valid()) {
230  if ($iterator->current()->getHashCode() == $this->getHashCode()) {
231  $this->_worksheet->getDrawingCollection()->offsetUnset( $iterator->key() );
232  $this->_worksheet = null;
233  break;
234  }
235  }
236 
237  // Set new PHPExcel_Worksheet
238  $this->setWorksheet($pValue);
239  } else {
240  throw new PHPExcel_Exception("A PHPExcel_Worksheet has already been assigned. Drawings can only exist on one PHPExcel_Worksheet.");
241  }
242  }
243  return $this;
244  }
getCell($pCoordinate='A1')
Get cell at a specific coordinate.
Definition: Worksheet.php:1153
setWorksheet(PHPExcel_Worksheet $pValue=null, $pOverrideOld=false)
Set Worksheet.
+ Here is the call graph for this function:

Field Documentation

◆ $_coordinates

PHPExcel_Worksheet_BaseDrawing::$_coordinates
protected

Definition at line 78 of file BaseDrawing.php.

Referenced by getCoordinates().

◆ $_description

PHPExcel_Worksheet_BaseDrawing::$_description
protected

Definition at line 64 of file BaseDrawing.php.

Referenced by getDescription().

◆ $_height

PHPExcel_Worksheet_BaseDrawing::$_height
protected

Definition at line 106 of file BaseDrawing.php.

Referenced by getHeight().

◆ $_imageCounter

PHPExcel_Worksheet_BaseDrawing::$_imageCounter = 0
staticprivate

Definition at line 43 of file BaseDrawing.php.

◆ $_imageIndex

PHPExcel_Worksheet_BaseDrawing::$_imageIndex = 0
private

Definition at line 50 of file BaseDrawing.php.

Referenced by getImageIndex().

◆ $_name

PHPExcel_Worksheet_BaseDrawing::$_name
protected

Definition at line 57 of file BaseDrawing.php.

Referenced by getName().

◆ $_offsetX

PHPExcel_Worksheet_BaseDrawing::$_offsetX
protected

Definition at line 85 of file BaseDrawing.php.

Referenced by getOffsetX().

◆ $_offsetY

PHPExcel_Worksheet_BaseDrawing::$_offsetY
protected

Definition at line 92 of file BaseDrawing.php.

Referenced by getOffsetY().

◆ $_resizeProportional

PHPExcel_Worksheet_BaseDrawing::$_resizeProportional
protected

Definition at line 113 of file BaseDrawing.php.

Referenced by getResizeProportional().

◆ $_rotation

PHPExcel_Worksheet_BaseDrawing::$_rotation
protected

Definition at line 120 of file BaseDrawing.php.

Referenced by getRotation().

◆ $_shadow

PHPExcel_Worksheet_BaseDrawing::$_shadow
protected

Definition at line 127 of file BaseDrawing.php.

Referenced by getShadow().

◆ $_width

PHPExcel_Worksheet_BaseDrawing::$_width
protected

Definition at line 99 of file BaseDrawing.php.

Referenced by getWidth().

◆ $_worksheet

PHPExcel_Worksheet_BaseDrawing::$_worksheet
protected

Definition at line 71 of file BaseDrawing.php.

Referenced by getWorksheet().


The documentation for this class was generated from the following file: