XdevTabbedPane

Anfang  Zurück  Vor

Letzte Änderung 13.02.2014

 

Die Komponente XdevTabbedPane ist ein Container für XdevTabs. XdevTabs funktionieren prinzipiell wie Registerblätter. Jedes einzelne Registerblatt (XdevTab) setzt sich aus einem Button sowie aus einem angehängten Container zusammen. Dadurch funktionieren Beschriftung und Icon-Zuweisung genauso wie bei der Komponente XdevButton und wie bei einem herkömmlichen XdevContainer lassen sich beliebige Komponenten in ein Tab einfügen, völlig frei darin positionieren oder layouten. Jedes XdevTab stellt im Grunde eine eigenständige GUI-Komponente dar.

 

Ein XdevTabbedPane muss jedoch nicht extra konstruiert werden. Die Komponente ordnet alle Tabs selbständig an und steuert zudem deren Interaktion. Sie müssen lediglich die gewünschte Anzahl an Tabs hinzufügen. Reicht der Platz nicht mehr aus, um alle Tabs in einer Zeile unterzubringen, werden die Tabs automatisch in eine neue Zeile umgebrochen. Alternativ zum Umbruch lässt sich eine Scrollfunktion aktivieren. Über das Kontextmenü können Sie weitere Tabs hinzufügen, löschen oder deren Reihenfolge vertauschen.

 

Selektieren lassen sich XdevTabbedPane und dessen einzelne Tabs am einfachsten in der Übersicht.

 

 

clip0058

 

 

clip0386

 

 

 

Wichtige Eigenschaften

 

Tab-Position - Die Tabs eines XdevTabbedPanes lassen sich nicht nur oben, sondern wahlweise auch links, rechts und unten anordnen.


clip0052

 

clip0053

 

 

Orientierung: Oben

 

Orientierung: Unten

 

 

 

 

 

 

 

clip0054

 

clip0055

 

 

Orientierung: Links

 

Orientierung: Rechts

 

 

 

 

 

 

Tab-Verhalten - Wenn die Breite des XdevTabPanes nicht für die Darstellung aller Tabs ausreicht, werden die Tabs je nach Einstellung automatisch in die nächste Zeile umgebrochen oder horizontal gescrollt.


clip0056

 

clip0057

 

 

Tab-Verhalten: Umbrechen

 

Tab-Verhalten: Scrollen

 

 

 

 

Tabs deaktivieren

 

Die Tabs eines XdevTabbedPanes lassen sich nicht wie andere GUI-Komponenten deaktivieren bzw. aktivieren sondern nur vollständig entfernen und wieder hinzufügen.  Entfernen lässt sich ein XdevTab mit der Methode removeTabAt( ). Als Parameter muss der Index des zu  entfernenden Tabs übergeben werden.

 

tabbedPane.removeTabAt(0);

 

Umgekehrt lassen sich XdevTabs mit der Methode addTab( ) wieder hinzufügen.

 

Wichtigste Methoden

 

addTab

 

Fügt der XdevTabbedPane einen Tab hinzu.

 

Wichtigste Überladungen:

addTab(XdevTab tab)

tab - Der XdevTab, welcher der XdevTabbedPane hinzugefügt werden soll. Dieser wird nach allen bereits existierenden Tabs

// Hier wird ein neuer XdevTab erzeugt und dessen Attribute gesetzt
XdevTab tab = new XdevTab();
tab.setTitle("Neuer Tab");
tab.setIndex(2);
 
// Der XdevTab wird der XdevTabbedPane hinzugefügt
tabbedPane.addTab(tab);

 

Eine weiterführende Dokumentation zu XdevTabs finden Sie hier: XAPI Dokumentation.

 

addTab(String title, Component component)

title - Der Titel des Tabs, welcher in der XdevTabbedPane angezeigt wird.

component - Die Komponente, die angezeigt wird, wenn der Tab angewählt ist.

// Hier wird ein neuer Tab erzeugt, welcher den Titel "Neuer Tab" trägt und als Inhalt die Komponente "MyContainer" anzeigt.
tabbedPane.addTab("Neuer Tab",new MyContainer());

 

addTab(String title, Icon icon, Component component)

title - Der Titel des Tabs, welcher in der XdevTabbedPane angezeigt wird.

icon - Das Icon, welches vor dem Titel des Tabs angezeigt wird.

component - Die Komponente, die angezeigt wird, wenn der Tab angewählt ist.

// Das ImageIcon-Objekt wird erzeugt
ImageIcon icon = new ImageIcon("res/images/icon.png");
 
// Hier wird ein neuer Tab erzeugt, welcher den Titel "Neuer Tab" trägt und als Inhalt die Komponente "MyContainer" anzeigt.
// Zudem wird dem Tab "icon" als Icon zugewiesen
tabbedPane.addTab("Neuer Tab", icon, new MyContainer());

 

addTab(String title, Icon icon, Component component, String tip)

title - Der Titel des Tabs, welcher in der XdevTabbedPane angezeigt wird.

icon - Das Icon, welches vor dem Titel des Tabs angezeigt wird.

component - Die Komponente, die angezeigt wird, wenn der Tab angewählt ist.

tip - Der Tooltip, der als Mouseovereffekt angezeigt wird.

// Das ImageIcon-Objekt wird erzeugt
ImageIcon icon = new ImageIcon("res/images/icon.png");
 
// Hier wird ein neuer Tab erzeugt, welcher den Titel "Neuer Tab" trägt und als Inhalt die Komponente "MyContainer" anzeigt.
// Zudem wird dem Tab "icon" als Icon zugewiesen und "Dies ist ein neuer Tab" als Tooltip festgelegt
tabbedPane.addTab("Neuer Tab", icon, new MyContainer(), "Dies ist ein neuer Tab");

 

 

removeTabAt(int index)

 

Mit dieser Methode wird der XdevTab mit dem übergebenen Index von der XdevTabbedPane entfernt.

index - Der Index des XdevTabs, welcher entfernt werden soll.

// Entfernt den XdevTab mit dem Index "2" von der XdevTabbedPane
tabbedPane.removeTabAt(2);

 

 

getTabAt(int index) : Component

 

Diese Methode gibt den XdevTab zurück, welcher an der Position des übergebenen Index ist.

index - Der Index des gewünschten XdevTabs.

Rückgabewert: Der XdevTab an der Position des übergebenen Index.

// Gibt den Tab mit dem Index 1 zurück
tabbedPane.getTabAt(1);

 

getSelectedComponent() : Component

 

Diese Methode gibt den ausgewählten XdevTab zurück.

Rückgabewert: Der gerade ausgewählte XdevTab.

// Gibt den gerade ausgewählten XdevTab zurück
Component tab = tabbedPane.getSelectedComponent();