de.ipcon.gui

Class ClientWindowLifecycleHandler

java.lang.Object

de.ipcon.gui.AbstractClientHelper

de.ipcon.gui.ClientWindowLifecycleHandler

All Implemented Interfaces:

java.awt.event.WindowListener, java.util.EventListener

public class ClientWindowLifecycleHandler
extends AbstractClientHelper
implements java.awt.event.WindowListener

Adapts native AWT/Swing window lifecycle events for the client main frame.

Translates frame-level closing, activation and deactivation events into client shutdown hooks, state persistence triggers and focus delegation workflows.

See Also:

WindowListener

Constructor Summary

Constructors

Constructor and Description
ClientWindowLifecycleHandler(Client _client)

Method Summary

Modifier and Type	Method and Description
void	addVisualComponent(javax.swing.JComponent c, java.lang.String position)
void	addVisualComponent(java.lang.String container, javax.swing.JComponent c, java.lang.String position)
void	endWaitFeedback()
void	exportSystemObjectsNG()
de.ipcon.swing.WindowState	getLiveWindowState() Captures the live geometry, state, and scale of the active mainframe window.
java.awt.Image	getLogo() Returns the primary application logo image, loaded from the classpath.
javax.swing.JFrame	getMainFrame()
static java.awt.Font	getStandardEditorFont() Returns a "good" monospaced font for the editor component.
java.lang.String	getUniquePrefix() Returns the unique prefix for the window-title, only being applied for OS-managed windows when using the ClientNativeWindowManager.
static java.lang.String	getWindowTitle(BO bo, java.lang.String explicitDescription, boolean skipEntity) Constructs a formatted window title for a business object.
void	importSystemObjectsNG()
void	initMainFrame(de.ipcon.swing.WindowState lastWindowState) Constructs and styles the primary desktop frame, configures root panes, sets dialog parents, and applies initial window geometry and extended state.
void	registerClientContainer(java.lang.String name, ClientContainerI cc)
void	setDefaultFocusOwner(javax.swing.JComponent c)
void	setEmptyMDIFocus()
void	setMenuBar(javax.swing.JMenuBar mb)
void	setMultiWindowManager() Switches the desktop layout to multi-window manager mode.
void	setSingleWindowManager() Switches the desktop layout to single-window manager mode.
void	setUniquePrefix(java.lang.String p)
void	showAboutDialog()
void	showFlatlafInspector()
void	showFlatUIDefaultsInspector()
void	showGroovyConsole()
void	showHelpDialog()
void	showImportLicenseTemplate()
void	showL10nBundlesBookmark()
void	showLocaleSelectionDialog()
void	showPasswordChangeForm()
void	showReportIssueForm(BO sourceBO, Struktur sourceStruktur, java.awt.event.ActionEvent ae)
void	showReportIssueForm(java.awt.image.BufferedImage screenshot, java.lang.String stackTrace, java.lang.String shownError)
void	showSchemaTool()
void	showServerConsole()
void	showSyncNG()
void	startWaitFeedback()
void	takeScreenshot(java.awt.event.ActionEvent ae) Captures the current mainframe or desktop bounds, renders it to an image, and prompts the user to save.
void	toFront()
void	tryCleanupBeforeClose()
void	updateTitle() Sets the user-definable latter part of the title of the main client-window to the value stored in the
void	updateTitle(java.lang.String userTitleString) Sets the user-definable latter part of the title of the main client-window to the passed String.
void	windowActivated(java.awt.event.WindowEvent e)
void	windowClosed(java.awt.event.WindowEvent e)
void	windowClosing(java.awt.event.WindowEvent e)
void	windowDeactivated(java.awt.event.WindowEvent e)
void	windowDeiconified(java.awt.event.WindowEvent e)
void	windowIconified(java.awt.event.WindowEvent e)
void	windowOpened(java.awt.event.WindowEvent e)
void	zoomIn()
void	zoomOut()
void	zoomReset()

Methods inherited from class de.ipcon.gui.AbstractClientHelper

client

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ClientWindowLifecycleHandler

public ClientWindowLifecycleHandler(Client _client)

Method Detail

getStandardEditorFont

public static java.awt.Font getStandardEditorFont()

Returns a "good" monospaced font for the editor component.

Returns:

a suitable monospaced font for the editor component.

tryCleanupBeforeClose

public void tryCleanupBeforeClose()

getUniquePrefix

public java.lang.String getUniquePrefix()

Returns the unique prefix for the window-title, only being applied for OS-managed windows when using the ClientNativeWindowManager.

setUniquePrefix

public void setUniquePrefix(java.lang.String p)

getMainFrame

public javax.swing.JFrame getMainFrame()

setMenuBar

public void setMenuBar(javax.swing.JMenuBar mb)

setDefaultFocusOwner

public void setDefaultFocusOwner(javax.swing.JComponent c)

setEmptyMDIFocus

public void setEmptyMDIFocus()

addVisualComponent

public void addVisualComponent(javax.swing.JComponent c,
                               java.lang.String position)

addVisualComponent

