libcvautomation/xtest_command_strings.html

188 lines
11 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>libcvautomation: xte_commandString() Command Strings</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
$(document).ready(function() { searchBox.OnSelectItem(0); });
</script>
<script type="text/x-mathjax-config">
MathJax.Hub.Config({
extensions: ["tex2jax.js"],
jax: ["input/TeX","output/HTML-CSS"],
});
</script><script src="http://www.mathjax.org/mathjax/MathJax.js"></script>
</head>
<body>
<div id="top"><!-- do not remove this div! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">libcvautomation
&#160;<span id="projectnumber">2.0</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- Generated by Doxygen 1.7.6.1 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main&#160;Page</span></a></li>
<li class="current"><a href="pages.html"><span>Related&#160;Pages</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</span>
</div>
</li>
</ul>
</div>
</div>
<div class="header">
<div class="headertitle">
<div class="title"><a class="el" href="libcvautomation-xtest_8h.html#a7ea1430ed90d3166f8d9fbb4e240a28f" title="Execute a command where the command is coming from a string.">xte_commandString()</a> Command Strings </div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>This page describes the various command strings available for the <a class="el" href="libcvautomation-xtest_8h.html#a7ea1430ed90d3166f8d9fbb4e240a28f">xte_commandString()</a> function. </p>
<h2><a class="anchor" id="mousefunctions"></a>
Mouse Functions</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;mouseclick &lt;button_number&gt;&#39;</span>
</pre></div><p> Click the mouse button <code></code> &lt;button_number&gt; in-place.</p>
<h2><a class="anchor" id="imouseclick"></a>
Image Mouse Click</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;imouseclick &lt;image_name&gt;&#39;</span>
</pre></div><p> Click the mouse at an image's top-left corner.</p>
<h2><a class="anchor" id="icmouseclick"></a>
Image Mouse Click (Centered)</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;icmouseclick &lt;image_name&gt;&#39;</span>
</pre></div><p> Click the mouse at an image's center.</p>
<h2><a class="anchor" id="mousexy"></a>
Mouse XY Move</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;mousexy &lt;x-coord&gt; &lt;y-coord&gt;&#39;</span>
</pre></div><p> Move the mouse to an absolute coordinate. </p>
<dl class="warning"><dt><b>Warning:</b></dt><dd>The <code>&lt;x-coord&gt;</code> and <code>&lt;y-coord&gt;</code> are expected to be integers.</dd></dl>
<h2><a class="anchor" id="mouserxy"></a>
Mouse XY Move (Relative)</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;mouserxy &lt;x-increment&gt; &lt;y-increment&gt;&#39;</span>
</pre></div><p> Move the mouse by the given x and y values (relative motion). </p>
<dl class="user"><dt><b>A positive X increment will move the mouse to the right, and a positive Y increment will move the mouse down.</b></dt><dd></dd></dl>
<dl class="warning"><dt><b>Warning:</b></dt><dd>The <code>&lt;x-increment&gt;</code> and <code>&lt;y-increment&gt;</code> are expected to be integers.</dd></dl>
<h2><a class="anchor" id="mouseimage"></a>
Mouse Image Move</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;mouseimage &lt;image_name&gt;&#39;</span>
</pre></div><p> Move the mouse to an image's top-left corner.</p>
<h2><a class="anchor" id="cmouseimage"></a>
Mouse Image Move (Centered)</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;cmouseimage &lt;image_name&gt;&#39;</span>
</pre></div><p> Move the mouse to an image's center.</p>
<h2><a class="anchor" id="mousedown"></a>
Mouse Button Down</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;mousedown &lt;button_number&gt;&#39;</span>
</pre></div><p> Push and leave down a mouse button.</p>
<h2><a class="anchor" id="mouseup"></a>
Mouse Button Up</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;mouseup &lt;button_number&gt;&#39;</span>
</pre></div><p> Release mouse button <code></code> &lt;button_number&gt;</p>
<h2><a class="anchor" id="mousejiggle"></a>
Mouse Jiggle</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;mousejiggle&#39;</span>
</pre></div><p> Jiggle the mouse (helps to activate some widgets). Moves the mouse right and down 1 pixel, and then back.</p>
<h2><a class="anchor" id="mousescrolld"></a>
Mouse Scroll Down</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;mousescrolld&#39;</span>
</pre></div><p> Scroll the mouse down 1 time - depending on window manager settings, etc., this may be multiple lines. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>This is a wrapper function for clicking button 4 on the mouse</dd></dl>
<h2><a class="anchor" id="mousescrollu"></a>
Mouse Scroll Up</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;mousescrollu&#39;</span>
</pre></div><p> Scroll the mouse up 1 time - depending on window manager settings, etc., this may be multiple lines. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>This is a wrapper function for clicking button 5 on the mouse</dd></dl>
<h2><a class="anchor" id="mouselocation"></a>
Mouse Location</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;mouselocation&#39;</span>
</pre></div><p> Return the current location of the mouse pointer.</p>
<h2><a class="anchor" id="keyclick"></a>
Key Click</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;keyclick &lt;key_name&gt;&#39;</span>
</pre></div><p> Push and release a keyboard key. This can be a key like <code>'a'</code>, <code>'b'</code>, or something fancy like <code>'space'</code>. Please see <a class="el" href="xtest_key_strings.html">XTest Key Strings</a> for a full list of special keys.</p>
<h2><a class="anchor" id="keydown"></a>
Key Button Down</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;keydown &lt;key_name&gt;&#39;</span>
</pre></div><p> Push down <em>but do not release</em> a keyboard key. This can be a key like <code>'a'</code>, <code>'b'</code>, or something fancy like <code>'space'</code>. Please see <a class="el" href="xtest_key_strings.html">XTest Key Strings</a> for a full list of special keys.</p>
<h2><a class="anchor" id="keyup"></a>
Key Button Up</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;keyup &lt;key_name&gt;&#39;</span>
</pre></div><p> Release a keyboard key. This can be a key like <code>'a'</code>, <code>'b'</code>, or something fancy like <code>'space'</code>. Please see <a class="el" href="xtest_key_strings.html">XTest Key Strings</a> for a full list of special keys.</p>
<h2><a class="anchor" id="keystring"></a>
Keyboard Input String</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;keystring &lt;string&gt;&#39;</span>
</pre></div><p> Input a string of text to the X11 server. For example, inputting 'Hello, world!" will act as if you typed 'Hello, world!' from the keyboard. </p>
<dl class="warning"><dt><b>Warning:</b></dt><dd>Unlike <a class="el" href="xtest_command_strings.html#keydown">Key Button Down</a>, <a class="el" href="xtest_command_strings.html#keyup">Key Button Up</a>, and <a class="el" href="xtest_command_strings.html#keyclick">Key Click</a>, this function can not handle special keys like 'space'.</dd></dl>
<h2><a class="anchor" id="waitfor"></a>
Wait for Image</h2>
<div class="fragment"><pre class="fragment"> <span class="stringliteral">&#39;waitfor &lt;image_name&gt;&#39;</span>
</pre></div><p> Wait for an image to show up on screen. For example, this can be used to make sure a button exists before clicking it. </p>
</div></div><!-- contents -->
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Classes</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&#160;</span>Namespaces</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&#160;</span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&#160;</span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark">&#160;</span>Defines</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<hr class="footer"/><address class="footer"><small>
Generated on Thu Oct 11 2012 17:42:49 for libcvautomation by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.7.6.1
</small></address>
</body>
</html>