PDF转换控件Aspose.PDF for .Net使用教程（五）：在现有PDF文件中添加注释

Aspose.PDF for .NET是一种高PDF处理和解析API，用于在跨平台应用程序中执行文档管理和操作任务。API可以轻松用于生成、修改、转换、渲染、保护和打印PDF文档，而无需使用Adobe Acrobat。

Aspose.PDF for .NET是一种高PDF处理和解析API，用于在跨平台应用程序中执行文档管理和操作任务。API可以轻松用于生成、修改、转换、渲染、保护和打印PDF文档，而无需使用Adobe Acrobat。此外，API还提供PDF压缩选项，表格创建和操作，图形和图像功能，广泛的超链接功能，印章和水印任务，扩展的安全控制和自定义字体处理。

【下载体验Aspose.PDF for .NET最新版】

在接下来的系列教程中，将为开发者带来Aspose.PDF for .NET的一系列使用教程，例如进行文档间的转换，如何标记PDF文件，如何使用表单和图表等等。

第二章：使用注释

▲第二节：添加，删除和获取注释

在现有PDF文件中添加注释

注释包含在Annotations特定的集合中Page。此集合仅包含该单个页面的注释; 每个页面都有自己的Annotations集合。要向特定页面添加注释，请Annotations使用该Add方法将其添加到该页面的集合中。

1. 首先创建要添加到PDF的注释。
2. 然后打开输入PDF。
3. 将注释添加到Page对象的Annotations集合中。

以下代码段显示如何在PDF页面中添加注释：

//文档目录的路径。string dataDir = RunExamples.GetDataDir_AsposePdf_Annotations();//打开文档Document pdfDocument = new Document(dataDir + "AddAnnotation.pdf");//创建注释TextAnnotation textAnnotation = new TextAnnotation(pdfDocument.Pages[1], new Aspose.Pdf.Rectangle(200, 400, 400, 600));textAnnotation.Title = "Sample Annotation Title";textAnnotation.Subject = "Sample Subject";textAnnotation.State = AnnotationState.Accepted;textAnnotation.Contents = "Sample contents for the annotation";textAnnotation.Open = true;textAnnotation.Icon = TextIcon.Key;           Border border = new Border(textAnnotation);border.Width = 5;border.Dash = new Dash(1, 1);textAnnotation.Border = border;textAnnotation.Rect = new Aspose.Pdf.Rectangle(200, 400, 400, 600);           //在页面的注释集合中添加注释pdfDocument.Pages[1].Annotations.Add(textAnnotation);dataDir = dataDir + "AddAnnotation_out.pdf";//保存输出文件pdfDocument.Save(dataDir);

●隐形注释

有时，有必要创建在查看时在文档中不可见的水印，但在打印文档时应该可见。为此目的使用注释标志。以下代码段显示了如何操作：

//文档目录的路径。string dataDir = RunExamples.GetDataDir_AsposePdf_Annotations();//打开文档。Document doc = new Document(dataDir + "input.pdf");FreeTextAnnotation annotation = new FreeTextAnnotation(doc.Pages[1], new Aspose.Pdf.Rectangle(50, 600, 250, 650), new DefaultAppearance("Helvetica", 16, System.Drawing.Color.Red));annotation.Contents = "ABCDEFG";annotation.Characteristics.Border = System.Drawing.Color.Red;annotation.Flags = AnnotationFlags.Print | AnnotationFlags.NoView;doc.Pages[1].Annotations.Add(annotation);dataDir = dataDir + "InvisibleAnnotation_out.pdf";// 保存输出文件doc.Save(dataDir);

●添加InkAnnotation

InkAnnotation表示由一个或多个不相交点组成的徒手涂鸦。请尝试使用以下代码段在PDF文档中添加InkAnnotation：

