Bezeichnung
pdf.GetBrush -- gibt die PDF-Seite als Vektorpinsel zurück
Übersicht
[id, t] = pdf.GetBrush(id, page, brid[, transparent, getlinks])
Beschreibung
Mit diesem Befehl kann eine Seite aus dem durch id angegebenen PDF-Dokument in einen Vektorpinsel umgewandelt werden, der dann die ID brid erhält. Wenn Sie Nil in brid übergeben, wählt pdf.GetBrush() automatisch eine frei ID aus und gibt sie zurück.

Die zu konvertierende Seite muss im Argument page angegeben werden und eine Zahl im Bereich von 1 bis zur Gesamtzahl der Seiten im Dokument sein. Das von id angegebene PDF-Dokument muss mit pdf.OpenDocument() geöffnet worden sein.

Mit dem optionalen Argument transparent können Sie festlegen, ob der Seitenhintergrund transparent oder weiß sein soll. Wenn Sie hier True übergeben, erhalten Sie einen Vektorpinsel, bei dem der Seitenhintergrund durch Verwendung der Alphakanal-Transparenz vollständig transparent ist. Andernfalls wird der Seitenhintergrund weiß und Ihr Vektorpinsel wird keine Transparenz verwenden.

Beachten Sie, dass der Vektorpinsel immer noch vom PDF-Dokument abhängt, so dass es nicht erlaubt ist, pdf.CloseDocument() auf dem Dokument aufzurufen, während Sie den Pinsel noch benötigen.

Beachten Sie auch, dass Sie diesen Befehl nur für Seiten verwenden sollten, die noch nicht mit pdf.LoadPage() geladen wurden. Wenn Sie eine Seite, die mit pdf.LoadPage() geladen wurde, in einen Pinsel konvertieren möchten, verwenden Sie den Befehl pdf.GetBrushFromPage(). Siehe pdf.GetBrushFromPage für Details.

Ab Polybios 1.1 gibt es ein optionales Argument namens getlinks. Wenn dies auf True gesetzt ist, gibt pdf.GetBrush() eine Tabelle mit allen Links auf der Seite zurück. Die Tabelle wird als zweiter Rückgabewert zurückgegeben, wenn getlinks auf True gesetzt ist. Für jeden Eintrag wird die Tabelle die folgenden Felder initialisiert haben:

Action:
Dieses Feld gibt an, was passieren soll, wenn auf den jeweiligen Link geklickt wird. Dieses wird auf eine der folgenden speziellen Konstanten gesetzt:

#PDFACTION_GOTO:
Zur Seite im aktuellen Dokument springen.

#PDFACTION_REMOTEGOTO:
Springt zur Seite in einem anderen Dokument.

#PDFACTION_URI:
Öffnet eine URI.

#PDFACTION_LAUNCH:
Startet ein Programm.

#PDFACTION_UNSUPPORTED:
Unbekannte Aktion.

Target:
Dieses wird auf das Ziel des Links gesetzt. Abhängig von Action kann dies eingestellt werden auf eine Seitennummer, eine URI oder den Pfad zu einer externen Datei.

Left:
Linker Rand des Begrenzungsrechtecks des Links.

Top:
Oberer Rand des Begrenzungsrechtecks des Links.

Right:
Rechter Rand des Begrenzungsrechtecks des Links.

Bottom:
Unterer Rand des Begrenzungsrechtecks des Links.

Eingaben
id
Identifikator des zu verwendenden PDF-Dokuments
page
zu konvertierende Seitenzahl (ab 1)
brid
ID für den Vektorpinsel oder Nil für die automatische ID-Zuweisung
transparent
optional: True für einen transparenten, False für einen weißen Seitenhintergrund
gelinks
optional: True, wenn Seitenlinks zurückgegeben werden sollen (siehe oben) (Standard ist False) (V1.1).
Rückgabewerte
id
optional: Identifikator des Pinsels; wird nur zurückgegeben, wenn Sie Nil im dritten Argument brid übergeben (siehe oben).
t
optional: Tabelle mit allen Seitenlinks (siehe oben) (V1.1)

Navigation zeigen