com.teamdev.jxbrowser.chromium

Interface DialogHandler

All Known Implementing Classes:

DefaultDialogHandler, DefaultDialogHandler

public interface DialogHandler

Allows handling browser dialogs such as JavaScript alert, confirmation and prompt.

允许处理浏览器对话框，例如JavaScript警报，确认和提示。

Method Summary

Modifier and Type	Method and Description
void	onAlert(DialogParams params) This method is invoked when JavaScript alert dialog should be displayed. 当显示JavaScript警报对话框时，将调用此方法。
CloseStatus	onBeforeUnload(UnloadDialogParams params) This method is invoked before web page unload. 在网页卸载之前调用此方法。
CloseStatus	onColorChooser(ColorChooserParams params) This method is invoked when user selects HTML5 input element with type=color. 当用户选择type = color的HTML5输入元素时，将调用此方法。
CloseStatus	onConfirmation(DialogParams params) This method is invoked when JavaScript confirmation dialog should be displayed. 当显示JavaScript确认对话框时，将调用此方法。
CloseStatus	onFileChooser(FileChooserParams params) This method is invoked when file selection is to be done. 当选择文件时将调用此方法。
CloseStatus	onPrompt(PromptDialogParams params) This method is invoked when JavaScript prompt dialog should be displayed. 当显示JavaScript提示对话框时，将调用此方法。
CloseStatus	onReloadPostData(ReloadPostDataParams params) This method is invoked when attempt to reload a web page that has POST data and the user must confirm whether POST data must be sent again or reload must be canceled. 当尝试重新加载具有POST数据的网页时，将调用此方法，并且用户必须确认是否必须重新发送POST数据或必须取消重新加载。
CloseStatus	onSelectCertificate(CertificatesDialogParams params) This method is invoked when web server requires authorization via SSL client certificate. 当Web服务器需要通过SSL客户端证书进行授权时，将调用此方法。

Method Detail

onAlert

void onAlert(DialogParams params)

This method is invoked when JavaScript alert dialog should be displayed. In this method you can display standard Java modal dialog with the message that you can get from params. Please note that it's not necessary to display modal dialog in this method.

While this method is executed the Browser and JavaScript main threads will be blocked. Right after this method returns, Browser and JavaScript main threads continue their execution. It means that while this method is blocked, you cannot use any Browser functionality and you will not receive any events from Browser component. If you block this method forever, the whole Browser functionality will be blocked forever as well.

当显示JavaScript警报对话框时，将调用此方法。在这种方法中，您可以显示标准Java模式对话框，以及可以从params中获取的消息。请注意，在这种方法中不必显示模式对话框。执行此方法时，浏览器和JavaScript主线程将被阻止。此方法返回后，浏览器和JavaScript主线程会立即继续执行。这意味着在阻止此方法的同时，您将无法使用任何浏览器功能，也不会从浏览器组件接收任何事件。如果您永远阻止此方法，则整个浏览器功能也将永远被阻止。

Parameters:

params - the alert dialog parameters. -警报对话框参数。

onConfirmation

CloseStatus onConfirmation(DialogParams params)

This method is invoked when JavaScript confirmation dialog should be displayed. In this method you can display standard Java modal dialog with the message that you can get from params. Please note that it's not necessary to display modal dialog in this method.

While this method is executed the Browser and JavaScript main threads will be blocked. Right after this method returns, Browser and JavaScript main threads continue their execution. It means that while this method is blocked, you cannot use any Browser functionality and you will not receive any events from Browser component. If you block this method forever, the whole Browser functionality will be blocked forever as well.

当显示JavaScript确认对话框时，将调用此方法。在这种方法中，您可以显示标准Java模式对话框，以及可以从params中获取的消息。请注意，在这种方法中不必显示模式对话框。执行此方法时，浏览器和JavaScript主线程将被阻止。此方法返回后，浏览器和JavaScript主线程会立即继续执行。这意味着在阻止此方法的同时，您将无法使用任何浏览器功能，也不会从浏览器组件接收任何事件。如果您永远阻止此方法，则整个浏览器功能也将永远被阻止。

Parameters:

params - the confirmation dialog parameters. -确认对话框参数。

Returns:

