cib jrec technischer leitfaden
Werbung
> Technical Support & Services CIB JREC TECHNISCHER LEITFADEN Reine Java-Komponente eines Rich-Text Edit-Controls zur Bearbeitung von RTF-Dokumenten > Stand: 04. Dezember 2014 Version 1.6, Revision 24 CIB Software GmbH > Technical Support & Services > CIB jrec > Inhalt INHALT 1 ALLGEMEIN __________________________________________________________________________________ 3 1.1 Hinweis ______________________________________________________________________________________ 3 1.2 Autoren ______________________________________________________________________________________ 4 1.3 Support ______________________________________________________________________________________ 4 1.4 Versionshistorie _____________________________________________________________________________ 4 1.5 Literaturverweis_____________________________________________________________________________ 5 1.6 Lieferumfang ________________________________________________________________________________ 5 1.7 Lizenzierung _________________________________________________________________________________ 5 1.8 Abkürzungen_________________________________________________________________________________ 5 2 EINFÜHRUNG ________________________________________________________________________________ 7 3 TECHNISCHE SCHNITTSTELLEN _____________________________________________________________ 9 3.1 Konfiguration durch Properties_____________________________________________________________ 9 3.1.1 Allgemeine Properties 9 3.1.2 Properties zur Konfiguration der Toolbar 9 3.1.3 Properties zur Konfiguration des jrec Edit-Controls 3.2 Steuerung durch Aufrufparameter_________________________________________________________15 3.3 Konfigurationsdatei (INI-Datei) ___________________________________________________________15 4 SCHNELLER EINSTIEG ______________________________________________________________________17 4.1 Einbindung des CIB jrec in Java____________________________________________________________17 4.1.1 Einbindung in eine Java Swing-Applikation 17 4.1.2 Einbindung in eine Java SWT-Applikation 19 5 ABBILDUNGSVERZEICHNIS ________________________________________________________________22 6 STICHWORTVERZEICHNIS _________________________________________________________________23 12 2 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > Allgemein 1 ALLGEMEIN 1.1 HINWEIS © Copyright 2004-2015 CIB software GmbH. Alle Rechte vorbehalten. Die CIB software GmbH behält sich sämtliche Eigentumsrechte an der angebotenen Software und der dazugehörigen Dokumentation vor. Die Benutzung der Software und des dazugehörigen Benutzerhandbuches unterliegen dem der Software zugrundeliegenden Lizenzvertrag. Die Bereitstellung und der Download dieses Dokuments und der Software allein bewirken keine Übertragung von Nutzungs- und Vervielfältigungsrechten. Kein Teil dieses Handbuchs darf ohne schriftliche Genehmigung der CIB software GmbH in irgendeiner Form reproduziert oder weiterverwertet werden. Auch eine Bearbeitung, insbesondere eine Übersetzung der Dokumentation, ist ohne Genehmigung der CIB software GmbH nicht gestattet. Der Inhalt dieses Handbuches ist auch urheberrechtlich geschützt, wenn es nicht mit der Software geliefert wird, die eine Endbenutzerlizenzvereinbarung enthält. CIB coSys, CIB webdesk, CIB workbench, CIB dialog, CIB merge, CIB view, CIB format, CIB print, CIB pdf toolbox sind entweder eingetragene Marken oder Marken der CIB software GmbH. Windows ist eine eingetragene Marke der Microsoft Corporation. Solaris und Java sind Marken bzw. eingetragene Marken von Oracle und ihrer Tochtergesellschaften. Alle anderen Marken- und Produktnamen sind Marken oder eingetragene Marken der jeweiligen Rechteinhaber. Der Inhalt dieses Handbuchs wurde mit größter Sorgfalt erarbeitet. Die Angaben in diesem Handbuch gelten jedoch nicht als Zusicherung von Eigenschaften des Produktes. Die CIB software GmbH haftet nur im Umfang ihrer Verkaufs- und Lieferbedingungen und übernimmt keine Gewähr für technische Ungenauigkeiten und oder Auslassungen. Die CIB software GmbH haftet weder für technische oder typographische Fehler und Mängel in diesem Handbuch, noch für Schäden, die direkt oder indirekt auf die Lieferung, Leistung und Nutzung dieses Materials zurückzuführen sind. Die Informationen in diesem Handbuch können ohne Ankündigung geändert werden. Sollten während des Einsatzes Unstimmigkeiten in Zusammenhang mit den Ausführungen in dieser Übersicht auftreten, sind wir Ihnen für entsprechende Hinweise sehr dankbar: CIB software GmbH Elektrastraße 6a 81925 München E-Mail: [email protected] Tel.: 49 (0)89 / 1 43 60 - 111 Fax.: 49 (0)89 / 1 43 60 - 100 3 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > Allgemein 1.2 AUTOREN CIB software GmbH - Hubertus Baur (HB) 1.3 SUPPORT E-Mail: [email protected] Tel.: 49 (0)89 / 1 43 60 - 111 Fax.: 49 (0)89 / 1 43 60 – 100 1.4 VERSIONSHISTORIE Revision Beschreibung Datum 1/0 Erstausgabe 07.04.2009 1/1 Kap. 1: Lieferumfang erweitert 09.07.2009 Kap. 2: Einführung mit Bildern hinzugefügt Kap. 3: Beschreibung der Properties erweitert, Beschreibung der Aufrufparameter und der INI-Datei Kap. 4: Weitere Code-Beispiele zur Einbindung in Java 1/2 Property PROPERTY_REC_IGNORE_FIELDS = "JREC.ignoreFields" hinzugefügt 19.10.2010 1/3 Beispiele für INI-Datei erweitert, Copyright auf 2011 geändert 04.04.2011 1/4 Hinweis zum Deaktivieren der Jrec-Menüleiste 12.07.2011 1/5 Copyright 2004-2012, CIB Software GmbH -> CIB software GmbH, neue Adresse: Elektrastraße 6a, 81925 München 09.01.2012 1/6 Aktualisierung Copyright-Hinweis 2014 22.01.2014 4 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > Allgemein 1.5 LITERATURVERWEIS Dokumentationsart Titel Technischer Leitfaden CIB jrec Technischer Leitfaden (dieses Dokument) Technischer Leitfaden CIB jview Technischer Leitfaden Technischer Leitfaden CIB jviewArchive Technischer Leitfaden Schulung 1.6 LIEFERUMFANG Komponente Softwareumfang CIB jrec Die Applikation wird als zip-Datei angeliefert: CibJrec-<version>.zip Nach dem Auspacken ergibt sich folgende Verzeichnisstruktur mit den angegebenen Dateien: Verzeichnis Datei Inhalt CibJrec readme.txt ReadMe Datei run.bat Batch-Datei für den Start über die Konsole cibjrec.ini CIB jrec INI-Datei All javadoc Dateien, insbesondere index.html Java-Dokumentation zu CIB jrec: Einstieg über index.html CibJrec\docs\api und Unterverzeichnisse CibJrec\docs\manual CibJrec\lib CIB jrec Manual-Dokumente CibGUI-<version>.jar CIB GUI Java Archivdatei CibJrec-<version>.jar CIB jrec Java Archivdatei 1.7 LIZENZIERUNG Dieses Dokument gibt keine Hinweise zur Lizenzierung. Detaillierte Informationen zu Lizenzierung und den Lizenzmodellen erhalten Sie von den Mitarbeitern des CIB Vertriebs. 1.8 ABKÜRZUNGEN In diesem Dokument werden folgende Abkürzungen benutzt: - CIB GUI CIB – Graphical User Interface. Java-Archiv mit Basisfunktionen für die Bedienung der CIB Java-Applikationen 5 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > Allgemein - CIB jrec - CoMod Control DLL PDF RTF - Word HTML XML CIB – Java Rich Edit Control. Ein schlanker Texteditor mit Funktionen zur Formatierung von RTF-Texten. CIB office Module in diesem Fall ein "mehrzeiliges Eingabefeld" Dynamic Link Library Portable Document Format Rich Text Format. Leistungsfähiges, standardisiertes Dateiformat zur Beschreibung von Dokumenten. Spezifiziert und offengelegt von Microsoft. Microsoft Word 97, 2000, Office XP, Office 2003, Office 2007 Hypertext Markup Language eXtended Markup Language, Standardformat zur Datenübergabe 6 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > Einführung 2 EINFÜHRUNG CIB jrec ist eine Java basierte Rich-Text Editor-Komponente, die sich nach dem von anderen CIB Modulen bekannten Schnittstellenkonzept einfach in Masken und fremde Anwendungen integrieren lässt. Wie die anderen CIB Module kann dieses RTF-Edit-Control komfortabel durch Setzen verschiedener Properties gesteuert werden. Damit erfüllt sich ein häufiger Kundenwunsch nach einem schlanken Text(passagen)-Editor mit reduziertem Funktionsumfang, der einfach in andere Java-Anwendungen eingebunden werden kann. Der CIB jrec Editor kann entweder leer, mit ASCII oder RTF-Texten gestartet werden. Umgekehrt können die Texte wieder im ASCII- oder RTF-Format aus dem Edit-Control gelesen werden. CIB jrec besitzt folgende Möglichkeiten zur Textformatierung: · Verschiedene Schriftarten und Schriftgrößen · Zeichenattribute fett, kursiv, unterstrichen, farbig · Absatzausrichtung linksbündig, zentriert, rechtsbündig · Kopieren, Ausschneiden und Einfügen markierter Textabschnitte · Ein-/Ausblenden von Formatierungszeichen In einem RTF-Dokument vorhandene Tabulatorpositionen (dokumentübergreifend oder pro Absatz) werden ausgewertet und entsprechend angezeigt. Die vorliegende technische Dokumentation gibt einen Überblick über die Konfigurations- und Einsatzmöglichkeiten nebst Codebeispielen für einen "schnellen Einstieg" in die Thematik. Im Folgenden werden zwei Beispieldokumente dargestellt: Das erste Dokument wurde mit CIB jrec erstellt und zeigt beispielhaft einige Funktionen des Rich-Text Edit-Controls. Das zweite Dokument enthält verschiedene Tabulatoren und wurde mit MS Word erstellt, da in CIB jrec Dokumente mit expliziten Tabulatorpositionen zwar angezeigt, aber nicht erzeugt werden können. 7 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > Einführung Abbildung 1: Die Funktionen von CIB jrec Abbildung 2: Tabulatoren in CIB jrec 8 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > TECHNISCHE SCHNITTSTELLEN 3 TECHNISCHE SCHNITTSTELLEN 3.1 KONFIGURATION DURCH PROPERTIES 3.1.1 Allgemeine Properties Mit den folgenden Properties können generelle Einstellung für die Applikation gesetzt werden. Property-Bezeichnung Typ PROPERTY_TITLE String Setzt den Titel, der in der Titelzeile der Applikation angezeigt wird. Default: „JCibRec“ Property-Bezeichnung Typ PROPERTY_ICON_PATH String Setzt das Icon, das in der Titelzeile der Applikation angezeigt wird. Der Name der Icon-Datei mit vollständiger Pfadangabe wird übergeben. Default: „/de/cib/jrec/resource/CIBRichEdit.png“ Property-Bezeichnung Typ PROPERTY_JREC_INIFILENAME String Setzt den Namen der CIB jrec INI-Datei. Default: cibjrec.ini Hinweis: Mit dieser Property wird der Name der CIB jrec INI-Datei gesetzt. Falls als Wert „null“ gesetzt wird, wird keine INI-Datei verwendet. Property-Bezeichnung Typ PROPERTY_INPUTFILE String Setzt den Namen des Dokuments, das beim Start der Applikation geöffnet wird. Default: CIB jrec wird mit einem leeren Dokument geöffnet. 3.1.2 Properties zur Konfiguration der Toolbar Mit den folgenden Properties können die einzelnen Elemente der Toolbar aus- oder eingeschaltet werden. Setzen der Property auf TRUE bewirkt, dass das Element sichtbar und aktiv ist, FALSE bedeutet, das Element ist unsichtbar und deaktiviert. 9 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > TECHNISCHE SCHNITTSTELLEN Property-Bezeichnung Typ PROPERTY_BOLD_ENABLED Boolean Button für Schrifteinstellung „Fett“ aktivieren oder deaktivieren. TRUE (default): Button ist sichtbar und aktiv. FALSE: Button ist unsichtbar und deaktiviert. Property-Bezeichnung Typ PROPERTY_ITALIC_ENABLED Boolean Button für Schrifteinstellung „Kursiv“ aktivieren oder deaktivieren. TRUE (default): Button ist sichtbar und aktiv. FALSE: Button ist unsichtbar und deaktiviert. Property-Bezeichnung Typ PROPERTY_FONT_UNDERLINE_ENABLED Boolean Button für Schrifteinstellung „Unterstreichen“ aktivieren oder deaktivieren. TRUE (default): Button ist sichtbar und aktiv. FALSE: Button ist unsichtbar und deaktiviert. Property-Bezeichnung Typ PROPERTY_ALIGN_LEFT_ENABLED Boolean Button für Schrifteinstellung „Linksbündig“ aktivieren oder deaktivieren. TRUE (default): Button ist sichtbar und aktiv. FALSE: Button ist unsichtbar und deaktiviert. Property-Bezeichnung Typ PROPERTY_ALIGN_CENTER_ENABLED Boolean Button für Schrifteinstellung „Zentriert“ aktivieren oder deaktivieren. TRUE (default): Button ist sichtbar und aktiv. FALSE: Button ist unsichtbar und deaktiviert. Property-Bezeichnung Typ PROPERTY_ALIGN_RIGHT_ENABLED Boolean Button für Schrifteinstellung „Rechtsbündig“ aktivieren oder deaktivieren. 10 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > TECHNISCHE SCHNITTSTELLEN TRUE (default): Button ist sichtbar und aktiv. FALSE: Button ist unsichtbar und deaktiviert. Property-Bezeichnung Typ PROPERTY_ALIGN_BLOCK_ENABLED Boolean Button für Schrifteinstellung „Blocksatz“ aktivieren oder deaktivieren (nicht verfügbar). TRUE (default): Button ist sichtbar und aktiv. FALSE: Button ist unsichtbar und deaktiviert. Property-Bezeichnung Typ PROPERTY_COPY_ENABLED Boolean Button für Funktion „Kopieren“ aktivieren oder deaktivieren. TRUE (default): Button ist sichtbar und aktiv. FALSE: Button ist unsichtbar und deaktiviert. Property-Bezeichnung Typ PROPERTY_PASTE_ENABLED Boolean Button für Funktion „Einfügen“ aktivieren oder deaktivieren. TRUE (default): Button ist sichtbar und aktiv. FALSE: Button ist unsichtbar und deaktiviert. Property-Bezeichnung Typ PROPERTY_CUT_ENABLED Boolean Button für Funktion „Ausschneiden“ aktivieren oder deaktivieren. TRUE (default): Button ist sichtbar und aktiv. FALSE: Button ist unsichtbar und deaktiviert. Property-Bezeichnung Typ PROPERTY_FOREGROUND_COLOR_ENABLED Boolean Button für Schrifteinstellung „Schriftfarbe“ aktivieren oder deaktivieren. TRUE (default): Button ist sichtbar und aktiv. FALSE: Button ist unsichtbar und deaktiviert. 11 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > TECHNISCHE SCHNITTSTELLEN Property-Bezeichnung Typ PROPERTY_AUTOMATIC_COLOR_ENABLED Boolean Hinweis: Diese Property ist noch nicht implementiert. Property-Bezeichnung Typ PROPERTY_FONT_SIZE_ENABLED Boolean Auswahlliste (ComboBox) für die „Schriftgröße“ aktivieren oder deaktivieren. TRUE (default): ComboBox ist sichtbar und aktiv. FALSE: ComboBox ist unsichtbar und deaktiviert. Property-Bezeichnung Typ PROPERTY_FONT_ENABLED Boolean Auswahlliste (ComboBox) für die „Schriftart“ aktivieren oder deaktivieren. TRUE (default): ComboBox ist sichtbar und aktiv. FALSE: ComboBox ist unsichtbar und deaktiviert. Property-Bezeichnung Typ PROPERTY_SHOW_NONPRINTABLE_CHARS_ENABLED Boolean Button für Schrifteinstellung „Formatierungszeichen ein-/ausblenden“ aktivieren oder deaktivieren. TRUE (default): Button ist sichtbar und aktiv. FALSE: Button ist unsichtbar und deaktiviert. Property-Bezeichnung Typ PROPERTY_EXIT_REC_ENABLED Boolean Toolbar-Button „Schließen“ aktivieren oder deaktivieren. TRUE (default): Button ist sichtbar und aktiv. FALSE: Button ist unsichtbar und deaktiviert. 3.1.3 Properties zur Konfiguration des jrec Edit-Controls Mit diesen Properties kann das Verhalten des jrec Edit-Controls gesteuert werden. 12 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > TECHNISCHE SCHNITTSTELLEN Property-Bezeichnung Typ PROPERTY_ALLOWED_FONT_LIST String Durch Semikolon getrennte Liste der erlaubten Fonts (Fontname1;Fontname2; …). Falls nichtleer, wird die Liste der erlaubten Fonts auf die Fonts in der Liste eingeschränkt. Default: Alle erlaubten Fonts stehen im jrec Edit-Control zur Verfügung. Hinweis: Mit dieser Property kann die Liste der erlaubten Fonts auf die Fonts in der Liste eingeschränkt werden. Falls die Liste leer ist, sind alle erlaubten Fonts verfügbar. Property-Bezeichnung Typ PROPERTY_DEFAULT_FONT_FAMILY String Setzt die Standard-Schriftart des RTF-Dokuments. Default: RTF Standard-Schriftart (Times New Roman). Hinweis: Mit dieser Property wird der Name der Standard-Schriftart gesetzt. Falls die Property nicht gesetzt wird, wird die RTF Standard-Schriftart verwendet. Property-Bezeichnung Typ PROPERTY_DEFAULT_FONT_SIZE String Setzt die Standard-Schriftgröße des RTF-Dokuments. Default: RTF Standard-Schriftgröße (12). Hinweis: Mit dieser Property wird die Standard-Schriftgröße gesetzt. Falls die Property nicht gesetzt wird, wird die RTF Standard-Schriftgröße verwendet. Property-Bezeichnung Typ PROPERTY_GRAB_FOCUS_AFTER_SETRTF Boolean Bestimmt, ob in CIB jrec nach dem Setzen eines RTF-Texts durch setRTF() der Focus auf den Text gesetzt wird oder nicht. Default: FALSE Hinweis: Mit dieser Property wird festgelegt, ob nach dem Laden bzw. Setzen eines Texts der Focus automatisch in das Edit-Control gesetzt wird oder nicht. Property-Bezeichnung Typ PROPERTY_USE_ONLY_STANDARD_COLORS Boolean Im Farbauswahl-Dialog sind nur RTF-Standardfarben auswählbar. TRUE: Nur RTF-Standardfarben sind auswählbar. FALSE (default): Selbstdefinierte und RTF-Standardfarben sind wählbar. Hinweis: Mit dieser Property wird die Auswahlmöglichkeit der Farben im Farbauswahl-Dialog bestimmt. 13 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > TECHNISCHE SCHNITTSTELLEN Property-Bezeichnung Typ PROPERTY_POPUP_ENABLED Boolean Bestimmt, ob in CIB jrec das Popup-Menü aktiviert ist oder nicht. Da diese Property auch aus der INI-Datei gelesen wird, sollte sie erst nach dem Aufruf von cibRec.start() gesetzt werden, da sie sonst überschrieben wird. TRUE: Das Popup-Menü kann durch Klick mit der rechten Maustaste aktiviert werden. FALSE (default): Das Popup-Menü ist nicht aufrufbar. Hinweis: Mit dieser Property wird die Nutzbarkeit des Popup-Menüs bestimmt. Property-Bezeichnung Typ PROPERTY_WRITE_DEFAULTFONTSIZE Boolean Bestimmt, ob CIB jrec die Standard-Fontgröße in das RTF-Dokument schreibt. TRUE: Schreibt die Standard-Fontgröße in das RTF-Dokument. FALSE (default): Schreibt die Standard-Fontgröße nicht in das RTF-Dokument. Hinweis: Mit dieser Property wird das Schreiben der Standard-Fontgröße in das RTF-Dokuments konfiguriert. Property-Bezeichnung Typ PROPERTY_WRITE_DEFAULTTABS Boolean Bestimmt, ob CIB jrec die Standard-Tabulatoren pro Absatz in das RTF-Dokument schreibt. TRUE: Schreibt die Standard-Tabulatoren pro Absatz in das RTF-Dokument. FALSE (default): Schreibt die Standard-Tabulatoren nicht in das RTF-Dokument. Hinweis: Mit dieser Property wird das Schreiben der Standard-Tabulatoren in das RTF-Dokuments konfiguriert. Property-Bezeichnung Typ PROPERTY_REC_IGNORE_FIELDS Boolean Bestimmt, ob CIB jrec die im RTF-Dokument eingebetteten Felder ignoriert oder nicht. TRUE: Die im RTF eingebetteten Felder werden ignoriert, d.h. sie werden nicht angezeigt und nicht gespeichert. FALSE (default): Die im RTF eingebetteten Felder werden nicht ignoriert, d.h. sie werden angezeigt und gespeichert. Hinweis: Falls der Schalter gesetzt ist, werden eingebettete Felder nicht angezeigt und nicht gespeichert. Es wird nur das Fieldresult als normaler formatierter Text angezeigt und auch so gespeichert. Dies betrifft insbesondere auch Hyperlinks und Datei-Links. 14 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > TECHNISCHE SCHNITTSTELLEN 3.2 STEUERUNG DURCH AUFRUFPARAMETER CIB jrec kann auch durch Aufrufparameter in der Batch-Datei (run.bat) gesteuert werden. Dabei gilt die übliche Syntax für Kommandozeilenparameter: -<Parametername-1> <Parameterwert-1> … -<Parametername-n> <Parameterwert-n> Die Namen der Parameter entsprechen den internen Namen der Properties. Falls nicht bekannt, können sie durch den Support erfragt werden. Zusätzlich gibt es folgende Aufrufparameter: <Dateiname> Name des Dokuments, das beim Start der Applikation geladen werden soll. (ohne vorausgehendes Minuszeichen) -t Aktiviert die Ausgabe von Trace-Informationen in die Konsole 3.3 KONFIGURATIONSDATEI (INI-DATEI) CIB jrec kann durch eine Konfigurationsdatei gesteuert werden. Falls durch die Property PROPERTY_JREC_INIFILENAME kein anderer Name gesetzt wird, ist der Name der INI-Datei standardmäßig „cibjrec.ini“. Wenn keine INI-Datei verwendet werden soll, muss die INI-Datei auf den Wert „null“ gesetzt werden. Die INI-Datei wird beim Start von CIB jrec gelesen (in der Methode cibRec.start) und kann prinzipiell alle oben beschriebenen Properties enthalten, die dann die vorher gesetzten PropertyWerte überschreiben. Die Namen der Properties müssen den internen Namen der Properties entsprechen. Falls nicht bekannt, können sie durch den Support erfragt werden. Beginnt eine Zeile mit „#“, wird die Property ignoriert. Beispiel für den Inhalt einer INI-Datei: [Properties] TITLE=CIB Java Rich Edit Control INPUTFILE=D:\CIB\TestDokumente\RTF\Tabtest_All.rtf # Enable popup menu popup.Enabled=true # Show status line showstatus.Enabled=true # Show toolbar icon for nonprintable-characters #show-nonprintable-chars.Enabled=false 15 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > TECHNISCHE SCHNITTSTELLEN # Set default font family and size defaultFontFamily=Arial defaultFontSize=10 # Write default font size on saving writeDefaultFontSize=true # Write default tabs on saving #writeDefaultTabs=true # Grab focus after setting rtf file #grab.focus.after.setrtf.Enabled=false # Ignore field instructions within rtf content #JREC.ignoreFields=true 16 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > SCHNELLER EINSTIEG 4 SCHNELLER EINSTIEG 4.1 EINBINDUNG DES CIB JREC IN JAVA Wird der Jrec in eine Java-Applikation eingebunden, die ein eigenes Menü besitzt, muss das JRecMenü explizit deaktiviert werden. Dazu muss bei der Jrec-Instanz folgende Property gesetzt werden, bevor die Jrec-Instanz gestartet wird: // disable jrec menu bar – must be done // if custom application uses its own menu bar m_cibRec.setProperty(ICibApplication.PROPERTY_MENU_ENABLED, Boolean.FALSE); // set other Properties //... // jrec start and load m_cibRec.start(); m_cibRec.load(); Siehe dazu auch den Beispielcode zur Einbindung in eine Java Swing-Applikation. 4.1.1 Einbindung in eine Java Swing-Applikation import java.awt.Dimension; import javax.swing.JFrame; import javax.swing.JPanel; import javax.swing.WindowConstants; import javax.swing.text.MutableAttributeSet; import javax.swing.text.SimpleAttributeSet; import javax.swing.text.StyleConstants; import de.cib.jrec.JCibRec; public class MyRecTest extends JFrame { private static final long serialVersionUID = 1L; public static final String TEST_FILENAME = "c://tmp//rtf_data.rtf"; 17 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > SCHNELLER EINSTIEG JCibRec m_cibRec; public MySwingRecTest() { m_cibRec = new JCibRec(); JPanel recPanel = new JPanel(); recPanel.add(m_cibRec); getContentPane().add(recPanel); m_cibRec.setPreferredSize(new Dimension(650, 200)); // set standard formatting initDocumentAttributes(); // set input file (optional) m_cibRec.setProperty(ICibApplication.PROPERTY_INPUTFILE, TEST_FILENAME); // set Jrec application title m_cibRec.setProperty(ICibApplication.PROPERTY_TITLE, "CIB JRec integriert in Swing"); // disable jrec menu bar – must be done // if custom application uses its own menu bar m_cibRec.setProperty(ICibApplication.PROPERTY_MENU_ENABLED, Boolean.FALSE); // set other Properties //... // jrec start and load m_cibRec.start(); m_cibRec.load(); setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE); setLocation(200, 50); setResizable(false); pack(); } 18 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > SCHNELLER EINSTIEG // set standard formatting private void initDocumentAttributes() { MutableAttributeSet defaultAttributes = new SimpleAttributeSet(); StyleConstants.setFontSize(defaultAttributes, 8); StyleConstants.setFontFamily(defaultAttributes, "Courier New"); m_cibRec.getRecRichEditPane().setDocumentAttributeDefaults( defaultAttributes); } public static void main(String[] args) { MySwingRecTest recTest = new MySwingRecTest(); recTest.setVisible(true); } } Die Funktion initDocumentAttributes() zeigt beispielhaft, wie Sie die standardmäßige Schriftart und Schriftgröße für das Dokument setzen können. 4.1.2 Einbindung in eine Java SWT-Applikation Um JCibRec in eine SWT-Applikation zu integrieren, müssen einige Besonderheiten beachtet werden. JCibRec muss in einen AWT-Frame eingebettet werden, der als oberstes Objekt eine Instanz von RootPaneContainer (z.B. JApplet) enthält. In diesen RootPaneContainer werden dann alle weiteren Komponenten eingefügt. import org.eclipse.swt.SWT; import org.eclipse.swt.layout.FillLayout; import org.eclipse.swt.widgets.Composite; import org.eclipse.swt.widgets.Display; import org.eclipse.swt.widgets.Shell; import de.cib.gui.framework.ICibApplication; import de.cib.jrec.ICibRecApplication; import de.cib.jrec.JCibRec; 19 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > SCHNELLER EINSTIEG public class JRecInSWT { public static final String TEST_FILENAME = "Testdokument2.rtf"; public static void main(String[] args) { final Display display = new Display(); final Shell shell = new Shell(display); shell.setLayout(new FillLayout()); shell.setText("Shell for JRec integriert in SWT"); Composite composite = new Composite(shell, SWT.NO_BACKGROUND | SWT.EMBEDDED); /* * Set a Windows specific AWT property that prevents * heavyweight components from erasing their background. * Note that this is a global property and cannot be scoped. * It might not be suitable for your application. */ try { System.setProperty("sun.awt.noerasebackground", "true"); } catch (NoSuchMethodError error) { } final JCibRec cibRec = new JCibRec(composite); cibRec.setProperty(ICibApplication.PROPERTY_INPUTFILE, TEST_FILENAME); cibRec.setProperty(ICibApplication.PROPERTY_TITLE, "CIB JRec integriert in SWT"); cibRec.setProperty(ICibRecApplication.PROPERTY_POPUP_ENABLED, Boolean.TRUE); // disable jrec menu bar – must be done // if custom application uses its own menu bar cibRec.setProperty(ICibApplication.PROPERTY_MENU_ENABLED, Boolean.FALSE); 20 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > SCHNELLER EINSTIEG cibRec.setVisible(true); cibRec.start(); cibRec.load(); shell.open(); cibRec.grabFocus(); while (!shell.isDisposed()) { if (!display.readAndDispatch()) display.sleep(); } display.dispose(); } } 21 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > Abbildungsverzeichnis 5 ABBILDUNGSVERZEICHNIS Abbildung 1: Die Funktionen von CIB jrec...................................................................................... 8 Abbildung 2: Tabulatoren in CIB jrec ............................................................................................. 8 22 | 23 CIB Software GmbH > Technical Support & Services > CIB jrec > Stichwortverzeichnis 6 STICHWORTVERZEICHNIS CIB GUI 5 CIB jrec 5, 6, 7 CoMod 6 DLL 6 HTML 6 PDF 6 RTF 6, 7 Word 6 XML 6 23 | 23
