Rename ReturnKey to EnterKey

This makes the terminology consistent with Sailfish OS and the QNX QPA.
The kImePlatformDataReturnKeyType in the iOS QPA is not changed to not
break compatibility. Also, improve documentation.

Change-Id: I2780de5b1e9277185ae1d4d9bbc67e36682fbfba
Reviewed-by: J-P Nurmi <jpnurmi@theqtcompany.com>
Reviewed-by: Richard Moe Gustavsen <richard.gustavsen@theqtcompany.com>

2 files changed, 35 insertions, 34 deletions

diff --git a/src/corelib/global/qnamespace.h b/src/corelib/global/qnamespace.h
index 123e2edf0e..c6465ed087 100644
--- a/src/corelib/global/qnamespace.h
+++ b/src/corelib/global/qnamespace.h
@@ -1323,7 +1323,7 @@ public:
         ImAbsolutePosition = 0x400,
         ImTextBeforeCursor = 0x800,
         ImTextAfterCursor = 0x1000,
-        ImReturnKeyType = 0x2000,
+        ImEnterKeyType = 0x2000,
 
         ImPlatformData = 0x80000000,
         ImQueryInput = ImCursorRectangle | ImCursorPosition | ImSurroundingText |
@@ -1363,15 +1363,15 @@ public:
     };
     Q_DECLARE_FLAGS(InputMethodHints, InputMethodHint)
 
-    enum ReturnKeyType {
-        ReturnKeyDefault,
-        ReturnKeyEnter,
-        ReturnKeyDone,
-        ReturnKeyGo,
-        ReturnKeySend,
-        ReturnKeySearch,
-        ReturnKeyNext,
-        ReturnKeyPrevious
+    enum EnterKeyType {
+        EnterKeyDefault,
+        EnterKeyReturn,
+        EnterKeyDone,
+        EnterKeyGo,
+        EnterKeySend,
+        EnterKeySearch,
+        EnterKeyNext,
+        EnterKeyPrevious
     };
 
     enum ToolButtonStyle {
@@ -1697,7 +1697,7 @@ public:
     QT_Q_ENUM(InputMethodHint)
     QT_Q_ENUM(InputMethodQuery)
     QT_Q_FLAG(InputMethodHints)
-    QT_Q_ENUM(ReturnKeyType)
+    QT_Q_ENUM(EnterKeyType)
     QT_Q_FLAG(InputMethodQueries)
     QT_Q_FLAG(TouchPointStates)
     QT_Q_ENUM(ScreenOrientation)
diff --git a/src/corelib/global/qnamespace.qdoc b/src/corelib/global/qnamespace.qdoc
index d4d7b631ad..b981fed500 100644
--- a/src/corelib/global/qnamespace.qdoc
+++ b/src/corelib/global/qnamespace.qdoc
@@ -2527,7 +2527,7 @@
                                 but \b{must} not return an empty string unless the cursor is at the start of the document.
     \value ImTextAfterCursor    The plain text after the cursor. The widget can decide how much text to return,
                                 but \b{must} not return an empty string unless the cursor is at the end of the document.
-    \value ImReturnKeyType      The return key type.
+    \value ImEnterKeyType       The Enter key type.
 
     Masks:
 
@@ -2538,31 +2538,32 @@
 */
 
 /*!
-    \enum Qt::ReturnKeyType
+    \enum Qt::EnterKeyType
 
     This can be used to alter the appearance of the Return key on an on screen keyboard.
 
-    Note that not all of these values are supported on all platforms.
-
-    \value ReturnKeyDefault     The default return key.
-                                This can either be a button closing the keyboard, or a Return button
-                                causing a new line in case of a multi-line input field.
-    \value ReturnKeyEnter       Show a Return button that inserts a new line.
-                                The keyboard will not close when this button is pressed.
-    \value ReturnKeyDone        Show a "Done" button.
-                                The keyboard will close when this button is pressed.
-    \value ReturnKeyGo          Show a "Go" button.
-                                Typically used in an address bar when entering an URL; the keyboard
-                                will close when this button is pressed.
-    \value ReturnKeySend        Show a "Send" button.
-                                The keyboard will close when this button is pressed.
-    \value ReturnKeySearch      Show a "Search" button.
-                                The keyboard will close when this button is pressed.
-    \value ReturnKeyNext        Show a "Next" button.
-                                Typically used in a form to allow navigating to the next input field;
-                                the keyboard will not close when this button is pressed.
-    \value ReturnKeyPrevious    Show a "Previous" button.
-                                The keyboard will not close when this button is pressed.
+    \note Not all of these values are supported on all platforms.
+    For unsuppoted values the default key will be used instead.
+
+    \value EnterKeyDefault     The default Enter key.
+                               This can either be a button closing the keyboard, or a Return button
+                               causing a new line in case of a multi-line input field.
+    \value EnterKeyReturn      Show a Return button that inserts a new line.
+                               The keyboard will not close when this button is pressed.
+    \value EnterKeyDone        Show a "Done" button.
+                               The keyboard will close when this button is pressed.
+    \value EnterKeyGo          Show a "Go" button.
+                               Typically used in an address bar when entering a URL; the keyboard
+                               will close when this button is pressed.
+    \value EnterKeySend        Show a "Send" button.
+                               The keyboard will close when this button is pressed.
+    \value EnterKeySearch      Show a "Search" button.
+                               The keyboard will close when this button is pressed.
+    \value EnterKeyNext        Show a "Next" button.
+                               Typically used in a form to allow navigating to the next input field;
+                               the keyboard will not close when this button is pressed.
+    \value EnterKeyPrevious    Show a "Previous" button.
+                               The keyboard will not close when this button is pressed.
 
     \since 5.6
 */