CloseStatus.OK when dialog was closed successfully or CloseStatus.CANCEL when dialog was canceled. 对话框成功关闭时或对话框取消时的时间。

onPrompt

CloseStatus onPrompt(PromptDialogParams params)

This method is invoked when JavaScript prompt dialog should be displayed. In this method you can display standard Java modal dialog with the message and with text field with default prompt text that you can get from params. Please note that it's not necessary to display modal dialog in this method.

The prompt dialog contains a text field with prompt text. User can input any text in this text field. To provide the new prompt text back to JavaScript use the PromptDialogParams.setPromptText(String) method.

While this method is executed the Browser and JavaScript main threads will be blocked. Right after this method returns, Browser and JavaScript main threads continue their execution. It means that while this method is blocked, you cannot use any Browser functionality and you will not receive any events from Browser component. If you block this method forever, the whole Browser functionality will be blocked forever as well.

当显示JavaScript提示对话框时，将调用此方法。在这种方法中，您可以显示标准Java模态对话框，其中包含消息以及带有可以从params中获取的默认提示文本的文本字段。请注意，在这种方法中不必显示模式对话框。提示对话框包含带有提示文本的文本字段。用户可以在此文本字段中输入任何文本。要将新的提示文本提供回JavaScript，请使用PromptDialogParams.setPromptText（String）方法。执行此方法时，浏览器和JavaScript主线程将被阻止。此方法返回后，浏览器和JavaScript主线程会立即继续执行。这意味着在阻止此方法的同时，您将无法使用任何浏览器功能，也不会从浏览器组件接收任何事件。如果您永远阻止此方法，则整个浏览器功能也将永远被阻止。

Parameters:

params - the prompt dialog parameters such as dialog message and default prompt text. -提示对话框参数，例如对话框消息和默认提示文本。

Returns:

CloseStatus.OK when dialog was closed successfully or CloseStatus.CANCEL when dialog was canceled. 对话框成功关闭时或对话框取消时的时间。

onFileChooser

CloseStatus onFileChooser(FileChooserParams params)

This method is invoked when file selection is to be done. You can use this method to display a file chooser dialog with the required type that you can find out from the FileChooserParams.getMode() method.

Please note that it's not necessary to display file chooser dialog in this method. You can set the path to the selected file manually via FileChooserParams.setSelectedFiles(File...) method.

To provide the selected file path use the FileChooserParams.setSelectedFiles(File...) method.

While this method is executed the Browser main threads will be blocked. Right after this method returns, Browser main threads continue their execution. It means that while this method is blocked, you cannot use any Browser functionality and you will not receive any events from Browser component. If you block this method forever, the whole Browser functionality will be blocked forever as well.

当选择文件时将调用此方法。您可以使用此方法显示具有所需类型的文件选择器对话框，您可以从FileChooserParams.getMode（）方法中找到该对话框。请注意，在这种方法中不必显示文件选择器对话框。您可以通过FileChooserParams.setSelectedFiles（File ...）方法手动设置所选文件的路径。要提供选定的文件路径，请使用FileChooserParams.setSelectedFiles（File ...）方法。执行此方法时，浏览器主线程将被阻止。此方法返回后，浏览器主线程会立即继续执行。这意味着在阻止此方法的同时，您将无法使用任何浏览器功能，也不会从浏览器组件接收任何事件。如果您永远阻止此方法，则整个浏览器功能也将永远被阻止。

Parameters:

params - the file chooser dialog parameters such as dialog mode that you can get from FileChooserParams.getMode(). -文件选择器对话框参数，例如可以从中获得的对话框模式。

Returns:

CloseStatus.OK when dialog was closed successfully or CloseStatus.CANCEL when dialog was closed via Cancel button. 对话框成功关闭时或通过“取消”按钮关闭对话框时。

onBeforeUnload

CloseStatus onBeforeUnload(UnloadDialogParams params)

This method is invoked before web page unload. Some web page may override the window.onbeforeunload JavaScript function, so that a confirmation dialog will be shown every time when user try to reload web page or navigate to another web page. You can use this method to display an appropriate confirmation message dialog to ask user whether he or she really wants to leave or reload the web page. To find out whether web page will be reloaded you can check the UnloadDialogParams.isReload() method.

