Přidat anotaci lnk
Aspose.PDF for .NET je výkonná knihovna, která umožňuje vývojářům provádět různé operace s PDF. Jednou z takových operací je přidání inkoustové anotace do dokumentů PDF. V tomto článku poskytneme podrobného průvodce vysvětlujícího zdrojový kód C# pro přidávání inkoustové anotace pomocí Aspose.PDF pro .NET. Začněme!
Pochopení funkce inkoustové anotace Aspose.PDF pro .NET
Než se ponoříme do zdrojového kódu C#, nejprve si ujasněme, co je to Ink Annotation a jak se používá.
Ink Annotation je způsob, jak kreslit volné poznámky inkoustem na dokumenty PDF. Umožňuje vytvářet poznámky pomocí stylusu nebo myši. Tato funkce je užitečná v situacích, kdy potřebujete kreslit diagramy, náčrty nebo jiné typy poznámek.
Krok 1: Vytvoření nového dokumentu
Prvním krokem při přidávání inkoustové anotace do dokumentu PDF je vytvoření nové instance třídy Dokument. Toho je dosaženo pomocí následujícího fragmentu kódu:
string dataDir = "YOUR DATA DIRECTORY";
Document doc = new Document();
Page pdfPage = doc.Pages.Add();
Zde vytvoříme novou instanci třídy Document a přidáme do ní novou stránku.
Krok 2: Vytvoření inkoustové anotace
Dalším krokem je vytvoření instance třídy InkAnnotation. To se provádí pomocí následujícího fragmentu kódu:
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);
IList<Point[]> inkList = new List<Point[]>();
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);
Zde nejprve vytvoříme obdélník pomocí třídy System.Drawing.Rectangle a převedeme jej na Aspose.Pdf.Rectangle pomocí metody FromRect. Poté vytvoříme instanci třídy InkAnnotation pomocí obdélníku, seznamu bodů a stránky, kam je přidána anotace.
Poté nastavíme různé vlastnosti InkAnnotation, jako je nadpis, barva, styl čepice, ohraničení a krytí. Nakonec přidáme anotaci na stránku pomocí metody Annotations.Add.
Krok 3: Uložení dokumentu
Posledním krokem je uložení dokumentu PDF s přidanou Ink Annotation. Toho je dosaženo pomocí následujícího fragmentu kódu:
dataDir = dataDir + "AddlnkAnnotation_out.pdf";
doc.Save(dataDir);
Zde zřetězíme název výstupního souboru do datového adresáře a dokument uložíme pomocí metody Save.
Příklad zdrojového kódu pro přidávání inkoustové anotace pomocí Aspose.PDF pro .NET
// Cesta k adresáři dokumentů.
string dataDir = "YOUR DATA DIRECTORY";
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);
IList<Point[]> inkList = new List<Point[]>();
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";
// Uložit výstupní soubor
doc.Save(dataDir);
Závěr
tomto tutoriálu jsme prozkoumali, jak přidat inkoustové anotace do dokumentu PDF pomocí Aspose.PDF pro .NET. Pomocí podrobného průvodce a poskytnutého zdrojového kódu C# mohou vývojáři snadno implementovat funkci Ink Annotation do svých aplikací pro zpracování PDF.
FAQ
Otázka: Co je to inkoustová anotace v dokumentu PDF?
Odpověď: Inkoustová anotace v dokumentu PDF umožňuje uživatelům kreslit volné inkoustové anotace pomocí stylusu nebo myši. Běžně se používá k přidávání ručně kreslených náčrtů, diagramů nebo jiných poznámek od ruky do PDF.
Otázka: Mohu přizpůsobit vzhled poznámky inkoustu?
Odpověď: Ano, Aspose.PDF for .NET poskytuje různé vlastnosti pro přizpůsobení vzhledu inkoustové anotace, jako je barva, neprůhlednost, styl čepice, šířka ohraničení a další. Vývojáři mohou tyto vlastnosti upravit tak, aby splňovaly jejich specifické požadavky.
Otázka: Je možné přidat více inkoustových anotací na jednu stránku PDF?
Odpověď: Ano, pomocí Aspose.PDF for .NET můžete na jednu stránku PDF přidat více inkoustových anotací. Každá anotace inkoustu může mít vlastní sadu bodů a přizpůsobený vzhled.
Otázka: Mohu přidat inkoustové anotace ke stávajícím dokumentům PDF?
Odpověď: Ano, Aspose.PDF for .NET vám umožňuje přidávat inkoustové anotace jak do nově vytvořených dokumentů PDF, tak do stávajících souborů PDF. Můžete otevřít existující PDF, přidat inkoustové anotace a uložit aktualizovaný dokument.
Otázka: Jaké jsou některé běžné případy použití inkoustových anotací v dokumentech PDF?
Odpověď: Inkoustové anotace jsou užitečné pro širokou škálu aplikací, včetně přidávání podpisů nebo ručně psaných poznámek do formulářů PDF, anotování architektonických plánů nebo technických výkresů a označování dokumentů pro společnou kontrolu.