Lägg till lnk-anteckning
Aspose.PDF för .NET är ett kraftfullt bibliotek som gör det möjligt för utvecklare att utföra olika PDF-operationer. En sådan operation är att lägga till Ink Annotation till PDF-dokument. I den här artikeln kommer vi att tillhandahålla en steg-för-steg-guide för att förklara C#-källkoden för att lägga till Ink Annotation med Aspose.PDF för .NET. Låt oss börja!
Förstå bläckanteckningsfunktionen i Aspose.PDF för .NET
Innan vi dyker in i C#-källkoden, låt oss först förstå vad Ink Annotation är och dess användningsområden.
Ink Annotation är ett sätt att rita friformsbläckanteckningar på PDF-dokument. Det låter dig skapa kommentarer med en penna eller en mus. Den här funktionen är användbar i situationer där du behöver rita diagram, skisser eller andra typer av kommentarer.
Steg 1: Skapa ett nytt dokument
Det första steget i att lägga till Ink Annotation i ett PDF-dokument är att skapa en ny instans av klassen Document. Detta uppnås med hjälp av följande kodavsnitt:
string dataDir = "YOUR DATA DIRECTORY";
Document doc = new Document();
Page pdfPage = doc.Pages.Add();
Här skapar vi en ny instans av klassen Document och lägger till en ny sida till den.
Steg 2: Skapa bläckanteckning
Nästa steg är att skapa en instans av klassen InkAnnotation. Detta görs med hjälp av följande kodavsnitt:
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);
Här skapar vi först en rektangel med klassen System.Drawing.Rectangle och konverterar den till Aspose.Pdf.Rectangle med metoden FromRect. Vi skapar sedan en instans av klassen InkAnnotation med hjälp av rektangeln, en lista med punkter och sidan där anteckningen läggs till.
Vi ställer sedan in olika egenskaper för InkAnnotation, såsom titel, färg, kepsstil, kant och opacitet. Slutligen lägger vi till anteckningen på sidan med metoden Annotations.Add.
Steg 3: Spara dokumentet
Det sista steget är att spara PDF-dokumentet med bläckanteckningen tillagd. Detta uppnås med hjälp av följande kodavsnitt:
dataDir = dataDir + "AddlnkAnnotation_out.pdf";
doc.Save(dataDir);
Här sammanfogar vi utdatafilens namn till datakatalogen och sparar dokumentet med hjälp av Spara-metoden.
Exempel på källkod för att lägga till bläckanteckningar med Aspose.PDF för .NET
// Sökvägen till dokumentkatalogen.
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";
// Spara utdatafil
doc.Save(dataDir);
Slutsats
den här handledningen undersökte vi hur man lägger till Ink Annotations till ett PDF-dokument med Aspose.PDF för .NET. Genom att följa den steg-för-steg-guide och C#-källkoden som tillhandahålls, kan utvecklare enkelt implementera Ink Annotation-funktionalitet i sina PDF-behandlingsprogram.
FAQ’s
F: Vad är en bläckanteckning i ett PDF-dokument?
S: En bläckanteckning i ett PDF-dokument låter användare rita bläckanteckningar i fritt format med hjälp av en penna eller mus. Det används vanligtvis för att lägga till handritade skisser, diagram eller andra frihandsanteckningar till en PDF.
F: Kan jag anpassa utseendet på bläckanteckningen?
S: Ja, Aspose.PDF för .NET tillhandahåller olika egenskaper för att anpassa utseendet på bläckanteckningen, till exempel färg, opacitet, kapsylstil, kantbredd och mer. Utvecklare kan justera dessa egenskaper för att möta deras specifika krav.
F: Är det möjligt att lägga till flera bläckanteckningar på en enda PDF-sida?
S: Ja, du kan lägga till flera bläckanteckningar på en enda PDF-sida med Aspose.PDF för .NET. Varje bläckanteckning kan ha sin egen uppsättning punkter och anpassat utseende.
F: Kan jag lägga till bläckanteckningar i befintliga PDF-dokument?
S: Ja, Aspose.PDF för .NET låter dig lägga till Ink Annotations till både nyskapade PDF-dokument och befintliga PDF-filer. Du kan öppna en befintlig PDF, lägga till Ink Annotations och spara det uppdaterade dokumentet.
F: Vilka är några vanliga användningsfall för bläckanteckningar i PDF-dokument?
S: Bläckanteckningar är användbara för ett brett spektrum av tillämpningar, inklusive att lägga till signaturer eller handskrivna anteckningar till PDF-formulär, kommentera arkitektoniska ritningar eller tekniska ritningar och markera dokument för gemensam granskning.
