JavaScript Mezőkiterjesztések

JavaScript mezőbővítmények

A Aspose.Pdf.Annotations.JavascriptExtensions névtér tartalmazza a kezelett megfelelőket az Acrobat JavaScript AF_ formázási függvényekhez. Ezek az osztályok lehetővé teszik, hogy a PDF mező‑megjelenítési logikát a .NET alkalmazásában reprodukálja JavaScript végrehajtása nélkül.

FieldDateTimeFormatter egy statikus osztály — hívja meg közvetlenül a típust Format.
FieldNumberCurrencyFormatter és FieldNumberPercentFormatter szabályos
osztályok — hozzon létre egy példányt, majd hívja meg Format. Minden metódus ugyanazokat a paramétereket fogadja,
mint a megfelelő Acrobat JavaScript függvény, és formázott karakterláncot ad vissza.

FieldDateTimeFormatter

FieldDateTimeFormatter formáz egy nyers dátum/idő karakterláncot egy Acrobat‑stílusú dátumformátum‑mintával. Ennek megfelelője a AF_Date_Format JavaScript függvény.

Metódus aláírás

public static string Format(string dateFormat, string dateValue)

Paraméter	Típus	Leírás
`dateFormat`	`string`	Acrobat-stílusú dátumformátum-minta (például `"mm/dd/yyyy"`)
`dateValue`	`string`	Formázandó nyers dátumkarakterlánc

Példa

using Aspose.Pdf.Annotations.JavascriptExtensions;
string result = FieldDateTimeFormatter.Format("mm/dd/yyyy", "2026-06-11");
Console.WriteLine(result); // 06/11/2026

Ha a bemeneti értéket nem lehet értelmezni, a formázó változatlanul visszaadja az eredeti értéket.

MezőSzámPénznemFormázó

FieldNumberCurrencyFormatter formáz egy numerikus karakterláncot pénznemértékként. Ennek megfelelője a AF_Number_Format JavaScript függvény.

Metódus aláírás

public string Format(
    int precision,
    int sepStyle,
    int negStyle,
    string currencySymbol,
    bool isPrependCurrency,
    string fieldValue)

Parameter	Type	Description
`precision`	`int`	Tizedesjegyek száma
`sepStyle`	`int`	Ezres elválasztó stílusa (0 = vessző, 1 = nincs, 2 = pont)
`negStyle`	`int`	Negatív szám stílusa (0 = mínusz, 1 = zárójel, 2 = piros)
`currencySymbol`	`string`	Előre vagy hátra illesztett szimbólum (pl. `"$"`)
`isPrependCurrency`	`bool`	Ha `true`, a szimbólum előre kerül; egyébként hátra
`fieldValue`	`string`	Formázandó numerikus karakterlánc

Példa

using Aspose.Pdf.Annotations.JavascriptExtensions;
var formatter = new FieldNumberCurrencyFormatter();
string result = formatter.Format(
    precision: 2,
    sepStyle: 0,
    negStyle: 0,
    currencySymbol: "$",
    isPrependCurrency: true,
    fieldValue: "1234.5");
Console.WriteLine(result); // $1,234.50

FieldNumberPercentFormatter

FieldNumberPercentFormatter egy numerikus karakterláncot formáz százalékos értékként, a formátum alkalmazása előtt a értéket 100-zal szorozza. Ennek megfelelője a AF_Percent_Format JavaScript függvény.

Metódus aláírás

public string Format(
    int precision,
    int sepStyle,
    bool isPrependPercent,
    string fieldValue)

Parameter	Type	Description
`precision`	`int`	Tizedesjegyek száma
`sepStyle`	`int`	Ezres elválasztó stílusa
`isPrependPercent`	`bool`	Ha `true`, akkor a `%` szimbólum elé kerül; egyébként a végére
`fieldValue`	`string`	Formázandó numerikus karakterlánc (szorozva 100-zal)

Példa

using Aspose.Pdf.Annotations.JavascriptExtensions;
var formatter = new FieldNumberPercentFormatter();
string result = formatter.Format(
    precision: 1,
    sepStyle: 0,
    isPrependPercent: false,
    fieldValue: "0.1234");
Console.WriteLine(result); // 12.3%

Formátumkezelők használata egy űrlapfeldolgozó ciklusban

A következő minta pénznemformázást alkalmaz az összes szövegmező értékére egy PDF űrlapon:

using Aspose.Pdf;
using Aspose.Pdf.Annotations.JavascriptExtensions;
byte[] data = File.ReadAllBytes("form.pdf");
using var doc = Document.Open(data);
if (doc.Form is not null)
{
    var currencyFormatter = new FieldNumberCurrencyFormatter();
    foreach (var field in doc.Form.Fields)
    {
        if (field.Value is not null)
        {
            string formatted = currencyFormatter.Format(
                precision: 2,
                sepStyle: 0,
                negStyle: 0,
                currencySymbol: "$",
                isPrependCurrency: true,
                fieldValue: field.Value);
            Console.WriteLine($"{field.Name}: {formatted}");
        }
    }
}

Lásd még

Aspose.PDF — Vállalati dokumentáció