PDF אַנאַטיישאַנז וואָרט דאָקומענטן

ווי צו לייגן אַנאַטיישאַנז צו אַ פּדף ניצן C#. נעץ

אין הייַנט ס דיגיטאַל עלטער, [PDFs] (https://docs.fileformat.com/pdf/) האָבן ווערן אַ פאָלקס פֿאָרמאַט פֿאַר ייַנטיילונג אינפֿאָרמאַציע, דאָקומענטן און ריפּאָרץ. אָבער, פשוט וויוינג אַ פּדף קען נישט זיין גענוג פֿאַר פילע יוזערז. מאל, יוזערז זאל וועלן צו הויכפּונקט אָדער לייגן הערות צו ספּעציפיש פּאַרץ פון די PDF צו צושטעלן נאָך קאָנטעקסט אָדער באַמערקונגען. צומ גליק, עס זענען עטלעכע פריי פּדף אַנאַטייטערז בנימצא וואָס לאָזן ניצערס צו לייכט לייגן באַמערקונגען, הויכפּונקט טעקסט און מער. אָבער, אין דעם אַרטיקל, מיר וועלן ויספאָרשן ווי צו נוצן די REST API צו שטיצן פּדף אַנאַטיישאַנז, און ווייַזן איר ווי צו הויכפּונקט, באַמערקונג און לייגן הערות צו דיין פּדף דאָקומענטן.

REST API פֿאַר פּדף אַנאַטיישאַן

[Aspose.PDF Cloud] (https://products.aspose.cloud/pdf/curl/) גיט אַן גרינג-צו-נוצן און פולשטענדיק לייזונג צו לייגן אַנאַטיישאַנז צו פּדף דאָקומענטן פּראָגראַממאַטיק. מיט Aspose.PDF קלאָוד, איר קענען לייגן פאַרשידן טייפּס פון אַנאַטיישאַנז צו פּדף דאָקומענטן, אַרייַנגערעכנט טעקסט, בילד, שטעמפּל און פאַרשידן מאַרקאַפּ אַנאַטיישאַנז. איר קענען אויך מאָדיפיצירן יגזיסטינג אַנאַטיישאַנז, אַזאַ ווי טשאַנגינג די שטעלע, גרייס, קאָליר אָדער קיין אנדערע פּראָפּערטיעס.

סופּפּאָרטעד אַנאַטיישאַנז אַרייַננעמען טעקסט, סירקלע, פּאָליגאָן, פּאָלילינע, שורה, קוואַדראַט, פרעעטעקסט, הויכפּונקט, אַנדערליין, סקוויגגלי, סטרייקאַוט, קאַרעט, טינט, לינק, אויפֿשפּרינג, פילע אַטטאַטשמענט, סאָונד, פֿילם, פאַרשטעלן, ווידזשיט, וואָטערמאַרק, טראַפּנעט, פּרינטערמאַרק, רעדאַקטיאָן, שטעמפּל, ריטשמעדיאַ און PDF3D.

איצט, אין סדר צו לייגן די SDK אין דיין פּרויעקט, ביטע זוכן Aspose.PDF-Cloud אין NuGet פּאַקידזשיז פאַרוואַלטער און גיט די לייג פּעקל קנעפּל. דער ווייַטער וויכטיק שריט איז צו רעגיסטרירן אַ חשבון איבער קלאָוד דאַשבאָרד און באַקומען דיין פערזענלעכע קליענט קראַדענטשאַלז. ביטע קוק איבער די [שנעל אָנהייב] (https://docs.aspose.cloud/words/getting-started/quickstart/) פירער פֿאַר מער דעטאַילס.

לייג באַמערקונגען צו פּדף ניצן C#

לאָמיר אַ קוק איבער די C#. נעץ קאָד סניפּאַט וואָס איז געניצט צו לייגן אַנאַטיישאַן צו אַ פּדף דאָקומענט.

// פֿאַר גאַנץ ביישפילן און דאַטן טעקעס, ביטע גיין צו 
https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet

// באַקומען קליענט קראַדענטשאַלז פֿון https://dashboard.aspose.cloud/
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";

// שאַפֿן אַ כייפעץ פון PdfApi
PdfApi api = new PdfApi(clientSecret, clientID);

// שאַפֿן רשימה כייפעץ אַנטהאַלטן FreeTextAnnotations
List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>
{
new FreeTextAnnotation(
    // ספּעציפיצירן די רעקטאַנגגיאַלער געגנט מיט FreeTextAnnotation
    // אויך דעפינירן טעקסט פאָרמאַטטינג פרטים
    Rect: new Rectangle(100, 800, 350, 830),
    TextStyle:new TextStyle(
        FontSize: 26, Font: "Arial",
        ForegroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0, 0xFF, 0),
        BackgroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0xFF, 0, 0)
        ))
    {
    // אינהאַלט צו זיין געוויזן אין FreeTextAnnotation
    Contents = "Confidential !",
    Color = new Aspose.Pdf.Cloud.Sdk.Model.Color(0, 0, 0, 0),
    Id = "id1",
    Name = "Test Free Text",                    
    Flags = new List<AnnotationFlags> {AnnotationFlags.Default},
    HorizontalAlignment = HorizontalAlignment.Center,
    Intent = FreeTextIntent.FreeTextTypeWriter,
    RichText = "Rich Text",
    Subject = "Text Box Subj",
    ZIndex = 1,
    Justification = Justification.Center,
    Title = "Title",
    PageIndex = 1                     
    }
};
var response = api. PostPageFreeTextAnnotations("Binder1.pdf", 1, annotations);

איצט, לעץ פֿאַרשטיין די קאָד סניפּאַט אין מער דעטאַילס.

PdfApi api = new PdfApi(clientSecret, clientID);

שאַפֿן אַ בייַשפּיל פון PdfApi קלאַס וואָס נעמט קליענט קראַדענטשאַלז ווי אַרגומענטן אין זיין קאָנסטרוקטאָר.

List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>

ווי די API שטיצט די פיייקייט צו לייגן איין אָדער מער אַנאַטיישאַנז פון ענלעך טיפּ אין דער זעלביקער צייט, אַזוי מיר דאַרפֿן צו שאַפֿן אַ רשימה כייפעץ פון FreeTextAnnnotation טיפּ.

new FreeTextAnnotation(
    Rect: new Rectangle(100, 800, 350, 830),
    TextStyle:new TextStyle(
        FontSize: 26, Font: "Arial",
        ForegroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0, 0xFF, 0),
        BackgroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0xFF, 0, 0)
        ))