While this method is executed the Browser main threads will be blocked. Right after this method returns, Browser main threads continue their execution. It means that while this method is blocked, you cannot use any Browser functionality and you will not receive any events from Browser component. If you block this method forever, the whole Browser functionality will be blocked forever as well.

在网页卸载之前调用此方法。某些网页可能会覆盖window.onbeforeunload JavaScript函数，因此，每次用户尝试重新加载网页或导航到另一个网页时，都会显示一个确认对话框。您可以使用此方法显示适当的确认消息对话框，以询问用户他或她是否真的要离开或重新加载网页。若要确定是否将重新加载网页，可以检查UnloadDialogParams.isReload（）方法。执行此方法时，浏览器主线程将被阻止。此方法返回后，浏览器主线程会立即继续执行。这意味着在阻止此方法的同时，您将无法使用任何浏览器功能，也不会从浏览器组件接收任何事件。如果您永远阻止此方法，则整个浏览器功能也将永远被阻止。

Parameters:

params - the unload dialog parameters such as dialog message and reload flag. -卸载对话框参数，例如对话框消息和重新加载标志。

Returns:

CloseStatus.OK when web page can be unloaded or CloseStatus.CANCEL when unload operation must be canceled. 何时可以卸载网页或必须取消卸载操作。

onSelectCertificate

CloseStatus onSelectCertificate(CertificatesDialogParams params)

This method is invoked when web server requires authorization via SSL client certificate. To access the list of the certificates from the system storage that match the server criteria you can use the CertificatesDialogParams.getCertificates() method. To inform the web server to use a specific client certificate use the CertificatesDialogParams.setSelectedCertificate(Certificate) method. The Certificate can be one of the certificates from the list, or you can construct it from an existing X509Certificate instance using the corresponding constructor Certificate.Certificate(X509Certificate)

You can use this method to display a dialog with a list of available certificates that allows end user to select the required certificate manually or cancel SSL authorization.

当Web服务器需要通过SSL客户端证书进行授权时，将调用此方法。要访问与服务器标准匹配的系统存储中的证书列表，可以使用CertificatesDialogParams.getCertificates（）方法。要通知Web服务器使用特定的客户端证书，请使用CertificatesDialogParams.setSelectedCertificate（Certificate）方法。证书可以是列表中的证书之一，也可以使用相应的构造函数Certificate.Certificate（X509Certificate）从现有X509Certificate实例构造它。可以使用此方法显示一个对话框，其中列出了可用的证书，这些证书可以终止用户手动选择所需的证书或取消SSL授权。

Parameters:

params - use it to get information about SSL authorization request, get a list of available certificates and select the required one. -使用它来获取有关SSL授权请求的信息，获取可用证书的列表，然后选择所需的证书。

Returns:

CloseStatus.OK when certificate is selected or CloseStatus.CANCEL when authorization must be canceled. 选择证书或必须取消授权时。

onReloadPostData

CloseStatus onReloadPostData(ReloadPostDataParams params)

This method is invoked when attempt to reload a web page that has POST data and the user must confirm whether POST data must be sent again or reload must be canceled.

You can use this method to display confirmation dialog where you ask user whether web page can be reloaded or not.

当尝试重新加载具有POST数据的网页时，将调用此方法，并且用户必须确认是否必须重新发送POST数据或必须取消重新加载。您可以使用此方法显示确认对话框，在此询问用户是否可以重新加载网页。

Parameters:

params - the reload dialog parameters. -重新加载对话框参数。

Returns:

CloseStatus.OK when reloading is confirmed or CloseStatus.CANCEL when reloading must be canceled. 确认重新加载时或必须取消重新加载时。

onColorChooser

CloseStatus onColorChooser(ColorChooserParams params)

This method is invoked when user selects HTML5 input element with type=color. You can use this method to display your own color chooser dialog or set required color programmatically without displaying any dialogs.

当用户选择type = color的HTML5输入元素时，将调用此方法。您可以使用此方法显示自己的颜色选择器对话框，或以编程方式设置所需的颜色，而无需显示任何对话框。

Parameters:

params - the color chooser dialog params. -颜色选择器对话框参数。

Returns:

CloseStatus.OK when dialog was closed successfully or CloseStatus.CANCEL when dialog was closed via Cancel button. 对话框成功关闭时或通过“取消”按钮关闭对话框时。