core/com.nokia.carbide.cpp.doc.user/html/tasks/eventpoints/log_point_set.htm
author stechong
Wed, 20 Oct 2010 11:19:31 -0500
changeset 2165 2a7b5eccb0bc
parent 1791 727385d8e2b3
permissions -rw-r--r--
Keeping PlatSim internal only.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
<title>Log Point</title>
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
</head>
<body >
<h2>Log Point</h2>
<p>  A <b>Log Point</b> logs or speaks a string or expression. A Log Point can also record messages to the Log window. You can configure the message that appears in the log window.</p>
<h5>Related tasks</h5>
<ul>
  <li><a href="pause_point_set.htm">Setting a Pause Point</a></li>
  <li><a href="pause_point_clear.htm">Clearing a Pause Point </a></li>
</ul>
<p>&nbsp;</p>
<div class="step">
  <h5>Setting a Log Point</h5>
  <p>To set a Log Point, follow these steps:</p>
  <ol>
    <li>Click the cursor on the line of source code at which you want to set the Log Point.</li>
    <li>Click Debug &gt; Set Eventpoint &gt; Set Log Point.</li>
    <li>Enter the text of your log message in the Message text box.</li>
    <li>Check at least one of these checkboxes:</li>
    <ul><li><b>Log Message</b>&mdash;check to have the IDE display your message in a Message window when program execution reaches the Log Point</li>
    <li><b>Speak Message</b> (Windows OS)&mdash;check to have the IDE use the sound capabilities of the host operating system to speak the message that you enter in the Message text box.</li>
    <p class="note"><b>NOTE</b> (Windows) Install the Speech software development kit (SDK) in order to have the Speak Message feature work correctly.</p>
    <li><b>Treat as Expression</b>&mdash;check to have the IDE evaluate the text you enter in the Message text box as an expression. For example, if you enter the name of a variable in the Message text, the debugger writes the value of that variable in the console output window.</li>
    <li><b>Stop in Debugger</b>&mdash;check to stop program execution in the debugger</li>
    </ul>
    <li>Click the OK button to confirm your settings.</li>
  </ol>
</div>
<p>Example use: If you want to display the value of a variable each time some code is executed, set a log point, check the Log Message and Treat as expression boxes and enter the variable name in the edit box, then click OK.</p>
<div id="footer">Copyright &copy; 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br />License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>

</body>
</html>