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
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|