B4J Library jRLDialogsX - Dialogs Library

rwblinn · Mar 30, 2015

jRLDialogsX is an open source B4J Dialogs Library providing a comprehensive set of Dialogs.
The library is coded as a B4J Class with Inline Java, no additional libraries or wrappers required.
Note: Requirements minimum B4J v5.80 and Java JDK v8 (8u40+).

Version: 1.88 - Attached the B4J library, source code, full example.

How to Use

Copy jrldialogsx.jar, jrldialogsxfiles.jar and xml to the B4J additional library folder.
In the B4J project, select jrldialogsx from the B4J IDE Libs tab.
See folder Examples - the fullexample is a must read, get started with the InformationDialog.

Version Control

20221122 (v1.88) NEW: Set button CSS style; AlertSelectionDialog (buttons selection); CustomAlert (hightly configurable dialog) (See Post #91)
20190407 (v1.87) NEW: SimpleFormDialog - DatePicker via option "D"; YesNoCancel dialog - if Cancel text is empty, the cancel button is not created;NEW: ListDialog, ListDialog2 - if DefaultItem = -1 then no item selected;UPD: Documentation & Examples; Published on GitHub
20180326 (v1.86) NEW: ListFindDialog Set or get content of textfield FindItem
20180312 (v1.85) NEW: DidYouKnow2 dialog with prev / next tip buttons; ExtendedDialog Show or hide the less details hyperlink button; UPD: ListFindDialog search field across dialog window, moved buttons OK & cancel down; UPD: Documentation & Examples. See Post #73
20171025 (v1.80) NEW: jRLDialogsXFiles.jar holding additional files from the library Files folder. This file must be located in the B4J Additional Libraries folder.; NEW: ListFindDialog with a find item option - first non Inline Java Dialog (requires jRLDialogsXFiles.jar); UPD: Icons (for dialogs DidYouKnow and LoginDialog2) are included in jRLDialogsXFiles.jar; UPD: LoginDialog and Login2Dialog2 with textfield horizontal grow option; UPD: Documentation & Examples. See Post #60
20170906 (v1.77) UPD: SimpleformDialog set request focus on first field; UPD: Minor changes
20170822 (v1.76) NEW: Library renamed from jRLDialogs8 to jRLDialogsX; UPD: Minor changes
20170802 (v1.75) NEW: PDF Documentation
20170711 (v1.74) NEW: SimpleFormDialog ComboBox Field with field value comma separated string, SimpleFormDialog Property ComboBox editable; UPD: Examples. See Post #60
20170703 (v1.72) NEW:ToastMessageAlert Information,Warning,Error; MessageHTMLDialog3 with OK/Cancel, MessageHTML show/hide details button; UPD: Examples. See Post #58
20170626 (v1.68) NEW:MessageDialog set wrap;SimpleFormDialog set inputfield width;MessageHTMLDialog2;Overview;UPD:Examples. See Post #56
20170620 (v1.65) NEW:Localization Show Details Hyperlink Button for Dialogs Extended, Message, MessageHTML; NEW: Extended Dialog option Message & MessageHTML Dialogs;UPD: Examples. See Post #55
20170612 (v1.62) NEW:SliderDialog; NEW:SimpleFormDialog CheckBox Field; NEW: Extended Dialog option show content expanded; NEW: DoNotAskAgainDialog; UPD: Fields padding removed; UPD: Examples. See Post #53.
20170601 (v1.59) NEW:SimpleFormDialog TextArea Field, option to split form fields; FIX: ConfirmDialog; UPD: Examples. See Post #50.
20170531 (v1.58) NEW:ToastMessage set background and border line color; UPD: Examples. See Post #49.
20170530 (v1.57) NEW:ColorNameDialog and ColorPickerDialog to get Color as Paint; NEW:ToastMessage set font size and border width; UPD:Toastmessage using default colors; UPD:Examples. See Post #47.
20170528 (v1.56) NEW:SimpleFormDialog (create n label:field pairs; field=Text or Password or Numeric); MultiInputFieldDialog (create n label:textfield pairs); IntegerInputDialog; Full Example reworked. See Post #46.
20170525 (v1.53) NEW:TimePicker (24h), TimePicker (12h), TextInputDialog4 (with option to set the width of the textfield, no label used); More examples. See Post #44.
20170522 (v1.50) NEW:String localisation Username Label/Prompt, Password Label/Prompt, OK/Cancel Button, YES/NO Button, Login Button, Select Button. See Post #42.
20160801 (v1.47) UPD:Set default selected item for ChoiceDialog, SelectDialog, ListDialog, and ListDialog2; Example 1 converted to B4J Visual Designer.
20160411 (v1.46) UPD:MessageHTMLDialog handles anchors if defined like href="#myanchor" ... name="myanchor" ...
20151011 (v1.45) UPD:Textfield gets initial focus when openeing dialog TextInputDialog, TextInputDialog2, TextInputDialog3, LoginDialog, LoginDialog2, TextAreaDialog
20150910 (v1.40) NEW:SetParentWindow; FIX: ToastMessage center screen
20150828 (v1.30) NEW:ToastMessage
20150604 (v1.20 )NEW:TextAreaDialog
20150617 (v1.11) UPD:TextInputDialog3 added hint for checking null
20150512 (v1.10) NEW:TextInputDialog3
20150406 (v1.00) NEW:SpinnerIntegerDialog, SpinnerDoubleDialog, SpinnerListDialog
20150405 (v0.90) NEW:TextInputDialog2, DatePickerDialog
20150404 (v0.80) NEW:SelectDialog; FIX: ListDialog, ListDialog2 removed expand option
20150403 (v0.70) NEW:ListDialog, ListDialog2
20150402 (v0.60) NEW:LoginDialog2, DidYouKnowDialog, ExceptionDialog, Message, MessageHTMLDialog
20150401 (v0.50) NEW:ExtendedDialog, LoginDialog
20150331 (v0.40) NEW:YesNoCancelDialog
20150330 (v0.10) NEW:First Version

Simple Example Information Dialog with localized OK Button Text

B4X:

Sub Process_Globals
  ..
  'Define the dialog using jrldialogsX
  Private Dlg As DialogsX
End Sub
Sub AppStart (Form1 As Form, Args() As String)
  ...
  'Init the dialog
  Dlg.Initialize
  'Localize (optional)
  Dlg.OKButtonText = "Thank You"
  'Use the dialog to show Information Dialog
  Dlg.InformationDialog("About", "jRLDialogX Information Dialog Example", "Hello World")
End Sub

rwblinn · Jan 20, 2019

ByteCounter said:
Are all the dialogs/pickers/other UI elements modal, or just the warning one?

Yes, except the ToastMessage and ToastMessageAlert dialogs.

micro · Mar 10, 2019

Hi rwblinn
How I change the icon present on dialog form?
The icon is different, it's not the same as I chose from the designer.
Thanks

rwblinn · Mar 10, 2019

micro said:
Hi rwblinn
How I change the icon present on dialog form?
The icon is different, it's not the same as I chose from the designer.
Thanks

The library makes use of the standard JavaFX Dialogs.
To change the icon, inline Java needs to be changed - which is quite a task for all the dialogs.
In the source code, see method

B4X:

public static Map.MyMap LoginDialog2

for an example.

Please note, as mentioned in post #79, I am not maintaining this library anymore.

Recommendation: Instead this library, use dialogs from the standard XUI library or develop own dialogs class(es) derived from the standard libraries.

Ilya G. · Apr 5, 2019

Can you please add date picker field to SimpleFormDialog

rwblinn · Apr 7, 2019

Update v1.87 (see Post #1)

NEW: SimpleFormDialog - DatePicker via option "D"
NEW: YesNoCancel dialog - if Cancel text is empty, the cancel button is not created
NEW: ListDialog, ListDialog2 - if DefaultItem = -1 then no item selected
NEW: ListFindDialog Set or get content of textfield FindItem
UPD: Documentation & Examples
NEW: Published on GitHub

Note
Although had stopped developing this library further, decided to make few changes and publish on GitHub.
Again, source code of the library is included, feel free to amend further BUT consider to make use of the newest [B4X] XUI libraries (Views, Dialogs).
This library is developed using B4J v731 with JDK 1.8.0_202

thinktank · Dec 17, 2019

nice library, is it possible to set text font, alignment, size properties displayed via Dlg.MessageDialog()? tia

rwblinn · Dec 19, 2019

thinktank said:
is it possible to set text font, alignment, size properties displayed via Dlg.MessageDialog()? tia

This is not possible. Consider using the MessageHTMLDialog or create your own using B4XDialogs from the XUI Views Library.

B4X:

MessageHTMLDialog(Title As String, Content As String)
Title - string to show in the title bar. Content - string with HTML formatted content in an expanded web view.

Example Code Snippet

B4X:

Private Dlg As DialogsX

Dlg.Initialize
Dlg.SetParentWindow(MainForm)
Dlg.OKButtonText = "Close"
Dlg.MessageHTMLDialogShowLessDetailsText = "Show Less..."
Dlg.MessageHTMLDialogShowMoreDetailsText = "Show More..."
Dlg.MessageHTMLDialogDialogExpanded = True
Dim msg As String = "<html><h1>Test Message</h1><hr><p>This is the content. Select OK or cancel to proceed.</p></html>"
Dlg.MessageHTMLDialog("jRLDialogsX Library MessageHTMLDialog example", msg)

thinktank said:
nice library

Thanks, Appreciated.

T201016 · Nov 16, 2022

rwblinn said:
jRLDialogsX is an open source B4J Dialogs Library providing a comprehensive set of Dialogs.

Hi, @rwblinn
I have a question, how can I change the font size in the dialogues presented in the post?
A little example would be nice here.

rwblinn · Nov 17, 2022

T201016 said:
Hi, @rwblinn
How can I change the font size in the dialogues presented in the post?

This is not possible without making (significant) changes to the library.
The library makes (mostly) use of the standard JavaFX dialogs.
An option to style these standard dialogs, is to use an external style sheet with style classes (see below example).
Because the library core is developed with Inline Java, each of the methods has to be changed.

Recommendations
Look at the B4XDialogs as part of the XUI Views instead
OR
if you want to create your own simple dialogs, look at this example:

B4J Example Customized Alert Dialog Type Information:

#Region Project
' B4JHowTo AlertDialogStyle
' Style the standard JavaFX Alert dialog by using an external stylesheet.
' 20221117 rwbl
#End Region
#Region Project Attributes
    #MainFormWidth: 600
    #MainFormHeight: 600
#End Region

Sub Process_Globals
    Private fx As JFX
    Private MainForm As Form
    Private xui As XUI
    Private Button1 As B4XView
End Sub

Sub AppStart (Form1 As Form, Args() As String)
    MainForm = Form1
    MainForm.RootPane.LoadLayout("Layout1")
    MainForm.Show
    Button1_Click
End Sub

Sub Button1_Click
    AlertDialogEx("Title", "Header", $"Content${CRLF}${CRLF}More..."$)
End Sub

'Alert Dialog type INFORMATION with styling for the dialogpane.
'The style is defined in an external stylesheet AlertDialog.css.
Sub AlertDialogEx(title As String, header As String, content As String)
    Dim joAlert As JavaObject
    Dim joAlertType As JavaObject
    
    'Init the AlertType Enum Class
    joAlertType.InitializeStatic("javafx.scene.control.Alert.AlertType")
    'Get the AlertType INFORMATION used to set the Alert Dialog type
    Dim joAlertTypeInfo As JavaObject = joAlertType.RunMethod("valueOf", Array("INFORMATION"))

    'Create a new instance of the Alert Dialog as INFORMATIONType   
    joAlert.InitializeNewInstance("javafx.scene.control.Alert", Array(joAlertTypeInfo))
    
    'Styling - Load the external stylesheet "AlertDialog" located in the files folder.
    Dim joDialogPane As JavaObject = joAlert.RunMethod("getDialogPane", Null)
    joDialogPane.RunMethodJO("getStylesheets", Null).RunMethodJO("add", Array(File.GetUri(File.DirAssets, "AlertDialog.css")))
    'Add the style class
    joDialogPane.RunMethodJO("getStyleClass", Null).RunMethodJO("add", Array("AlertDialog"))

    'Set alert text for the title, header, content
    joAlert.RunMethodJO("setTitle", Array As String(title))
    joAlert.RunMethod("setHeaderText", Array As String(header))
    joAlert.RunMethod("setContentText", Array As String(content))

    'Show the alert dialog and wait for the OK button to be pressed
    If joAlert.RunMethodjo("showAndWait", Null).RunMethod("isPresent", Null)=True Then
        Log("Dialog closed with OK")
    End If
End Sub

AlertDialog External Stylesheet:

// Dialog background color
.AlertDialog{
    -fx-background-color: #FFFFFF;
}

// Header panel
.AlertDialog:header *.header-panel{
    -fx-background-color: #0000FF;
}
// Header label
.AlertDialog:header *.header-panel *.label{
    -fx-font-size: 18px;
    -fx-font-style: italic;
    -fx-text-fill: #FFFFFF;
    -fx-font-weight: bold;
}

// Content label
.AlertDialog > *.label.content{
    -fx-font-size: 18px;
    -fx-font-weight: normal;
}

// Button bar
.AlertDialog > *.button-bar > *.container{
    -fx-background-color: #D3D3D3;
}

T201016 · Nov 20, 2022

Hello, @rwblinn

I've included a slightly reworked source code that works for my needs. I especially wanted to change the font in the description dialog and the frameless window.

Class Module DialogsX:

'Returns: Integer with Yes = 1, No = 0, Cancel = -1.
Public Sub Dialog(Title As String , Header As String, Content As String) As Int
    Return joInlineJava.RunMethod("YesNoCancelDialog", Array(Title, Header, Content))
End Sub

YesNoCancelDialog:

public static int YesNoCancelDialog(String mtitle, String mheader, String mcontent) {
    Alert alert = new Alert(AlertType.CONFIRMATION);
    alert.setTitle(mtitle);
    alert.setHeaderText(mheader);
    alert.initStyle(StageStyle.TRANSPARENT);
    alert.getDialogPane().setStyle("-fx-background-color: #e2e2e2; -fx-border-color: DarkSlateGray; -fx-border-width: 2; -fx-border-radius: 0;");
    
    Label lbl = new Label(mcontent);
    lbl.setAlignment(Pos.CENTER_LEFT);
    lbl.setStyle("-fx-font-size: 13px;");
    lbl.setWrapText(true);
    alert.getDialogPane().setContent(lbl);

    ButtonType buttonTypeYes = new ButtonType(mYesButtonText, ButtonBar.ButtonData.YES);
    ButtonType buttonTypeNo = new ButtonType(mNoButtonText, ButtonBar.ButtonData.NO);
    if(!mCancelButtonText.isEmpty()) {
        ButtonType buttonTypeCancel = new ButtonType(mCancelButtonText, ButtonBar.ButtonData.CANCEL_CLOSE);
        alert.getButtonTypes().setAll(buttonTypeYes, buttonTypeNo, buttonTypeCancel);
    } else {
        alert.getButtonTypes().setAll(buttonTypeYes, buttonTypeNo);
    }
    alert.initOwner(parentWindow);
    Optional<ButtonType> result = alert.showAndWait();
    if (result.get() == buttonTypeYes){
        return 1;
    } else if (result.get() == buttonTypeNo) {
        return 0;
    } else {
        return -1;
    }
};

rwblinn · Nov 22, 2022

Update v1.88 (see Post #1)

NEW: Set button CSS style - Example: Dlg.OKButtonStyle = "-fx-font-size: 24px;-fx-background-color: indianred;"
NEW: AlertSelectionDialog - Alert dialog with buttons selection option
NEW: CustomAlertDialog - Hightly configurable alert dialog
UPD: Documentation & Examples

Note
Although stopped developing this library further, got inspired by post #88 (thanks for the trigger) .
Again, source code of the library is included, feel free to amend.
This library is developed using B4J 9.80 (64 bit) and Java JDK 11.

Example CustomAlertDialog

CustionAlertDialog - Warning:

Private Sub WarningDialog
    Dim DialogStyle As String = "-fx-background-color: navy; -fx-border-color: DarkSlateGray; -fx-border-width: 2; -fx-border-radius: 0;"
    Dim HeaderStyle As String = "-fx-background-color: #FFFF00; -fx-font-style: italic; -fx-font-size: 24px;-fx-text-fill: #FF0000; -fx-font-weight: bold;"
    Dim ContentStyle As String = "-fx-background-color: white; -fx-font-size: 33px;-fx-text-fill: #0000FF; -fx-font-weight: bold;"
    Dlg.CustomAlertDialog("WARNING", "Title", "Warning", $"Content${CRLF}..."$, -1, -1, "UTILITY", DialogStyle, HeaderStyle, ContentStyle, "OK", "", "", "-fx-background-color: #FF0000; -fx-text-fill: #FFFFFF; -fx-font-weight: bold;", "", "")
End Sub

B4J Library jRLDialogsX - Dialogs Library

Attachments

rwblinn

Well-Known Member

micro

Well-Known Member

rwblinn

Well-Known Member

Ilya G.

Active Member

rwblinn

Well-Known Member

thinktank

Member

rwblinn

Well-Known Member

T201016

Active Member

rwblinn

Well-Known Member

T201016

Active Member

rwblinn

Well-Known Member

Similar Threads

B4J Library jRLDialogsX - Dialogs Library

Attachments

Well-Known Member

Well-Known Member

Well-Known Member

Active Member

Well-Known Member

Member

Well-Known Member

Active Member

Well-Known Member

Active Member

Well-Known Member

Similar Threads

Privacy & Transparency

Privacy & Transparency