שאַפֿן אַן אָביעקט פון FreeTextAnnotation ווו מיר דעפינירן די רעקטאַנגגיאַלער געגנט פֿאַר אַננאָטאַטיאָן און טעקסט פאָרמאַטטינג דעטאַילס.

Contents = "Confidential !"

דאָ מיר דעפינירן די אינהאַלט פֿאַר FreeTextAnnotation.

var response = api. PostPageFreeTextAnnotations("Binder1.pdf", 1, annotations);

רופן די REST API צו לייגן FreeTextAnnotation אויף דער ערשטער בלאַט פון PDF דאָקומענט שוין בנימצא אין קלאָוד סטאָרידזש.

געגעבן אונטן זענען די מעגלעך וואַלועס וואָס קענען זיין אַסיינד צו די פּראָפּערטיעס געניצט אין אויבן קאָד סניפּאַט.

  • אַננאָטאַטיאָן פלאַגס - סופּפּאָרטעד וואַלועס קענען זיין `[דיפאָלט, ומזעיק, פאַרבאָרגן, פּרינט, נאָזאָאָם, נאָראָטאַטע, נאָוויעוו, רעאַדאָנלי, פארשפארט, ToggleNoView, LockedContents].
  • דרייען - ראָוטיישאַן ווינקל פֿאַר טעקסט. מעגלעך וואַלועס קענען זיין [קיין, אויף90, אויף180, אויף270].
  • AnnotationFlags - א סכום פון פלאַגס וואָס ספּעציפיצירן פאַרשידן קעראַקטעריסטיקס פון די אַנאַטיישאַן. די מעגלעך ווערט קענען זיין `[דיפאָלט, ומזעיק, פאַרבאָרגן, פּרינט, נאָזאָאָם, נאָראָטאַטע, נאָוויעוו, רעאַדאָנלי, לאַקט, ToggleNoView, LockedContents].
  • FreeTextIntent - ענומערייץ די ינטענץ פון די פריי טעקסט אַנאַטיישאַן. מעגלעך וואַלועס קענען זיין [ Undefined, FreeTextCallout, FreeTextTypeWriter].

לייג פריי טעקסט אַנאַטיישאַן צו פּדף ניצן קורל קאַמאַנדז

די נוצן פון cURL קאַמאַנדז צו רופן Aspose.PDF קלאָוד אַפּי איז אַ גוט צוגאַנג צו דערגרייכן דעם פאָדערונג. עס איז אויך גוט אויב איר זענט באַקאַנט מיט באַפֿעלן שורה מכשירים אָדער בעסער צו נוצן זיי. אַזוי, מיט די cURL באַפֿעלן שורה געצייַג, איר קענען מאַכן הטטפּ ריקוועס און דורכפירן פאַרשידן אַפּעריישאַנז וועגן פּדף טעקע פּראַסעסינג.

