blob: c861a2833ada89c550a640978e620082f14d60b9 [file] [log] [blame]
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Chapter 6. Adding keyboard layout files</title>
<link rel="stylesheet" type="text/css" href="../../css/style.css">
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
<link rel="home" href="../index.html" title="Jubula Developer Manual">
<link rel="up" href="../index.html" title="Jubula Developer Manual">
<link rel="prev" href="../functions/functions.html" title="Chapter 5. Creating ITE functions">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr><th colspan="3" align="center">Chapter 6. Adding keyboard layout files</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="../functions/functions.html">Prev</a> </td>
<th width="60%" align="center"> </th>
<td width="20%" align="right"> </td>
</tr>
</table>
<hr>
</div>
<div xmlns:d="http://docbook.org/ns/docbook" class="breadcrumbs">
<span class="breadcrumb-link"><a href="../index.html">Jubula Developer Manual</a></span> &gt; <span class="breadcrumb-node">Adding keyboard layout files</span>
</div>
<div class="chapter">
<div class="titlepage"><div><div><h1 class="title">
<a name="keyboardLayout"></a>Chapter 6. Adding keyboard layout files</h1></div></div></div>
<p>
For SWT and RCP AUTs, you need to define a keyboard layouts for the
AUT (i.e. which keyboard layout is set for the system on which the AUT
runs).
</p>
<p>
The keyboard layouts for German (Germany) and English (US) are already
present. If you want to use another keyboard layout, follow the
instructions in the next section to create one.
</p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem"><p>
The name of the file must be in the following format:<br xmlns:d="http://docbook.org/ns/docbook">
keyboardmapping_&lt;language&gt;_&lt;COUNTRY&gt;.properties<br xmlns:d="http://docbook.org/ns/docbook">
e.g. for US English: keyboardmapping_en_US.properties
</p></li>
<li class="listitem"><p>
In the file, enter the codes for all characters which require you
to press a modifier key.
</p></li>
<li class="listitem"><p>
The format for these codes is:<br xmlns:d="http://docbook.org/ns/docbook">
&lt;Character&gt;=&lt;Modifier&gt;+&lt;Character without modifier&gt;<br xmlns:d="http://docbook.org/ns/docbook">
e.g. for the @ character: @=shift+2
</p></li>
<li class="listitem"><p>
The following symbols must be escaped with a backslash:<br xmlns:d="http://docbook.org/ns/docbook">
<code class="literal">! = : \ ,</code><br xmlns:d="http://docbook.org/ns/docbook">
e.g. <code class="literal">\!=shift+1</code> for !
</p></li>
<li class="listitem"><p>
There are pictures of various keyboards on the following website:<br xmlns:d="http://docbook.org/ns/docbook">
<span class="emphasis"><em>http://www.uni-regensburg.de/EDV/Misc/KeyBoards/</em></span>
</p></li>
<li class="listitem">
<p>
To add the keyboard layout file, you must create a fragment containing your newly added keyboard layout file(s). The host plugin for the fragment is:<br xmlns:d="http://docbook.org/ns/docbook">
<span class="emphasis"><em>org.eclipse.jubula.client.core</em></span><br xmlns:d="http://docbook.org/ns/docbook">
The path within the fragment must be:<br xmlns:d="http://docbook.org/ns/docbook">
<span class="emphasis"><em>resources/keyboard_mapping/&lt;name&gt;.properties</em></span>
</p>
<p xmlns:d="http://docbook.org/ns/docbook"><table>
<colgroup>
<col>
<col>
</colgroup>
<tbody><tr>
<td><img align="bottom" width="100" height="91" src="../images/img2.jpg"></td>
<td class="topbotline"><span class="strong"><strong>If you name the file with the locale code, then the keyboard layout will be displayed in plain text in the AUT configuration dialog.</strong></span></td>
</tr></tbody>
</table></p>
</li>
</ol></div>
</div>
<br xmlns:d="http://docbook.org/ns/docbook"><hr xmlns:d="http://docbook.org/ns/docbook">
<address xmlns:d="http://docbook.org/ns/docbook">Copyright BREDEX GmbH 2015. Made available under the Eclipse Public License v1.0.</address>
<br xmlns:d="http://docbook.org/ns/docbook">
</body>
</html>