文檔半島外圍網上直營>>Aspose.PDF for .NET開發者使用教程>>PDF轉換控件Aspose.PDF for .Net使用教程（五）：在現有PDF文件中添加注釋
PDF轉換控件Aspose.PDF for .Net使用教程（五）：在現有PDF文件中添加注釋
Aspose.PDF for .NET是一種高PDF處理和解析API，用于在跨平臺應用程序中執行文檔管理和操作任務。API可以輕松用于生成、修改、轉換、渲染、保護和打印PDF文檔，而無需使用Adobe Acrobat。此外，API還提供PDF壓縮選項，表格創建和操作，圖形和圖像功能，廣泛的超鏈接功能，印章和水印任務，擴展的安全控制和自定義字體處理。
在接下來的系列教程中，將為開發者帶來Aspose.PDF for .NET的一系列使用教程，例如進行文檔間的轉換，如何標記PDF文件，如何使用表單和圖表等等。
第二章：使用注釋
▲第二節：添加，刪除和獲取注釋
在現有PDF文件中添加注釋
注釋包含在Annotations特定的集合中Page。此集合僅包含該單個頁面的注釋; 每個頁面都有自己的Annotations集合。要向特定頁面添加注釋，請Annotations使用該Add方法將其添加到該頁面的集合中。
- 首先創建要添加到PDF的注釋。
- 然后打開輸入PDF。
- 將注釋添加到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 Document
Aspose.PDF.Document doc = new Aspose.PDF.Document("source.pdf");
//Load Page object to add Annotation
Page page = doc.Pages[1];
//Create Annotation
WatermarkAnnotation wa = new WatermarkAnnotation(page, new Aspose.PDF.Rectangle(100, 500, 400, 600));
//Add annotaiton into Annotation collection of Page
page.Annotations.Add(wa);
//Create TextState for Font settings
Aspose.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 Text
wa.Opacity = 0.5;
//Add Text in Annotation
wa.SetTextAndState(new string[] { "HELLO", "Line 1", "Line 2" }, ts);
//Save the Docuemnt
doc.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 player
rma.CustomPlayer = new FileStream(@"C:\Adobe\Acrobat 11.0\Acrobat\MultimediaSkins\Players\Videoplayer.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 document
string videoName = "VideoTutorial.mp4";
//also we use skin for video player
string 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)\Adobe\Acrobat 11.0\Acrobat\Multimedia Skins\SkinOverAllNoFullNoCaption.swf",FileMode.Open, FileAccess.Read));
//set poster for video
rma.SetPoster(new FileStream(myDir + "barcode.jpg",FileMode.Open, FileAccess.Read));
Stream fs = new FileStream(myDir + videoName, FileMode.Open, FileAccess.Read);
//set video content
rma.SetContent(videoName, fs);
//set type of the content (video)
rma.Type = RichMediaAnnotation.ContentType.Video;
//active player by click
rma.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.Document
doc = 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 player
rma.CustomPlayer = new FileStream(@"C:\Program Files (x86)\Adobe\Acrobat 11.0\Acrobat\MultimediaSkins\Players\Audioplayer.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 event
rma.ActivateOn = RichMediaAnnotation.ActivationEvent.PageOpen;
//set audio content
rma.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群，各類資源及時分享，技術問題交流討論！（掃描下方二維碼加入群聊）
QQ交談
在線咨詢
渝公網安備
50010702500608號
客服熱線