Send Inputs

' ***********************************************************************
' Author   : Elektro
' Modified : 25-05-2014
' ***********************************************************************
' <copyright file="SendInputs.vb" company="Elektro Studios">
'     Copyright (c) Elektro Studios. All rights reserved.
' </copyright>
' ***********************************************************************

#Region " Usage Examples "

'Private Sub Test() Handles Button1.Click

'    AppActivate(Process.GetProcessesByName("notepad").First.Id)

'    Dim c As Char = Convert.ToChar(Keys.Oemtilde) ' Ñ
'    Dim Result As Integer = SendInputs.SendKey(key:=Convert.ToChar(c.ToString.ToLower), KeyAction:=SendInputs.KeyAction.Press)
'    MessageBox.Show(String.Format("Successfull events: {0}", CStr(Result)))

'    SendInputs.SendKey(key:=Keys.Enter, KeyAction:=SendInputs.KeyAction.Press)
'    SendInputs.SendKey(key:=Convert.ToChar(Keys.Back), KeyAction:=SendInputs.KeyAction.Press)
'    SendInputs.SendKey(key:=Convert.ToChar(Keys.D0), KeyAction:=SendInputs.KeyAction.Press, BlockInput:=False)

'    SendInputs.SendKeys([String]:="Hello World", BlockInput:=True)
'    SendInputs.SendKeys([String]:=Keys.Insert, BlockInput:=False)

'    SendInputs.MouseClick(MouseAction:=SendInputs.MouseButton.RightPress, BlockInput:=False)

'    SendInputs.MouseMove(X:=5, Y:=-5, BlockInput:=False)
'    SendInputs.MouseMove(Offset:=New Point With {.X = 5, .Y = -5}, BlockInput:=False)

'    SendInputs.MousePosition(Position:=New Point With {.X = 100, .Y = -500}, BlockInput:=False)

'End Sub

#End Region

#Region " Imports "

Imports System.Runtime.InteropServices
Imports System.ComponentModel

#End Region

