In diesem Abschnitt werden die Optionen und Parameter beschrieben, mit denen Sie die "Formatierung und Gestaltung des Inhaltsverzeichnisses", unter Verwendung von Textvorlagen, anpassen können.
|
Zusätzliche Erklärungen zur Benutzung von Textvorlagen und weitere Einstellungen finden Sie im Abschnitt Textvorlagen. |
|
Benutzen Sie die Textvorlage N2PDFVALUE_TOC_PARAGRAPH_NAME werden in alle Ebenen des Inhaltsverzeichnisses die Einstellungen gesetzt und dabei auch evtl. bereits gesetzte individuelle Einstellungen überschrieben. |
N2PDFVALUE_TOC_LEVEL1_PARAGRAPH_NAME
N2PDFVALUE_TOC_LEVEL2_PARAGRAPH_NAME
N2PDFVALUE_TOC_LEVEL3_PARAGRAPH_NAME
...
...
N2PDFVALUE_TOC_LEVEL10_PARAGRAPH_NAME
Diese Parameter ermöglichen Ihnen, für die jeweilige Ebene des Inhaltsverzeichnis individuelle Einstellungen zu setzen. Es handelt sich dabei um fest definierte Namen für die Textvorlagen.
Beispiel - Schriftart "Verdana" mit Schritzgröße "10" für die erste Ebene setzen:
Call N2PDFSetOption ( JobID, N2PDFOPTION_PARAGRAPH_FONT_NAME,_
"Verdana", N2PDFVALUE_TOC_LEVEL1_PARAGRAPH_NAME )
Call N2PDFSetOption ( JobID, N2PDFOPTION_PARAGRAPH_FONT_SIZE,_
"10", N2PDFVALUE_TOC_LEVEL1_PARAGRAPH_NAME )
N2PDFVALUE_TOC_HEADER_PARAGRAPH_NAME
N2PDFVALUE_TOC_FOOTER_PARAGRAPH_NAME
Diese Parameter erlauben die Formatierung des Textes, der vor und hinter dem Inhaltsverzeichnis ausgegeben wird, zu definieren. Es handelt sich dabei um einen fest definierten Namen für eine Textvorlage.
Beispiel - Schriftart "Verdana" für den Kopf des Inhaltsverzeichnisses setzen:
Call N2PDFSetOption ( JobID, N2PDFOPTION_PARAGRAPH_FONT_NAME,_
"Verdana", N2PDFVALUE_TOC_HEADER_PARAGRAPH_NAME )
N2PDFOPTION_TOC_TAB_NUMBER
N2PDFOPTION_TOC_TAB_TEXT
N2PDFOPTION_TOC_TAB_PAGENUMBER
Über diese Parameter wird die Position der drei Spalten im Inhaltsverzeichnis bestimmt. Es handelt sich dabei um die Positionen für
- die Nummerierung, (N2PDFOPTION_TOC_TAB_NUMBER)
- den Text des Kapitels und (N2PDFOPTION_TOC_TAB_TEXT)
- die Seitennummer (N2PDFOPTION_TOC_TAB_PAGENUMBER)
Sie können über den Wert <OptionStr> eine Position übergeben oder Sie setzen den Wert auf N2PDFVALUE_TOC_AUTOMATIC_TAB zur automatischen Berechnung der Position (Standardeinstellung). Wenn Sie einen Wert angeben, muss dieser in der Maßeinheit sein, die über „Systemeinstellungen " festgelegt wurde.
Beispiel – Abstand auf 3 cm setzen:
Call N2PDFSetOption ( JobID, N2PDFOPTION_TOC_Tab_Text, "3" , "" )
Beispiel – Abstand auf 3 cm nur in Ebene 1 setzen:
Call N2PDFSetOption ( JobID, N2PDFOPTION_TOC_TAB_TEXT,_
"3" , N2PDFVALUE_TOC_LEVEL1_PARAGRAPH_NAME )
|
Bei der Funktion wird als letzter Parameter die Ebene angegeben (z. B. N2PDFVALUE_TOC_LEVEL1_PARAGRAPH_NAME). Ist der Wert "", dann gilt die Angabe für alle Ebenen. |
N2PDFOPTION_TOC_TABFILL_NUMBER
N2PDFOPTION_TOC_TABFILL_TEXT
Über diese beiden Parameter können Sie ein Füllzeichen zwischen der Nummerierung, dem Kapiteltext und der Seitennummer angeben. Als Standardwert sind dort Leerzeichen vorhanden. Sie können bei <OptionString> einen der folgenden Werte verwenden:
Punkte |
N2PDFVALUE_TOC_TABFILL_DOTS |
Vert. zentrierte Punkte |
N2PDFVALUE_TOC_TABFILL_MDOTS |
Trennzeichen |
N2PDFVALUE_TOC_TABFILL_HYPHEN |
Unterstreichen |
N2PDFVALUE_TOC_TABFILL_UNDERLINE |
Vert. zentrierte Trennzeichen |
N2PDFVALUE_TOC_TABFILL_THYPHEN |
Gleichheitszeichen |
N2PDFVALUE_TOC_TABFILL_EQUALSIG |
Pfeil |
N2PDFVALUE_TOC_TABFILL_ARROW |
Beispiel: Punkte zwischen Kapiteltext und Seitennummer
Call N2PDFSetOption ( JobID, N2PDFOPTION_TOC_TABFILL_TEXT,_
N2PDFVALUE_TOC_TABFILL_DOTS, "" )
Beispiel: Punkte zwischen Kapiteltext und Seitennummer nur für Ebene 1
Call N2PDFSetOption ( JobID, N2PDFOPTION_TOC_TABFILL_TEXT,_
N2PDFVALUE_TOC_TABFILL_DOTS, N2PDFVALUE_TOC_LEVEL1_PARAGRAPH_NAME )
|
Bei der Funktion wird als letzter Parameter die Ebene angegeben (z. B. N2PDFVALUE_TOC_LEVEL1_PARAGRAPH_NAME). Ist der Wert "", dann gilt die Angabe für alle Ebenen. |
N2PDFOPTION_TOC_TEXT_MAX_WIDTH
Über diesen Parameter stellen Sie die max. Breite des Kapiteltextes im Inhaltsverzeichnis ein. Die Angabe erfolgt in der Maßeinheit die über N2PDFOPTION_SYSTEM_METRICS_MODE eingestellt wurde. Ist diese Option aktiviert, dann können die Kapiteltexte mehrzeilig sein und die Einträge werden auch mehrzeilig in das Inhaltsverzeichnis übernommen.
Beispiel: Max. Breite von 5 cm
Call N2PDFSetOption ( JobID, N2PDFOPTION_TOC_TEXT_MAX_WIDTH, "5", "" )
N2PDFOPTION_TOC_MAX_NUMBERING_LEVEL
Über diesen Parameter kann die max. Darstellungstiefe für das Inhaltsverzeichnis eingestellt werden. Damit ist es z. B. möglich, dass nur die Hauptkapitel (z. B. 1., 2., usw. ) im Inhaltsverzeichnis erscheinen, selbst wenn im Haupttext weitere Unterebenen (wie z. B. 1.1, 1.2, usw.) vorhanden sind. Der Abstand zwischen der Kapitelnummer und dem Text wird automatisch angepasst, wenn eine maximale Tiefe für das Inhaltsverzeichnis gesetzt wurde.
Beispiel: Nur die Kapitel der ersten Ebene im Inhaltsverzeichnis ausgeben
Call N2PDFSetOption ( JobID, N2PDFOPTION_TOC_MAX_NUMBERING_LEVEL, "1", "" )