Placing Cursor Within a Multiline Edit Control

When working with multiline controls, you may need to place the cursor to a specified position, for example, if you want to select any word within a phrase, or modify text, or insert new text. Generally, performing this operation is similar to setting insertion points within a single-line edit control. This approach is described in the Setting Insertion Point in an Edit Control topic.

While testing edit controls, you can use specific properties and methods of the corresponding program object to perform certain actions and obtain data stored in controls. You can call these methods and properties from your keyword tests, as well as from scripts. This topic describes how to work with the needed properties and methods from your scripts. However, when testing a control from your keyword test, you can use the same methods and properties calling them from keyword test operations. For more information, see Keyword Tests Basic Operations.

You can place the cursor to the desired position by clicking on it. You can perform this operation by using the Click action. The coordinates of the insertion point are specified in pixels.

An example below demonstrates how to set the insertion point by simulating a click:

def Main():
  # Run Notepad 
  WshShell.Run("notepad.exe", SW_SHOWNORMAL)
 
  # Obtain the edit object and fill it with text 
  p = Sys.Process("NOTEPAD")
  Edit = p.Window("Notepad").Window("Edit")
  Edit.Keys("What else have you got in your pocket?[Enter]")
  Edit.Keys("Only a thimble...[Enter]")
  Edit.Keys("Hand it over here!!")

  # Move the cursor to the desired position
  Edit.Click(55,20)

Using the Click action implies that you must find the starting position's coordinates for the selection. You can detect the mouse position, for example, by recording a script (see Recording Automated Tests). This approach is rather difficult, so it is easier to place the cursor in the following way:

• Simulate Click without any parameters. In this case the cursor will be placed at the end of the text. If the edit control you are working with is already active, you can omit this operation.

• Use keystrokes to move the cursor to the desired position. Placing the cursor via simulating keystrokes is described in the Setting Insertion Point in an Edit Control topic. The only difference between single-line and multiline control is that you can only select horizontal position within single-line edit controls, and both vertical and horizontal within multiline edit controls. Use the Up and Down keystrokes to move the cursor from one string to another. Moving the cursor within the string is similar to working with the single-line edit control. You can use the Home an End keystrokes, which allow you to position the cursor at the beginning or at the end of the string.

  The following code example simulates the typing of text and places the cursor before 'else' within the text.

  JavaScript, JScript

  Python

  VBScript

  DelphiScript

  C++Script, C#Script

  JavaScript, JScript

  function Main()
  {
    var p, Edit;
    // Run Notepad
    WshShell.Run("notepad.exe", SW_SHOWNORMAL);
   
    // Obtain the edit object and fill it with text
    p = Sys.Process("NOTEPAD");
    Edit = p.Window("Notepad").Window("Edit");
    Edit.Keys("What else have you got in your pocket?[Enter]");
    Edit.Keys("Only a thimble...[Enter]");
    Edit.Keys("Hand it over here!!");
  
    // Move the cursor to the desired position
    Edit.Keys("[Up][Up][Home]");
    Edit.Keys("[Right][Right][Right][Right][Right]");
  }

  Python

  def Main():
    # Run Notepad 
    WshShell.Run("notepad.exe", SW_SHOWNORMAL)
   
    # Obtain the edit object and fill it with text 
    p = Sys.Process("NOTEPAD")
    Edit = p.Window("Notepad").Window("Edit")
    Edit.Keys("What else have you got in your pocket?[Enter]")
    Edit.Keys("Only a thimble...[Enter]")
    Edit.Keys("Hand it over here!!")
  
    # Move the cursor to the desired position
    Edit.Keys("[Up][Up][Home]")
    Edit.Keys("[Right][Right][Right][Right][Right]")

  VBScript

  Sub Main
    Dim p, Edit
    ' Run Notepad
    Call WshShell.Run("notepad.exe", SW_SHOWNORMAL)
  
    ' Obtain the edit object and fill it with text
    Set p = Sys.Process("NOTEPAD")
    Set Edit = p.Window("Notepad").Window("Edit")
    Edit.Keys "What else have you got in your pocket?[Enter]"
    Edit.Keys "Only a thimble...[Enter]"
    Edit.Keys "Hand it over here!!"
  
    ' Move the cursor to the desired position
    Edit.Keys "[Up][Up][Home]"
    Edit.Keys "[Right][Right][Right][Right][Right]"
  End Sub

  DelphiScript

  procedure Main;
    var p, Edit : OleVariant;
  begin
    // Run Notepad
    WshShell.Run('notepad.exe', SW_SHOWNORMAL);
  
    // Obtain the edit object
    p := Sys.Process('NOTEPAD');
    Edit := p.Window('Notepad').Window('Edit');
    Edit.Keys('What else have you got in your pocket?[Enter]');
    Edit.Keys('Only a thimble...[Enter]');
    Edit.Keys('Hand it over here!!');
  
    // Move the cursor to the desired position
    Edit.Keys('[Up][Up][Home]');
    Edit.Keys('[Right][Right][Right][Right][Right]');
  end;

  C++Script, C#Script

  function Main()
  {
    var p, Edit;
    // Run Notepad
    WshShell["Run"]("notepad.exe", SW_SHOWNORMAL);
  
    //Obtain the edit object and fill it with text
    p = Sys.Process("NOTEPAD");
    Edit = p.Window("Notepad").Window("Edit");
    Edit["Keys"]("What else have you got in your pocket?[Enter]");
    Edit["Keys"]("Only a thimble...[Enter]");
    Edit["Keys"]("Hand it over here!!");
  
    // Move the cursor to the desired position
    Edit["Keys"]("[Up][Up][Home]");
    Edit["Keys"]("[Right][Right][Right][Right][Right]");
   }

See Also

Working With Multiline Edit Controls - Specifics
Setting Insertion Point in an Edit Control
Recording Automated Tests