איצט, אין סדר צו לייגן אַנאַטיישאַנז צו אַ פּדף דאָקומענט ניצן CURL קאַמאַנדז, ערשטער, מיר דאַרפֿן צו דזשענערייט אַ אָטענטאַקיישאַן סימען דורך שיקן אַ בקשה צו די סימען ענדפּוינט מיט דיין אַפּ SID און אַפּ שליסל. ביטע ויספירן די פאלגענדע באַפֿעל צו דזשענערייט די accessToken.

curl -v "https://api.aspose.cloud/connect/token" \
 -X POST \
 -d "grant_type=client_credentials&client_id=ee170169-ca49-49a4-87b7-0e2ff815ea6e&client_secret=7f098199230fc5f2175d494d48f2077c" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Accept: application/json"

אַמאָל די אַקסעסטאָקען איז דזשענערייטאַד, ביטע ויספירן די פאלגענדע באַפֿעל וואָס מוסיף די FreeTextAnnotation צו די פּדף דאָקומענט. די אַנאַטייטיד פּדף טעקע איז דערהייַנטיקט אויף קלאָוד סטאָרידזש.

curl -v "https://api.aspose.cloud/v3.0/pdf/{inputPDF}/pages/1/annotations/freetext" \
-X POST \
-H  "accept: application/json" \
-H  "authorization: Bearer {accessToken}" \
-H  "Content-Type: application/json" \
-d "[  {        \"Color\": {      \"A\": 0,      \"R\": 0,      \"G\": 0,      \"B\": 0    },    \"Contents\": \"Confidential !\",    \"Modified\": \"01/05/2023 12:00:00.000 PM\",    \"Id\": \"id0\",    \"Flags\": [      \"Default\"    ],    \"Name\": \"comment\",    \"Rect\": {      \"LLX\": 100,      \"LLY\": 800,      \"URX\": 350,      \"URY\": 830    },    \"PageIndex\": 0,    \"ZIndex\": 1,    \"HorizontalAlignment\": \"Center\",    \"VerticalAlignment\": \"Center\",    \"CreationDate\": \"03/05/2023 16:00:00.000 PM\",    \"Subject\": \"Subj.\",    \"Title\": \"Main Heading\",    \"RichText\": \"Hello world...\",    \"Justification\": \"Left\",    \"Intent\": \"FreeTextTypeWriter\",    \"Rotate\": \"None\",    \"TextStyle\": {      \"FontSize\": 26,      \"Font\": \"Arial\",      \"ForegroundColor\": {        \"A\": 10,        \"R\": 10,        \"G\": 100,        \"B\": 120      },      \"BackgroundColor\": {        \"A\": 0,        \"R\": 0,        \"G\": 50,        \"B\": 80      }    }  }]"

פאַרבייַטן {inputPDF} מיט די נאָמען פון אַרייַנשרייַב פּדף טעקע שוין בנימצא אויף קלאָוד סטאָרידזש, {accessToken} מיט JWT אַקסעס טאָקען דזשענערייטאַד אויבן.

PDF אַנאָטאַטיאָן פאָרויסיקע ווייַזונג

בילד: - פאָרויסיקע ווייַזונג פון פריי טעקסט אַנאַטיישאַן אין PDF טעקע.

די פּדף דאָקומענט געניצט אין די אויבן בייַשפּיל קענען זיין דאַונלאָודיד פֿון [דעם לינק] (https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet/blob/master/testData/Binder1.pdf).

מסקנא

אין מסקנא, אַדינג אַנאַטיישאַנז צו פּדף קענען זייער פֿאַרבעסערן זייער נוציקייט און פאַנגקשאַנאַליטי. צי איר זוכט צו הויכפּונקט וויכטיק טעקסט, לייגן באַמערקונגען אָדער נעמען הערות גלייך אין דעם דאָקומענט, Aspose.PDF קלאָוד איז אַן אַמייזינג ברירה צו דערגרייכן דעם. מיר האָבן אויך געלערנט אַז Aspose.PDF קלאָוד סדק פֿאַר .נעט און CURL קאַמאַנדז פאָרשלאָגן שטאַרק סאַלושאַנז פֿאַר אַנאַטייטינג פּדפס, געבן איר די פיייקייט צו שאַפֿן קאַסטאַמייזד וואָרקפלאָווס און אָטאַמיישאַן פּראַסעסאַז. דעריבער, מיט די מכשירים, איר קענען געשווינד און לייכט לייגן אַנאַטיישאַנז צו פּדף, בשעת שפּאָרן צייט און פאַרגרעסערן פּראָודאַקטיוויטי.

נוציק לינקס

שייַכות אַרטיקלען

מיר רעקאָמענדירן צו גיין דורך די פאלגענדע בלאָגס: