Muster-Code für die Klassen eines Task-Frames

Dieses Dokument enthält Code-Muster für die Klasse für ein Task-Frame und Erweiterungen, die entsprechend den jeweiligen Anforderungen zusätzlich implementiert werden können.

Inhaltsverzeichnis:

Vorbedingung 
Muster-Code für die Klasse für das Frame (GUI) 
Muster-Code für die Klasse für den ActionHandler 
Muster-Code für die Klasse für den DocumentListener 

Anleitung zur Adaptierung in allen Klassen 
* Änderung des Namens des Java-Packages 
* Änderung des Namens der Klassen 
* Adaptieren der Kommentare 
* Änderung der Variablen-Namen für die BO-Klassen (BO und BOC) 

Anleitung zur Adaptierung in der Klasse für das Frame (GUI) 
* Änderung des Namens der Klasse des CommandCenters 
* Definieren der Variablen für die 'aufzuhebenden' Selektionskriterien für die Anzeige der Liste 
* Definieren der Variablen für die GUI-Elemente 
* Einsetzen des internen Codes für den Aufruf des Task-Frames 
* Adaptieren der 'Constructor'-Methoden für jedes GUI-Element 
* Aufnehmen der GUI-Elemente in das pnl_DetailFields 
* Aufnehmen der GUI-Elemente in das pnl_ListFields (nach Bedarf) 
* Festlegen von Feldern mit verpflichtender Eingabe 
* Reagieren auf Änderungen der Spaltenbreite in JTables - Methode columnMarginChanged(...) 

Anleitung zur Adaptierung bei Verwendung von Währungen in der Klasse für die GUI 
* Adaptieren in der Methode initialize_frame 
* Adaptieren in der Methode initialize_after_frame 

Anleitung zur Adaptierung in der Klasse für den ActionHandler 
* Festlegen des 'ActionCommand' für eine Schaltfläche zur Anzeige der Liste – Methode handleEvent(...) 
* 'Aufheben' der Werte für die Auswahlkriterien - Methode getSelectionCriteria(...)
* Eventuelle Adaptierungen in der Methode processAfterConstruction(...)
* Verarbeiten eventuell im CommandCenter eingegebener Parameter - Methode processCCParameter(...)
* Adaptieren der Methode setToGUI(...)
* Adaptieren der Methoden setFieldsForInsert(...) und setFieldsForUpdate(...)
* Adaptieren der Methode redisplayBOList(...)
* Adaptieren der Methode store(...)
* Adaptieren der Methode copy(...)
* Adaptieren der Methoden getNext(...) und getPrevious(...)
* Adaptieren der Methode getSingleBO(...)
* Adaptieren der Methode getForUpdate(...)
* Adaptieren der Methode processDeactivate(...)

Anleitung zur Adaptierung in der Klasse für den DocumentListener 
* Definieren der Variable für 'Document's und 'Flag's 
* Zuweisen der Referenz auf das 'Document' des GUI-Elements im 'Constructor' 
* Erstmaliges Setzen der 'Flag's im 'Constructor' 
* Reagieren auf Eingaben - Methode anyUpdate(...) 
* Reagieren auf Änderungen bei CheckBoxes, RadioButtons und ComboBoxes - Methode itemStateChanged(...) 
* Zusammenfassen der Flags für korrekte / fehlerhafte Eingaben - Methode checkEntriesOK() 

Spezieller Muster-Code 
* Übernehmen von Werten aus den Parameter-Feldern des CommandCenter 

Weitere Schritte und verwandte Dokumentation 

Vorbedingung:

• Tutorial für die Programmierung eines Heavyweight-Clients (Fat-Client) durchgearbeitet.

• Klassen für das (die) verwendeten Business-Object(s) implementiert.
  Den Leitfaden dazu finden Sie im Dokument Leitfaden für die Entwicklung von Heavyweight-Clients mit dem JS-FCF – Alle Schritte zur Entwicklung von DBA (DataBase-Access) und BO (Business-Object) Klassen.

• Layout für die Anordnung der GUI-Elemente.
  Ein Formblatt dafür finden Sie unter Poster für das GUI-Layout der Basisklasse JSBS_TaskFrame.

▲ zum Inhaltsverzeichnis

Muster-Code für die Klasse für das Frame (GUI)

Welche Platzhalter durch Bezeichnungen des eigentlichen Projektes zu ersetzen sind finden Sie im Abschnitt
Anleitung zur Adaptierung in allen Klassen und
Anleitung zur Adaptierung in der Klasse für das Frame (GUI) .

package application_package.client;
/*
 * Packages mit den GUI-Elementen. */
import java.awt.*;
import javax.swing.*;
/*
 * Packages mit den Klassen zum Bearbeiten von Events */
import java.awt.event.*;
import javax.swing.event.*;
/*
 * Package mit der Basisklasse für das TaskFrame. */
import js_base.frame.*;
/*
 * Package mit den Business-Objects. */
import application_package.boc.*;
/**
 * 
 * @author name[at]company
 * @date 20xx-xx-xx
 *
 * @description
 *  Klasse für den Aufbau der Benutzeroberfläche eines Frames (Fensters)
 *  für die Geschäftsanwendung (Task)
 *  XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
 *
 *  Die Geschäftsanwendung (Task) ermöglicht
 *  XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
 * 
 * @change-log
 * when          who                       why
 * -----------------------------------------------------------------
 * 
 */
public class application_task extends JSBS_TaskFrame {
/*
 * Variable für die Referenz auf die Klasse des Start-Frame (CommandCenter). */
    protected application_CommandCenter frmCC;
/*
 * Zugehöriges DocumentListener Objekt definieren. */
    protected application_task__DocumentListener
                structapplication_task__DocumentListener;
/*
 * Business-Objects (Client-Side-Klasse)
 * für die Detail-Anzeige und-Bearbeitung definieren. */
    protected application_entity_BOC
                structapplication_entity_BOC_Read;
    protected application_entity_BOC
                structapplication_entity_BOC_Processed;
/*
 * Liste mit Business-Objects (Client-Side-Klasse)
 * für die Auswahl-Liste definieren. */
    protected application_entity_BOC_Set
                structapplication_entity_BOC_Set;
/*
 * Werte der Selektion für die Anzeige der Auswahl-Liste.
 * Diese werden gesetzt wenn die Liste neu angezeigt wird und werden gebraucht,
 * wenn die Liste neu angezeigt werden soll aber die GUI-Elemente für die Auswahl
 * schon geändert sein können.
 * Das ist der Fall, wenn ein BO gelöscht wurde. */
    protected int int_Selection_VariableName_1 = 0;
    protected String str_Selection_VariableName_2 = "";
/*
 * Muster-GUI-Elemente;
 * Diese sind durch jene GUI-Elemente, die für diesen Task-Frame spezifisch sind,
 * zu ersetzen. */
    private JSBS_Dividerline dl_Sample_Areas_To_Be_Separated;
    protected JLabel lbl_Sample_JLabel_Right;
    protected JLabel lbl_Sample_JLabel_Left;
    protected JTextField txt_Sample_JTextField;
    protected JTextArea txt_Sample_JTextArea;
    protected JList lst_Sample_JList;
    protected JComboBox combo_Sample_JComboBox;
    protected JCheckBox chk_Sample_JCheckBox;
    protected JRadioButton rbtn_Sample_JRadioButton_1;
    protected JRadioButton rbtn_Sample_JRadioButton_2;
    protected ButtonGroup btngrp_Sample_ButtonGroup = new ButtonGroup();
    protected JButton btn_Sample_JButton;
    protected JSBS_ImagePane img_Sample_ImagePane;
/*
 * Constructor der Klasse.
 * Code darin wird aufgerufen wenn ein Objekt dieser Klasse erstellt wird.
 * Als Parameter wird das StartFrame (CommandCenter) und die Parameter,
 * die der Anwender bereits im StartFrame erfaßt hat, übernommen.
 * Das StartFrame enthält alle Einstellungen, die für die gesamte Anwendung gelten
 * und die Klassen für die Verbindung zur Datenbank oder
 * zum Java-Application-Server (JAS).
 * Die Parameter, die der Anwender bereits im StartFrame erfaßt hat,
 * steuern individuell für jedes TaskFrame, welche Liste oder welches einzelne BO
 * sofort nach der 'Konstruktion' des TaskFrame angezeigt wird. */
    public application_task(application_CommandCenter parmCC) {
/*
 * Aufruf des Constructors der Basisklasse (JSBS_TaskFrame).
 * Darin werden die Klasse des StartFrames und eventuell Werte einzelner Variablen
 * in lokale Variablen übertragen. */
        super (parmCC, parmCC.get_txt_Parameter1().getText(),
               parmCC.get_txt_Parameter2().getText(), parmCC.get_txt_Parameter3().getText());
/*
 * Übernehmen der Klasse des CommandCenters in die dafür bestimmte Variable dieser Klasse. */
        frmCC = parmCC;
/* 
 * Aufrufen der Methoden mit den individuellen Initialisierungen für diese Klasse. */
        initialize_before_frame();
        initialize_frame();
        initialize_after_frame();
    }
/* 
 * Methode mit den Initialisierungen die notwendig sind bevor das Frame (Window)
 * angezeigt wird. */
    private void initialize_before_frame() {
/* 
 * 'Konstruieren' der Business-Objects, die in diesem Task-Frame verwendet werden. */
      structapplication_entity_BOC_Read =
                new application_entity_BOC(frmCC, this);
      structapplication_entity_BOC_Processed =
                new application_entity_BOC(frmCC, this);
      structapplication_entity_BOC_Set =
                new application_entity_BOC_Set(frmCC, this);
    }
/* 
 * Methode mit der das Frame (Window) angezeigt wird. */
    private void initialize_frame() {
/* Frame (Window) sichtbar machen (anzeigen). */
      setVisible(true);
/* Anfangsgröße festlegen. */
      setSize(800, 600);
/* Grund-Panel mit den weiteren GUI-Elementen anzeigen.
 * Die GUI-Elemente und deren Anordnung sind in der geerbten Klasse
 * (JSBS_TaskFrame) festgelegt. */
      setContentPane(get_pnl_Main());
/* 
 * Wenn in Ihrer Anwendung die Auswahl von Währungen möglich sein soll,
 * dann kommentieren Sie bitte die folgende Zeile aus und setzen die
 * Zeile oberhalb unter Kommentar. */
//      setContentPane(get_pnl_Main_With_Currency_Selection());
/*
 * Methode aufrufen die die Größe und Position des Fensters beim letzten Schließen
 * wieder herstellen.
 * Die dafür notwendige Datenstruktur und die aufgerufenen Methode ist in der
 * geerbten Basisklasse codiert. */
      setFramePosition();
/* Mouse-Listener zu der JTable, in der die auswählbaren Business-Objects angezeigt
 * werden, hinzufügen. Damit wird beim Anklicken einer Zeile der JTable die Nummer der
 * Zeile in das JTextField für die Auswahl (txt_Selection) übertragen.
 * Das Feststellen der Zeile und das Übertragen wird durch eine Methode in der
 * geerbten Basisklasse durchgeführt. */
      get_pnl_SelectionListTable().addMouseListener(this);
    }
/* 
 * Methode mit den Initialisierungen die notwendig sind nachdem das Frame (Window)
 * angezeigt wird. */
    private void initialize_after_frame() {
/* Methode zum Zuordnen des sprachabhängigen Textes zu den GUI-Elementen aufrufen. */
      JSBS_GUIServices.processLanguageDependantElements(this);
/* GUI-Elemente, bei denen eine Eingabe zwingend erforderlich ist ('Mandatory'),
 * festlegen. Die Festlegung hier ist 'stärker' als eine eventuelle Prüf-Regel
 * in der Datei 'DisplayStrings.xml'. */
      structJSBS_EntryRules.addApplicationMandatoryGUIElement(get_txt_SampleJTextField());
/* DocumentListener konstruieren und anschließend die Methode der geerbten Klasse
 * aufrufen mit der die notwendigen Listener zu den GUI-Elementen hinzugefügt werden. */
      structapplication_task__DocumentListener =
          new application_task__DocumentListener(this);
      addListeners(this.getContentPane(), structapplication_task__DocumentListener);
/*
 * Border (Ränder der GUI-Elemente) einfärben damit sie besser sichtbar sind. */
/* Zuerst jenes Elemente vom Typ JPanel festlegen, das eingefärbt werden soll. */
      arrayJPanelBordersToBeColored = new JPanel[1];
      arrayJPanelBordersToBeColored[0] = get_pnl_Main();
/* 
 * Wenn in Ihrer Anwendung die Auswahl von Währungen möglich sein soll,
 * dann kommentieren Sie bitte die folgende Zeile aus und setzen die
 * Zeile oberhalb unter Kommentar. */
//      arrayJPanelBordersToBeColored[0] = get_pnl_Main_With_Currency_Selection();
/* 
 * Methode aufrufen mit der die 'Border' eingefärbt werden. */
      JSBS_GUIServices.processBorders(this);
/*
 * Eintragen dieses Tasks in die Tabelle beim CommandCenter.
 * Der von der aufgerufenen Methode zurückgelieferte ID wird verwendet
 * wenn die angezeigten Daten verändert werden sollen.
 * Das Verändern der angezeigten Daten ist sinnvoll, wenn der Anwender einen
 * Datensatz aus der Liste auswählt (Methode 'getForUpdate(..)' in der Klasse
 * xxx__ActionHandler.
 * Der 2. Parameter beim Aufruf der Methode ist der interne Code dieser Klasse
 * in der Datei 'Tasks.xml'.
 * Der 3. Parameter ist eine Kurzfassung der angezeigten Daten;
 * diese Daten sind jetzt noch nicht vorhanden. */
      dblCC_TaskID = frmCC.addOpenTaskFrame(this, "internal_Selection_Code", "");
/* 
 * Methode, die nach der 'Construction' der Klasse ausgeführt werden soll, aufrufen.
 * Eine nähere Beschreibung ist im Kommentar zu dieser Methode. */
      application_task__ActionHandler.processAfterConstruction(this);
/*
 * Methode aufrufen, die die Combobox für die Auswahl der Währung füllt.
 * Anschließend die gewählte Währung aus dem StartFrame (CommandCenter)
 * übernehmen.
 * Wenn in Ihrer Anwendung die Auswahl von Währungen möglich sein soll,
 * dann entfernen Sie bitte den Kommentar vor den folgenden Zeilen. */
//      frmCC.fillComboBoxWithCurrencies(get_combo_CurrencySelection());
//      JSBS_GUIServices.setJComboBoxItem(get_combo_CurrencySelection(),
//            frmCC.structJSBS_UniversalParameters.strPreferredCurrency,
//            frmCC.structJSBS_UniversalParameters, true);
    }
/* 
 * ******************************
 * Methoden zum 'Construct' (Initialisierung) der einzelnen GUI-Elemente.
 * Die Muster-GUI-Elemente sind durch jene für die Geschäftsanwendung zu ersetzen.
 * */
    private JSBS_Dividerline get_dl_Sample_Areas_To_Be_Separated() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (dl_Sample_Areas_To_Be_Separated == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          dl_Sample_Areas_To_Be_Separated = new JSBS_Dividerline();
          dl_Sample_Areas_To_Be_Separated.setName("dl_Sample_Areas_To_Be_Separated");
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building dl_Sample_Areas_To_Be_Separated in class application_task.");
          Exc.printStackTrace();
        }
      }
      return dl_Sample_Areas_To_Be_Separated;
    }
/* */
    protected JLabel get_lbl_Sample_JLabel_Right() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (lbl_Sample_JLabel_Right == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          lbl_Sample_JLabel_Right = new JLabel();
          lbl_Sample_JLabel_Right.setName("lbl_Sample_JLabel_Right");
          lbl_Sample_JLabel_Right.setHorizontalAlignment(SwingConstants.TRAILING);
/* Mit folgender Code-Zeile wird das GUI-Element mit einem Text versehen.
 * Damit ist auf der GUI der Name des GUI-Elementes zu sehen solange noch kein
 * sprach-spezifischer Text definiert ist. */
          lbl_Sample_JLabel_Right.setText("lbl_Sample_JLabel_Right");
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building lbl_Sample_JLabel_Right in class application_task.");
          Exc.printStackTrace();
        }
      }
      return lbl_Sample_JLabel_Right;
    }
/* */
    protected JLabel get_lbl_Sample_JLabel_Left() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (lbl_Sample_JLabel_Left == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          lbl_Sample_JLabel_Left = new JLabel();
          lbl_Sample_JLabel_Left.setName("lbl_Sample_JLabel_Left");
          lbl_Sample_JLabel_Left.setHorizontalAlignment(SwingConstants.LEADING);
/* Mit folgender Code-Zeile wird das GUI-Element mit einem Text versehen.
 * Damit ist auf der GUI der Name des GUI-Elementes zu sehen solange noch kein
 * sprach-spezifischer Text definiert ist. */
          lbl_Sample_JLabel_Left.setText("lbl_Sample_JLabel_Left");
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building lbl_Sample_JLabel_Left in class application_task.");
          Exc.printStackTrace();
        }
      }
      return lbl_Sample_JLabel_Left;
    }
/* */
    protected JTextField get_txt_Sample_JTextField() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (txt_Sample_JTextField == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          txt_Sample_JTextField = new JTextField();
          txt_Sample_JTextField.setName("txt_Sample_JTextField");
          txt_Sample_JTextField.setHorizontalAlignment(SwingConstants.LEADING);
/* Das folgende Kommando ('TRAILING') wird verwendet wenn das Eingabefeld für einen numerischen Wert ist. */
          txt_Sample_JTextField.setHorizontalAlignment(SwingConstants.TRAILING);
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building txt_Sample_JTextField in class application_task.");
          Exc.printStackTrace();
        }
      }
      return txt_Sample_JTextField;
    }
/* */
    protected JTextArea get_txt_Sample_JTextArea() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (txt_Sample_JTextArea == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          txt_Sample_JTextArea = new JTextArea();
          txt_Sample_JTextArea.setName("txt_Sample_JTextArea");
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building txt_Sample_JTextArea in class application_task.");
          Exc.printStackTrace();
        }
      }
      return txt_Sample_JTextArea;
    }
/* */
    protected JList get_lst_Sample_JList() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (lst_Sample_JList == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          lst_Sample_JList = new JList();
          lst_Sample_JList.setName("lst_Sample_JList");
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building lst_Sample_JList in class application_task.");
          Exc.printStackTrace();
        }
      }
      return lst_Sample_JList;
    }
/* */
    protected JComboBox get_combo_Sample_JComboBox() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (combo_Sample_JComboBox == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          combo_Sample_JComboBox = new JComboBox();
          combo_Sample_JComboBox.setName("combo_Sample_JComboBox");
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building combo_Sample_JComboBox in class application_task.");
          Exc.printStackTrace();
        }
      }
      return combo_Sample_JComboBox;
    }
/* */
    protected JCheckBox get_chk_Sample_JCheckBox() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (chk_Sample_JCheckBox == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          chk_Sample_JCheckBox = new JCheckBox();
          chk_Sample_JCheckBox.setName("chk_Sample_JCheckBox");
          chk_Sample_JCheckBox.setHorizontalAlignment(SwingConstants.TRAILING );
          chk_Sample_JCheckBox.setHorizontalTextPosition(SwingConstants.LEADING);
/* Mit folgender Code-Zeile wird das GUI-Element mit einem Text versehen.
 * Damit ist auf der GUI der Name des GUI-Elementes zu sehen solange noch kein
 * sprach-spezifischer Text definiert ist. */
          chk_Sample_JCheckBox.setText("chk_Sample_JCheckBox");
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building chk_Sample_JCheckBox in class application_task.");
          Exc.printStackTrace();
        }
      }
      return chk_Sample_JCheckBox;
    }
/* */
    protected JRadioButton get_rbtn_Sample_JRadioButton_1() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (rbtn_Sample_JRadioButton_1 == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          rbtn_Sample_JRadioButton_1 = new JRadioButton();
          rbtn_Sample_JRadioButton_1.setName("rbtn_Sample_JRadioButton_1");
          rbtn_Sample_JRadioButton_1.setHorizontalAlignment(SwingConstants.LEADING);
          rbtn_Sample_JRadioButton_1.setHorizontalTextPosition(SwingConstants.TRAILING);
          btngrp_Sample_ButtonGroup.add(rbtn_Sample_JRadioButton_1);
/* Mit folgender Code-Zeile wird das GUI-Element mit einem Text versehen.
 * Damit ist auf der GUI der Name des GUI-Elementes zu sehen solange noch kein
 * sprach-spezifischer Text definiert ist. */
          rbtn_Sample_JRadioButton_1.setText("rbtn_Sample_JRadioButton_1");
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building rbtn_Sample_JRadioButton_1 in class application_task.");
          Exc.printStackTrace();
        }
      }
      return rbtn_Sample_JRadioButton_1;
    }
/* */
    protected JRadioButton get_rbtn_Sample_JRadioButton_2() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (rbtn_Sample_JRadioButton_2 == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          rbtn_Sample_JRadioButton_2 = new JRadioButton();
          rbtn_Sample_JRadioButton_2.setName("rbtn_Sample_JRadioButton_2");
          rbtn_Sample_JRadioButton_2.setHorizontalAlignment(SwingConstants.TRAILING);
          rbtn_Sample_JRadioButton_2.setHorizontalTextPosition(SwingConstants.LEADING);
          btngrp_Sample_ButtonGroup.add(rbtn_Sample_JRadioButton_2);
/* Mit folgender Code-Zeile wird das GUI-Element mit einem Text versehen.
 * Damit ist auf der GUI der Name des GUI-Elementes zu sehen solange noch kein
 * sprach-spezifischer Text definiert ist. */
          rbtn_Sample_JRadioButton_2.setText("rbtn_Sample_JRadioButton_2");
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building rbtn_Sample_JRadioButton_2 in class application_task.");
          Exc.printStackTrace();
        }
      }
      return rbtn_Sample_JRadioButton_2;
    }
/* */
    protected JButton get_btn_Sample_JButton() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (btn_Sample_JButton == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          btn_Sample_JButton = new JButton();
          btn_Sample_JButton.setName("btn_Sample_JButton");
/* 
 * Durch den 'ActionListener' wird beim Anklicken des GUI-Elements mit der Maustaste
 * die Methode 'actionPerformed' aufgerufen. */
          btn_Sample_JButton.addActionListener(this);
/* 
 * Über den 'ActionCommand' kann abgefragt werden, welches GUI-Element mit der
 * Maustaste angeklickt wurde. */
          btn_Sample_JButton.setActionCommand("btn_Sample_JButton");
/* Mit folgender Code-Zeile wird das GUI-Element mit einem Text versehen.
 * Damit ist auf der GUI der Name des GUI-Elementes zu sehen solange noch kein
 * sprach-spezifischer Text definiert ist. */
          btn_Sample_JButton.setText("btn_Sample_JButton");
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building btn_Sample_JButton in class application_task.");
          Exc.printStackTrace();
        }
      }
      return btn_Sample_JButton;
    }
/* */
    protected JSBS_ImagePane get_img_Sample_ImagePane() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (img_Sample_ImagePane == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
/* 
 * Die folgenden zwei Zeilen können alternativ verwendet werden.
 * 1. Möglichkeit:
 * In der anschließenden Zeile wird kein 'JLabel' für die Anzeige der Größe des Images übergeben. */
          img_Sample_ImagePane = new JSBS_ImagePane();
/* 2. Möglichkeit:
 * In der anschließenden Zeile wird ein GUI-Element vom Typ 'JLabel' übergeben in dem innerhalb
 * von 'JSBS_ImagePane' die Größe des angezeigten Images (als 'Pixel x Pixel') als Text gesetzt wird. */
          img_Sample_ImagePane = new JSBS_ImagePane(get_lbl_ImageSize());
          img_Sample_ImagePane.setName("img_Sample_ImagePane");
/* 
 * Damit das Image in einer akzeptablen Größe angezeigt wird und nicht zu sehr schrumpfen kann
 * werden Grenzen für die Größe festgelegt. */
          img_Sample_ImagePane.setPreferredSize(new Dimension(400, 400));
          img_Sample_ImagePane.setMinimumSize(new Dimension(300, 300));
          img_Sample_ImagePane.setMaximumSize(new Dimension(1000, 500));
/* 
 * Über das folgende Kommando werden die sprachspezifischen Texte für 'copy' und 'paste' im Kontext-Menu
 * (erscheint wenn der Mauszeiger über dem Image positioniert ist und die rechte Maustaste gedrückt wird)
 * festgelegt. Die aktuellen Texte werden aus der XML-Struktur in der Datei 'DisplayStrings.xml'
 * ausgelesen.
 * Wenn noch keine Texte darin definiert sind kommentieren Sie die Zeile aus – dann werden einfache
 * Standard-Texte angezeigt.
 * Wenn eine Auswahlmöglichkeit nicht angezeigt werden soll dann übergeben Sie statt des Textes den Wert
 * 'null' als Parameter. Sind beide Parameter 'null' dann wird das Kontext-Menu nicht angezeigt. */
          img_Sample_ImagePane.setLanguageSpecificMenuTexts(
                    frmCC.structJSBS_XML_DisplayStrings.getSupplementaryText("MenuItem_CopyToClipboard"),
                    frmCC.structJSBS_XML_DisplayStrings.getSupplementaryText("MenuItem_PasteFromClipboard"));
/* 
 * Wenn das Image über das Kontext-Menu 'paste' eingefügt werden kann dann wird mit dem folgenden Listener
 * und dessen Methode ein Erkennen des geänderten Images möglich.
 * Innerhalb der Methode kann eine weitere Methode aufgerufen werden, die das Image weiter verarbeitet -
 * z.B. eine Vorbereitung für das Speichern auf der Datenbank. */
          img_Sample_ImagePane.addPropertyChangeListener(new PropertyChangeListener() {
            public void propertyChange(PropertyChangeEvent evt) {
/* Aufrufen der Methode, die das Image weiter bearbeitet. */
              application_task__ActionHandler.processChangedImage(this);
            }
          });
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building img_Sample_ImagePane in class application_task.");
          Exc.printStackTrace();
        }
      }
      return img_Sample_ImagePane;
    }
/* */
/* 
 * ******************************
 * Methode zum 'Construct' (Initialisierung) des Panels mit den GUI-Elementen für
 * die Abwicklung des Geschäftsfalles.
 * Diese Methode überschreibt das 'Construct' des JPanel (mit gleichem Namen) in der
 * geerbten Methode aus der Klasse JSBS_TaskFrame.
 * */
    protected JPanel get_pnl_DetailFields() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (pnl_DetailFields == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
          pnl_DetailFields = new JPanel();
          pnl_DetailFields.setName("pnl_DetailFields");
/* 
 * Mit der folgenden Anweisung wird die Eigenschaft 'GridBagLayout festgelegt
 * 'GridBagLayout' unterteilt das JPanel in 'dehnbare' Felder; damit 'wachsen' oder
 * 'schrumpfen' darin platzierte GUI-Elemente abhängig von der Größe des JPanel. */
          pnl_DetailFields.setLayout(new GridBagLayout());
/* 
 * Die folgenden Anweisungen platzieren GUI-Elemente in den 'Feldern' des JPanel. */
/* Zuerst wird eine Variable für die Platzierungs-Eigenschaften erstellt. */
          GridBagConstraints gbc_dl_Sample_Areas_To_Be_Separated = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_dl_Sample_Areas_To_Be_Separated.gridx = 0;
          gbc_dl_Sample_Areas_To_Be_Separated.gridy = 0;
          gbc_dl_Sample_Areas_To_Be_Separated.gridwidth = 4;
          gbc_dl_Sample_Areas_To_Be_Separated.weightx = 1;
          gbc_dl_Sample_Areas_To_Be_Separated.fill = GridBagConstraints.HORIZONTAL;
          gbc_dl_Sample_Areas_To_Be_Separated.anchor = GridBagConstraints.CENTER;
          gbc_dl_Sample_Areas_To_Be_Separated.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_dl_Sample_Areas_To_Be_Separated(), gbc_dl_Sample_Areas_To_Be_Separated);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_lbl_Sample_JLabel_Right = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_lbl_Sample_JLabel_Right.gridx = 0;
          gbc_lbl_Sample_JLabel_Right.gridy = 0;
          gbc_lbl_Sample_JLabel_Right.weightx = 1;
          gbc_lbl_Sample_JLabel_Right.fill = GridBagConstraints.HORIZONTAL;
          gbc_lbl_Sample_JLabel_Right.anchor = GridBagConstraints.LINE_END;
          gbc_lbl_Sample_JLabel_Right.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_lbl_Sample_JLabel_Right(), gbc_lbl_Sample_JLabel_Right);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_txt_Sample_JTextField = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_txt_Sample_JTextField.gridx = 0;
          gbc_txt_Sample_JTextField.gridy = 1;
          gbc_txt_Sample_JTextField.weightx = 1;
          gbc_txt_Sample_JTextField.fill = GridBagConstraints.HORIZONTAL;
          gbc_txt_Sample_JTextField.anchor = GridBagConstraints.LINE_START;
          gbc_txt_Sample_JTextField.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_txt_Sample_JTextField(), gbc_txt_Sample_JTextField);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_combo_Sample_JComboBox = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_combo_Sample_JComboBox.gridx = 0;
          gbc_combo_Sample_JComboBox.gridy = 2;
          gbc_combo_Sample_JComboBox.weightx = 1;
          gbc_combo_Sample_JComboBox.fill = GridBagConstraints.HORIZONTAL;
          gbc_combo_Sample_JComboBox.anchor = GridBagConstraints.LINE_START;
          gbc_combo_Sample_JComboBox.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_combo_Sample_JComboBox(), gbc_combo_Sample_JComboBox);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_chk_Sample_JCheckBox = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_chk_Sample_JCheckBox.gridx = 0;
          gbc_chk_Sample_JCheckBox.gridy = 3;
          gbc_chk_Sample_JCheckBox.weightx = 1;
          gbc_chk_Sample_JCheckBox.fill = GridBagConstraints.HORIZONTAL;
          gbc_chk_Sample_JCheckBox.anchor = GridBagConstraints.LINE_END;
          gbc_chk_Sample_JCheckBox.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_chk_Sample_JCheckBox(), gbc_chk_Sample_JCheckBox);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_rbtn_Sample_JRadioButton_1 = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_rbtn_Sample_JRadioButton_1.gridx = 0;
          gbc_rbtn_Sample_JRadioButton_1.gridy = 4;
          gbc_rbtn_Sample_JRadioButton_1.weightx = 1;
          gbc_rbtn_Sample_JRadioButton_1.fill = GridBagConstraints.HORIZONTAL;
          gbc_rbtn_Sample_JRadioButton_1.anchor = GridBagConstraints.LINE_START;
          gbc_rbtn_Sample_JRadioButton_1.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_rbtn_Sample_JRadioButton_1(), gbc_rbtn_Sample_JRadioButton_1);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_rbtn_Sample_JRadioButton_2 = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_rbtn_Sample_JRadioButton_2.gridx = 0;
          gbc_rbtn_Sample_JRadioButton_2.gridy = 5;
          gbc_rbtn_Sample_JRadioButton_2.weightx = 1;
          gbc_rbtn_Sample_JRadioButton_2.fill = GridBagConstraints.HORIZONTAL;
          gbc_rbtn_Sample_JRadioButton_2.anchor = GridBagConstraints.LINE_END;
          gbc_rbtn_Sample_JRadioButton_2.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_rbtn_Sample_JRadioButton_2(), gbc_rbtn_Sample_JRadioButton_2);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_lbl_Sample_JLabel_Left = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_lbl_Sample_JLabel_Left.gridx = 1;
          gbc_lbl_Sample_JLabel_Left.gridy = 0;
          gbc_lbl_Sample_JLabel_Left.weightx = 1;
          gbc_lbl_Sample_JLabel_Left.fill = GridBagConstraints.HORIZONTAL;
          gbc_lbl_Sample_JLabel_Left.anchor = GridBagConstraints.LINE_START;
          gbc_lbl_Sample_JLabel_Left.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_lbl_Sample_JLabel_Left(), gbc_lbl_Sample_JLabel_Left);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_txt_Sample_JTextArea = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_txt_Sample_JTextArea.gridx = 1;
          gbc_txt_Sample_JTextArea.gridy = 1;
          gbc_txt_Sample_JTextArea.gridwidth = 1;
          gbc_txt_Sample_JTextArea.gridheight = 5;
          gbc_txt_Sample_JTextArea.weightx = 1;
          gbc_txt_Sample_JTextArea.fill = GridBagConstraints.BOTH;
          gbc_txt_Sample_JTextArea.anchor = GridBagConstraints.LINE_START;
          gbc_txt_Sample_JTextArea.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_txt_Sample_JTextArea(), gbc_txt_Sample_JTextArea);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_lst_Sample_JList = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_lst_Sample_JList.gridx = 2;
          gbc_lst_Sample_JList.gridy = 1;
          gbc_lst_Sample_JList.gridwidth = 1;
          gbc_lst_Sample_JList.gridheight = 5;
          gbc_lst_Sample_JList.weightx = 1;
          gbc_lst_Sample_JList.fill = GridBagConstraints.BOTH;
          gbc_lst_Sample_JList.anchor = GridBagConstraints.LINE_START;
          gbc_lst_Sample_JList.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_lst_Sample_JList(), gbc_lst_Sample_JList);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_btn_Sample_JButton = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_btn_Sample_JButton.gridx = 0;
          gbc_btn_Sample_JButton.gridy = 6;
          gbc_btn_Sample_JButton.gridwidth = 3;
          gbc_btn_Sample_JButton.weightx = 1;
          gbc_btn_Sample_JButton.fill = GridBagConstraints.BOTH;
          gbc_btn_Sample_JButton.anchor = GridBagConstraints.LINE_START;
          gbc_btn_Sample_JButton.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_btn_Sample_JButton(), gbc_btn_Sample_JButton);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_img_Sample_ImagePane = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_img_Sample_ImagePane.gridx = 0;
          gbc_img_Sample_ImagePane.gridy = 8;
          gbc_img_Sample_ImagePane.gridwidth = 3;
          gbc_img_Sample_ImagePane.weightx = 1;
          gbc_img_Sample_ImagePane.fill = GridBagConstraints.BOTH;
          gbc_img_Sample_ImagePane.anchor = GridBagConstraints.LINE_START;
          gbc_img_Sample_ImagePane.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_DetailFields().add(get_img_Sample_ImagePane(), gbc_img_Sample_ImagePane);
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building pnl_DetailFields in class application_task.");
          Exc.printStackTrace();
        }
      }
      return pnl_DetailFields;
    }
/* */
/* 
 * ******************************
 * Methode zum 'Construct' (Initialisierung) des Panels mit den GUI-Elementen zum Filtern,
 * welche BO (Datensätze) in der angezeigten Liste für die Auswahl enthalten sind.
 * Diese Methode überschreibt das 'Construct' des JPanel (mit gleichem Namen) in der
 * geerbten Methode aus der Klasse JSBS_TaskFrame.
 * **********
 * Wenn in der Benutzeroberfläche (GUI) dieses Teilprogramms (Tasks) keine Auswahlmöglichkeiten
 * für Filterkriterien vorgesehen sind dann löschen Sie bitte diese Methode.
 * */
    protected JPanel get_pnl_ListFields() {
/* Zuerst Prüfen, ob die Variable bereits 'constructed' (initialisiert) ist. */
      if (pnl_ListFields == null) {
/* Variable noch nicht 'constructed'; Code für die Initialisierung folgt. */
        try {
/* Das 'Konstruieren' des GUI-Elements ist in der geerbten Klasse definiert.
 * Dort ist auch die JTable für die Anzeige der Liste der ausgewählten Datensätze und
 * das Eingabefeld für die Auswahl definiert. */
          super.get_pnl_ListFields();
/* 
 * Die folgenden Anweisungen platzieren GUI-Elemente in den 'Feldern' des JPanel. */
/* Zuerst wird eine Variable für die Platzierungs-Eigenschaften erstellt. */
          GridBagConstraints gbc_lbl_Sample_JLabel_Right = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_lbl_Sample_JLabel_Right.gridx = 0;
          gbc_lbl_Sample_JLabel_Right.gridy = 0;
          gbc_lbl_Sample_JLabel_Right.weightx = 1;
          gbc_lbl_Sample_JLabel_Right.fill = GridBagConstraints.HORIZONTAL;
          gbc_lbl_Sample_JLabel_Right.anchor = GridBagConstraints.LINE_END;
          gbc_lbl_Sample_JLabel_Right.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_ListFields().add(get_lbl_Sample_JLabel_Right(), gbc_lbl_Sample_JLabel_Right);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_txt_Sample_JTextField = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_txt_Sample_JTextField.gridx = 0;
          gbc_txt_Sample_JTextField.gridy = 1;
          gbc_txt_Sample_JTextField.weightx = 1;
          gbc_txt_Sample_JTextField.fill = GridBagConstraints.HORIZONTAL;
          gbc_txt_Sample_JTextField.anchor = GridBagConstraints.LINE_START;
          gbc_txt_Sample_JTextField.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_ListFields().add(get_txt_Sample_JTextField(), gbc_txt_Sample_JTextField);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_combo_Sample_JComboBox = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_combo_Sample_JComboBox.gridx = 0;
          gbc_combo_Sample_JComboBox.gridy = 2;
          gbc_combo_Sample_JComboBox.weightx = 1;
          gbc_combo_Sample_JComboBox.fill = GridBagConstraints.HORIZONTAL;
          gbc_combo_Sample_JComboBox.anchor = GridBagConstraints.LINE_START;
          gbc_combo_Sample_JComboBox.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_ListFields().add(get_combo_Sample_JComboBox(), gbc_combo_Sample_JComboBox);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_chk_Sample_JCheckBox = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_chk_Sample_JCheckBox.gridx = 0;
          gbc_chk_Sample_JCheckBox.gridy = 3;
          gbc_chk_Sample_JCheckBox.weightx = 1;
          gbc_chk_Sample_JCheckBox.fill = GridBagConstraints.HORIZONTAL;
          gbc_chk_Sample_JCheckBox.anchor = GridBagConstraints.LINE_END;
          gbc_chk_Sample_JCheckBox.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_ListFields().add(get_chk_Sample_JCheckBox(), gbc_chk_Sample_JCheckBox);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_rbtn_Sample_JRadioButton_1 = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_rbtn_Sample_JRadioButton_1.gridx = 0;
          gbc_rbtn_Sample_JRadioButton_1.gridy = 4;
          gbc_rbtn_Sample_JRadioButton_1.weightx = 1;
          gbc_rbtn_Sample_JRadioButton_1.fill = GridBagConstraints.HORIZONTAL;
          gbc_rbtn_Sample_JRadioButton_1.anchor = GridBagConstraints.LINE_START;
          gbc_rbtn_Sample_JRadioButton_1.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_ListFields().add(get_rbtn_Sample_JRadioButton_1(), gbc_rbtn_Sample_JRadioButton_1);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_rbtn_Sample_JRadioButton_2 = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_rbtn_Sample_JRadioButton_2.gridx = 0;
          gbc_rbtn_Sample_JRadioButton_2.gridy = 5;
          gbc_rbtn_Sample_JRadioButton_2.weightx = 1;
          gbc_rbtn_Sample_JRadioButton_2.fill = GridBagConstraints.HORIZONTAL;
          gbc_rbtn_Sample_JRadioButton_2.anchor = GridBagConstraints.LINE_END;
          gbc_rbtn_Sample_JRadioButton_2.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_ListFields().add(get_rbtn_Sample_JRadioButton_2(), gbc_rbtn_Sample_JRadioButton_2);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_lbl_Sample_JLabel_Left = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_lbl_Sample_JLabel_Left.gridx = 1;
          gbc_lbl_Sample_JLabel_Left.gridy = 0;
          gbc_lbl_Sample_JLabel_Left.weightx = 1;
          gbc_lbl_Sample_JLabel_Left.fill = GridBagConstraints.HORIZONTAL;
          gbc_lbl_Sample_JLabel_Left.anchor = GridBagConstraints.LINE_START;
          gbc_lbl_Sample_JLabel_Left.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_ListFields().add(get_lbl_Sample_JLabel_Left(), gbc_lbl_Sample_JLabel_Left);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_txt_Sample_JTextArea = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_txt_Sample_JTextArea.gridx = 1;
          gbc_txt_Sample_JTextArea.gridy = 1;
          gbc_txt_Sample_JTextArea.gridwidth = 1;
          gbc_txt_Sample_JTextArea.gridheight = 5;
          gbc_txt_Sample_JTextArea.weightx = 1;
          gbc_txt_Sample_JTextArea.fill = GridBagConstraints.BOTH;
          gbc_txt_Sample_JTextArea.anchor = GridBagConstraints.LINE_START;
          gbc_txt_Sample_JTextArea.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_ListFields().add(get_txt_Sample_JTextArea(), gbc_txt_Sample_JTextArea);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_lst_Sample_JList = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_lst_Sample_JList.gridx = 2;
          gbc_lst_Sample_JList.gridy = 1;
          gbc_lst_Sample_JList.gridwidth = 1;
          gbc_lst_Sample_JList.gridheight = 5;
          gbc_lst_Sample_JList.weightx = 1;
          gbc_lst_Sample_JList.fill = GridBagConstraints.BOTH;
          gbc_lst_Sample_JList.anchor = GridBagConstraints.LINE_START;
          gbc_lst_Sample_JList.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_ListFields().add(get_lst_Sample_JList(), gbc_lst_Sample_JList);
/* 
 * Platzieren des nächsten GUI-Elements. */
          GridBagConstraints gbc_btn_Sample_JButton = new GridBagConstraints();
/* Definition der Platzierungs-Eigenschaften. */
          gbc_btn_Sample_JButton.gridx = 0;
          gbc_btn_Sample_JButton.gridy = 6;
          gbc_btn_Sample_JButton.gridwidth = 3;
          gbc_btn_Sample_JButton.weightx = 1;
          gbc_btn_Sample_JButton.fill = GridBagConstraints.BOTH;
          gbc_btn_Sample_JButton.anchor = GridBagConstraints.LINE_START;
          gbc_btn_Sample_JButton.insets = new Insets(3, 3, 3, 3);
/* Platzieren des GUI-Elements auf dem JPanel. */
          get_pnl_ListFields().add(get_btn_Sample_JButton(), gbc_btn_Sample_JButton);
        }
        catch (Throwable Exc) {
/* Fehler beim 'construct' ist sehr unwahrscheinlich und kann nur beim 'Starten'
 * des Tasks auftreten.
 * Deswegen werden Fehlermeldungen nur auf der Konsole ausgegeben. */
          System.out.println("Error while building pnl_ListFields in class application_task.");
          Exc.printStackTrace();
        }
      }
      return pnl_ListFields;
    }
/*
 * METHODE die ausgeführt wird wenn das Fenster geschlossen wird.
 * In dieser Methode wird:
 * * Die Spaltenbreiten der JTable(s) in die entsprechende (in der geerbten Klasse
 *   definierten) Datenstruktur übertragen damit sie auf der Datenbank gespeichert
 *   werden können.
 * * Die Methode zur Prüfung, ob Daten geändert aber nicht gespeichert wurden,
 *   aufgerufen.
 * * Zuletzt wird die Methode gleichen Namens in der geerbten Klasse aufgerufen;
 *   in dieser wird der für alle Task-Frames gleichbleibende Code ausgeführt. */
    public void windowClosing(WindowEvent e) {
/*
 * 'Art', welche Verarbeitung nach dem Anklicken des 'Close'-Icons des Fensters
 * ausgeführt wird, verändern.
 * Nur so kann im Code abgefragt werden, ob das Fenster wirklich geschlossen werden
 * soll. */
      this.setDefaultCloseOperation(JFrame.DO_NOTHING_ON_CLOSE);
/*
 * Methode aufrufen, die prüft ob die Eingabe-Daten geändert aber nicht gespeichert
 * wurden. Diese Methode liefert nur dann 'false' zurück wenn der Anwender ungespeicherte
 * Daten noch prüfen und eventuell korrigieren will. */
      if (application_task__ActionHandler.checkForUnstoredChanges(this)) {
/* Frame kann geschlossen werden; gleichnamige Methode der geerbten Klasse den Code, der
 * für alle Task-Frames gleich ist, ausführen lassen. */
        super.windowClosing(e);
      }
      else {
/* Anwender hat entschieden, dass das Fenster nicht geschlossen werden soll.
 * Fenster wieder sichtbar machen. */
        this.setVisible(true);
      }
    }
/*
 * METHODE die ausgeführt wird wenn sich der Status eines GUI-Elementes, dem
 * ein 'ItemListener' hinzugefügt ist, ändert. */
    public void itemStateChanged(ItemEvent e) {
/*
 * Zur Verarbeitung des Ereignisses die Methode in der zu dieser Klasse gehörenden
 * 'DocumentListener'-Klasse aufrufen.
 * Grund für die Implementierung des Codes im 'DocumentListener' ist, dass im
 * 'DocumentListener' auch alle Eingabe-Prüfungen und das Aktivieren/Deaktivieren von
 * Schaltflächen implementiert ist. */
      structapplication_task__DocumentListener.itemStateChanged(e);
    }
/*
 * METHODE die ausgeführt wird wenn der Rand einer Spalte verschoben wird.
 * Dieses Ereignis tritt dann auf, wenn der Anwender die Breite der Spalten
 * einer JTable verändert.
 * In dieser Methode werden dann die neuen Spaltenbreiten auf die Datenstruktur,
 * die beim Schliessen des Fensters auf der Datenbank gespeichert wird, übernommen. */
    public void columnMarginChanged(ChangeEvent e) {
/*
 * Weil der Wert von 'bolInhibitColumnMarginChangeStore' auch von parallel laufenden
 * Methoden verändert werden kann wird der gesamte Code in der Methode 'synchronized'
 * ausgeführt. */
      synchronized (this) {
/*
 * Prüfen, ob der Code in dieser Methode überhaupt ausgeführt werden soll.
 * Die Bedeutung von 'bolInhibitColumnMarginChangeStore' ist bei der Definition
 * der Variable (in der geerbten Klasse 'JSBS_TaskFrame') beschrieben. */
        if (bolInhibitColumnMarginChangeStore) return;
/*
 * Gleichnamige Methode der geerbten Klasse aufrufen.
 * Darin werden die Spaltenbreiten der JTable 'pnl_SelectionListTable' (in der geerbten
 * Methode definiert) auf das BO und die Variable
 * 'structJSBS_FramePosition_BOC.ColumnWidthArray01' (ebenfalls in der geerbten Klasse
 * definiert) übertragen. */
        super.columnMarginChanged(e);
/*
 * Wenn weitere JTables verwendet werden, dann kann hier der Code für das Übernehmen
 * der Spaltenbreite auf die Datenstruktur adaptiert werden.   */
        structJSBS_FramePosition_BOC.ColumnWidthArray0x =
              JSBS_GUIServices.getTableColumnWidth(get_pnl_additional_JTable());
      }
    }
/*
 * METHODE die ausgeführt wird wenn ein Klick mit einer Maustaste
 * auf ein GUI-Element, dem der ActionListener hinzugefügt wurde, erfolgt. */
    public void actionPerformed(ActionEvent e) {
/*
 * Gleichnamige Methode in der geerbten Basisklasse aufrufen.
 * Damit werden die 'geerbten' Verarbeitungen (die für alle Anwendungsprogramme
 * gleich sein können) zuerst ausgeführt. */
      super.actionPerformed(e);
/*
 * Weitere Verarbeitung in einer eigenen Klasse mit statischen Methoden. */
      application_task__ActionHandler.handleEvent(this, e);
    }
}