ButtonClick Method

Clicks a button with specified caption in specified window.

Syntax

public static string ButtonClick( 
   string windowName,
   string buttonName,
   bool topMost
)

Parameters

windowName

Type: System.String

The header of the window.

buttonName

Type: System.String

The text displayed on the button.

topMost

Type: System.Boolean

true if need to show the window on top of all; otherwise, false. Default value is false.

Return Value

Type: System.String

The answer with information about the success of the current command's execution. If current command was successful then this answer is "ok"; otherwise message describing the error.

Remarks

There are several ways of calling this method. The parameter topMost have the default value and you can call the method without this parameter.

This method searches the button by the caption and does not case sensitive.

Example

The following code example demonstrates uses of the ButtonClick method. First of all in this part of code call MouseClick method and as result it opens the save file dialog. Then waits two seconds (the time to display the window) and clicks on button with caption " Save " in window with header " Save as " using ButtonClick method.

// show the save file dialog
string result = Emulator.MouseClick("Simple window", MouseButton.Left, MouseButtonEvent.Click, 200, 200);
// wait a little bit
System.Threading.Thread.Sleep(2000);
// if mouse click was successful
if (result == "ok" && !Emulator.ErrorDetected)
{
    // click on button with caption "Save"
    result = Emulator.ButtonClick("Save as", "Save");
    // make answer
    if (result == "ok" && !Emulator.ErrorDetected) return "All done";
    else return "Fail";
}

// show the save file dialog
$result = ZennoLab\Emulation\Emulator::MouseClick("Simple window", MouseButton::Left, MouseButtonEvent::Click, 200, 200);
// wait a little bit
System\Threading\Thread::Sleep(2000);
// if mouse click was successful
if ($result == "ok" && !Emulator::ErrorDetected)
{
    // click on button with caption "Save"
    $result = ZennoLab\Emulation\Emulator::ButtonClick("Save as", "Save");
    // make answer
    if ($result == "ok" && !ZennoLab\Emulation\Emulator::ErrorDetected) return "All done";
    else return "Fail";
}

Requirements

Target Platforms: Desktop: Windows XP SP3 and older. Server: Windows Server 2003 and older.

Reference

Emulator Class
Emulator Members
MouseClick Method
MouseMove Method