''' <summary>
''' Synthesizes keystrokes, mouse motions, and button clicks.
''' </summary>
Public Class SendInputs

#Region " P/Invoke "

    Friend Class NativeMethods

#Region " Methods "

        ''' <summary>
        ''' Blocks keyboard and mouse input events from reaching applications.
        ''' For more info see here:
        ''' http://msdn.microsoft.com/en-us/library/windows/desktop/ms646290%28v=vs.85%29.aspx
        ''' </summary>
        ''' <param name="fBlockIt">
        ''' The function's purpose.
        ''' If this parameter is 'TRUE', keyboard and mouse input events are blocked.
        ''' If this parameter is 'FALSE', keyboard and mouse events are unblocked.
        ''' </param>
        ''' <returns>
        ''' If the function succeeds, the return value is nonzero.
        ''' If input is already blocked, the return value is zero.
        ''' </returns>
        ''' <remarks>
        ''' Note that only the thread that blocked input can successfully unblock input.
        ''' </remarks>
        <DllImport("User32.dll", CharSet:=CharSet.Auto, CallingConvention:=CallingConvention.StdCall,
        SetLastError:=True)>
        Friend Shared Function BlockInput(
              ByVal fBlockIt As Boolean
       ) As Integer
        End Function

        ''' <summary>
        ''' Synthesizes keystrokes, mouse motions, and button clicks.
        ''' For more info see here:
        ''' http://msdn.microsoft.com/en-us/library/windows/desktop/ms646310%28v=vs.85%29.aspx
        ''' </summary>
        ''' <param name="nInputs">
        ''' Indicates the number of structures in the pInputs array.
        ''' </param>
        ''' <param name="pInputs">
        ''' Indicates an Array of 'INPUT' structures.
        ''' Each structure represents an event to be inserted into the keyboard or mouse input stream.
        ''' </param>
        ''' <param name="cbSize">
        ''' The size, in bytes, of an 'INPUT' structure.
        ''' If 'cbSize' is not the size of an 'INPUT' structure, the function fails.
        ''' </param>
        ''' <returns>
        ''' The function returns the number of events that it successfully
        ''' inserted into the keyboard or mouse input stream.
        ''' If the function returns zero, the input was already blocked by another thread.
        ''' </returns>
        <DllImport("user32.dll", SetLastError:=True)>
        Friend Shared Function SendInput(
              ByVal nInputs As Integer,
              <MarshalAs(UnmanagedType.LPArray), [In]> ByVal pInputs As INPUT(),
              ByVal cbSize As Integer
       ) As Integer
        End Function

#End Region

#Region " Enumerations "

        ''' <summary>
        ''' VirtualKey codes.
        ''' </summary>
        Friend Enum VirtualKeys As Short

            ''' <summary>
            ''' The Shift key.
            ''' VK_SHIFT
            ''' </summary>
            SHIFT = &H10S

            ''' <summary>
            ''' The DEL key.
            ''' VK_DELETE
            ''' </summary>
            DELETE = 46S

            ''' <summary>
            ''' The ENTER key.
            ''' VK_RETURN
            ''' </summary>
            [RETURN] = 13S

        End Enum

        ''' <summary>
        ''' The type of the input event.
        ''' For more info see here:
        ''' http://msdn.microsoft.com/en-us/library/windows/desktop/ms646270%28v=vs.85%29.aspx
        ''' </summary>
        <Description("Enumeration used for 'type' parameter of 'INPUT' structure")>
        Friend Enum InputType As Integer

            ''' <summary>
            ''' The event is a mouse event.
            ''' Use the mi structure of the union.
            ''' </summary>
            Mouse = 0

            ''' <summary>
            ''' The event is a keyboard event.
            ''' Use the ki structure of the union.
            ''' </summary>
            Keyboard = 1

            ''' <summary>
            ''' The event is a hardware event.
            ''' Use the hi structure of the union.
            ''' </summary>
            Hardware = 2

        End Enum

        ''' <summary>
        ''' Specifies various aspects of a keystroke.
        ''' This member can be certain combinations of the following values.
        ''' For more info see here:
        ''' http://msdn.microsoft.com/en-us/library/windows/desktop/ms646271%28v=vs.85%29.aspx
        ''' </summary>
        <Description("Enumeration used for 'dwFlags' parameter of 'KeyboardInput' structure")>
        <Flags>
        Friend Enum KeyboardInput_Flags As Integer

            ''' <summary>
            ''' If specified, the scan code was preceded by a prefix byte that has the value '0xE0' (224).
            ''' </summary>
            ExtendedKey = &H1

            ''' <summary>
            ''' If specified, the key is being pressed.
            ''' </summary>
            KeyDown = &H0

            ''' <summary>
            ''' If specified, the key is being released.
            ''' If not specified, the key is being pressed.
            ''' </summary>
            KeyUp = &H2

            ''' <summary>
            ''' If specified, 'wScan' identifies the key and 'wVk' is ignored.
            ''' </summary>
            ScanCode = &H8

            ''' <summary>
            ''' If specified, the system synthesizes a 'VK_PACKET' keystroke.
            ''' The 'wVk' parameter must be '0'.
            ''' This flag can only be combined with the 'KEYEVENTF_KEYUP' flag.
            ''' </summary>
            Unicode = &H4

        End Enum

        ''' <summary>
        ''' A set of bit flags that specify various aspects of mouse motion and button clicks.
        ''' The bits in this member can be any reasonable combination of the following values.
        ''' For more info see here:
        ''' http://msdn.microsoft.com/en-us/library/windows/desktop/ms646273%28v=vs.85%29.aspx
        ''' </summary>
        <Description("Enumeration used for 'dwFlags' parameter of 'MouseInput' structure")>
        <Flags>
        Friend Enum MouseInput_Flags As Integer

            ''' <summary>
            ''' The 'dx' and 'dy' members contain normalized absolute coordinates.
            ''' If the flag is not set, 'dx' and 'dy' contain relative data
            ''' (the change in position since the last reported position).
            ''' This flag can be set, or not set,
            ''' regardless of what kind of mouse or other pointing device, if any, is connected to the system.
            ''' </summary>
            Absolute = &H8000I

            ''' <summary>
            ''' Movement occurred.
            ''' </summary>
            Move = &H1I

            ''' <summary>
            ''' The 'WM_MOUSEMOVE' messages will not be coalesced.
            ''' The default behavior is to coalesce 'WM_MOUSEMOVE' messages.
            ''' </summary>
            Move_NoCoalesce = &H2000I

            ''' <summary>
            ''' The left button was pressed.
            ''' </summary>
            LeftDown = &H2I

            ''' <summary>
            ''' The left button was released.
            ''' </summary>
            LeftUp = &H4I

            ''' <summary>
            ''' The right button was pressed.
            ''' </summary>
            RightDown = &H8I

            ''' <summary>
            ''' The right button was released.
            ''' </summary>
            RightUp = &H10I

            ''' <summary>
            ''' The middle button was pressed.
            ''' </summary>
            MiddleDown = &H20I

            ''' <summary>
            ''' The middle button was released.
            ''' </summary>
            MiddleUp = &H40I

            ''' <summary>
            ''' Maps coordinates to the entire desktop.
            ''' Must be used in combination with 'Absolute'.
            ''' </summary>
            VirtualDesk = &H4000I

            ''' <summary>
            ''' The wheel was moved, if the mouse has a wheel.
            ''' The amount of movement is specified in 'mouseData'.
            ''' </summary>
            Wheel = &H800I

            ''' <summary>
            ''' The wheel was moved horizontally, if the mouse has a wheel.
            ''' The amount of movement is specified in 'mouseData'.
            ''' </summary>
            HWheel = &H1000I

            ''' <summary>
            ''' An X button was pressed.
            ''' </summary>
            XDown = &H80I

            ''' <summary>
            ''' An X button was released.
            ''' </summary>
            XUp = &H100I

        End Enum

#End Region

#Region " Structures "

        ''' <summary>
        ''' Used by 'SendInput' function
        ''' to store information for synthesizing input events such as keystrokes, mouse movement, and mouse clicks.
        ''' For more info see here:
        ''' http://msdn.microsoft.com/en-us/library/windows/desktop/ms646270%28v=vs.85%29.aspx
        ''' </summary>
        <Description("Structure used for 'INPUT' parameter of 'SendInput' API method")>
        <StructLayout(LayoutKind.Explicit)>
        Friend Structure Input

            ' ******
            '  NOTE
            ' ******
            ' Field offset for 32 bit machine: 4
            ' Field offset for 64 bit machine: 8

            ''' <summary>
            ''' The type of the input event.
            ''' </summary>
            <FieldOffset(0)>
            Public type As InputType

            ''' <summary>
            ''' The information about a simulated mouse event.
            ''' </summary>
            <FieldOffset(8)>
            Public mi As MouseInput

            ''' <summary>
            ''' The information about a simulated keyboard event.
            ''' </summary>
            <FieldOffset(8)>
            Public ki As KeyboardInput

            ''' <summary>
            ''' The information about a simulated hardware event.
            ''' </summary>
            <FieldOffset(8)>
            Public hi As HardwareInput

        End Structure

        ''' <summary>
        ''' Contains information about a simulated mouse event.
        ''' For more info see here:
        ''' http://msdn.microsoft.com/en-us/library/windows/desktop/ms646273%28v=vs.85%29.aspx
        ''' </summary>
        <Description("Structure used for 'mi' parameter of 'INPUT' structure")>
        Friend Structure MouseInput

            ''' <summary>
            ''' The absolute position of the mouse,
            ''' or the amount of motion since the last mouse event was generated,
            ''' depending on the value of the dwFlags member.
            ''' Absolute data is specified as the 'x' coordinate of the mouse;
            ''' relative data is specified as the number of pixels moved.
            ''' </summary>
            Public dx As Integer

            ''' <summary>
            ''' The absolute position of the mouse,
            ''' or the amount of motion since the last mouse event was generated,
            ''' depending on the value of the dwFlags member.
            ''' Absolute data is specified as the 'y' coordinate of the mouse;
            ''' relative data is specified as the number of pixels moved.
            ''' </summary>
            Public dy As Integer

            ''' <summary>
            ''' If 'dwFlags' contains 'MOUSEEVENTF_WHEEL',
            ''' then 'mouseData' specifies the amount of wheel movement.
            ''' A positive value indicates that the wheel was rotated forward, away from the user;
            ''' a negative value indicates that the wheel was rotated backward, toward the user.
            ''' One wheel click is defined as 'WHEEL_DELTA', which is '120'.
            '''
            ''' If 'dwFlags' does not contain 'MOUSEEVENTF_WHEEL', 'MOUSEEVENTF_XDOWN', or 'MOUSEEVENTF_XUP',
            ''' then mouseData should be '0'.
            ''' </summary>
            Public mouseData As Integer

            ''' <summary>
            ''' A set of bit flags that specify various aspects of mouse motion and button clicks.
            ''' The bits in this member can be any reasonable combination of the following values.
            ''' The bit flags that specify mouse button status are set to indicate changes in status,
            ''' not ongoing conditions.
            ''' For example, if the left mouse button is pressed and held down,
            ''' 'MOUSEEVENTF_LEFTDOWN' is set when the left button is first pressed,
            ''' but not for subsequent motions.
            ''' Similarly, 'MOUSEEVENTF_LEFTUP' is set only when the button is first released.
            '''
            ''' You cannot specify both the 'MOUSEEVENTF_WHEE'L flag
            ''' and either 'MOUSEEVENTF_XDOWN' or 'MOUSEEVENTF_XUP' flags simultaneously in the 'dwFlags' parameter,
            ''' because they both require use of the 'mouseData' field.
            ''' </summary>
            Public dwFlags As MouseInput_Flags

            ''' <summary>
            ''' The time stamp for the event, in milliseconds.
            ''' If this parameter is '0', the system will provide its own time stamp.
            ''' </summary>
            Public time As Integer

            ''' <summary>
            ''' An additional value associated with the mouse event.
            ''' An application calls 'GetMessageExtraInfo' to obtain this extra information.
            ''' </summary>
            Public dwExtraInfo As IntPtr

        End Structure

        ''' <summary>
        ''' Contains information about a simulated keyboard event.
        ''' For more info see here:
        ''' http://msdn.microsoft.com/en-us/library/windows/desktop/ms646271%28v=vs.85%29.aspx
        ''' </summary>
        <Description("Structure used for 'ki' parameter of 'INPUT' structure")>
        Friend Structure KeyboardInput

            ''' <summary>
            ''' A virtual-key code.
            ''' The code must be a value in the range '1' to '254'.
            ''' If the 'dwFlags' member specifies 'KEYEVENTF_UNICODE', wVk must be '0'.
            ''' </summary>
            Public wVk As Short

            ''' <summary>
            ''' A hardware scan code for the key.
            ''' If 'dwFlags' specifies 'KEYEVENTF_UNICODE',
            ''' 'wScan' specifies a Unicode character which is to be sent to the foreground application.
            ''' </summary>
            Public wScan As Short

            ''' <summary>
            ''' Specifies various aspects of a keystroke.
            ''' </summary>
            Public dwFlags As KeyboardInput_Flags

            ''' <summary>
            ''' The time stamp for the event, in milliseconds.
            ''' If this parameter is '0', the system will provide its own time stamp.
            ''' </summary>
            Public time As Integer

            ''' <summary>
            ''' An additional value associated with the keystroke.
            ''' Use the 'GetMessageExtraInfo' function to obtain this information.
            ''' </summary>
            Public dwExtraInfo As IntPtr

        End Structure

        ''' <summary>
        ''' Contains information about a simulated message generated by an input device other than a keyboard or mouse.
        ''' For more info see here:
        ''' http://msdn.microsoft.com/en-us/library/windows/desktop/ms646269%28v=vs.85%29.aspx
        ''' </summary>
        <Description("Structure used for 'hi' parameter of 'INPUT' structure")>
        Friend Structure HardwareInput

            ''' <summary>
            ''' The message generated by the input hardware.
            ''' </summary>
            Public uMsg As Integer

            ''' <summary>
            ''' The low-order word of the lParam parameter for uMsg.
            ''' </summary>
            Public wParamL As Short

            ''' <summary>
            ''' The high-order word of the lParam parameter for uMsg.
            ''' </summary>
            Public wParamH As Short

        End Structure

