lnk Annotation Line Width

Introduktion

När du arbetar med PDF-dokument kan lägga till anteckningar vara ett kraftfullt sätt att markera information eller lägga till interaktiva element till dina filer. En sådan anteckning är Ink Annotation, som låter dig rita fria linjer på din PDF. Men vad händer om du behöver anpassa utseendet på dessa linjer, särskilt linjebredden? I den här handledningen går vi igenom processen för att ställa in färganteckningslinjebredden med Aspose.PDF för .NET.

Förutsättningar

Innan vi dyker in i koden, låt oss se till att du har allt inställt för att följa denna handledning smidigt:

  1. Aspose.PDF för .NET: Se till att du har Aspose.PDF för .NET-biblioteket installerat. Du kan ladda ner den frånnedladdningssida eller installera den via NuGet Package Manager i Visual Studio.
  2. Utvecklingsmiljö: Denna handledning förutsätter att du arbetar i en .NET-utvecklingsmiljö som Visual Studio.
  3. Grundläggande kunskaper om C#: En grundläggande förståelse av C# hjälper dig att följa med i kodningsstegen.
  4. PDF-dokument: Använd antingen ett befintligt PDF-dokument eller skapa ett nytt för den här handledningen.

Importera nödvändiga namnområden

Innan du börjar koda, se till att importera de nödvändiga namnrymden i ditt projekt:

using System.IO;
using Aspose.Pdf.Annotations;
using Aspose.Pdf;
using Aspose.Pdf.Facades;
using System;
using System.Collections;
using System.Collections.Generic;

Dessa namnområden tillhandahåller de klasser och metoder som behövs för att manipulera PDF-dokument, arbeta med anteckningar och hantera grafiska element.

Nu när vi har våra förutsättningar på plats, låt oss dela upp processen att ställa in färganteckningslinjens bredd i tydliga, hanterbara steg.

Steg 1: Initiera PDF-dokumentet

Först måste vi skapa eller öppna ett PDF-dokument. För den här handledningen skapar vi ett nytt PDF-dokument från början.

// Initiera PDF-dokumentet
string dataDir = "YOUR DOCUMENT DIRECTORY"; // Ange din dokumentkatalog
Document doc = new Document();
doc.Pages.Add(); // Lägg till en tom sida i dokumentet

Här startar vi en nyDocument objekt, som representerar vår PDF-fil. Vi lägger sedan till en tom sida i detta dokument att arbeta med.

Steg 2: Skapa bläckanteckningen

Därefter skapar vi själva bläckanteckningen. Detta innebär att definiera de punkter som utgör bläckslagen.

// Skapa bläckanteckningen
IList<Point[]> inkList = new List<Point[]>();
LineInfo lineInfo = new LineInfo();
lineInfo.VerticeCoordinate = new float[] { 55, 55, 70, 70, 70, 90, 150, 60 };
lineInfo.Visibility = true;
lineInfo.LineColor = Color.Red;
lineInfo.LineWidth = 2;

I det här steget definierar viLineInfo objekt, som håller koordinaterna för bläckdragen, deras synlighet, färg och initiala linjebredd. DeVerticeCoordinate matrisen innehåller X- och Y-koordinaterna för varje punkt i strecket.

Steg 3: Konvertera koordinater till punkter

Nu måste vi konvertera dessa koordinater till punkter som kan användas av Ink Annotation.

// Konvertera koordinater till punkter
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);

Denna loop bearbetar koordinatmatrisen och omvandlar varje koordinatpar till aPoint objekt, som sedan läggs till vårinkList.

Steg 4: Lägg till bläckanteckningen på PDF-sidan

Med punkterna redo kan vi nu skapa bläckanteckningen och lägga till den på PDF-sidan.

// Lägg till bläckanteckningen på PDF-sidan
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(Color.Green);

I det här steget initierar vi enInkAnnotationobjekt, som anger sidan, en avgränsande rektangel och vår lista med punkter. Vi anger också anteckningens ämne, titel och färg.

Steg 5: Anpassa anteckningens kant

För att ytterligare anpassa utseendet på vår kommentar kommer vi att ändra dess kantegenskaper.

// Anpassa anteckningens kant
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);

Här skapar vi enBorder objekt för vår anteckning, anger dess bredd, effekt, streckmönster och stil. Detta steg säkerställer att anteckningen sticker ut visuellt på PDF-sidan.

Steg 6: Spara PDF-dokumentet

Slutligen, efter att ha gjort alla nödvändiga ändringar, är det dags att spara dokumentet.

// Spara PDF-dokumentet
dataDir = dataDir + "lnkAnnotationLineWidth_out.pdf";
doc.Save(dataDir);
Console.WriteLine("\nInk annotation line width setup successfully.\nFile saved at " + dataDir);

Denna kod sparar det modifierade PDF-dokumentet med bläckanteckningen i den angivna katalogen. DeConsole.WriteLine uttalande bekräftar framgångsrik exekvering av koden.

Slutsats

Grattis! Du har framgångsrikt skapat och anpassat en bläckanteckning i ett PDF-dokument med Aspose.PDF för .NET. Denna handledning täckte hela processen, från initialisering av dokumentet till att spara den slutliga filen. Med denna kunskap kan du utforska de enorma funktionerna i Aspose.PDF för .NET ytterligare och tillämpa liknande tekniker på andra typer av anteckningar eller PDF-manipulationer.

FAQ’s

Kan jag använda olika färger för olika delar av bläckanteckningen?

Ja, du kan skapa fleraInkAnnotation objekt med olika färger och lägg till dem på samma eller olika sidor i din PDF.

Hur ändrar jag linjebredden dynamiskt?

Du kan justeraLineWidth egendom avLineInfo objekt innan du konverterar koordinaterna till punkter.

Är det möjligt att göra bläckanteckningen transparent?

Ja, du kan ändraOpacity egendom avInkAnnotation objekt för att göra det transparent.

Kan jag lägga till flera bläckanteckningar på samma sida?

Absolut! Du kan lägga till så många bläckanteckningar som du vill på en enda sida genom att upprepa processen.

Hur tar jag bort en bläckanteckning från en PDF?

Du kan ta bort en anteckning med hjälp avdoc.Pages[1].Annotations.Delete(a1) metod, vara1 är ditt anteckningsobjekt.

Osynlig anteckning i PDF-fil Redigera sida