public void addVisualComponent(java.lang.String container,
                               javax.swing.JComponent c,
                               java.lang.String position)

registerClientContainer

public void registerClientContainer(java.lang.String name,
                                    ClientContainerI cc)

initMainFrame

public void initMainFrame(de.ipcon.swing.WindowState lastWindowState)

Constructs and styles the primary desktop frame, configures root panes, sets dialog parents, and applies initial window geometry and extended state.

updateTitle

public void updateTitle()

Sets the user-definable latter part of the title of the main client-window to the value stored in the

See Also:

of the current user named "mainframe.title". If such an EinstellungenVariable does not exist or is empty, the user-definable part falls back to the l10n-ed description of the currently logged in user.

updateTitle

public void updateTitle(java.lang.String userTitleString)

Sets the user-definable latter part of the title of the main client-window to the passed String. If no String is passed, the user-definable part defaults to the value stored in the

See Also:

of the current user named "mainframe.title". If such an EinstellungenVariable does not exist or is empty, the user-definable part falls back to the l10n-ed description of the currently logged in user.

getLiveWindowState

public de.ipcon.swing.WindowState getLiveWindowState()

Captures the live geometry, state, and scale of the active mainframe window.

Returns:

current WindowState, or null if the mainframe is not initialized

toFront

public void toFront()

startWaitFeedback

public void startWaitFeedback()

endWaitFeedback

public void endWaitFeedback()

showFlatUIDefaultsInspector

public void showFlatUIDefaultsInspector()

showFlatlafInspector

public void showFlatlafInspector()

zoomIn

public void zoomIn()

zoomReset

public void zoomReset()

zoomOut

public void zoomOut()

showSyncNG

public void showSyncNG()

exportSystemObjectsNG

public void exportSystemObjectsNG()

importSystemObjectsNG

public void importSystemObjectsNG()

showL10nBundlesBookmark

public void showL10nBundlesBookmark()

showSchemaTool

public void showSchemaTool()

showServerConsole

public void showServerConsole()

showGroovyConsole

public void showGroovyConsole()

showAboutDialog

public void showAboutDialog()

showHelpDialog

public void showHelpDialog()

showLocaleSelectionDialog

public void showLocaleSelectionDialog()

showPasswordChangeForm

public void showPasswordChangeForm()

showImportLicenseTemplate

public void showImportLicenseTemplate()

showReportIssueForm

public void showReportIssueForm(BO sourceBO,
                                Struktur sourceStruktur,
                                java.awt.event.ActionEvent ae)

showReportIssueForm

public void showReportIssueForm(java.awt.image.BufferedImage screenshot,
                                java.lang.String stackTrace,
                                java.lang.String shownError)

takeScreenshot

public void takeScreenshot(java.awt.event.ActionEvent ae)

Captures the current mainframe or desktop bounds, renders it to an image, and prompts the user to save.

getWindowTitle

public static java.lang.String getWindowTitle(BO bo,
                                              java.lang.String explicitDescription,
                                              boolean skipEntity)
                                       throws java.lang.IllegalArgumentException

Constructs a formatted window title for a business object.

Parameters:

bo - the business object; must not be null

explicitDescription - optional description format/pattern; may be null

skipEntity - if true, suppresses the entity prefix

Returns:

formatted title string

Throws:

java.lang.IllegalArgumentException - if bo is null

setSingleWindowManager

public void setSingleWindowManager()

Switches the desktop layout to single-window manager mode.

Updates profile plugin configuration via ClientProfileSettingsHelper.applySingleWindowManagerLayout() and triggers re-initialization of the desktop workspace.

setMultiWindowManager

public void setMultiWindowManager()

Switches the desktop layout to multi-window manager mode.

Updates profile plugin configuration via ClientProfileSettingsHelper.applyMultiWindowManagerLayout() and triggers re-initialization of the desktop workspace.

getLogo

public java.awt.Image getLogo()

Returns the primary application logo image, loaded from the classpath.

Returns:

the application Image, or null if no logo asset is found

windowOpened

public void windowOpened(java.awt.event.WindowEvent e)

Specified by:

windowOpened in interface java.awt.event.WindowListener

windowClosing

public void windowClosing(java.awt.event.WindowEvent e)

Specified by:

windowClosing in interface java.awt.event.WindowListener

windowClosed

public void windowClosed(java.awt.event.WindowEvent e)

Specified by:

windowClosed in interface java.awt.event.WindowListener

windowIconified

public void windowIconified(java.awt.event.WindowEvent e)

Specified by:

windowIconified in interface java.awt.event.WindowListener

windowDeiconified

public void windowDeiconified(java.awt.event.WindowEvent e)

Specified by:

windowDeiconified in interface java.awt.event.WindowListener

windowActivated

public void windowActivated(java.awt.event.WindowEvent e)

Specified by:

windowActivated in interface java.awt.event.WindowListener

windowDeactivated

public void windowDeactivated(java.awt.event.WindowEvent e)

Specified by:

windowDeactivated in interface java.awt.event.WindowListener