<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Adding and parsing Enumerations</title>
<link href="../../book.css" type="text/css" rel="stylesheet"></head>
<body>
<h2>Adding and parsing Enumerations</h2>
<p>Enumerations can also be used as trace parameters. When a enum value is
passed to trace function, it will be converted to a string when the trace is decoded. </p>
<p>To add an Enumeration, do the following: </p>
<ol>
<li>From the Trace Builder menu, select <b>Add Enum / Constant to Enum</b>.</li>
<li>Select an existing Enumeration name or define a new one by typing the
name to the <b>Enum Name</b> field. </li>
<li>Type a name for a new Constant. </li>
<li>Type a value for this Constant. You can also specify it as a hexaecimal
value by selecting the <b>Hex ID</b> box.</li>
<li>Click <b>OK</b>. </li>
</ol>
<p><b>Note:</b> To use the created Enumeration values in traces, you must
<a href="addingparameters.htm">add them as a parameter</a>.</p>
<h3>Parsing Enumerations from the source code</h3>
<p>To parse an existing Enumeration from a source code, do the following: </p>
<ol>
<li>Select the Enumeration name from the source code, for example:
<p><img src="images/enumeration.png"></p></li>
<li>From the Trace Builder menu, select <b>Parse Enum</b>.</li>
<li>The Enumeration should now be visible in the Trace Builder tree view,
for example: <p><img src="images/enumerationparsed.png"></p> </li>
</ol>
<p>You can now use the Enumeration as a parameter in a trace. For more
information, see <a href="addingparameters.htm">Adding parameters to existing
traces</a>. </p>
<div id="footer">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved.
License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.</div>
</body>
</html>