PDF-inhoud toevoegen in AIR

Als Adobe Reader of Adobe Acrobat 8.1 of hoger niet op de computer van de gebruiker is geïnstalleerd, wordt PDF-inhoud niet weergegeven in een AIR-toepassing. Om na te gaan of een gebruiker PDF-inhoud kan renderen, moet u eerst de eigenschap HTMLLoader.pdfCapability controleren. Deze eigenschap is ingesteld op een van de volgende constanten uit de klasse HTMLPDFCapability.

Als de gebruiker een Windows-computer heeft waarop Adobe Acrobat of Adobe Reader versie 7.x of hoger wordt uitgevoerd, wordt die versie gebruikt, zelfs als een recentere versie is geïnstalleerd die het laden van PDF-inhoud ondersteunt. Als in dit geval de waarde van de eigenschap pdfCapability is ingesteld op HTMLPDFCapability.STATUS_OK terwijl een AIR-toepassing PDF-inhoud probeert te laden, geeft de oudere versie van Acrobat of Reader een waarschuwing weer (er wordt geen uitzondering gegenereerd in de AIR-toepassing). Als deze situatie zich bij uw eindgebruikers kan voordoen, kunt u instructies opgeven om Acrobat te sluiten terwijl uw toepassing wordt uitgevoerd. U wordt aangeraden deze instructies weer te geven als de PDF-inhoud niet binnen een aanvaardbare tijd wordt geladen.

Bij Linux zoekt AIR naar Adobe Reader op het pad (PATH) dat door de gebruiker is geëxporteerd (als het de opdracht acroread bevat) en in de map /opt/Adobe/Reader.

Aan de hand van de volgende code kan worden vastgesteld of een gebruiker PDF-inhoud in een AIR-toepassing kan weergeven. Als de gebruiker PDF-inhoud niet kan weergeven, wordt er door de code een foutcode getraceerd die overeenkomt met het HTMLPDFCapability-foutobject:

if(HTMLLoader.pdfCapability == HTMLPDFCapability.STATUS_OK)  
{ 
    trace("PDF content can be displayed"); 
} 
else  
{ 
    trace("PDF cannot be displayed. Error code:", HTMLLoader.pdfCapability); 
} 

U kunt een PDF toevoegen aan een AIR-toepassing door een HTMLLoader-instantie te maken, de afmetingen ervan in te stellen en het pad van een PDF te laden.

In het volgende voorbeeld ziet u hoe u een PDF vanaf een externe site laadt. Vervang de URLRequest door het pad naar een beschikbare externe PDF.

var request:URLRequest = new URLRequest("http://www.example.com/test.pdf"); 
pdf = new HTMLLoader(); 
pdf.height = 800; 
pdf.width = 600; 
pdf.load(request); 
container.addChild(pdf);

U kunt ook inhoud laden vanaf bestands-URL's en AIR-specifieke URL-schema's, zoals app en app-storage. Voorbeeld: de volgende code laadt het bestand test.pdf naar de PDF-submap van de toepassingsmap:

app:/js_api_reference.pdf

Zie URI-schema's voor meer informatie over URL-schema's van AIR.

U kunt JavaScript gebruiken om PDF-inhoud te besturen, net zoals in een webpagina in de browser.

JavaScript-extensies voor Acrobat bieden onder andere de volgende mogelijkheden:

• Paginanavigatie en vergroting regelen

• Formulieren in het document verwerken

• Multimediagebeurtenissen besturen

Meer informatie over JavaScript-extensies voor Adobe Acrobat vindt u in Adobe Acrobat Developer Connection op http://www.adobe.com/devnet/acrobat/javascript.html.

PDF-inhoud in Adobe AIR is onderworpen aan de volgende beperkingen:

• PDF-inhoud wordt niet weergegeven in een venster (een NativeWindow-object) dat transparant is (waarbij de eigenschap transparent is ingesteld op true).

• De weergavevolgorde van een PDF-bestand is anders dan bij andere weegaveobjecten in een AIR-toepassing. Hoewel PDF-inhoud correct wordt weergegeven volgens de HTML-weergavevolgorde, bevindt deze zich altijd boven inhoud in de weergavevolgorde van de AIR-toepassing.

• Als bepaalde visuele eigenschappen van een HTMLLoader-object dat een PDF-document bevat worden gewijzigd, wordt het PDF-document onzichtbaar. Het betreft hierbij onder andere de eigenschappen filters, alpha, rotation en scaling. Als deze eigenschappen worden gewijzigd, wordt de PDF-inhoud onzichtbaar totdat de eigenschappen opnieuw worden ingesteld. De PDF-inhoud is eveneens onzichtbaar als u deze eigenschappen wijzigt bij weergaveobjectcontainers die het HTMLLoader-object bevatten.

• PDF-inhoud is alleen zichtbaar wanneer de eigenschap scaleMode van het Stage-object van het NativeWindow-object dat de PDF-inhoud bevat, is ingesteld op StageScaleMode.NO_SCALE. Wanneer deze eigenschap is ingesteld op een andere waarde, is de PDF-inhoud niet zichtbaar.

• Wanneer de gebruiker op koppelingen naar inhoud in het PDF-bestand klikt, wordt de schuifpositie van de PDF-inhoud bijgewerkt. Wanneer de gebruiker op koppelingen naar inhoud buiten het PDF-bestand klikt, wordt het HTMLLoader-object omgeleid waarin de PDF-inhoud zich bevindt (zelfs als het doel van een koppeling een nieuw venster is).

• Workflows voor PDF-commentaar werken niet in AIR.