exportToPNG

Beschreibung

Exportiert ein Gantt-Diagramm im PNG-Format

exportToPNG: (export?: any) => void

Parameter

• export - Objekt - optional, ein Objekt mit Export-Einstellungen (siehe Details)

Beispiel

gantt.exportToPNG();

//oder
gantt.exportToPNG({
  name: "mygantt.png"
});

//oder
gantt.exportToPNG({
    name: "mygantt.png",
    header: "<h1>My company</h1>",
    footer: "<h4>Bottom line</h4>",
    locale: "en",
    start: "01-04-2026",
    end: "11-04-2026",
    skin: "terrace",
    data: { },
    server: "https://myapp.com/myexport/gantt",
    raw: true,
    callback: (res) => {
        alert(res.url);
    }
});

Details

Hinweis

Diese Methode ist in der Export-Erweiterung definiert, daher müssen Sie das export_api Plugin aktivieren. Lesen Sie die Details im Artikel.

Hinweis

Wenn Sie die Gantt-Version älter als 8.0 verwenden, müssen Sie die Datei https://export.dhtmlx.com/gantt/api.js auf Ihrer Seite einbinden, um den Online-Export-Service zu aktivieren, z.B.:

<script src="codebase/dhtmlxgantt.js"></script>
<script src="https://export.dhtmlx.com/gantt/api.js"></script>

Die exportToPNG Methode nimmt als Parameter ein Objekt mit einer Reihe von Eigenschaften (alle Eigenschaften sind optional):

name	(string) der Name der Ausgabedatei
skin	('terrace', 'skyblue', 'meadow', 'broadway') das Skin des Ausgabe-Gantt-Diagramms
locale	(string) legt die Sprache fest, die im Ausgabe-Gantt-Diagramm verwendet wird
start	(string) legt das Startdatum des Datenbereichs fest, der im Ausgabe-Gantt-Diagramm dargestellt wird. Das Datumsformat wird durch die config festgelegt
end	(string) legt das Enddatum des Datenbereichs fest, der im Ausgabe-Gantt-Diagramm dargestellt wird. Das Datumsformat wird durch die config festgelegt
data	(object) legt eine benutzerdefinierte Datenquelle fest, die im Ausgabe-Gantt-Diagramm präsentiert wird
header	(string) legt den Header fest, der dem Ausgabe-PDF-Bild hinzugefügt wird. Hinweis: Hier können Sie beliebiges HTML verwenden
footer	(string) legt den Footer fest, der dem Ausgabe-PDF-Bild hinzugefügt wird. Hinweis: Hier können Sie beliebiges HTML verwenden
server	(string) legt den API-Endpunkt für die Anfrage fest. Kann mit der lokalen Installation des Export-Services verwendet werden. Der Standardwert ist https://export.dhtmlx.com/gantt
raw	(boolean) definiert, dass sämtliches Gantt-Markup unverändert exportiert wird, einschließlich aller benutzerdefinierten Elemente. false standardmäßig. Lesen Sie die Details
callback	(function) Wenn Sie eine URL zum Herunterladen einer generierten PNG-Datei erhalten möchten, kann die Callback-Eigenschaft verwendet werden. Sie erhält ein JSON-Objekt mit der Eigenschaft url
additional_settings	(object) Ein Objekt mit zusätzlichen Einstellungen. Das Objekt kann folgende Attribute enthalten: width - (number|string) die Breite der Ausgabeseite height - (number|string) die Höhe der Ausgabeseite Die width und height Parameter werden ignoriert, wenn slice_archive angegeben ist. slice_archive - (boolean|object) ermöglicht das Speichern großer Diagramme in Teilen und deren Bezug im Archiv. Als Objekt nimmt das Attribut die Optionen width und height entgegen. Falls die Stückgröße nicht definiert ist (d.h. slice_archive: true), gelten die Standardgrößen 1000×1000. slice_check - (boolean) fügt dem Archiv eine HTML-Seite hinzu. Die Seite ermöglicht es zu prüfen, dass alle Teile korrekt exportiert wurden.

Exportieren großer Gantt-Diagramme in Teilen

Die maximalen Größen der exportierten Datei betragen 10000×10000.

Sie können eine der Größen erhöhen und die andere entsprechend verringern, indem Sie die Attribute width/height der Eigenschaft additional_settings verwenden. Falls das Produkt aus width und height größer als 100000000 (10000×10000) ist, wird das exportierte PNG-Bild zugeschnitten.

Es besteht die Möglichkeit, das Gantt-Diagramm in Teilen zu exportieren und diese im Archiv abzurufen, indem Sie das Attribut slice_archive der Eigenschaft additional_settings verwenden:

gantt.exportToPNG({
    server: "https://export.dhtmlx.com/beta/gantt",
    additional_settings: {
        //width: 2000,
        //height: 2000,
        slice_archive: { width: 2000, height: 2000 },
        slice_check: true,
    }
});

Verwandtes Beispiel: Export in PNG-Bilder

Sie können die Größen der output PNG-Bilder entweder definieren, indem Sie das Attribut als Objekt mit den Optionen width und height festlegen:

slice_archive: { width: 2000, height: 2000 }

Oder Sie setzen das Attribut auf true. In diesem Fall erhalten die exportierten Stücke des Gantt Standardgrößen: 1000×1000.

slice_archive: true

Zeitbeschränkungen

Hinweis

Der Export-Service unterliegt Zeitbeschränkungen.

Wenn der Prozess länger als 20 Sekunden dauert, wird der Export abgebrochen und der folgende Fehler tritt auf:

Error: Timeout trigger 20 seconds

Wenn mehrere Benutzer Gantt gleichzeitig exportieren, kann der Vorgang länger dauern als üblich. Das ist jedoch unproblematisch, da die Zeit, die für eine Export-Anfrage eines bestimmten Benutzers aufgewendet wird, separat gezählt wird.

Hinweis

Wenn Sie große Diagramme exportieren müssen, können Sie ein eigenständiges Export-Modul verwenden (Standalone Export-Modul). Das Export-Modul wird kostenfrei bereitgestellt, wenn Sie Gantt unter einer der Lizenzen Commercial, Enterprise oder Ultimate erhalten haben, oder Sie können das Modul separat erwerben (buy the module separately).

Verwandte API

• exportToMSProject
• exportToPrimaveraP6
• exportToExcel
• exportToICal
• exportToPDF
• exportToJSON
• importFromExcel
• importFromPrimaveraP6
• importFromMSProject

Verwandte Guides

• Export nach PDF und PNG