//文档目录的路径。string dataDir = RunExamples.GetDataDir_AsposePdf_Annotations();Document doc = new Document();Page pdfPage = doc.Pages.Add();System.Drawing.Rectangle drect = new System.Drawing.Rectangle();drect.Height = (int)pdfPage.Rect.Height;drect.Width = (int)pdfPage.Rect.Width;drect.X = 0;drect.Y = 0;Aspose.Pdf.Rectangle arect = Aspose.Pdf.Rectangle.FromRect(drect);IListinkList = new List();Aspose.Pdf.Point[] arrpt = new Aspose.Pdf.Point[3];inkList.Add(arrpt);arrpt[0] = new Aspose.Pdf.Point(100, 800);arrpt[1] = new Aspose.Pdf.Point(200, 800);arrpt[2] = new Aspose.Pdf.Point(200, 700);InkAnnotation ia = new InkAnnotation(pdfPage, arect, inkList);ia.Title = "XXX";ia.Color = Aspose.Pdf.Color.LightBlue; // (GetColorFromString(stroke.InkColor));ia.CapStyle = CapStyle.Rounded;Border border = new Border(ia);border.Width = 25;ia.Opacity = 0.5;pdfPage.Annotations.Add(ia);dataDir = dataDir + "AddlnkAnnotation_out.pdf";//保存输出文件doc.Save(dataDir);

●设置InkAnnotation的线宽

可以使用LineInfo和Border对象更改InkAnnottion的宽度：

//文档目录的路径。string dataDir = RunExamples.GetDataDir_AsposePdf_Annotations();Document doc = new Document();doc.Pages.Add();IListinkList = new List();LineInfo lineInfo = new LineInfo();lineInfo.VerticeCoordinate = new float[] { 55, 55, 70, 70, 70, 90, 150, 60 };lineInfo.Visibility = true;lineInfo.LineColor = System.Drawing.Color.Red;lineInfo.LineWidth = 2;int length = lineInfo.VerticeCoordinate.Length / 2;Aspose.Pdf.Point[] gesture = new Aspose.Pdf.Point[length];for (int i = 0; i < length; i++){   gesture[i] = new Aspose.Pdf.Point(lineInfo.VerticeCoordinate[2 * i], lineInfo.VerticeCoordinate[2 * i + 1]);}inkList.Add(gesture);InkAnnotation a1 = new InkAnnotation(doc.Pages[1], new Aspose.Pdf.Rectangle(100, 100, 300, 300), inkList);a1.Subject = "Test";a1.Title = "Title";a1.Color = Aspose.Pdf.Color.FromRgb(System.Drawing.Color.Green);Border border = new Border(a1);border.Width = 3;border.Effect = BorderEffect.Cloudy;border.Dash = new Dash(1, 1);border.Style = BorderStyle.Solid;doc.Pages[1].Annotations.Add(a1);dataDir = dataDir + "lnkAnnotationLineWidth_out.pdf";//保存输出文件doc.Save(dataDir);

●添加WatermarkAnnotation

可以在PDF页面的特定位置使用WaterarkAnnotation添加水印文本，也可以使用不透明度属性控制水印的不透明度。请检查以下代码段以添加WatermarkAnnotation：

C＃

//Load a DocumentAspose.PDF.Document doc = new Aspose.PDF.Document("source.pdf");//Load Page object to add AnnotationPage page = doc.Pages[1];//Create AnnotationWatermarkAnnotation wa = new WatermarkAnnotation(page, new Aspose.PDF.Rectangle(100, 500, 400, 600));//Add annotaiton into Annotation collection of Pagepage.Annotations.Add(wa);//Create TextState for Font settingsAspose.PDF.Text.TextState ts = new Aspose.PDF.Text.TextState();ts.ForegroundColor = Aspose.PDF.Color.Blue;ts.Font = FontRepository.FindFont("Times New Roman");ts.FontSize = 32;//Set opacity level of Annotaiton Textwa.Opacity = 0.5;//Add Text in Annotationwa.SetTextAndState(new string[] { "HELLO", "Line 1", "Line 2" }, ts);//Save the Docuemntdoc.Save("Output.pdf");

●添加RichMediaAnnotation

当您需要在PDF文档中添加外部视频链接时，您可以使用MovieAnnotaiton。但是当需要在PDF文档中嵌入媒体时，您需要使用RichMediaAnnotation。此注释允许将媒体文件嵌入PDF文档中并设置视频/音频播放器，实现为Flash应用程序。由于许可限制，我们不能在产品中包含第三方Flash脚本，因此您应该提供播放视频或音频的脚本。您应该提供Flash应用程序代码。例如，您可以使用随Adobe Acrobat一起分发的videoplayer.swf和audioplayer.swf，可以在Acrobat文件夹的Multimedia Skins / Players子文件夹中找到。其他选择是使用StrobeMediaPLayback.swf播放器或在flash中实现的任何其他视频播放器。

RichMediaAnnotation 可以使用以下类的方法/属性：

