Differences

This shows you the differences between two versions of the page.

--- jvx:client:gui:custom_dialog [2018/02/01 13:34]
admin
+++ jvx:client:gui:custom_dialog [2025/08/20 10:01] (current)
admin
@@ Line 1: / Line 1: @@
 ~~NOTRANS~~
-~~Title: Open a custom dialog~~
+~~Title: Open a Custom Dialog~~
-Sometimes you want to show dialogues instead of work-screens because a dialog is a simple popup that shows details about a selected record or requests input from the user. Another reason could be, that a work-screen shows different dialogues on button clicks.
+Sometimes you want to show dialogues instead of workscreens because a dialog is a simple popup that shows details about a selected record or requests input from the user. Another reason could be that a workscreen shows different dialogues on button clicks.
-It's very easy to show a dialog in your application or work-screen. Use the Dialog class and use it as follows:
+It's very easy to show a dialog in your application or workscreen. Use the dialog class and use it as follows:
 <file java>
@@ Line 18: / Line 18: @@
 //dialog with Ok button
 Dialog dlg = new Dialog(panContent);
+dlg.setTitle("Dialog test");
+dlg.setModal(true);
 //show dialog as frame
-Dialog.openInternalFrame(this, "Dialog test", true, dlg);
+Dialog.openInternalFrame(getApplication());
 </file>
-The Dialog itself is a Content and can be used without internal frames as well. It depends on your IApplication implementation if you use an internal frame or the content itself.
+The dialog itself is a content and can be used without internal frames as well. It depends on your IApplication implementation: if you use an internal frame or the content itself.
-The class supports OK, Cancel buttons and allows user-defined buttons instead of default buttons.
+The class supports OK and cancel buttons and allows user-defined buttons instead of default buttons.
 The title is an optional attribute. If you don't set the title, the name of the dialog will be used. The dialog itself has a default preferred size. You should change the default setting if you need a different size.
-Above dialog looks like this:
+The above dialog looks like this:
 {{:jvx:client:gui:dialog.png?nolink|}}
-With Ok and Cancel:
+With Ok and cancel:
 {{:jvx:client:gui:dialog_ok_cancel.png?nolink|}}
+\\
+\\
+Here's an example dialog:
+<file java>
+private UINumberField nfValue;
+public void doShowDialog()
+{
+    nfValue = new UINumberField();
+    nfValue.setPrecision(3);
+    nfValue.setScale(0);
+    UIFormLayout flDialog = new UIFormLayout();
+    UIPanel panDialog = new UIPanel(flDialog);
+    panDialog.add(new UILabel("Value"), flDialog.getConstraints(0, 0));
+    panDialog.add(nfValue, flDialog.getConstraints(1, 0, -1, 0));
+    panDialog.setPreferredSize(200, 40);
+    Dialog dialog = new Dialog(panDialog);
+    dialog.setModal(true);
+    dialog.setTitle("Enter a numeric value");
+    dialog.setPreferredSize(null);
+    dialog.getOkButton().eventAction().addListener(this::doAfterDialog);
+    dialog.open(getApplication());
+}
+public void doAfterDialog()
+{
+    showInformation("Value = " + nfValue.getValue());
+}
+</file>
+The dialog can be opened by button press or another action. It opens a simple dialog which shows a label and a number field. The number can be max. 3 digits. If you press OK button in the dialog, an information message with the entered number will be shown.