Improve RPA.Word.Application selection usage (#1159)

docs/source/releasenotes.rst

@@ -12,6 +12,12 @@ Latest versions
 `Upcoming release <https://github.com/robocorp/rpaframework/projects/3#column-16713994>`_
 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
+- Library **RPA.Word.Application** (:pr:`1159`):
+
+  - Add keyword ``Select current paragraph`` for selecting the current paragraph.
+  - Add keyword ``Select paragraphs`` for selecting previous/next paragraphs.
+  - Add keyword ``Copy selection to clipboard`` for copying the selection to the clipboard.
+
 - Library **RPA.Excel.Application** (:pr:`1158`):
 
   - Add keyword ``Remove hidden columns and rows`` from given range.

packages/main/src/RPA/Word/Application.py

@@ -322,3 +322,24 @@ def write_text(
 
         self.app.Selection.TypeText(text)
         self.app.Selection.Select()
+
+    def select_current_paragraph(self):
+        """Select text in current active paragraph."""
+        self.app.Selection.Paragraphs(1).Range.Select()
+
+    def copy_selection_to_clipboard(self):
+        """Copy current text selection to clipboard."""
+        self.app.Selection.Copy()
+
+    def select_paragraph(self, count: int = 1):
+        """Select paragraph(s) from current cursor position.
+
+        Negative `count` moves cursor up number of paragraphs and
+        positive `count` moves cursor down number of paragraphs.
+
+        :param count: number of paragraphs to select
+        """
+        start = self.app.Selection.Range.Start
+        self.app.Selection.MoveDown(Unit=constants.wdParagraph, Count=count)
+        end = self.app.Selection.Range.End
+        self.app.Selection.SetRange(start, end)