• Stream CustomPlayer { set; }：允许设置用于播放视频的播放器。
• string CustomFlashVariables { set; }：允许设置传递给Flash应用程序的变量。该行是“key = value”对的集合，用“＆”分隔;
• void AddCustomData(strig name, Stream data)：为播放器添加其他数据。例如，source = video.mp4＆autoPlay = true＆scale = 100
• ActivationEvent ActivateOn { get; set}：事件激活玩家; 可能的值有Click，PageOpen，PageVisible
• void SetContent(Stream stream, string name)：设置要播放的视频/音频数据
• void Update()：创建注释的数据结构。应该最后调用此方法
• void SetPoster(Stream)：设置视频的海 ，即播放器未激活时显示的图片

嵌入视频文件（C#）

string myDir = "C:/Temp/"; Aspose.PDF.Document doc = new Aspose.PDF.Document(); Page page = doc.Pages.Add(); RichMediaAnnotation rma = new RichMediaAnnotation(page, new Aspose.PDF.Rectangle(100,500, 300, 600)); //here we should specify stream containing code of the video playerrma.CustomPlayer = new FileStream(@"C:AdobeAcrobat 11.0AcrobatMultimediaSkinsPlayersVideoplayer.swf",FileMode.Open,FileAccess.Read); //give name to video data. This data will be embedded into document with this name and referenced from flash variables by this name. //videoName should not contain path to the file; this is rather "key" to access data inside of the PDF documentstring videoName = "VideoTutorial.mp4"; //also we use skin for video playerstring skinName = "SkinOverAllNoFullNoCaption.swf"; //compose flash variables line for player. please note that different players may have different format of the flash variables line. Refer to documentation for your player.rma.CustomFlashVariables = String.Format("source={0}&skin={1}", "VideoTutorial.mp4", skinName); //add skin code. rma.AddCustomData(skinName,new FileStream(@"C:Program Files (x86)AdobeAcrobat 11.0AcrobatMultimedia SkinsSkinOverAllNoFullNoCaption.swf",FileMode.Open, FileAccess.Read)); //set poster for videorma.SetPoster(new FileStream(myDir + "barcode.jpg",FileMode.Open, FileAccess.Read)); Stream fs = new FileStream(myDir + videoName, FileMode.Open, FileAccess.Read); //set video contentrma.SetContent(videoName, fs); //set type of the content (video)rma.Type = RichMediaAnnotation.ContentType.Video; //active player by clickrma.ActivateOn = RichMediaAnnotation.ActivationEvent.Click; //update annotation data. This method should be called after all assignments/setup. This method initializes data structure of the annotation and embeds required data. rma.Update(); //add annotation on the page.page.Annotations.Add(rma); doc.Save(myDir + "Output.pdf");

嵌入音频文件（C#）

Aspose.PDF.Documentdoc = new Aspose.PDF.Document(); Page page = doc.Pages.Add(); //give name to audio data. This data will be embedded into document with this name and referenced from flash variables by this name. string audioName = "test_cbr.mp3"; RichMediaAnnotation rma = new RichMediaAnnotation(page, new Aspose.PDF.Rectangle(100,650, 300, 670)); Stream fs = new FileStream(myDir+audioName, FileMode.Open, FileAccess.Read); //here we should specify stream containing code of the audio playerrma.CustomPlayer = new FileStream(@"C:Program Files (x86)AdobeAcrobat 11.0AcrobatMultimediaSkinsPlayersAudioplayer.swf", FileMode.Open,FileAccess.Read); //compose flash variables line for player. please note that different players may have different format of the flash variables line. Refer to documentation for your player.rma.CustomFlashVariables = String.Format("source={0}", "test_cbr.mp3"); //active player on page open eventrma.ActivateOn = RichMediaAnnotation.ActivationEvent.PageOpen; //set audio contentrma.SetContent(audioName, fs); //set type of the content (audio)rma.Type = RichMediaAnnotation.ContentType.Audio; //update annotation data. This method should be called after all assignments/setup. This method initializes data structure of the annotation and embeds required data. rma.Update(); //add annotation on the page.page.Annotations.Add(rma); doc.Save(myDir+"39606-2.pdf");

— 未完待续 —

*想要购买Aspose.PDF for .NET正版授权的朋友可以联系在线客服了解详情哦~

欢迎加入ASPOSE技术交流QQ群，各类资源及时分享，技术问题交流讨论！（扫描下方二维码加入群聊）

标签：