/*******************************************************************************
* You may amend and distribute as you like, but don't remove this header!
*
* EPPlus provides server-side generation of Excel 2007/2010 spreadsheets.
* See http://www.codeplex.com/EPPlus for details.
*
* Copyright (C) 2011 Jan Källman
*
* 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.
*
* The GNU Lesser General Public License can be viewed at http://www.opensource.org/licenses/lgpl-license.php
* If you unfamiliar with this license or have questions about it, here is an http://www.gnu.org/licenses/gpl-faq.html
*
* All code and executables are provided "as is" with no warranty either express or implied.
* The author accepts no liability for any damage or loss of business that this product may cause.
*
* Code change notes:
*
* Author Change Date
*******************************************************************************
* Jan Källman License changed GPL-->LGPL 2011-12-27
*******************************************************************************/
using System;
using System.Collections.Generic;
using System.Text;
using System.Xml;
using System.Collections;
using OfficeOpenXml.Utils;
namespace OfficeOpenXml
{
///
/// Collection of Excelcomment objects
///
public class ExcelCommentCollection : IEnumerable, IDisposable
{
internal RangeCollection _comments;
internal ExcelCommentCollection(ExcelPackage pck, ExcelWorksheet ws, XmlNamespaceManager ns)
{
CommentXml = new XmlDocument();
CommentXml.PreserveWhitespace = false;
NameSpaceManager=ns;
Worksheet=ws;
CreateXml(pck);
AddCommentsFromXml();
}
private void CreateXml(ExcelPackage pck)
{
var commentParts = Worksheet.Part.GetRelationshipsByType(ExcelPackage.schemaComment);
bool isLoaded=false;
CommentXml=new XmlDocument();
foreach(var commentPart in commentParts)
{
Uri = UriHelper.ResolvePartUri(commentPart.SourceUri, commentPart.TargetUri);
Part = pck.Package.GetPart(Uri);
XmlHelper.LoadXmlSafe(CommentXml, Part.GetStream());
RelId = commentPart.Id;
isLoaded=true;
}
//Create a new document
if(!isLoaded)
{
CommentXml.LoadXml("");
Uri = null;
}
}
private void AddCommentsFromXml()
{
var lst = new List();
foreach (XmlElement node in CommentXml.SelectNodes("//d:commentList/d:comment", NameSpaceManager))
{
var comment = new ExcelComment(NameSpaceManager, node, new ExcelRangeBase(Worksheet, node.GetAttribute("ref")));
lst.Add(comment);
}
_comments = new RangeCollection(lst);
}
///
/// Access to the comment xml document
///
public XmlDocument CommentXml { get; set; }
internal Uri Uri { get; set; }
internal string RelId { get; set; }
internal XmlNamespaceManager NameSpaceManager { get; set; }
internal Packaging.ZipPackagePart Part
{
get;
set;
}
///
/// A reference to the worksheet object
///
public ExcelWorksheet Worksheet
{
get;
set;
}
///
/// Number of comments in the collection
///
public int Count
{
get
{
return _comments.Count;
}
}
///
/// Indexer for the comments collection
///
/// The index
/// The comment
public ExcelComment this[int Index]
{
get
{
if (Index < 0 || Index >= _comments.Count)
{
throw(new ArgumentOutOfRangeException("Comment index out of range"));
}
return _comments[Index] as ExcelComment;
}
}
///
/// Indexer for the comments collection
///
/// The cell
/// The comment
public ExcelComment this[ExcelCellAddress cell]
{
get
{
ulong cellID=ExcelCellBase.GetCellID(Worksheet.SheetID, cell.Row, cell.Column);
if (_comments.IndexOf(cellID) >= 0)
{
return _comments[cellID] as ExcelComment;
}
else
{
return null;
}
}
}
///
/// Adds a comment to the top left cell of the range
///
/// The cell
/// The comment text
/// Author
/// The comment
public ExcelComment Add(ExcelRangeBase cell, string Text, string author)
{
var elem = CommentXml.CreateElement("comment", ExcelPackage.schemaMain);
int ix=_comments.IndexOf(ExcelAddress.GetCellID(Worksheet.SheetID, cell._fromRow, cell._fromCol));
//Make sure the nodes come on order.
if (ix < 0 && (~ix < _comments.Count))
{
ix = ~ix;
var preComment = _comments[ix] as ExcelComment;
preComment._commentHelper.TopNode.ParentNode.InsertBefore(elem, preComment._commentHelper.TopNode);
}
else
{
CommentXml.SelectSingleNode("d:comments/d:commentList", NameSpaceManager).AppendChild(elem);
}
elem.SetAttribute("ref", cell.Start.Address);
ExcelComment comment = new ExcelComment(NameSpaceManager, elem , cell);
comment.RichText.Add(Text);
if(author!="")
{
comment.Author=author;
}
_comments.Add(comment);
//Check if a value exists otherwise add one so it is saved when the cells collection is iterated
if (!Worksheet._values.Exists(cell._fromRow, cell._fromCol))
{
Worksheet._values.SetValue(cell._fromRow, cell._fromCol, null);
}
return comment;
}
///
/// Removes the comment
///
/// The comment to remove
public void Remove(ExcelComment comment)
{
ulong id = ExcelAddress.GetCellID(Worksheet.SheetID, comment.Range._fromRow, comment.Range._fromCol);
int ix=_comments.IndexOf(id);
if (ix >= 0 && comment == _comments[ix])
{
comment.TopNode.ParentNode.RemoveChild(comment.TopNode); //Remove VML
comment._commentHelper.TopNode.ParentNode.RemoveChild(comment._commentHelper.TopNode); //Remove Comment
Worksheet.VmlDrawingsComments._drawings.Delete(id);
_comments.Delete(id);
}
else
{
throw (new ArgumentException("Comment does not exist in the worksheet"));
}
}
void IDisposable.Dispose()
{
if (_comments != null)
((IDisposable)_comments).Dispose();
}
///
/// Removes the comment at the specified position
///
/// The index
public void RemoveAt(int Index)
{
Remove(this[Index]);
}
#region IEnumerable Members
IEnumerator IEnumerable.GetEnumerator()
{
return _comments;
}
#endregion
internal void Clear()
{
while(Count>0)
{
RemoveAt(0);
}
}
}
}