400 lines
16 KiB
C#
400 lines
16 KiB
C#
#region PDFsharp - A .NET library for processing PDF
|
||
//
|
||
// Authors:
|
||
// Stefan Lange
|
||
//
|
||
// Copyright (c) 2005-2017 empira Software GmbH, Cologne Area (Germany)
|
||
//
|
||
// http://www.pdfsharp.com
|
||
// http://sourceforge.net/projects/pdfsharp
|
||
//
|
||
// Permission is hereby granted, free of charge, to any person obtaining a
|
||
// copy of this software and associated documentation files (the "Software"),
|
||
// to deal in the Software without restriction, including without limitation
|
||
// the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
||
// and/or sell copies of the Software, and to permit persons to whom the
|
||
// Software is furnished to do so, subject to the following conditions:
|
||
//
|
||
// The above copyright notice and this permission notice shall be included
|
||
// in all copies or substantial portions of the Software.
|
||
//
|
||
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
||
// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
||
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
||
// DEALINGS IN THE SOFTWARE.
|
||
#endregion
|
||
|
||
using System;
|
||
using PdfSharp.Drawing;
|
||
|
||
namespace PdfSharp.Pdf.Annotations
|
||
{
|
||
/// <summary>
|
||
/// Represents the base class of all annotations.
|
||
/// </summary>
|
||
public abstract class PdfAnnotation : PdfDictionary
|
||
{
|
||
/// <summary>
|
||
/// Initializes a new instance of the <see cref="PdfAnnotation"/> class.
|
||
/// </summary>
|
||
protected PdfAnnotation()
|
||
{
|
||
Initialize();
|
||
}
|
||
|
||
/// <summary>
|
||
/// Initializes a new instance of the <see cref="PdfAnnotation"/> class.
|
||
/// </summary>
|
||
protected PdfAnnotation(PdfDocument document)
|
||
: base(document)
|
||
{
|
||
Initialize();
|
||
}
|
||
|
||
/// <summary>
|
||
/// Initializes a new instance of the <see cref="PdfAnnotation"/> class.
|
||
/// </summary>
|
||
internal PdfAnnotation(PdfDictionary dict)
|
||
: base(dict)
|
||
{ }
|
||
|
||
void Initialize()
|
||
{
|
||
Elements.SetName(Keys.Type, "/Annot");
|
||
Elements.SetString(Keys.NM, Guid.NewGuid().ToString("D"));
|
||
Elements.SetDateTime(Keys.M, DateTime.Now);
|
||
}
|
||
|
||
/// <summary>
|
||
/// Removes an annotation from the document
|
||
/// <seealso cref="PdfAnnotations.Remove(PdfAnnotation)"/>
|
||
/// </summary>
|
||
[Obsolete("Use 'Parent.Remove(this)'")]
|
||
public void Delete()
|
||
{
|
||
Parent.Remove(this);
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets or sets the annotation flags of this instance.
|
||
/// </summary>
|
||
public PdfAnnotationFlags Flags
|
||
{
|
||
get { return (PdfAnnotationFlags)Elements.GetInteger(Keys.F); }
|
||
set
|
||
{
|
||
Elements.SetInteger(Keys.F, (int)value);
|
||
Elements.SetDateTime(Keys.M, DateTime.Now);
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets or sets the PdfAnnotations object that this annotation belongs to.
|
||
/// </summary>
|
||
public PdfAnnotations Parent
|
||
{
|
||
get { return _parent; }
|
||
set { _parent = value; }
|
||
}
|
||
PdfAnnotations _parent;
|
||
|
||
/// <summary>
|
||
/// Gets or sets the annotation rectangle, defining the location of the annotation
|
||
/// on the page in default user space units.
|
||
/// </summary>
|
||
public PdfRectangle Rectangle
|
||
{
|
||
get { return Elements.GetRectangle(Keys.Rect, true); }
|
||
set
|
||
{
|
||
Elements.SetRectangle(Keys.Rect, value);
|
||
Elements.SetDateTime(Keys.M, DateTime.Now);
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets or sets the text label to be displayed in the title bar of the annotation<6F>s
|
||
/// pop-up window when open and active. By convention, this entry identifies
|
||
/// the user who added the annotation.
|
||
/// </summary>
|
||
public string Title
|
||
{
|
||
get { return Elements.GetString(Keys.T, true); }
|
||
set
|
||
{
|
||
Elements.SetString(Keys.T, value);
|
||
Elements.SetDateTime(Keys.M, DateTime.Now);
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets or sets text representing a short description of the subject being
|
||
/// addressed by the annotation.
|
||
/// </summary>
|
||
public string Subject
|
||
{
|
||
get { return Elements.GetString(Keys.Subj, true); }
|
||
set
|
||
{
|
||
Elements.SetString(Keys.Subj, value);
|
||
Elements.SetDateTime(Keys.M, DateTime.Now);
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets or sets the text to be displayed for the annotation or, if this type of
|
||
/// annotation does not display text, an alternate description of the annotation<6F>s
|
||
/// contents in human-readable form.
|
||
/// </summary>
|
||
public string Contents
|
||
{
|
||
get { return Elements.GetString(Keys.Contents, true); }
|
||
set
|
||
{
|
||
Elements.SetString(Keys.Contents, value);
|
||
Elements.SetDateTime(Keys.M, DateTime.Now);
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets or sets the color representing the components of the annotation. If the color
|
||
/// has an alpha value other than 1, it is ignored. Use property Opacity to get or set the
|
||
/// opacity of an annotation.
|
||
/// </summary>
|
||
public XColor Color
|
||
{
|
||
get
|
||
{
|
||
PdfItem item = Elements[Keys.C];
|
||
PdfArray array = item as PdfArray;
|
||
if (array != null) // TODO: check for iref?
|
||
{
|
||
if (array.Elements.Count == 3)
|
||
{
|
||
// TODO: an array.GetColor() function may be useful here
|
||
return XColor.FromArgb(
|
||
(int)(array.Elements.GetReal(0) * 255),
|
||
(int)(array.Elements.GetReal(1) * 255),
|
||
(int)(array.Elements.GetReal(2) * 255));
|
||
}
|
||
}
|
||
return XColors.Black;
|
||
}
|
||
set
|
||
{
|
||
// TODO: an array.SetColor(clr) function may be useful here
|
||
PdfArray array = new PdfArray(Owner, new PdfReal[] { new PdfReal(value.R / 255.0), new PdfReal(value.G / 255.0), new PdfReal(value.B / 255.0) });
|
||
Elements[Keys.C] = array;
|
||
Elements.SetDateTime(Keys.M, DateTime.Now);
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets or sets the constant opacity value to be used in painting the annotation.
|
||
/// This value applies to all visible elements of the annotation in its closed state
|
||
/// (including its background and border) but not to the popup window that appears when
|
||
/// the annotation is opened.
|
||
/// </summary>
|
||
public double Opacity
|
||
{
|
||
get
|
||
{
|
||
if (!Elements.ContainsKey(Keys.CA))
|
||
return 1;
|
||
return Elements.GetReal(Keys.CA, true);
|
||
}
|
||
set
|
||
{
|
||
if (value < 0 || value > 1)
|
||
throw new ArgumentOutOfRangeException("value", value, "Opacity must be a value in the range from 0 to 1.");
|
||
Elements.SetReal(Keys.CA, value);
|
||
Elements.SetDateTime(Keys.M, DateTime.Now);
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Predefined keys of this dictionary.
|
||
/// </summary>
|
||
public class Keys : KeysBase
|
||
{
|
||
// ReSharper disable InconsistentNaming
|
||
|
||
/// <summary>
|
||
/// (Optional) The type of PDF object that this dictionary describes; if present,
|
||
/// must be Annot for an annotation dictionary.
|
||
/// </summary>
|
||
[KeyInfo(KeyType.Name | KeyType.Optional, FixedValue = "Annot")]
|
||
public const string Type = "/Type";
|
||
|
||
/// <summary>
|
||
/// (Required) The type of annotation that this dictionary describes.
|
||
/// </summary>
|
||
[KeyInfo(KeyType.Name | KeyType.Required)]
|
||
public const string Subtype = "/Subtype";
|
||
|
||
/// <summary>
|
||
/// (Required) The annotation rectangle, defining the location of the annotation
|
||
/// on the page in default user space units.
|
||
/// </summary>
|
||
[KeyInfo(KeyType.Rectangle | KeyType.Required)]
|
||
public const string Rect = "/Rect";
|
||
|
||
/// <summary>
|
||
/// (Optional) Text to be displayed for the annotation or, if this type of annotation
|
||
/// does not display text, an alternate description of the annotation<6F>s contents
|
||
/// in human-readable form. In either case, this text is useful when
|
||
/// extracting the document<6E>s contents in support of accessibility to users with
|
||
/// disabilities or for other purposes.
|
||
/// </summary>
|
||
[KeyInfo(KeyType.TextString | KeyType.Optional)]
|
||
public const string Contents = "/Contents";
|
||
|
||
// P
|
||
|
||
/// <summary>
|
||
/// (Optional; PDF 1.4) The annotation name, a text string uniquely identifying it
|
||
/// among all the annotations on its page.
|
||
/// </summary>
|
||
[KeyInfo(KeyType.TextString | KeyType.Optional)]
|
||
public const string NM = "/NM";
|
||
|
||
/// <summary>
|
||
/// (Optional; PDF 1.1) The date and time when the annotation was most recently
|
||
/// modified. The preferred format is a date string, but viewer applications should be
|
||
/// prepared to accept and display a string in any format.
|
||
/// </summary>
|
||
[KeyInfo(KeyType.Date | KeyType.Optional)]
|
||
public const string M = "/M";
|
||
|
||
/// <summary>
|
||
/// (Optional; PDF 1.1) A set of flags specifying various characteristics of the annotation.
|
||
/// Default value: 0.
|
||
/// </summary>
|
||
[KeyInfo("1.1", KeyType.Integer | KeyType.Optional)]
|
||
public const string F = "/F";
|
||
|
||
/// <summary>
|
||
/// (Optional; PDF 1.2) A border style dictionary specifying the characteristics of
|
||
/// the annotation<6F>s border.
|
||
/// </summary>
|
||
[KeyInfo("1.2", KeyType.Dictionary | KeyType.Optional)]
|
||
public const string BS = "/BS";
|
||
|
||
/// <summary>
|
||
/// (Optional; PDF 1.2) An appearance dictionary specifying how the annotation
|
||
/// is presented visually on the page. Individual annotation handlers may ignore
|
||
/// this entry and provide their own appearances.
|
||
/// </summary>
|
||
[KeyInfo("1.2", KeyType.Dictionary | KeyType.Optional)]
|
||
public const string AP = "/AP";
|
||
|
||
/// <summary>
|
||
/// (Required if the appearance dictionary AP contains one or more subdictionaries; PDF 1.2)
|
||
/// The annotation<6F>s appearance state, which selects the applicable appearance stream from
|
||
/// an appearance subdictionary.
|
||
/// </summary>
|
||
[KeyInfo("1.2", KeyType.Dictionary | KeyType.Optional)]
|
||
public const string AS = "/AS";
|
||
|
||
/// <summary>
|
||
/// (Optional) An array specifying the characteristics of the annotation<6F>s border.
|
||
/// The border is specified as a rounded rectangle.
|
||
/// In PDF 1.0, the array consists of three numbers defining the horizontal corner
|
||
/// radius, vertical corner radius, and border width, all in default user space units.
|
||
/// If the corner radii are 0, the border has square (not rounded) corners; if the border
|
||
/// width is 0, no border is drawn.
|
||
/// In PDF 1.1, the array may have a fourth element, an optional dash array defining a
|
||
/// pattern of dashes and gaps to be used in drawing the border. The dash array is
|
||
/// specified in the same format as in the line dash pattern parameter of the graphics state.
|
||
/// For example, a Border value of [0 0 1 [3 2]] specifies a border 1 unit wide, with
|
||
/// square corners, drawn with 3-unit dashes alternating with 2-unit gaps. Note that no
|
||
/// dash phase is specified; the phase is assumed to be 0.
|
||
/// Note: In PDF 1.2 or later, this entry may be ignored in favor of the BS entry.
|
||
/// </summary>
|
||
[KeyInfo(KeyType.Array | KeyType.Optional)]
|
||
public const string Border = "/Border";
|
||
|
||
/// <summary>
|
||
/// (Optional; PDF 1.1) An array of three numbers in the range 0.0 to 1.0, representing
|
||
/// the components of a color in the DeviceRGB color space. This color is used for the
|
||
/// following purposes:
|
||
/// <20> The background of the annotation<6F>s icon when closed
|
||
/// <20> The title bar of the annotation<6F>s pop-up window
|
||
/// <20> The border of a link annotation
|
||
/// </summary>
|
||
[KeyInfo("1.1", KeyType.Array | KeyType.Optional)]
|
||
public const string C = "/C";
|
||
|
||
// @PDF/UA
|
||
/// <summary>
|
||
/// (Required if the annotation is a structural content item; PDF 1.3)
|
||
/// The integer key of the annotation<6F>s entry in the structural parent tree.
|
||
/// </summary>
|
||
[KeyInfo("1.3", KeyType.Integer | KeyType.Optional)]
|
||
public const string StructParent = "/StructParent";
|
||
|
||
/// <summary>
|
||
/// (Optional; PDF 1.1) An action to be performed when the annotation is activated.
|
||
/// Note: This entry is not permitted in link annotations if a Dest entry is present.
|
||
/// Also note that the A entry in movie annotations has a different meaning.
|
||
/// </summary>
|
||
[KeyInfo("1.1", KeyType.Dictionary | KeyType.Optional)]
|
||
public const string A = "/A";
|
||
|
||
// AA
|
||
// StructParent
|
||
// OC
|
||
|
||
// ----- Excerpt of entries specific to markup annotations ----------------------------------
|
||
|
||
/// <summary>
|
||
/// (Optional; PDF 1.1) The text label to be displayed in the title bar of the annotation<6F>s
|
||
/// pop-up window when open and active. By convention, this entry identifies
|
||
/// the user who added the annotation.
|
||
/// </summary>
|
||
[KeyInfo(KeyType.TextString | KeyType.Optional)]
|
||
public const string T = "/T";
|
||
|
||
/// <summary>
|
||
/// (Optional; PDF 1.3) An indirect reference to a pop-up annotation for entering or
|
||
/// editing the text associated with this annotation.
|
||
/// </summary>
|
||
[KeyInfo(KeyType.Dictionary | KeyType.Optional)]
|
||
public const string Popup = "/Popup";
|
||
|
||
/// <summary>
|
||
/// (Optional; PDF 1.4) The constant opacity value to be used in painting the annotation.
|
||
/// This value applies to all visible elements of the annotation in its closed state
|
||
/// (including its background and border) but not to the popup window that appears when
|
||
/// the annotation is opened.
|
||
/// The specified value is not used if the annotation has an appearance stream; in that
|
||
/// case, the appearance stream must specify any transparency. (However, if the viewer
|
||
/// regenerates the annotation<6F>s appearance stream, it may incorporate the CA value
|
||
/// into the stream<61>s content.)
|
||
/// The implicit blend mode is Normal.
|
||
/// Default value: 1.0.
|
||
/// </summary>
|
||
[KeyInfo(KeyType.Real | KeyType.Optional)]
|
||
public const string CA = "/CA";
|
||
|
||
//RC
|
||
//CreationDate
|
||
//IRT
|
||
|
||
/// <summary>
|
||
/// (Optional; PDF 1.5) Text representing a short description of the subject being
|
||
/// addressed by the annotation.
|
||
/// </summary>
|
||
[KeyInfo("1.5", KeyType.TextString | KeyType.Optional)]
|
||
public const string Subj = "/Subj";
|
||
|
||
//RT
|
||
//IT
|
||
// ReSharper restore InconsistentNaming
|
||
}
|
||
}
|
||
}
|