FormValidationMessageRequest QML Type | Qt WebEngine 5.8

Qt 5.8 | Qt WebEngine | QML Types | FormValidationMessageRequest QML Type

Qt 5.8.0 Reference Documentation

# FormValidationMessageRequest QML Type

A request for showing a HTML5 form validation message to the user. More...

Import Statement: | import QtWebEngine 1.4
Since: | QtWebEngine 1.4

- List of all members, including inherited members

## Properties

- accepted : bool
- anchor : rectangle
- subText : bool
- text : bool
- type : enumeration

## Detailed Description

A FormValidationMessageRequest is passed as an argument of the WebEngineView::formValidationMessageRequested signal. It is generated when the handling of the validation message is requested.

The accepted property of the request indicates whether the request is handled by the user code or the default message should be displayed.

The following code uses a custom message to handle the request:

      WebEngineView {
          // ...
          onFormValidationMessageRequested: function(request) {
              request.accepted = true;
              switch (request.type) {
                  case FormValidationMessageRequest.Show:
                      validationMessage.text = request.text;
                      validationMessage.x = request.x;
                      validationMessage.y = request.y
                      validationMessage.visible = true;
                      break;
                   case FormValidationMessageRequest.Move:
                      break;
                   case FormValidationMessageRequest.Hide:
                      validationMessage.visible = false;
                      break;
                   }
          }
          // ...
      }

## Property Documentation

accepted : bool

Indicates whether the form validation request has been accepted by the signal handler.

If the property is `false` after any signal handlers for WebEngineView::validationMessageRequested have been executed, a default file validation message will be shown. To prevent this, set `request.accepted` to `true`.

The default is `false`.

[read-only] anchor : rectangle

An anchor of an element in the viewport for which the form validation message should be displayed.

[read-only] subText : bool

The subtext of the form validation message.

[read-only] text : bool

The text of the form validation message.

[read-only] type : enumeration

The type of the form validation message request.

Constant | Description
--- | ---
`ValidationMessageRequest.Show` | The form validation message should be shown.
`ValidationMessageRequest.Hide` | The form validation message should be hidden.
`ValidationMessageRequest.Move` | The form validation message should be moved.