JavaScriptActions Özellik

Bu API girdisi tanımlayıcıları, imzaları, kod bloklarını ve PDF terimlerini özgün biçiminde korur.

Belge düzeyi tüm JavaScript eylemlerini tek bir dinamik dizi olarak döndürür

JavaScriptActions, her belge düzeyi JavaScript eylemini TPdfJavaScriptAction kayıtlarından oluşan tek bir dinamik diziye dönüştürür. Her kayıt eylemin adını taşır (genellikle catalog’un /Names /JavaScript name tree’sindeki giriş anahtarı, ör. OpenAction, App.calc) ve script kaynağını WString olarak çözümler. Dizi uzunluğu JavaScriptActionCount değerine eşittir

Sonuç, Active False ise ya da PDF hiç belge düzeyi script içermiyorsa boştur. Her girdiye ihtiyaç duyduğunuzda JavaScriptActions, JavaScriptAction[Index] üzerinde dönmekten daha rahattır — tek ayırma, tek ayrıştırma, gruplanmaya ya da süzülmeye hazır. Çok büyük script kümelerinde, tercih etmek yerine indeksli erişiciyi kullanın; böylece her script gövdesi baştan üretilmez

PDFiumPas scriptleri yalnızca inceleme verisi olarak sunar — onları çalıştırmaz, sandbox etmez ya da dönüştürmez. Diziyi “JavaScript içerir” uyarısı göstermek, dağıtımdan önce scriptleri temizlemek için (düşük seviyeli bir FPDFDoc_* mutation pass ile birlikte) ya da harici bir analizöre beslemek için kullanın. Alan düzeyi ve annotation düzeyi scriptler başka yerde yer alır ve bu dizinin parçası değildir

• Script adlarının benzersiz ya da boş olmaması garanti edilmez — PDF adı olmayan action dictionary’lere izin verir (ör. satır içi OpenAction)
• Dizi, geçerli belge durumunun bir anlık görüntüsüdür; bu çağrıdan sonra PDF üzerinde yapılan değişiklikler dönen diziye geri yansımaz
• Hızlı bir “no JS” denetimi için Length(Result) = 0 kullanın sayımı ayrı hesaplamadan

JavaScriptAction, JavaScriptActionCount, Permissions