#End Region

    End Class

#End Region

#Region " Enumerations "

    ''' <summary>
    ''' Indicates a mouse button.
    ''' </summary>
    <Description("Enumeration used for 'MouseAction' parameter of 'MouseClick' function.")>
    Public Enum MouseButton As Integer

        ''' <summary>
        ''' Hold the left button.
        ''' </summary>
        LeftDown = &H2I

        ''' <summary>
        ''' Release the left button.
        ''' </summary>
        LeftUp = &H4I

        ''' <summary>
        ''' Hold the right button.
        ''' </summary>
        RightDown = &H8I

        ''' <summary>
        ''' Release the right button.
        ''' </summary>
        RightUp = &H10I

        ''' <summary>
        ''' Hold the middle button.
        ''' </summary>
        MiddleDown = &H20I

        ''' <summary>
        ''' Release the middle button.
        ''' </summary>
        MiddleUp = &H40I

        ''' <summary>
        ''' Press the left button.
        ''' ( Hold + Release )
        ''' </summary>
        LeftPress = LeftDown + LeftUp

        ''' <summary>
        ''' Press the Right button.
        ''' ( Hold + Release )
        ''' </summary>
        RightPress = RightDown + RightUp

        ''' <summary>
        ''' Press the Middle button.
        ''' ( Hold + Release )
        ''' </summary>
        MiddlePress = MiddleDown + MiddleUp

    End Enum

    ''' <summary>
    ''' Indicates a keyboard key action.
    ''' </summary>
    Public Enum KeyAction As Integer

        ''' <summary>
        ''' Holds the key.
        ''' </summary>
        Hold = &H0

        ''' <summary>
        ''' Releases the key.
        ''' </summary>

        Release = &H2

        ''' <summary>
        ''' Press he key.
        ''' </summary>
        Press = Hold Or Release

    End Enum

#End Region

#Region " Public Methods "

    ''' <summary>
    ''' Sends a keystroke.
    ''' </summary>
    ''' <param name="key">
    ''' Indicates the keystroke to simulate.
    ''' </param>
    ''' <param name="BlockInput">
    ''' If set to <c>true</c>, the keyboard and mouse are blocked until the keystroke is sent.
    ''' </param>
    ''' <returns>
    ''' The function returns the number of events that it successfully inserted into the keyboard input stream.
    ''' If the function returns zero, the input was already blocked by another thread.
    ''' </returns>
    Public Shared Function SendKey(ByVal key As Char,
                                   ByVal KeyAction As KeyAction,
                                   Optional BlockInput As Boolean = False) As Integer

        ' Block Keyboard and mouse.
        If BlockInput Then NativeMethods.BlockInput(True)

        ' The inputs structures to send.
        Dim Inputs As New List(Of NativeMethods.Input)

        ' The current input to add into the Inputs list.
        Dim CurrentInput As New NativeMethods.Input

        ' Determines whether a character is an alphabetic letter.
        Dim IsAlphabetic As Boolean = Not (key.ToString.ToUpper = key.ToString.ToLower)

        ' Determines whether a character is an uppercase alphabetic letter.
        Dim IsUpperCase As Boolean =
            (key.ToString = key.ToString.ToUpper) AndAlso Not (key.ToString.ToUpper = key.ToString.ToLower)

        ' Determines whether the CapsLock key is pressed down.
        Dim CapsLockON As Boolean = My.Computer.Keyboard.CapsLock

        ' Set the passed key to upper-case.
        If IsAlphabetic AndAlso Not IsUpperCase Then
            key = Convert.ToChar(key.ToString.ToUpper)
        End If

        ' If character is alphabetic and is UpperCase and CapsLock is pressed down,
        ' OrElse character is alphabetic and is not UpperCase and CapsLock is not pressed down,
        ' OrElse character is not alphabetic.
        If (IsAlphabetic AndAlso IsUpperCase AndAlso CapsLockON) _
        OrElse (IsAlphabetic AndAlso Not IsUpperCase AndAlso Not CapsLockON) _
        OrElse (Not IsAlphabetic) Then

            If KeyAction = SendInputs.KeyAction.Press Then

                ' Hold the character key.
                With CurrentInput
                    .type = NativeMethods.InputType.Keyboard
                    .ki.wVk = Convert.ToInt16(CChar(key))
                    .ki.dwFlags = NativeMethods.KeyboardInput_Flags.KeyDown
                End With : Inputs.Add(CurrentInput)

                ' Release the character key.
                With CurrentInput
                    .type = NativeMethods.InputType.Keyboard
                    .ki.wVk = Convert.ToInt16(CChar(key))
                    .ki.dwFlags = NativeMethods.KeyboardInput_Flags.KeyUp
                End With : Inputs.Add(CurrentInput)

            Else

                With CurrentInput
                    .type = NativeMethods.InputType.Keyboard
                    .ki.wVk = Convert.ToInt16(CChar(key))
                    .ki.dwFlags = KeyAction
                End With : Inputs.Add(CurrentInput)

            End If

            ' If character is alphabetic and is UpperCase and CapsLock is not pressed down,
            ' OrElse character is alphabetic and is not UpperCase and CapsLock is pressed down.
        ElseIf (IsAlphabetic AndAlso IsUpperCase AndAlso Not CapsLockON) _
        OrElse (IsAlphabetic AndAlso Not IsUpperCase AndAlso CapsLockON) Then

            ' Hold the Shift key.
            With CurrentInput
                .type = NativeMethods.InputType.Keyboard
                .ki.wVk = NativeMethods.VirtualKeys.SHIFT
                .ki.dwFlags = NativeMethods.KeyboardInput_Flags.KeyDown
            End With : Inputs.Add(CurrentInput)

            If KeyAction = SendInputs.KeyAction.Press Then

                ' Hold the character key.
                With CurrentInput
                    .type = NativeMethods.InputType.Keyboard
                    .ki.wVk = Convert.ToInt16(CChar(key))
                    .ki.dwFlags = NativeMethods.KeyboardInput_Flags.KeyDown
                End With : Inputs.Add(CurrentInput)

                ' Release the character key.
                With CurrentInput
                    .type = NativeMethods.InputType.Keyboard
                    .ki.wVk = Convert.ToInt16(CChar(key))
                    .ki.dwFlags = NativeMethods.KeyboardInput_Flags.KeyUp
                End With : Inputs.Add(CurrentInput)

            Else

                With CurrentInput
                    .type = NativeMethods.InputType.Keyboard
                    .ki.wVk = Convert.ToInt16(CChar(key))
                    .ki.dwFlags = KeyAction
                End With : Inputs.Add(CurrentInput)

            End If

            ' Release the Shift key.
            With CurrentInput
                .type = NativeMethods.InputType.Keyboard
                .ki.wVk = NativeMethods.VirtualKeys.SHIFT
                .ki.dwFlags = NativeMethods.KeyboardInput_Flags.KeyUp
            End With : Inputs.Add(CurrentInput)

        End If ' UpperCase And My.Computer.Keyboard.CapsLock is...

        ' Send the input key.
        Return NativeMethods.SendInput(Inputs.Count, Inputs.ToArray,
                                       Marshal.SizeOf(GetType(NativeMethods.Input)))

        ' Unblock Keyboard and mouse.
        If BlockInput Then NativeMethods.BlockInput(False)

    End Function

    ''' <summary>
    ''' Sends a keystroke.
    ''' </summary>
    ''' <param name="key">
    ''' Indicates the keystroke to simulate.
    ''' </param>
    ''' <param name="BlockInput">
    ''' If set to <c>true</c>, the keyboard and mouse are blocked until the keystroke is sent.
    ''' </param>
    ''' <returns>
    ''' The function returns the number of events that it successfully inserted into the keyboard input stream.
    ''' If the function returns zero, the input was already blocked by another thread.
    ''' </returns>
    Public Shared Function SendKey(ByVal key As Keys,
                                   ByVal KeyAction As KeyAction,
                                   Optional BlockInput As Boolean = False) As Integer

        Return SendKey(Convert.ToChar(key), KeyAction, BlockInput)

    End Function

    ''' <summary>
    ''' Sends a string.
    ''' </summary>
    ''' <param name="String">
    ''' Indicates the string to send.
    ''' </param>
    ''' <param name="BlockInput">
    ''' If set to <c>true</c>, the keyboard and mouse are blocked until the keystroke is sent.
    ''' </param>
    ''' <returns>
    ''' The function returns the number of events that it successfully inserted into the keyboard input stream.
    ''' If the function returns zero, the input was already blocked by another thread.
    ''' </returns>
    Public Shared Function SendKeys(ByVal [String] As String,
                                    Optional BlockInput As Boolean = False) As Integer

        Dim SuccessCount As Integer = 0

        ' Block Keyboard and mouse.
        If BlockInput Then NativeMethods.BlockInput(True)

        For Each c As Char In [String]
            SuccessCount += SendKey(c, BlockInput:=False, KeyAction:=KeyAction.Press)
        Next c

        ' Unblock Keyboard and mouse.
        If BlockInput Then NativeMethods.BlockInput(False)

        Return SuccessCount

    End Function

    ''' <summary>
    ''' Slices the mouse position.
    ''' </summary>
    ''' <param name="Offset">
    ''' Indicates the offset, in coordinates.
    ''' </param>
    ''' <param name="BlockInput">
    ''' If set to <c>true</c>, the keyboard and mouse are blocked until the mouse movement is sent.
    ''' </param>
    ''' <returns>
    ''' The function returns the number of events that it successfully inserted into the mouse input stream.
    ''' If the function returns zero, the input was already blocked by another thread.
    ''' </returns>
    Public Shared Function MouseMove(ByVal Offset As Point,
                                     Optional BlockInput As Boolean = False) As Integer

        ' Block Keyboard and mouse.
        If BlockInput Then NativeMethods.BlockInput(True)

        ' The inputs structures to send.
        Dim Inputs As New List(Of NativeMethods.Input)

        ' The current input to add into the Inputs list.
        Dim CurrentInput As New NativeMethods.Input

        ' Add a mouse movement.
        With CurrentInput
            .type = NativeMethods.InputType.Mouse
            .mi.dx = Offset.X
            .mi.dy = Offset.Y
            .mi.dwFlags = NativeMethods.MouseInput_Flags.Move
        End With : Inputs.Add(CurrentInput)

        ' Send the mouse movement.
        Return NativeMethods.SendInput(Inputs.Count, Inputs.ToArray,
                                       Marshal.SizeOf(GetType(NativeMethods.Input)))

        ' Unblock Keyboard and mouse.
        If BlockInput Then NativeMethods.BlockInput(False)

    End Function

    ''' <summary>
    ''' Slices the mouse position.
    ''' </summary>
    ''' <param name="X">
    ''' Indicates the 'X' offset.
    ''' </param>
    ''' <param name="Y">
    ''' Indicates the 'Y' offset.
    ''' </param>
    ''' <param name="BlockInput">
    ''' If set to <c>true</c>, the keyboard and mouse are blocked until the mouse movement is sent.
    ''' </param>
    ''' <returns>
    ''' The function returns the number of events that it successfully inserted into the mouse input stream.
    ''' If the function returns zero, the input was already blocked by another thread.
    ''' </returns>
    Public Shared Function MouseMove(ByVal X As Integer, ByVal Y As Integer,
                                     Optional BlockInput As Boolean = False) As Integer

        Return MouseMove(New Point(X, Y), BlockInput)

    End Function

    ''' <summary>
    ''' Moves the mouse hotspot to an absolute position, in coordinates.
    ''' </summary>
    ''' <param name="Position">
    ''' Indicates the absolute position.
    ''' </param>
    ''' <param name="BlockInput">
    ''' If set to <c>true</c>, the keyboard and mouse are blocked until the mouse movement is sent.
    ''' </param>
    ''' <returns>
    ''' The function returns the number of events that it successfully inserted into the mouse input stream.
    ''' If the function returns zero, the input was already blocked by another thread.
    ''' </returns>
    Public Shared Function MousePosition(ByVal Position As Point,
                                         Optional BlockInput As Boolean = False) As Integer

        ' Block Keyboard and mouse.
        If BlockInput Then NativeMethods.BlockInput(True)

        ' The inputs structures to send.
        Dim Inputs As New List(Of NativeMethods.Input)

        ' The current input to add into the Inputs list.
        Dim CurrentInput As New NativeMethods.Input

        ' Transform the coordinates.
        Position.X = CInt(Position.X * 65535 / (Screen.PrimaryScreen.Bounds.Width - 1))
        Position.Y = CInt(Position.Y * 65535 / (Screen.PrimaryScreen.Bounds.Height - 1))

        ' Add an absolute mouse movement.
        With CurrentInput
            .type = NativeMethods.InputType.Mouse
            .mi.dx = Position.X
            .mi.dy = Position.Y
            .mi.dwFlags = NativeMethods.MouseInput_Flags.Absolute Or NativeMethods.MouseInput_Flags.Move
            .mi.time = 0
        End With : Inputs.Add(CurrentInput)

        ' Send the absolute mouse movement.
        Return NativeMethods.SendInput(Inputs.Count, Inputs.ToArray,
                                       Marshal.SizeOf(GetType(NativeMethods.Input)))

        ' Unblock Keyboard and mouse.
        If BlockInput Then NativeMethods.BlockInput(False)

    End Function

    ''' <summary>
    ''' Moves the mouse hotspot to an absolute position, in coordinates.
    ''' </summary>
    ''' <param name="X">
    ''' Indicates the absolute 'X' coordinate.
    ''' </param>
    ''' <param name="Y">
    ''' Indicates the absolute 'Y' coordinate.
    ''' </param>
    ''' <param name="BlockInput">
    ''' If set to <c>true</c>, the keyboard and mouse are blocked until the mouse movement is sent.
    ''' </param>
    ''' <returns>
    ''' The function returns the number of events that it successfully inserted into the mouse input stream.
    ''' If the function returns zero, the input was already blocked by another thread.
    ''' </returns>
    Public Shared Function MousePosition(ByVal X As Integer, ByVal Y As Integer,
                                         Optional BlockInput As Boolean = False) As Integer

        Return MousePosition(New Point(X, Y), BlockInput)

    End Function

    ''' <summary>
    ''' Simulates a mouse click.
    ''' </summary>
    ''' <param name="MouseAction">
    ''' Indicates the mouse action to perform.
    ''' </param>
    ''' <param name="BlockInput">
    ''' If set to <c>true</c>, the keyboard and mouse are blocked until the mouse movement is sent.
    ''' </param>
    ''' <returns>
    ''' The function returns the number of events that it successfully inserted into the mouse input stream.
    ''' If the function returns zero, the input was already blocked by another thread.
    ''' </returns>
    Public Shared Function MouseClick(ByVal MouseAction As MouseButton,
                                      Optional BlockInput As Boolean = False) As Integer

        ' Block Keyboard and mouse.
        If BlockInput Then NativeMethods.BlockInput(True)

        ' The inputs structures to send.
        Dim Inputs As New List(Of NativeMethods.Input)

        ' The current input to add into the Inputs list.
        Dim CurrentInput As New NativeMethods.Input

        ' The mouse actions to perform.
        Dim MouseActions As New List(Of MouseButton)

        Select Case MouseAction

            Case MouseButton.LeftPress ' Left button, hold and release.
                MouseActions.Add(MouseButton.LeftDown)
                MouseActions.Add(MouseButton.LeftUp)

            Case MouseButton.RightPress ' Right button, hold and release.
                MouseActions.Add(MouseButton.RightDown)
                MouseActions.Add(MouseButton.RightUp)

            Case MouseButton.MiddlePress ' Middle button, hold and release.
                MouseActions.Add(MouseButton.MiddleDown)
                MouseActions.Add(MouseButton.MiddleUp)

            Case Else ' Other
                MouseActions.Add(MouseAction)

        End Select ' MouseAction

        For Each Action As MouseButton In MouseActions

            ' Add the mouse click.
            With CurrentInput
                .type = NativeMethods.InputType.Mouse
                '.mi.dx = Offset.X
                '.mi.dy = Offset.Y
                .mi.dwFlags = Action
            End With : Inputs.Add(CurrentInput)

        Next Action

        ' Send the mouse click.
        Return NativeMethods.SendInput(Inputs.Count, Inputs.ToArray,
                                       Marshal.SizeOf(GetType(NativeMethods.Input)))

        ' Unblock Keyboard and mouse.
        If BlockInput Then NativeMethods.BlockInput(False)

    End Function

#End Region

End Class